产品溯源平台产品系统Vibe Coding

这个项目是复合肥产品溯源系统，核心是给每一袋复合肥打上"一袋一码"的二维码，实现从工厂到田间的全链路数字化管理。

一、业务背景
1. 农资流通链条长（厂家→经销商→终端→农户），传统模式下企业无法掌握产品出库后的真实流向，渠道管控基本靠人工台账，效率低、易出错。
2. 化肥市场假冒伪劣、窜货乱价问题突出，农户买到假肥难以维权，企业品牌信誉受损，却缺乏有效的技术手段进行防伪与举证。
3. 国家对农资产品安全、可追溯的监管要求日益严格，数字化溯源成为农服企业转型升级的刚需。

二、行业场景
4. 面向农资生产企业的"数字化车间 + 流通管控 + 终端营销"综合场景：管理后台批量生成二维码并打印贴袋，车间摄像头自动捕捉包装码，码垛设备将包装码绑定垛码，操作员用 PDA 扫描垛码关联产品、订单、生产批次，最终农户扫码查看完整溯源信息。

三、解决的问题
5. 防伪验真：一袋一码，扫码即验证真伪，附质检报告、检验员信息，杜绝假冒产品。
6. 防窜货预警：记录每次扫码的 IP 与地区，与订单授权的经销商销售区域比对，异地扫码、频繁扫码自动触发预警，有效管控窜货乱价。
7. 全链路可追溯：生成时间线（原料入厂→生产加工→成品入库→出库发运→经销商签收→终端零售），责任可倒查。
8. 生产数字化：二维码批量生成、摄像头捕捉、码垛绑定全流程线上化，状态流转清晰（created→captured→activated→sold_out），替代人工登记。
9. 渠道与订单管理：订单、经销商及授权区域统一管理，并预留 ERP/MES 对接能力，支撑后续系统集成。
10. 终端赋能：农户扫码即得产品养分含量、执行标准、施肥建议与安全提示，提升

系统按职责划分为 7 个后端模块、前端用户端与管理后台，主要功能覆盖产品管理到终端扫码的全链路。说明如下：

一、主要模块
1. 产品管理（tf_product）：维护复合肥产品信息，含养分含量、执行标准、生产企业、施肥建议、安全提示。
2. 订单与经销商管理（tf_order）：管理订单与经销商（授权销售区域、联系人），是防窜货比对的依据。
3. 二维码管理（tf_qrcode）：二维码批次批量生成、导出，包装码一袋一码（含短码），状态机流转跟踪。
4. 生产环节（tf_factory）：生产线、摄像头设备注册，包装码捕捉记录，垛码创建与绑定。
5. 质检管理（tf_quality）：检验员、质检报告、报告编号，关联产品真伪与溯源展示。
6. 溯源查询（tf_tracing）：扫码查询溯源数据、扫码记录、统计汇总与防窜货预警。
7. 操作日志（tf_operation）：全系统关键操作留痕，支撑审计与责任倒查。
8. 前端与后台：用户端溯源页（扫码展示时间线、质检、施肥指导）；管理后台（二维码、产品、订单、生产监控、扫码统计）。

二、主要功能
9. 二维码生成打印：后台批量建批次、生成编码与图片包，打印贴袋。
10. 车间自动捕捉：摄像头扫描包装码并记录时间、设备、图片，重复扫码自动去重。
11. 码垛绑定：垛码绑定多袋包装码，便于批量管理。
12. PDA 信息填充：操作员扫描垛码，关联产品、订单、生产批次，激活二维码。
13. 扫码溯源：用户扫码查看产品、质检、流向、时间线、施肥建议与安全提示。
14. 防窜货预警：比对扫码地区与授权区域，监测异地、高频扫码并预警。
15. 统计看板：扫码总量、今日扫码、预警数、地区分布图表，支持筛选导出。
16. 扩展对接：预留 ERP 与 MES 对接字段，支撑后续系统集成。

一、技术栈
1. 前端：用 React 框架加类型脚本开发，打包采用 Vite，样式基于 Tailwind 并配合组件库，数据请求与图表用对应开源库。
2. 后端：用 Django 框架搭配 Python，接口走标准 REST 风格，开发阶段用轻量数据库，登录采用令牌鉴权。
3. 规范：内置一套界面设计规范，统一配色、字体与明暗主题。

二、架构
4. 前后端分离：网页端通过接口代理访问后端服务。
5. 后端按业务拆成七个独立模块，分别是产品、订单、二维码、生产、质检、溯源、操作日志。
6. 数据上产品、订单、二维码、扫码记录层层关联，托盘码一对多绑定包装码。
7. 状态机驱动：包装码从生成、打印、捕捉、绑垛到激活、出库分阶段流转，垛码同理，每步由特定操作触发并做校验。
8. 预留对接企业管理系统与生产系统的字段，便于后续扩展。

三、亮点
9. 一袋一码全程溯源：从原料入厂到终端零售的时间线可查，责任可倒查。
10. 防窜货预警：比对扫码地点与经销商授权区域，异地或高频扫码自动提醒。
11. 生产数字化与权限：摄像头捕捉、码垛绑定、手持设备填单替代人工台账；按管理员、操作员、质检员等角色控制访问。

四、难点
12. 高频扫码去重：车间多设备同时扫描需识别重复且不重复计数，保证状态一致。
13. 绑定与状态边界：垛容量限制、包装码须已捕捉、不可重复绑垛、未激活禁止溯源等约束较复杂。
14. 批量编码与升级：单批次上千个唯一码生成；开发库需平滑迁移到生产库并打通企业系统。