骨架
① 本地大模型(数据不出境,政务/物流合规)
② 不直接替代人工裁决(辅助复核 = 始终 human-in-the-loop)
③ 三系统架构:工控系统 / BS 后台 / 同物比对分析服务,独立部署
| 模块 | 状态 | 说明 |
|---|---|---|
| §1 业务主流程与案件管理 | ✅ 一期全做 | 案件创建 / 编号 / 状态机 / 图片上传 / 报关信息 / 队列 |
| §2 同物比对与证据帧 | ⚠️ 一期做核心 | BS 侧全做;算法侧做图片比对(视频/关键帧/证据帧 暂缓) |
| §3 规则库与品牌库 | ✅ 一期全做 | 规则 / 品牌 / 别名 / 关键词 / 异常筛查引擎 |
| §4 本地大模型 | ❌ 不在一期 | 文档明确"不在开发内容",二期专项 |
| §5 人工复核 / 日志 / 报告 | ❌ 不在一期 | 文档明确"一期暂不考虑",二期专项 |
| §6 部署与联调 | ✅ 一期全做 | Docker 部署 / 联调 / 演示样本 / 培训 |
一期真正交付的 = 案件管理 + 同物比对(BS + 算法)+ 规则品牌 + 部署联调。接口和数据结构为二期全部预留,避免补坑。
一期物流开箱检测系统(8 周 × 8 工作包 · ≈93.5 人天)
│
├── W1 基础平台搭建 ······························· 10.5 人天
│ ├── W1.1 数据库 schema 设计 + 评审
│ ├── W1.2 Docker Compose 骨架
│ ├── W1.3 案件中心骨架(CRUD + 编号 + 状态机)
│ ├── W1.4 接口规范定稿(OpenAPI 3.0)
│ └── W1.5 OpenCLIP PoC(相似度可行性)
│
├── W2 案件中心完成 ······························· 18 人天
│ ├── W2.1 案件列表 + 详情 + 队列
│ ├── W2.2 图片上传 + MinIO + 90 天清理
│ ├── W2.3 报关信息录入(19 字段)
│ ├── W2.4 状态流转接口
│ └── W2.5 WMS 推送接入
│
├── W3 规则品牌基础 ······························· 16 人天
│ ├── W3.1 规则 CRUD + JSON 条件引擎
│ ├── W3.2 规则 Excel 导入 + 模板
│ ├── W3.3 品牌名录 + 别名映射
│ ├── W3.4 关键词库 + OCR 匹配
│ └── W3.5 参考图库 CRUD + 分类 + 版本
│
├── W4 同物比对 v1 ································ 18 人天
│ ├── W4.1 资料接收 + 工控对接(gRPC stream)
│ ├── W4.2 图像预处理(OpenCV + pHash)
│ ├── W4.3 OpenCLIP 特征提取 + FAISS 检索
│ ├── W4.4 同物置信度 + 7 类风险标签
│ └── W4.5 后台比对结果展示(只读 UI)
│
├── W5 异常筛查引擎 + 集成 ························· 15 人天
│ ├── W5.1 异常筛查引擎(规则求值 + 标签)
│ ├── W5.2 异常 → 状态联动
│ ├── W5.3 异常日统计
│ ├── W5.4 BS ↔ 算法服务内调(gRPC)
│ └── W5.5 全流程联调
│
├── W6 优化与压测 ································ 10 人天
│ ├── W6.1 性能压测(100 并发 / 1k 案件)
│ ├── W6.2 慢 SQL + 索引调优
│ ├── W6.3 前端体验优化
│ ├── W6.4 安全自查
│ └── W6.5 90 天清理实测
│
├── W7 部署 + 文档 ································ 8 人天
│ ├── W7.1 部署脚本 + 备份演练
│ ├── W7.2 演示样本(5 类异常)
│ ├── W7.3 用户操作手册
│ ├── W7.4 管理员手册 + 接口文档
│ └── W7.5 部署文档 + FAQ
│
└── W8 联调 + 培训 + 交付 ··························· 12 人天
├── W8.1 现场联调(工控+海关+WMS 三方)
├── W8.2 异常场景测试 + Bug 修复
├── W8.3 培训(4 类角色)
├── W8.4 演示流程彩排 + 录屏
└── W8.5 一期项目总结 + 验收交付
| 角色 | 人数 | 主要负责 | 关键产出 |
|---|---|---|---|
| 前端 A | 1 | 案件中心 / 队列 / 详情(§1) | 案件相关 5 个页面 |
| 前端 B | 1 | 规则 / 品牌 / 参考图库 / 比对展示(§2 §3) | 规则 + 比对 6 个页面 |
| 后端 A | 1 | 案件 / 报关 / 文件 / 接口 / 部署(§1 + §6) | 案件中心全链路 + 部署 |
| 后端 B | 1 | 规则引擎 / 品牌 / 异常筛查(§3) | 引擎 + 7 类异常标签 |
| 后端 C | 1 | 同物比对 BS 侧 / 算法编排(§2) | 资料接收 + 比对编排 |
| 算法 A | 1 | OpenCLIP / 预处理 / 置信度(§2) | 算法服务 v1 |
| 运维 A | 1 | Docker / Nginx / 备份 / 部署 / 培训 | 部署包 + 培训支持 |
| 售前/培训 | 0.5(兼职) | 文档 / 培训 / 演示样本(§6) | 5 类样本 + 培训交付 |
| 合计 | 7.5 | ≈ 93.5 人天(8 周 × 5 工作日 × 投入度) | |
前 3 项 = 阻塞启动,缺一不可。
| # | 决策项 | 默认假设 | 截止 | 阻塞 |
|---|---|---|---|---|
| 1 | 海关接口规格 | HTTP 推送,19 字段 | W1 周三 | §1.3.4 全部 |
| 2 | 工控接口规格 | gRPC stream,12 字段 | W1 周三 | §2.5.1 全部 |
| 3 | WMS 接口字段 | HTTP POST 箱件码 | W1 周三 | §1.3.1 双入口 |
| 4 | 同物比对算法 | OpenCLIP 自研 | W1 周五(看 PoC) | §2.7.6 全部 |
| 5 | 参考图库来源 | 客户提供种子 | W3 周五 | §2.7.5 |
| 6 | 相似度阈值 | 0.75 | W1 周五 | §2.7.7 公式 |
| 7 | 异常自动进复核规则 | 任一异常即复核 | W5 周三 | §3.3.6 引擎 |
| 8 | 案件编号规则 | YYYYMMDD-{箱号6位}-{序号} | W1 周五 | §1.3.2 |
| 9 | 一期范围锁版 | 文档"暂不考虑"项全部二期 | W1 周五 | 全局范围 |
| 10 | OCR/品牌识别结果来源 | 工控自带 | W1 周五 | §1.3.3 + §2.5.1 |
| 频率 | 事项 | 参与人 | 时长 |
|---|---|---|---|
| 每日 | 早站会(昨天 / 今天 / 卡点) | 全员 | 10 min |
| 每周一 | 周计划 review + 周报 | 全员 + Rus | 30 min |
| 每周三 | 客户进度同步会 | Rus + 后端 A + 客户 | 30 min |
| 每周五 | 演示 + 自测报告 | 全员 | 60 min |
| 每两周 | 里程碑评审(M1/M2/M3/M4) | 全员 + Rus + 客户 | 90 min |
| 按需 | 接口联调会(工控/海关/WMS) | 后端 A + 客户技术 | 60 min |
┌─────────────────────────────────────────────────────────────┐
│ Nginx(反向代理 + 静态资源 + HTTPS) │
│ :80 / :443 │
└──────────────┬──────────────────────────────────────────────┘
│
┌───────────┼─────────────┬───────────────────┐
▼ ▼ ▼ ▼
┌────────┐ ┌────────┐ ┌──────────────┐ ┌──────────────┐
│ 后台 │ │ 算法 │ │ PostgreSQL │ │ MinIO │
│ Spring │ │ FastAPI│ │ :5432 │ │ :9000/:9001 │
│ :8080 │ │ :8000 │ │ 业务数据 │ │ 图片+视频 │
└───┬────┘ └───┬────┘ └──────────────┘ └──────────────┘
│ gRPC │ 读
└──────────┤
▼
┌──────────────────┐
│ FAISS Index │
│ 特征向量落盘 │
└──────────────────┘
▲
│ HTTP / gRPC
│
┌───────────┼───────────┬──────────────┐
│ │ │ │
┌──┴──┐ ┌────┴───┐ ┌────┴────┐ ┌─────┴─────┐
│ WMS │ │ 现场 │ │ 海关 │ │ 人工后台 │
│ 推送 │ │ 工控 │ │ 接口 │ │ 录入/审核 │
└─────┘ └────────┘ └─────────┘ └───────────┘