docs/三期/三期开发进度表.md

虫虫出海三期开发进度表

创建日期：2026-07-28
当前阶段：范围规划与大任务拆分
总体状态：待确认
规划依据：三期开发规划.md
维护方式：参考一期进度表，采用“总体大任务 → 详细任务 → 里程碑 → 未确认事项 → 开工准入 → 验收”的结构。

一、三期目标

三期承接二期到仓、实测、差异处理、处理单元编码和当前位置记录，完成智能排柜、订舱、拖车预约、PDA 拣货、柜封拍照、报关协同、港务信息查询和国内出仓闭环。

当前验收基线为“完成国内出仓，等待装船”。在 P3-Q13 最终确认前，不把装船发运纳入三期完成条件。

二、总体进度（大任务）

大任务 ID	大任务	范围	状态	进度	计划开始	计划完成	负责人	关键依赖/备注
T01	需求确认与原型	锁定阶段边界、流程依赖、排柜规则、设备、文件、报关和港务信息；完成页面原型	进行中	40%	2026-07-28	待排期	待分配	已盘点 docs/悦 三期相关原型；后台有较完整参考，客户端三期页面和 PDA 柜封拍照仍待补
T02	公共契约与数据模型	主/子状态、权限、事件、错误码、出仓单、柜次、任务、证据、报关和审计模型	待确认	0%	待排期	待排期	待分配	依赖 T01、二期输出契约
T03	出仓单与柜次	出仓单创建、列表、详情、订单拆分/拼柜、柜次和时间线	待确认	0%	待排期	待排期	待分配	依赖 T02、P3-Q2、P3-Q11
T04	智能排柜	排柜规则、系统建议、冲突、人工确认和追溯	待确认	0%	待排期	待排期	待分配	依赖 T03、P3-Q1、P3-Q2
T05	订舱与港务信息	订舱、变更异常、预计开船/到港信息、来源和更新时间	待确认	0%	待排期	待排期	待分配	依赖 T03、P3-Q9、P3-Q11
T06	拖车预约	服务商、车辆司机、预约时间窗、到离仓节点和异常	待确认	0%	待排期	待排期	待分配	依赖 T03、一期往来单位、P3-Q3
T07	PDA 拣货与复核	任务生成、领取、扫码、部分拣货、异常、弱网幂等和后台复核	待确认	0%	待排期	待排期	待分配	依赖 T04、二期处理单元/位置、P3-Q4、P3-Q5
T08	装柜及柜封证据	装柜节点、柜号、铅封号、PDA 拍照上传、照片清单和复核	待确认	0%	待排期	待排期	待分配	依赖 T07、文件能力、P3-Q6
T09	报关资料与回执	客户上传、后台审核补件、提交代理、回执上传和客户下载	待确认	0%	待排期	待排期	待分配	依赖文件能力、P3-Q7、P3-Q8、P3-Q12
T10	国内出仓门禁	必要条件校验、确认出仓、阻塞、通知、冲正和审计	待确认	0%	待排期	待排期	待分配	依赖 T05～T09、P3-Q10～P3-Q13
T11	客户端出仓协同	出仓进度、柜次、回执、预计开船/到港和变更时间线	待确认	0%	待排期	待排期	待分配	依赖 T05、T09、T10；客户可见范围
T12	联调测试与发布	跨端联调、自动化测试、PDA 真机、安全、弱网、迁移、验收和发布	待开始	0%	待排期	待排期	待分配	依赖 T02～T11 完成

三、详细任务表

详细任务按大任务逐项拆分。当前先建立任务骨架；每次拆分一个大任务，确认交付内容、优先级和依赖后再进入开发。

ID	大任务	端	模块	功能/交付内容	优先级	状态	进度	依赖	负责人	备注
P3-T01-00	T01	公共	需求确认与原型	完成需求确认表、页面清单和原型评审，锁定开工阻断项	P0	进行中	40%	-	待分配	已建立文档骨架并完成 docs/悦 原型初审，后续逐项确认和裁剪
P3-T02-00	T02	公共	公共契约与数据模型	待 T01 确认后拆分	P0	待确认	0%	P3-T01-00	待分配	下一层将拆状态、权限、数据模型、接口和审计
P3-T03-00	T03	后台/服务端	出仓单与柜次	待 T02 契约明确后拆分	P0	待确认	0%	P3-T02-00	待分配	-
P3-T04-00	T04	后台/服务端	智能排柜	待排柜规则确认后拆分	P0	待确认	0%	P3-T03-00、P3-Q1	待分配	-
P3-T05-00	T05	后台/服务端	订舱与港务信息	待港务范围和字段确认后拆分	P0	待确认	0%	P3-T03-00、P3-Q9	待分配	-
P3-T06-00	T06	后台/服务端	拖车预约	待流程依赖确认后拆分	P0	待确认	0%	P3-T03-00、P3-Q11	待分配	-
P3-T07-00	T07	PDA/后台/服务端	PDA 拣货与复核	待拣货输入和设备确认后拆分	P0	待确认	0%	P3-T04-00、P3-Q4、P3-Q5	待分配	已有静态 PDA 原型可复用
P3-T08-00	T08	PDA/后台/服务端	装柜及柜封证据	待照片清单确认后拆分	P0	待确认	0%	P3-T07-00、P3-Q6	待分配	需新增柜封拍照原型
P3-T09-00	T09	客户端/后台/服务端	报关资料与回执	待资料和回执规则确认后拆分	P0	待确认	0%	P3-Q7、P3-Q8、P3-Q12	待分配	-
P3-T10-00	T10	后台/服务端	国内出仓门禁	待流程、回执和终点确认后拆分	P0	待确认	0%	P3-T05-00～P3-T09-00	待分配	高风险状态操作
P3-T11-00	T11	客户端/服务端	客户端出仓协同	待客户可见字段确认后拆分	P0	待确认	0%	P3-T05-00、P3-T09-00、P3-T10-00	待分配	-
P3-T12-00	T12	公共	联调测试与发布	待各模块拆分完成后细化测试与发布任务	P0	待开始	0%	P3-T02-00～P3-T11-00	待分配	-
P3-T01-PROTO-01	T01	公共	原型盘点	盘点流程图、后台、企业客户端和 PDA 中与三期相关的页面及交互	P0	已完成	100%	-	待分配	2026-07-28 已完成首次盘点，来源为 docs/悦
P3-T03-PROTO-01	T03	后台	出仓单原型核验	对照通用 WMS 出库单、货柜和装柜清单，确定三期出仓单可复用字段与需重做部分	P0	进行中	50%	P3-T01-PROTO-01、P3-Q11	待分配	通用“出库”不能直接等同三期“国内出仓”
P3-T04-PROTO-01	T04	后台	智能排柜原型核验	映射智能装柜的线路页签、筛选、智能锁定、订单分柜、拖放调整和集装箱详情	P0	已完成	100%	P3-T01-PROTO-01	待分配	原型叫“智能装柜”，与“智能排柜”的业务边界待 P3-Q1 确认
P3-T05-PROTO-01	T05	后台	订舱港务原型核验	映射订舱列表、新增/详情、放舱、船名航次、港口和 ETD/ATD/ETA/ATA 字段	P0	已完成	100%	P3-T01-PROTO-01	待分配	港务信息是否独立模块仍待 P3-Q9 确认
P3-T06-PROTO-01	T06	后台	拖车原型核验	映射拖车列表、新增表单、运输公司、司机、车头号、装箱日期、费用和附件	P0	已完成	100%	P3-T01-PROTO-01	待分配	预约时间窗和到离仓节点仍需按三期流程补充
P3-T07-PROTO-01	T07	后台/PDA	拣货原型核验	对照通用 WMS 出库拣货和现有 PDA 集装箱拣货，锁定可复用交互与真实接口缺口	P0	已完成	100%	P3-T01-PROTO-01	待分配	PDA 静态交互已有，任务、鉴权、持久化和弱网仍待开发
P3-T08-PROTO-01	T08	后台	装柜证据原型核验	映射货柜列表、预装清单、装柜清单、柜号、单证、船期和装柜明细	P0	已完成	100%	P3-T01-PROTO-01	待分配	后台参考较完整，但现场拍照上传原型缺失
P3-T08-PROTO-02	T08	PDA	柜封拍照原型	新增柜次确认、货柜/铅封拍照、照片类型、预览、重试和提交页面原型	P0	待开始	0%	P3-Q4、P3-Q6	待分配	docs/悦 暂无对应原型
P3-T09-PROTO-01	T09	后台	报关单证原型核验	映射报关单列表、单证管理、报关/清关/放行资料及装柜清单附件	P0	已完成	100%	P3-T01-PROTO-01	待分配	客户上传和回执下载页面仍需新建
P3-T10-PROTO-01	T10	后台	出仓门禁原型	设计统一门禁检查、阻塞原因、确认出仓和冲正页面	P0	进行中	30%	P3-Q10～P3-Q13	待分配	现有原型只有分散状态和放行字段，无统一出仓门禁页
P3-T11-PROTO-01	T11	客户端	客户端三期原型	新增出仓进度、报关资料上传/补件、回执下载和港务/船期页面原型	P0	待开始	0%	P3-Q7～P3-Q9、P3-Q12、P3-Q13	待分配	现有客户端原型未覆盖三期专用页面

四、原型对照与开发影响

大任务	docs/悦 现有原型	覆盖判断	开发处理
T03 出仓单与柜次	通用 WMS 出库单、货柜列表、装柜清单	部分参考	保留列表、状态和明细交互，按国内出仓业务重新定义对象和门禁
T04 智能排柜	入库单列表中的“智能装柜”弹窗	已有参考	复用线路、筛选、锁定、分柜和拖放交互，按 P3-Q1 裁剪规则
T05 订舱与港务信息	订舱列表、新增/详情、放舱、货柜船期字段	已有参考	复用订舱字段和页面结构，确认港务信息范围及来源后裁剪
T06 拖车预约	拖车列表、新增拖车	已有参考	复用车辆司机和费用字段，补预约时间窗、到仓及离仓节点
T07 PDA 拣货与复核	通用 WMS 出库、PDA 集装箱拣货	已有参考	保留 PDA 交互，重做真实任务、权限、幂等、弱网和后台复核
T08 装柜及柜封证据	货柜列表、预装清单、装柜清单	部分参考	后台页面裁剪复用；PDA 货柜/铅封拍照页面新建
T09 报关资料与回执	报关单列表、单证管理、装柜清单附件	部分参考	后台裁剪复用；客户上传、补件和回执下载页面新建
T10 国内出仓门禁	分散的出库状态、国内报关成功和放行资料	部分参考	新建统一门禁检查和确认出仓页面，避免直接照搬“已放行”规则
T11 客户端出仓协同	头程下单客户端只有船期字段和出仓时间展示	覆盖不足	新建三期客户端出仓进度、报关和港务信息页面

货代SaaS平台原型.html 是全量平台参考原型，其中海外仓、完整 WMS、费用和清关能力不自动纳入三期；所有复用项仍需经过三期范围裁剪。

五、建议拆分模板

每个大任务按照同一顺序拆成可开发、可验收的小任务：

1. RULE：业务规则、状态、权限和异常。
2. DATA：数据表、字段、快照、版本和审计。
3. API：接口、鉴权、幂等、并发和错误码。
4. ADM / CLI / PDA：各端页面与交互。
5. TEST：单元、接口、端到端、权限和边界测试。
6. ACCEPT：业务验收、证据和遗留问题。

例如 T04 智能排柜后续可使用 P3-T04-RULE-01、P3-T04-DATA-01、P3-T04-API-01、P3-T04-ADM-01、P3-T04-TEST-01 编号。

六、建议里程碑

里程碑	交付目标	状态	计划完成
P3-M0 需求与原型锁定	阶段边界、流程、规则、设备、文件和页面原型确认	待确认	待排期
P3-M1 公共契约	二三期输入、状态、权限、数据模型和接口契约稳定	待排期	待排期
P3-M2 出仓编排	出仓单、排柜、订舱、港务和拖车可用	待排期	待排期
P3-M3 仓内出仓	PDA 拣货、复核、装柜和柜封证据闭环	待排期	待排期
P3-M4 报关协同	客户资料、后台审核、提交代理、回执上传下载闭环	待排期	待排期
P3-M5 国内出仓	门禁满足后可确认出仓并进入当前约定终点	待排期	待排期
P3-M6 三期上线	联调、真机、安全、测试、验收和生产发布完成	待排期	待排期

七、未确认事项（需求确认进度）

当前共 13 项待确认事项，其中 7 项为开工阻断、5 项为模块阻断、1 项为非阻断。完整建议、负责人、计划确认日期和最终结论统一维护在 三期需求确认表；开工阻断项未确认前，受影响的大任务保持“待确认”。

编号	阻断级别	待确认事项	状态	主要影响
P3-Q1	开工阻断	智能排柜的硬约束和软偏好	待确认	T04 智能排柜、T07 拣货任务
P3-Q2	开工阻断	是否支持拼柜、一单多柜和拆批出仓	待确认	T03 出仓单与柜次、T04 智能排柜
P3-Q3	非阻断	“预约托车”是否统一为“预约拖车”	待确认	T06 拖车预约、页面与接口文案
P3-Q4	模块阻断	PDA 型号、系统和扫描头接入方式	待确认	T07 PDA 拣货、T08 柜封拍照、真机验收
P3-Q5	开工阻断	拣货是否依赖实时库存和库位可用量	待确认	T02 二三期契约、T07 PDA 拣货
P3-Q6	模块阻断	柜封照片必传类型、角度、数量和留存期限	待确认	T08 装柜证据、T10 出仓门禁
P3-Q7	模块阻断	报关资料清单是否按国家、渠道和货物类型变化	待确认	T09 报关资料、文件版本
P3-Q8	模块阻断	报关代理接收资料和返回回执的方式	待确认	T09 报关协同、回执上传
P3-Q9	开工阻断	港务信息的业务含义、字段和维护方	待确认	T05 订舱港务、T11 客户端展示
P3-Q10	模块阻断	确认出仓后的错误处理和冲正方式	待确认	T10 出仓门禁、权限和审计
P3-Q11	开工阻断	九个动作的强制前置和并行关系	待确认	T03～T10 全流程和状态机
P3-Q12	开工阻断	报关回执类型及海关放行是否为出仓硬门禁	待确认	T09 报关状态、T10 出仓门禁
P3-Q13	开工阻断	三期终点是等待装船还是装船发运	待确认	阶段边界、状态、里程碑和验收

八、开工准入清单

产品和业务完成需求确认后，先进入“开工准备”；以下准入项全部通过后，三期才能从范围规划正式切换到全面开发。

准入编号	准入条件	当前状态	责任方	完成证据
P3-GO-01	P3-Q1～P3-Q13 均形成明确结论，7 项开工阻断全部解除	进行中	产品、业务	三期需求确认表.md 状态均为已确认并填写最终结论
P3-GO-02	确认结论已同步开发规划、进度表、页面清单和验收范围	待开始	产品、项目负责人	四份文档口径一致，无未标注的候选规则
P3-GO-03	关键缺失原型已补齐并评审，包括出仓门禁、客户端三期页面和 PDA 柜封拍照	进行中	产品、设计、业务	页面清单中的关键页面达到已确认状态
P3-GO-04	T02 公共契约完成，二期输入、状态机、权限、数据模型、接口、错误码和审计口径稳定	待开始	前后端、架构/技术负责人	契约评审记录及稳定的数据/API 定义
P3-GO-05	T03～T12 已拆成 RULE、DATA、API、ADM/CLI/PDA、TEST、ACCEPT 任务，并填写负责人和计划	待开始	项目负责人、研发、测试	详细任务可独立开发、联调和验收
P3-GO-06	产品、业务、研发和测试完成开工评审，确认范围、依赖、风险和首批任务	待开始	项目负责人	开工评审纪要及明确的 GO 结论

准入口径：P3-GO-01 完成后可以进入 T02 契约设计和详细任务拆分；P3-GO-01～P3-GO-06 全部通过后，才进入全面功能开发。

九、状态维护规则

• 状态统一使用：待确认、待开始、进行中、联调中、测试中、已完成、已阻塞。
• 进度填写 0%～100%；只有开发、测试和业务验收均完成后才能填写 100%。
• 开始开发时填写负责人、计划开始和计划完成日期。
• 出现阻塞时在备注中填写阻塞原因、责任人和预计解除时间。
• 大任务进度应由其详细任务加权汇总；当前骨架阶段先人工维护，拆分完成后再确定权重。

十、下一步拆分顺序

1. 先处理 T01，逐项确认 P3-Q1～P3-Q13，并补齐关键页面原型。
2. 拆 T02 公共契约与数据模型，固定二期输入和三期核心对象。
3. 按业务顺序拆 T03～T10，每个模块补齐规则、数据、接口、页面和测试。
4. 拆 T11 客户端可视范围和交互。
5. 最后拆 T12 联调、真机、验收和发布任务。