detailed-designlisted

# 详细设计（LLD） > 功能级详细设计：类图 + 接口 + 数据模型 + 时序图 + 错误处理 + 测试策略。 > 产出 `changes/proposals/<id>/design.md`。 ## 前置条件 - 变更提案存在 - ���项目：HLD 已完成 - 历史项目：变更涉及架构/模型/接口变更 ## 执行步骤 ### 第 1 步：读 HLD（如有） ```bash cat changes/proposals/<current>/hld.md # 新项目 cat changes/proposals/<current>/proposal.md ``` ### 第 2 步：类图设计 用 mermaid 画类图： ```mermaid classDiagram class UserEntity { +Long id +String username +String email +Long tenantId } class UserRepository { <<interface>> +findById(Long) Optional~UserEntity~ +save(UserEntity) UserEntity } class UserService { <<interface>> +findById(Long) UserVO +create(UserDTO) Long } class UserServiceImpl { -UserRepository userRepository +findById(Long) UserVO } UserServiceImpl ..|> UserService UserServiceImpl --> UserRepository UserRepository ..> UserEntity ``` ### 第 3 步：接口定义 按 `api-design` 技能输出契约： ```java // 内部 API GET /api/v1/users/{id} → UserVO GET /api/v1/users/page → ResPage<UserVO> POST /api/v1/users → Long PUT /api/v1/users/{id} → void DELETE /api/v1/users/{id} → void // 开放 API GET /api/open/v1/users/{id} → UserVO ``` ### 第 4 步：数据模型 按 `model-design` 和 `database-design` 技能输出： - Entity / PO / DTO / VO / Query 定义 - 数据表 DDL - Flyway 迁移脚本 ### 第 5 步：时序图 画关键业务流程的时序图： ```mermaid sequenceDiagram participant C as Client participant Ctrl as Con