项目7 · Go 书签与检索服务

• 标准库 net/http 路由与方法处理
• 中间件：请求 ID、日志、耗时与 panic 恢复
• 存储接口与内存实现，错误传播保留上下文
• context 取消传播与优雅退出
• 表驱动测试与 httptest 接口测试

• 01GET /health 健康检查
• 02GET /bookmarks?q=&tag=&page=&size= 检索分页
• 03POST /bookmarks 创建（JSON 校验）
• 04GET /bookmarks/{id} 与 DELETE /bookmarks/{id}
• 05请求日志中间件（方法/路径/状态码/耗时/请求 ID）
• 06SIGINT 优雅退出（停止接收新请求、等待在途请求）

# 项目 7：Go 书签与检索服务

用 Go 标准库实现一个完整服务：HTTP 路由、JSON 校验、中间件、存储接口、并发安全、context 取消与优雅退出。

## 启动（参考实现）

```bash
cd examples/projects/p7-go-bookmark/solution
go run .
# 服务在 http://127.0.0.1:8200
curl http://127.0.0.1:8200/health
```

## 测试

```bash
cd examples/projects/p7-go-bookmark/solution
go test ./... -count=1
# ok reactlab.exercise/p7

# 或一键验收（solution 过 / starter 挂）：
bash tests/run-checks.sh
```

## 目录

```
starter/   起点（main.go 骨架 + TODO）
solution/  参考实现（main.go / middleware.go / main_test.go）
tests/     验收脚本 run-checks.sh
docs/      api.md · data-model.md（含 SQLite 版本表结构）
fixtures/  bookmarks.json
```

## 接口

见 `docs/api.md`。错误统一为 `{"error":{"category","message"}}`。

## 优雅退出

Ctrl+C 后 `srv.Shutdown` 停止接收新请求并在 5 秒内等待在途请求结束，然后进程退出。