小蓝书 Go
零基础入门

01|先理解你要学习的产品

前一站:总目录 · 下一站:终端与文件

今天的目标#

不写代码,先说清楚谁在使用小蓝书、可以做什么、哪些东西需要保存。你可以把它理解成一本多人共同写的生活手册:有人发海边照片,有人在下面评论,也有人收藏它作为周末计划。

一次分享里有什么#

假设蓝小满发布“在海边,浪费一个下午”。系统至少需要保存作者、标题、正文、图片地址和发布时间。Momo 给它点赞后,还要保存“谁给哪篇笔记点过赞”,而不只是把某个数字加一。否则 Momo 再点一次就可能刷出无数赞,刷新也无法知道自己是否已经点赞。

评论也是一条独立记录,有作者和所属笔记。回复评论还要知道回复哪条、属于哪个一级讨论。关注不是双方自动成为好友,而是一条有方向的关系:A 关注 B 不代表 B 关注 A。

三种参与者#

身份 可以尝试的动作 限制
未登录访客 浏览公开笔记、资料、评论和搜索 无法发布、点赞、上传
普通用户 注册登录、发布和修改自己的内容、参与互动 不能编辑他人的笔记或进入管理后台
管理员 看统计、搜索账户、停用或软删除普通用户 不通过用户管理接口修改管理员

登录是建立身份,权限是判断身份能做什么,两件事要分开理解。页面把按钮藏起来只是方便使用;后端还必须独立检查权限,因为人可以绕过页面直接发送 HTTP 请求。

新旧项目的关系#

原 Java 项目把认证、笔记、评论、搜索等拆成许多进程。Go 版保留业务用途,把它们组织在一个进程的不同文件里。你从一个程序和一个数据库就能开始学,不需要先配置微服务注册中心。代价是当前实现采用单实例数据库写入,不能把它说成已经验证过的大型分布式平台。

先记住五个目录#

cmd/server        开始运行的地方
internal/httpapi  接收和回复网络请求
internal/service  检查业务规则并调用 SQL
frontend          浏览器中的页面
docs              从入门到部署的课程

internal 的意思是项目内部代码,Go 会限制其他模块直接导入它。cmd 是可执行程序入口的常用目录名。初学时不用记住全部文件,先能区分“页面在哪里”和“后端规则在哪里”。

动手练习和验收#

打开项目根目录,找到 go.mod、frontend/package.json 和 README.md。只阅读,不改动。然后用自己的话回答:收藏一篇笔记,需要保存一个总数就够了吗?为什么关注表要保存两个用户 ID?若能解释“保存关系之后才能重复检查、取消和统计”,本章就完成了。

— 本篇阅读完毕 —
来源:小蓝书 Go / docs / 01-beginner/01-project-tour.md 下载原文
输入关键词,在三个知识库中搜索
支持正文检索 · 直接定位章节Esc 关闭