docs/README.md

虫虫出海文档入口

本文件只负责选入口，不保存业务规则或部署进度。已知页面、文件、API 或当前正文时跳过本文件；未知代码入口查业务索引的命中行，不沿所有 README 逐层读取。

按任务选一种入口

任务	从哪里开始
改代码、文案或局部逻辑	已知目标文件及适用 AGENTS.md；业务语义不明才补一段正文
只有中文业务词或多义词	业务索引，代码入口与规则正文分开选择
跨阶段流程、节点关系或上下游交接	全流程维护入口，只查受影响阶段
已知某个业务域，需要找规则	下表选择该域；找到正文后停止扩展
运行、验证、部署或数据库操作	下方工程专题，按操作类型只选对应章节

业务域入口

业务域	入口
客户、企业、权限与头程订单	订单与客户
到仓、测量、箱码、计价与入库费用	入库测量与计费
分柜、装柜、订舱、拖车、报关与国内出仓	国内货柜履约
接柜、库存、库内服务、排车、预约与海外本土业务	海外仓业务
费用入池、账单、资金账户与收付款	财务管理
自营经营、库存周转与领星采集	自营业务
箱唛、托盘标、HOLD 与 BOL	打印标签维护

公共契约与工程专题（命中才读）

主题	当前入口
服务拓扑、环境配置、部署状态与验收项	部署主契约
Gateway、Auth 会话、服务身份与可靠投递	认证与通信主契约
平台/客户、菜单与操作权限	层级与权限契约
单据编号、订单主状态与操作	编号契约、订单状态契约，按问题选一项
本机资源、最小验证、工作区与协作执行	工程执行约束
Admin 样式、Client 样式或视觉验收	Admin 样式、Client 样式、前端验收，不将三份作为共同必读
测试 Jenkins、数据库操作与中文注释	测试部署指南、数据库操作手册、数据库注释规范，按操作选读
测量设备上传	墨家接口说明

方案、证据与历史（按需）

• 独立主题设计只在该任务触发：数据库发布方案、生产发布方案、生产环境方案、OSS 设计、看板规划。方案不证明已实现或已部署。
• 原型与截图按应用指引定向查找；样板、样式核对记录、进度表和验收报告不作为日常开发入口。
• 历史流程、货柜历史、财务历史仅用于追溯；旧双区域架构不覆盖当前主契约。
• 只有独立任务协作才查开发环境独立任务协作登记或测试环境独立任务协作登记，不同时读取两表。

维护边界

同一主题优先更新现行正文，不为每轮对话新增方案、总结、进度或交接文件。只有独立主题且现有正文无法承载时才新增，并在所属域登记角色、触发条件和替代关系。已完成的过程材料冻结归档；索引只同步路径或职责变化，不复制阶段数量、字段、状态、测试结果或完成进度。事实优先级及修改范围遵循工作区根指引。