27 lines
1.7 KiB
Markdown
27 lines
1.7 KiB
Markdown
# Orders 模块业务逻辑
|
||
|
||
## 模块职责
|
||
|
||
Orders 模块负责登录后的订单 Tab。当前第一轮同步覆盖订单管理和核销订单两个入口，提供列表展示、筛选、分页、刷新和手动核销闭环。
|
||
|
||
本轮不迁移扫码核销、退款、完整订单详情、历史拍摄、任务上传、视频预告等长尾流程；这些入口统一进入安全占位页，后续按独立模块逐个迁移。
|
||
|
||
## 核心对象
|
||
|
||
- `OrdersView`：订单 Tab 根视图，读取 `AccountContext`、`PermissionContext`、`AppRouter` 和 `OrdersAPI`。
|
||
- `OrdersViewModel`：管理订单子入口、筛选条件、分页状态、加载状态和手动核销状态。
|
||
- `OrdersAPI`：封装订单列表、核销订单列表和订单核销接口。
|
||
- `OrdersEntry`：表示订单 Tab 内部入口，包含订单管理和核销订单。
|
||
|
||
## 数据流程
|
||
|
||
订单页面从 `AccountContext.currentScenic` 读取当前景区 ID，从 `PermissionContext.currentRole` 读取角色 ID。景区管理员角色 `roleId == 53` 使用景区管理员订单接口，其他角色使用摄影师订单接口。
|
||
|
||
订单管理支持状态筛选、手机号搜索、开始/结束日期筛选。筛选变更后从第一页重新加载，滚动到列表底部时加载下一页。
|
||
|
||
核销订单支持手动输入订单号。核销成功后重新拉取第一页核销订单，并重置分页状态；核销失败只清理提交状态，不刷新列表。
|
||
|
||
## 路由边界
|
||
|
||
首页 `photographer_orders` 和 `/scenic-order-manage` 会进入订单管理，`verification_order` 会进入核销订单。订单 Tab 内点击详情、扫码、退款等未迁移能力时进入占位页，避免入口崩溃。
|