2026-07-31 10:43:30 +08:00
|
|
|
|
# 虫虫出海文档索引
|
|
|
|
|
|
|
2026-09-04 16:44:08 +08:00
|
|
|
|
项目交付文档按业务域组织。当前开发环境以端到端全流程为统一范围；历史规划、确认和验收记录保留在对应业务域目录，仅用于追溯决策，不构成功能边界。
|
2026-07-31 10:43:30 +08:00
|
|
|
|
|
2026-09-04 16:44:08 +08:00
|
|
|
|
## 业务域文档
|
2026-07-31 10:43:30 +08:00
|
|
|
|
|
2026-09-10 12:18:35 +08:00
|
|
|
|
- [业务快速索引](业务快速索引.md)：按关键词检索跨端代码入口与业务边界；先查根 AGENTS.md 短路由，按需读取命中行。
|
|
|
|
|
|
|
2026-09-04 16:44:08 +08:00
|
|
|
|
- [订单与客户](订单与客户/README.md)：登录认证、客户与企业、权限、头程订单和客户工作台。
|
|
|
|
|
|
- [入库测量与计费](入库测量与计费/README.md)：预约取货、到仓收货、箱码与箱唛、测量、尺寸策略、计价和入库费用。
|
|
|
|
|
|
- [国内货柜履约](国内货柜履约/README.md)：分柜与同柜、智能排柜、订舱、拖车、PDA 拣货、装柜、报关和国内出仓。
|
|
|
|
|
|
- [海外仓业务](海外仓业务/README.md)：船节点、海外接柜、入仓、库存、托盘、换标、转运、废弃、退货、排车、PDA 出库、派送、异常退回、客户回访、一件代发及海外本土业务。
|
|
|
|
|
|
- [船节点标准化契约](海外仓业务/船节点标准化契约.md)：统一船司原始状态、标准节点、预计/实际时间、异常事实、还柜停止规则和新增船司接入门禁。
|
|
|
|
|
|
- [财务管理](财务管理/README.md)：应收、应付、费用池、账单、收款、成本、核销、凭证以及国内外业务费用来源。
|
2026-09-16 12:02:41 +08:00
|
|
|
|
- [打印标签维护](打印标签维护/README.md)：箱唛、各类托盘标、HOLD、BOL 与其他单据的现状盘点、参考样张和逐项改版记录。
|
2026-07-31 10:43:30 +08:00
|
|
|
|
|
2026-09-04 16:44:08 +08:00
|
|
|
|
## 全流程公共契约
|
2026-07-31 10:43:30 +08:00
|
|
|
|
|
2026-09-18 16:48:32 +08:00
|
|
|
|
- [头程下单到尾程出库全流程操作手册](头程下单到尾程出库全流程操作手册.md)：从客户头程下单、国内收货测量、分柜装柜和国内出仓，贯通跨区尾程建单、海外接柜入仓、排车、PDA 拣货与尾程出库的角色、操作、状态、编号、门禁和异常处理。
|
|
|
|
|
|
- [头程下单到尾程出库现状流程全景清单](头程下单到尾程出库现状流程全景清单.md)：以 F01～F40 盘点现有主链、并行流程、条件分支和异常流，明确操作人、入口/出口状态、单据、编号、数据交接和评审项；应先评审本清单，再进入优化。
|
|
|
|
|
|
- [头程到尾程分阶段流程](头程到尾程分阶段流程/README.md)：F01～F40 六个阶段现状文档已全部完成，逐阶段记录操作、字段、状态、数据流、异常、完成判定和上下游交接条件，可按阶段评审并进入优化。
|
|
|
|
|
|
- [头程到尾程 AI 流程优化上下文包](头程到尾程AI流程优化上下文包.md)：统一 AI 分析所需的术语、流程变体、RACI、阶段合同、阻断分类、问题证据、指标口径、优化卡模板和完成定义。
|
|
|
|
|
|
- [头程下单到尾程出库流程易用性与数据流转优化方案](头程下单到尾程出库流程易用性与数据流转优化方案.md)：基于已走通主链梳理现状操作问题，提出统一进度、下一动作、操作回执、数据归属、跨区可观测、PDA 易用性、P0-P2 优先级和验收指标。
|
2026-08-20 09:10:34 +08:00
|
|
|
|
- [跨区域认证与服务通信契约](跨区域认证与服务通信契约.md)：统一账号、国内/海外 Token、双区域 API、JWKS、Outbox/Inbox 与服务身份边界。
|
2026-08-20 19:55:24 +08:00
|
|
|
|
- [双区域部署与 Nacos 规划](双区域部署与Nacos规划.md)：开发/测试同机共置、生产国内/海外独立控制面、Nacos、数据库及 Event Bridge 部署边界。
|
2026-08-20 09:10:34 +08:00
|
|
|
|
- [平台、客户层级与权限契约](平台客户层级与权限契约.md)：平台/客户两级产品语义、列表包含详情的只读权限和跨层同步要求。
|
2026-09-04 16:44:08 +08:00
|
|
|
|
- [统一订单主状态与操作契约](统一订单主状态与操作契约.md)：统一订单状态、操作编码、内部状态映射和可信履约回传边界。
|
|
|
|
|
|
- [Admin/Client 前端原型还原验收规则](Admin-Client前端原型还原验收规则.md)：页面操作承载方式、视觉还原、响应式检查和验收证据要求。
|
2026-09-14 17:06:52 +08:00
|
|
|
|
- [Admin 高密度界面规范](Admin高密度界面规范.md)：已确认订单样板的字号、间距、表格、描述表、弹框和彩色页签规则，以及国内仓、客户管理推广入口。
|
|
|
|
|
|
- [Admin 客户管理样式核对记录](Admin客户管理样式核对记录.md)：客户列表、海外仓阶梯费用及关联详情和弹框的样式与人工验收项。
|
2026-09-14 18:34:32 +08:00
|
|
|
|
- [Admin 国内仓样式核对记录](Admin国内仓样式核对记录.md)：7 个菜单、关联详情与浮层的范围、样式复核和验收证据。
|
|
|
|
|
|
- [Admin 货柜管理样式核对记录](Admin货柜管理样式核对记录.md)：订舱、拖车、送柜报关、清关提柜入口及共享组件边界。
|
2026-09-14 20:03:25 +08:00
|
|
|
|
- [Admin 海外仓样式核对记录](Admin海外仓样式核对记录.md)：海外仓 10 个菜单、独立详情、作业弹框和共享组件显式接入边界。
|
2026-09-04 16:44:08 +08:00
|
|
|
|
- [AI 工程执行与协作约束](AI工程执行与协作约束.md)：工作区、依赖、Git、部署、数据库、质量门禁和独立任务协作规则。
|
2026-08-11 18:06:30 +08:00
|
|
|
|
- [数据库中文注释维护规范](数据库注释维护规范.md)：数据库注释口径、职责、迁移流程、自动门禁与实值验收要求。
|
2026-09-19 17:02:08 +08:00
|
|
|
|
- [数据库版本迁移与 Jenkins 自动发布方案](数据库版本迁移与Jenkins自动发布方案.md)：两人团队自动迁移规划；统一工具入口、自动编号、开发/测试/生产执行分工、单服务迁移范围、漏写迁移检查、Flyway 校验、失败候选修订、发布证据保留、带数据升级演练及实施顺序。
|
2026-09-19 17:30:24 +08:00
|
|
|
|
- [数据库迁移操作手册](../baiyue-firstleg/deploy/sql/数据库迁移操作手册.md)：开发者和发布执行人日常使用说明；包含新建、检查、生成清单、测试执行、生产晋级、失败处理和维护规则。
|
2026-09-18 18:50:45 +08:00
|
|
|
|
- [生产服务监控告警与无停机发布方案](生产服务监控告警与无停机发布方案.md)：容器与外部可用性监控、部署期告警处理、自动恢复、发布通知及滚动/蓝绿发布演进方案。
|
2026-09-04 16:44:08 +08:00
|
|
|
|
- [测试环境 Jenkins 部署指南](测试环境Jenkins部署指南.md)：测试环境持续部署授权、Job 参数、健康检查与失败处理。
|
|
|
|
|
|
- [阿里云生产环境选型、压测与上线手册](阿里云生产环境选型压测与上线手册.md)：ECS/ALB、RDS MySQL、Redis、OSS、Nacos、RocketMQ、压测、高可用、监控、备份与上线清单。
|
2026-09-17 10:57:21 +08:00
|
|
|
|
- [阿里云 OSS 文件中心接入设计与评审](阿里云OSS文件中心接入设计与评审.md)：Admin、Client、国内/海外 PDA 文件接入 OSS 的区域拓扑、存储适配、权限、一致性、实施拆分、验收门禁和方案评审。
|
2026-09-04 16:44:08 +08:00
|
|
|
|
- [首页数据看板真实化与统计策略规划](首页数据看板真实化与统计策略规划.md)：首页指标、实时与缓存边界、统计口径和实施顺序。
|
|
|
|
|
|
- [墨家设备测量上传接口说明 V3](墨家设备测量上传接口说明-V3.md)：测量设备经 Gateway 上传箱码、尺寸、重量和图片的接口契约。
|
|
|
|
|
|
|
|
|
|
|
|
## 环境协作
|
|
|
|
|
|
|
|
|
|
|
|
- [开发环境独立任务协作登记](开发环境独立任务协作登记.md)：开发环境全流程总控与长期专项的稳定任务、职责及开发数据库/部署/HTTP 授权。
|
2026-09-09 12:50:36 +08:00
|
|
|
|
- [测试环境独立任务协作登记](独立任务协作登记.md)：登记已清空，任务由用户手动管理。
|
|
|
|
|
|
- [测试任务盘点与需求台账](测试任务盘点与需求台账.md)：历史任务快照、未闭环需求、提交线索和待核实证据，不作为当前调度依据。
|
2026-09-04 16:44:08 +08:00
|
|
|
|
|
|
|
|
|
|
## 参考资料
|
|
|
|
|
|
|
|
|
|
|
|
- `悦/`：产品原型、流程图、历史架构资料和调研数据，只作为需求参考，不直接定义当前范围。
|
|
|
|
|
|
- `superpowers/`：按日期和主题保留的具体功能设计与实施记录。
|
2026-07-31 10:43:30 +08:00
|
|
|
|
|
|
|
|
|
|
## 维护规则
|
|
|
|
|
|
|
2026-09-04 16:44:08 +08:00
|
|
|
|
- 新文档按业务域归档，不新增以开发批次编号命名的目录、文件、标题、任务或范围标签。
|
|
|
|
|
|
- 当前交付范围始终按端到端全流程理解；业务域目录只用于检索和职责归属，不用于排除上下游流程。
|
|
|
|
|
|
- 范围、字段或流程冲突时，按“当前对话确认 > 正式契约与确认记录 > 项目指引与代码 > 原型 > 历史记录”判断。
|
|
|
|
|
|
- 新增或修改业务能力时，同步更新业务域 README、跨端契约、接口、权限、SQL、测试和验收入口。
|
|
|
|
|
|
- 原型中出现的功能不自动成为有效实现；必须由正式契约、代码和验收证据共同确认。
|
