Files
lab/go/projects/lyra/docs/plans/2026-10-17-business-package-layout.md
labmem 3f16384376 feat(lyra): 启动 HTTP 服务并添加示例接口
- 注册 GET /hello,使用统一响应结构并添加路由回归测试
- 使用 lyra.toml 配置 Gin 模式与监听地址,处理启动错误
- 明确 handler/service 业务分包约定并同步文档
2026-10-17 10:32:44 +08:00

2.1 KiB

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 响应一致。
  • 验证未监听实际端口、未连接数据库;保留工作区既有配置与其他用户改动。