今天的目标#
不写代码,先说清楚谁在使用小蓝书、可以做什么、哪些东西需要保存。你可以把它理解成一本多人共同写的生活手册:有人发海边照片,有人在下面评论,也有人收藏它作为周末计划。
一次分享里有什么#
假设蓝小满发布“在海边,浪费一个下午”。系统至少需要保存作者、标题、正文、图片地址和发布时间。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?若能解释“保存关系之后才能重复检查、取消和统计”,本章就完成了。