ouyangxq
b34626bd4b
新增 29 个模块级 AGENTS.md，补齐入口表指向，使 33 个业务模块均可从入口直达页面与接口。 - 每个模块指引统一为：路径基准 / 页面与入口表 / 关键边界 / 验证入口 - 入口表 35 行改为指向 modules 下的 AGENTS.md，补齐费用项目、审计日志、尺寸配置、装柜照片等缺失词条 - 详细索引最长行从 1315 字符压缩到 699 字符，规则正文移入新增的“货柜工作台规则”小节 - 仅索引文档，未改动业务代码
3.0 KiB
3.0 KiB
Admin 预约日历模块指引
路径基准与读取顺序
- 本文件适用于
src/modules/appointment-calendar/，代码路径相对本目录；应用公共规则见../../../AGENTS.md，预约规则见../../../docs/business-index.md；工作日历正式规则在工作区docs/海外仓业务/预约工作日历V13变更说明.md。 - 本模块扁平存放页面、面板与 API，无
pages/、components/分层：*.vue多为面板，*Api.ts为对应接口，calendar.ts/schedule.ts/tripCalendar.ts为日历与航段计算，useWorkDraft.ts/useWorkSyncRead.ts为草稿与只读同步。 - 后端只查
lastleg-service/（inboundplan/、appointmentplanning/）；到港事实只读firstleg/的船节点，纯页面与文案不读后端。
页面与入口
| 目标 | 入口 | API 与后端 |
|---|---|---|
| 预约列表与日历主页面 | AppointmentCalendarView.vue；appointment-calendar |
api.ts、calendar.ts；lastleg-service/inboundplan/ |
| 工作日历、车次与送仓待办 | WorkCalendarPanel.vue、TripAppointmentPanel.vue |
workApi.ts、tripCalendar.ts；lastleg-service/appointmentplanning/ |
| 新建/批量预约、多客户共车 | AppointmentCreatePanel.vue、AppointmentBatchForm.vue、WorkSharedTripForm.vue |
workApi.ts、batchApi.ts |
| 货物验证与入仓码关系 | AppointmentCargoPanel.vue、AppointmentCargoTabs.vue、AppointmentInboundCodes.vue、CargoVerificationForm.vue |
cargoVerificationApi.ts |
| 改期、取消与取消记录 | AppointmentImpactDialog.vue、AppointmentCancellationDialog.vue、AppointmentCancellationHistory.vue、AppointmentCancellationRecords.vue |
impactApi.ts |
| 派送安排与分批后送 | WorkDispatchForm.vue、WorkExistingDispatchForm.vue |
workApi.ts；lastleg-service/delivery/ |
| 收货范围与收货计划 | ReceivingScope.vue、WorkReceivingPanel.vue、WorkReceiptPlans.vue |
receivingApi.ts |
| 外部候选取货与跟进 | AppointmentExternalCandidates.vue、AppointmentFollowupDialog.vue |
planningApi.ts、workApi.ts |
关键边界
- 同仓跨客户共用一张预约，客户归属在货物明细，不为每个客户拆预约；同车多客户按 V13 规则处理。
- 到港事实只读 Firstleg 船节点，送仓与排车归 Lastleg；不得用预计到港替代计划到仓，也不得反向写船节点。
- 改期、取消、重新预约必须按服务端影响范围与版本提交，取消记录只追加，不改写历史。
- 未定日期事项进入待办跟进，不伪造日期；分批后送的批次关系以服务端返回为准。
- 面板之间共享草稿状态，
useWorkDraft.ts是唯一草稿入口；刷新时用useWorkSyncRead.ts合并服务端事实并保留本机未提交输入。
验证
- 定向：
pnpm test src/modules/appointment-calendar/<目标测试>；日历与批次规则变更同时核对 V13 规则文档与lastleg-service合同。 - 本文件或索引变更后，从后端根运行
./scripts/agents-index-contract.ps1。