# 请求生命周期维护备注

HTML 主入口需要把一次请求从入口到响应讲完整，不能只列 Controller 或 URL。

建议顺序：

1. HTTP Request：路径、方法、认证信息和请求体。
2. Version / Auth：`X-API-Version: 1`、登录态、RBAC、owner、tenant。
3. Controller DTO：参数校验、DTO 转换、统一响应包装。
4. Application：事务、幂等、跨模块 facade、任务或外部编排。
5. Domain：状态机、不变式、revision / expectedVersion / expectedStatus。
6. DB / Adapter：Mapper、外部 adapter、outbox、任务执行器。
7. Assembler：读模型和 OpenAPI response DTO。
8. CommonResult：对外 JSON 字段 `code/data/msg`。

每个节点需要给出常见问题、定位证据和下一步，方便初级工程师按层排障。