feat(lyra): 启动 HTTP 服务并添加示例接口

- 注册 GET /hello,使用统一响应结构并添加路由回归测试
- 使用 lyra.toml 配置 Gin 模式与监听地址,处理启动错误
- 明确 handler/service 业务分包约定并同步文档
This commit is contained in:
2026-10-17 10:32:44 +08:00
parent 8b320817ed
commit 3f16384376
12 changed files with 154 additions and 46 deletions
@@ -0,0 +1,30 @@
# Handler 与 Service 的业务分包调整
## 已确认范围
- handler、service 可以按明确业务分包;服务级简单接口保留在根包。
- 将 `/hello` 从 `internal/handler/lyra` 移至 `internal/handler`,同步路由引用;入口路由文件使用 `router.go`。
- router、api、model 等其他层暂时保持平铺,公共基础能力不随业务重复拆分。
- 不预建空业务包,不改变 `/hello` 路径、响应契约或配置环境语义,不顺带改变启动错误处理。
- 同步架构文档、README、相关目录约定与过时的入口注释;历史方案保留为历史记录。
## 工作分工与顺序
1. 代码执行 lane:负责 handler 移动、router 引用和文件名、入口过时注释,以及路由回归测试。
2. 文档执行 lane:并行负责 architecture.md、README.md、必要的目录 AGENTS.md,解释业务分包与当前实现状态。
3. 父代理:整合两条 lane 的结果,审查最终差异并登记验证结论。
## 验证路径与归属
- 代码 lane:新增或利用 `httptest` 路由测试,不监听实际端口、不连接数据库,确认 `GET /hello` 返回 HTTP 200 且维持现有响应契约。
- 父代理:在 Lyra module 根执行 `go test ./...`、`go vet ./...`,确认移动后的包引用与编译正确;若执行 lane 已完成同等检查且最终代码未变则复用证据。
- 文档 lane:核对当前配置文件名、HTTP 启动状态与目录组织说明,不把未来规划写成已实现能力。
- 父代理:检查最终 diff、旧包路径残留和敏感信息风险,保留用户既有未提交改动。
## 状态
- 代码与文档 lane 均已完成,最终差异已审查。
- `/hello` 已移至 handler 根包,路由引用已更新;未创建空业务包。
- 架构文档、README 与 handler/service/router 的目录约定已同步。
- 验证通过:`go test ./...`、`go vet ./...`、`git diff --check`;路由测试确认 HTTP 200 与原有 JSON 响应一致。
- 验证未监听实际端口、未连接数据库;保留工作区既有配置与其他用户改动。