Files

T

ouyangxq b34626bd4b docs(admin): add module-level AGENTS indexes for all 33 modules

新增 29 个模块级 AGENTS.md，补齐入口表指向，使 33 个业务模块均可从入口直达页面与接口。

- 每个模块指引统一为：路径基准 / 页面与入口表 / 关键边界 / 验证入口
- 入口表 35 行改为指向 modules 下的 AGENTS.md，补齐费用项目、审计日志、尺寸配置、装柜照片等缺失词条
- 详细索引最长行从 1315 字符压缩到 699 字符，规则正文移入新增的“货柜工作台规则”小节
- 仅索引文档，未改动业务代码

2026-10-20 12:45:00 +08:00

3.0 KiB

Raw Blame History

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。

3.0 KiB Raw Blame History Unescape Escape

Admin 预约日历模块指引

路径基准与读取顺序

页面与入口

关键边界

验证

3.0 KiB

Raw Blame History