# 从空目录编写核心链路：八个可以验收的小阶段

前置：完成初学十章。此章是练习路线，建议在单独的 `D:\xiaolanshu-practice` 编写，不覆盖已经可运行的交付工程。每阶段只在上一步通过后继续。完整源码可作对照，先独立尝试，再看实现。

## 阶段一：最小 HTTP 服务

创建目录，运行 `go mod init xiaolanshu-practice`。写 main.go：

```go
package main

import (
    "encoding/json"
    "log"
    "net/http"
)

func main() {
    mux := http.NewServeMux()
    mux.HandleFunc("GET /health", func(w http.ResponseWriter, r *http.Request) {
        w.Header().Set("Content-Type", "application/json")
        json.NewEncoder(w).Encode(map[string]string{"status": "ok"})
    })
    log.Fatal(http.ListenAndServe("127.0.0.1:8099", mux))
}
```

运行 `go run .`，浏览器访问8099/health，看到JSON。先解释 Handler 的 w/r 再继续：r是进来的请求，w是回出去的响应。此代码只适合第一步练习，后续要补超时和优雅关闭。

## 阶段二：输入、输出和错误

增加 POST /notes，定义 NoteInput，json.NewDecoder 读取请求体；标题去空格后为空返回400；成功返回 `{success:true,data:{id:1,title:...}}`。先不接数据库，明说数据只在本次请求里，重启不会保留。写 httptest 发送空标题，断言400。

验收：错误请求不能返回200；JSON格式错不会panic；返回Content-Type正确。

## 阶段三：接 SQLite

使用与交付版相同的 modernc.org/sqlite 固定版本，database/sql.Open 建连接，创建 notes 表，INSERT 后 LastInsertId，GET按ID查询。把保存与读取放入独立 service，不把所有SQL写进main。Windows路径参考 database.Open 的 file URI 处理。

验收：发一篇、停程序、重启仍能读取。给文件夹改名时数据路径也要检查。测试用 t.TempDir 创建独立库，不能对默认实际库执行清空。

## 阶段四：登录身份

先做开发随机验证码，再创建用户和 sessions。按 auth.go 学校验摘要、过期、尝试和消费；签 JWT 但不把敏感数据放payload。给POST /notes加 Actor，拒绝未登录，并把 creator_id 来自可信身份。

验收：同码二次使用失败；篡改JWT失败；退出后旧JWT失败；伪造body.userId不改变作者。不要跳过这一步先做管理员界面。

## 阶段五：实现幂等点赞

创建 note_likes(user_id,note_id)组合主键；先做like/unlike目标状态，再做详情COUNT。用24个goroutine同时请求同一关系，最终只有1行。不要先做缓存计数，因为你需要先有可核验的事实表。

验收：重复like成功但不多计数；重复unlike不负数；陌生笔记404；私密笔记非作者不能新增赞。

## 阶段六：评论与关注

评论从一级开始，再加 parent_id/reply_id；写跨笔记回复必须失败的测试。关注从有向关系开始，再做 following/fans 两个方向查询。把分页纳入最初契约，不等全部写完才补。

验收：删除根评论后回复不再显示/点赞；用户不能自关注；普通人不能编辑他人笔记。把此阶段每个规则写成一条测试名。

## 阶段七：接前端

用 Vite 创建 React+TS工程，先只有一个输入框和发布按钮，fetch 你写的 POST /notes。把代理设置成8099；浏览器Network确认真实请求。再提取 api.ts，统一 token、错误和超时，最后分出列表、详情和编辑组件。

验收：不能靠Date.now模拟数据库ID；发完新建记录马上能读详情；后端关闭时页面清楚报错。等行为稳定，再按设计令牌增加摄影、布局、响应式和减少动画支持。

## 阶段八：运维与复盘

添加配置检查、构建脚本、关机、上传白名单、数据库备份和检查文档。运行全套测试、静态检查和依赖审计；保存实际结果，不填不存在的性能成绩。

最后对照本工程：哪些规则你遗漏了？哪些抽象让你更难解释？把一个从HTTP到SQL的完整例子讲给没写过代码的人听。能独立复现失败边界，比能复制大段源码更有价值。
