docs/三期/三期需求确认表.md

虫虫出海三期需求确认表

创建日期：2026-07-28
当前状态：确认中
用途：记录会影响三期范围、流程、数据模型、页面和验收的产品决策。

一、维护规则

• 状态统一使用：待确认、确认中、已确认、已取消。
• 阻断级别统一使用：开工阻断、模块阻断、非阻断。
• 结论确认后同步更新 三期开发规划.md、三期开发进度表.md 和受影响的页面原型。
• 未确认事项只能作为候选方案，不能直接写成固定开发或验收承诺。

二、确认事项

编号	决策/问题	当前建议	阻断级别	状态	负责人	计划确认	最终结论	影响模块
P3-Q1	智能排柜需考虑哪些硬约束和软偏好？	业务提供可执行规则表，建议可解释并由人工确认	开工阻断	待确认	待分配	待排期	-	智能排柜、拣货任务
P3-Q2	是否存在拼柜、一单多柜和拆批出仓？	通过订单-柜次关系预留能力，页面按高频场景逐步开放	开工阻断	待确认	待分配	待排期	-	订单、柜次、排柜、拣货
P3-Q3	原型“预约托车”是否统一为“预约拖车”？	建议使用行业常用的“拖车”，同时确认业务实际含义	非阻断	待确认	待分配	待排期	-	页面文案、接口字段说明
P3-Q4	目标 PDA 型号、系统和扫描头接入方式是什么？	保持设备适配层，不绑定厂商 SDK	模块阻断	确认中	用户当前对话确认	2026-08-10	Android 广播接入方式已确认并已接入：Action=android.intent.action.SCANRESULT、字符串 Extra=value；具体 PDA 型号、Android 版本、打包发布流程和目标设备真机验收仍待确认	PDA 拣货、真机验收
P3-Q5	拣货是否依赖实时库存和库位可用量？	默认使用二期处理单元和当前位置；如需完整库存，单独评估 WMS 范围	开工阻断	待确认	待分配	待排期	-	二三期契约、拣货、库存边界
P3-Q6	柜封照片有哪些必传类型、数量、采集方式、处理规则和留存期限？	已确认规则直接进入契约；权限和留存继续确认	模块阻断	确认中	用户当前对话确认	2026-08-10	五类证据各至少 1 张有效照片，可同类型多张追加；PDA 只能现场拍照，Admin 可人工上传；错图不硬删除，按原因、操作人、时间作废；带锁码照还必须填写锁码文本。Admin 上传角色、客户可见范围和留存期限仍待确认	装柜、PDA 拍照、Admin 上传、文件存储、订单后程门禁
P3-Q7	报关资料清单是否按国家、渠道和货物类型变化？	清单配置化，并保存业务使用的清单版本	模块阻断	待确认	待分配	待排期	-	客户资料、报关审核、文件版本
P3-Q8	报关代理如何接收资料并返回回执？	首版系统内整理、线下提交，正式接口后续评估	模块阻断	待确认	待分配	待排期	-	报关协同、回执上传
P3-Q9	“港务信息”指船期、港口作业状态还是两者，包含哪些字段，由谁维护？	先确认词义和字段；首版平台人工维护并审计	开工阻断	待确认	待分配	待排期	-	订舱、港务查询、客户展示
P3-Q10	订单进入“装柜完成”后发现错误如何处理？	不直接回退状态，使用授权冲正和反向审计事件	模块阻断	待确认	待分配	待排期	-	装柜完成门禁、权限、审计
P3-Q11	九个动作中哪些是强制前置，哪些允许并行？	已确认 PDA 子流程直接进入契约，其余跨模块依赖继续确认	开工阻断	确认中	用户当前对话确认	2026-08-10	PDA 进入任务即标记“拣货中”；扫描先写入绑定人员+任务+柜次的本地草稿，仅点击提交时批量写后端；部分拣货/跳拣允许，但未完成项必须填写异常原因并挂起，不能完成任务或进入 LOADED。一柜多人并行、退出/换班释放、批量提交超时/错误交互、最终 LOADED 触发人及订舱/拖车/报关硬门禁仍待确认	全流程、状态机、PDA、页面进度
P3-Q12	报关回执包含哪些类型，海关放行是否为装柜完成硬门禁？	当前不默认以放行为门禁，业务明确各类回执含义	开工阻断	待确认	待分配	待排期	-	报关状态、装柜完成门禁、客户回执
P3-Q13	三期终点以什么状态为准？	国内系统以能掌控的最后环节为终点	开工阻断	已确认	用户当前对话确认	2026-08-08	三期终点为 LOADED/装柜完成；DELIVERED/派送完成只能在到达海外仓后由海外仓可信回传推进，不属于国内三期操作和验收范围	阶段边界、状态、里程碑、验收、海外仓回传

2.1 PDA 已确认子决策

编号	确认日期	已确认结论	实现/验收含义
P3-PDA-D01	2026-08-09	PDA 正式作业必须联网；断网时不能开始正式拣货、提交、完成任务或推进 LOADED	不建设离线业务提交队列；网络恢复后由员工刷新并重试
P3-PDA-D02	2026-08-09	进入任务即标记“拣货中”	进入动作需调用后端开始接口，不能只改本地页面状态
P3-PDA-D03	2026-08-09	扫描结果先保存在本地草稿，点击“提交”时才批量写入后端，不逐码提交	批量请求需携带本次草稿全部明细；提交成功后再清理草稿
P3-PDA-D04	2026-08-09	未提交草稿需持久化，并绑定作业员、任务和柜次；其他账号不能继承	应用退出、前后台切换或设备重启后仍可恢复；成功提交或明确放弃后清理
P3-PDA-D05	2026-08-09	允许部分拣货和跳拣；每个未完成项必须填写异常原因	存在未解决异常时任务进入异常挂起/待处理，不能完成或推进 LOADED
P3-PDA-D06	2026-08-09	使用轻量、对员工不可见的幂等与版本控制	重复提交返回原结果；版本冲突提示员工刷新后重试，不静默覆盖
P3-PDA-D07	2026-08-09	PDA 只能现场拍照；Admin 可人工上传	PDA 不提供相册选择；Admin 上传必须受权限、归属和审计约束
P3-PDA-D08	2026-08-09	同类型证据允许多张并采用追加记录；错误/重复照片不硬删除，只作废	每条照片独立保存；作废记录原因、操作人和时间，历史可追溯
P3-PDA-D09	2026-08-09	空仓、半仓、满仓、锁仓、带锁码照五类证据各至少 1 张有效且未作废的照片，可多张；带锁码照同时要求锁码文本	服务端完整性门禁按“每类至少一张有效记录”校验，不能按单槽位替换模型实现

三、已确认架构决策

编号	确认日期	最终结论	影响
P3-D1	2026-08-08	三期不新建独立出仓单，现有订单列表承载全部主状态；柜次、订舱、拖车、拣货、证据和报关作为订单关联子对象	取消出仓单页面和数据模型规划，改为增强现有订单列表/详情及服务端统一编排

四、建议确认顺序

1. 先确认 P3-Q13、P3-Q11，锁定阶段终点和流程依赖。
2. 再确认 P3-Q1、P3-Q2、P3-Q5，锁定排柜、柜次和拣货输入。
3. 然后确认 P3-Q12、P3-Q7、P3-Q8，锁定报关和装柜完成门禁。
4. 最后确认设备、照片、港务信息、冲正和文案事项。

五、产品与业务确认会议

5.1 参会角色

• 产品负责人：逐项说明问题、候选方案和影响范围，维护最终结论。
• 业务负责人：确认流程、规则、例外、责任边界和客户可见范围。
• 仓库/运营代表：确认现场作业、PDA、照片、拖车、装柜和冲正可执行性。
• 研发与测试代表：识别数据、接口、设备、权限和验收风险，不代替业务作决定。

5.2 会议输入

• 本确认表中的 P3-Q1～P3-Q13。
• 三期开发规划.md 的流程、状态、里程碑和任务骨架。
• 三期页面与原型清单.md 中已有参考原型和待补页面。
• 二期输出契约、目标 PDA 信息、文件存储能力及报关/港务协作现状。

5.3 每项确认要求

1. 必须填写负责人、计划确认日期和可执行的最终结论，不能只记录“按建议处理”。
2. 最终结论需明确正常流程、异常/冲正、权限责任和验收口径。
3. 暂缓事项必须写明本期是否排除、临时方案、影响模块和再次确认日期。
4. 开工阻断项未解除时，不得将受影响模块标记为可开发。
5. 会议结束后，将结论同步到开发规划、开发进度表、页面原型和后续验收任务。

5.4 会议输出

• 13 项确认事项的状态和最终结论。
• 需要新增或调整的原型清单。
• 三期范围内/范围外清单及跨期依赖。
• 仍有风险的事项、责任人和完成日期。
• 是否允许进入 T02 契约设计与任务拆分的明确结论。