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