1.7 KiB
1.7 KiB
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 内点击详情、扫码、退款等未迁移能力时进入占位页，避免入口崩溃。