yaosutu
|
bb18e4fac8
|
docs(order-v3): §1 changelog 修 3 问 + 重组为按接口自含结构
按用户反馈修复 3 个问题：
(1) §1.3.1 主聚合输出字段：删 6 Tab 字段（finance/itinerary/contractInsurance/
serviceStandard/statusLog/refund），代码 OrderDetailRespVO 实际只有
main/tags/overview 3 字段（Issue #2460 已重构）
(2) 示例重组：原 §8 集中节按"多接口 changelog"模式打散，每个接口的请求+响应
示例下沉到 §3.x 接口章节内紧跟出参/错误码/边界
(3) 补全缺失请求示例：§1.3.2 ~ §1.3.7 6 个 GET Tab 子接口、§1.3.1 异常 case
等之前漏写请求示例的部分全补上
结构调整：原 13 节模板按"接口集中"组织（§3 详情/§4 入参/§5 出参/§7 错误码/
§8 示例 5 节）拆散为"每接口自含"结构（§3.x 含使用场景/入参/出参/错误码/边界/
示例），§6 枚举仍合并去重 + 标使用字段。
文件结构：
§0 模块全貌（4 子模块 + 推送状态表）
§1 接口背景
§2 变更清单（10 接口表）
§3 接口详情（10 个 §3.x 子节，每节自含）
§6 枚举字典（16 节，按字段分组 + 标使用接口位置）
§11 影响评估 / §12 注意事项 / §13 关联
SKILL.md 加约定：多接口 changelog 必须按接口分小节 + 示例必含请求+响应。
关联：HL feature 分支同步推 commit ae645a59 修 API-SPEC §1.3.1 字段表。
|
2026-05-18 16:36:47 +08:00 |
|
yaosutu
|
87fd82c56d
|
docs(order-v3): §1 core 模块首推 §1A（10 接口）
订单核心模块全新二期首推，含订单 CRUD + 详情主聚合 + 6 Tab 子接口 + 修改字段：
§1.1 POST /v3/admin/order 创建订单
§1.2 GET /v3/admin/order 订单列表
§1.3.1 GET /v3/admin/order/{id} 详情主聚合
§1.3.2 GET .../finance 财务 Tab
§1.3.3 GET .../contract-insurance 合同保险 Tab
§1.3.4 GET .../itinerary 行程 Tab（⚠️ Mock）
§1.3.5 GET .../status-log 状态记录 Tab
§1.3.6 GET .../refund 退款明细 Tab
§1.3.7 GET .../service-standard 服务标准 Tab
§1.4 PUT /v3/admin/order/{id} 修改订单字段
883 行 / 13 节齐全 / 15 枚举按使用字段分组 / 8 组示例（典型+边界+异常）。
§1B 取消订单 / §1C 状态机后续 commit 追加同一文件。
设计文档同步升 v5.49（API/SRS/DETAIL/DB 4 份 HTML）。
|
2026-05-18 16:17:59 +08:00 |
|
yaosutu
|
6c5087c6eb
|
docs(order-v3): 删除早期 §1.1 单接口测试 changelog
18_test_订单创建-修改接口-管理后台.md 是 §1.1 单接口测试样本，
将由后续 §1 总文件取代（含 §1.1+§1.2+§1.4 等 §1A 子模块全集）。
|
2026-05-18 15:58:22 +08:00 |
|
yaosutu
|
1701cf7a23
|
docs(order-v3): §4/§5/§9/§11/§12/§13 清理后端实现/派生/前端 use case 备注
前端 changelog 只写接口契约（入参/出参/类型/枚举/错误码/边界/示例）。
本次砍掉 7 类无效内容：
1. 后端字段来源（JWT 派生 / 产品快照派生）
2. 后端实现细节（雪花 ID JSON String / DB 层 AES / 从 Nacos 拼接）
3. 后端 DB 字段（写入 order_main.room_count / order_tag tag_type=PERSONAL）
4. 后端运维（端口 / DDL / Redis key / 重启 / 回滚耗时）
5. 前端 use case（弹窗标题用 / 前端拼催款话术）
6. 其他接口跳转（出行人不在本接口传，调 §2 单独添加）
7. 影响其他后端服务
字段 +46 / -75 净减 29 行，聚焦接口契约。
|
2026-05-18 15:44:12 +08:00 |
|
yaosutu
|
2a3ffb7737
|
docs(order-v3): §6 枚举/字典按字段分组重排 + SKILL 同步更新
原 §6 把 5 个枚举（createSource/orderStatus/flowStatus/consultantSource/paymentMode）
混在一张 23 行大表里，前端 AI 按字段查表难定位。
改为每枚举一个 H3 子节（6.1~6.5），每节附「所属字段 + 枚举类 + 类型 + 必填」头部说明。
|
2026-05-18 15:37:59 +08:00 |
|
yaosutu
|
0aee0ceddb
|
docs(order-v3): 订单创建接口 v3 admin POST /v3/admin/order 接口现状快照（测试 v2 目录）
启用 changelogs-v2/ 新目录，前端 v3 项目仓库后续从此目录读 changelog。
此份为 v3 admin 订单创建接口（OrderController.createOrder）的 v5.18 完整快照，
含 13 节固定模板（入参 13 字段 / 出参 20 字段 / 枚举 21 项 / 错误码 9 个 / 3 组示例）。
|
2026-05-18 15:04:12 +08:00 |
|