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 |
|