# 01｜先理解你要学习的产品

前一站：[总目录](../README.md) · 下一站：[终端与文件](02-tools.md)

## 今天的目标

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

## 一次分享里有什么

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

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

## 三种参与者

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

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

## 新旧项目的关系

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

## 先记住五个目录

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

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

## 动手练习和验收

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