样品申请与追踪(Sample Request & Tracking)方案说明
版本:P24 · v1.0 适用端:Web(PCB之家 PC + 移动端共用同一套数据) 定位:买家在正式批量下单前申请打样,供应商接单后按节点推进,双方在同一张「样品任务」里追踪进度、确认结果、记录瑕疵。本方案是设计稿与接口约定,落地前需按平台数据库规范重新评审字段。
1. 业务目标
- 让买家把「先打样再批量」的流程留在站内,减少线下微信对账。
- 让供应商的打样产能、样品配额、交期承诺可被记录和复盘。
- 为后续批量订单提供可引用的样品基线(版本、工艺参数、验收结论)。
2. 角色与权限
| 角色 | 可做 | 不可做 |
|---|---|---|
| 买家(需求方) | 发起样品申请、上传资料、确认收货、提交瑕疵记录、评价 | 修改供应商报价、修改流程日志 |
| 供应商(接单方) | 接单/拒单、报价、上报节点、上传出货凭证、填写工艺参数 | 修改买家提交的原始需求 |
| 运营(平台) | 查看全量样品任务、处理争议、冻结异常配额 | 代替买卖双方确认验收结论 |
说明:平台仅提供内容管理式增删改查,不做审核流引擎;本方案中的「运营处理」指运营通过管理后台读取记录后线下沟通,不承诺站内审批自动化。
3. 主流程
- 买家在商品/供应商详情页点击「申请打样」,填写板层、尺寸、数量、工艺要求、期望交期与收件信息。
- 系统按供应商
sample_quota校验当周剩余额度,额度不足则提示等待或改约。 - 供应商在「样品任务」中接单并给出样品单价、打样周期、可出货日期。
- 双方确认后任务进入「打样中」,供应商按节点上报:工程确认 → 投料 → 成型 → 测试 → 出货。
- 买家收货后 3 个工作日内确认结果:通过 / 有条件通过 / 不通过。
- 不通过时买家提交瑕疵记录(缺陷类型、位置、图片、期望处理),供应商响应返工或退款方案。
- 任务关闭后生成样品基线摘要,可在批量询价时引用。
4. 状态机
| 状态 | 含义 | 可流转到 |
|---|---|---|
| draft | 买家编辑中 | submitted |
| submitted | 已提交,等待供应商响应 | accepted / rejected / cancelled |
| accepted | 供应商已接单,待买家确认价格与交期 | in_production / cancelled |
| in_production | 打样中,按节点上报 | shipped / cancelled |
| shipped | 已出货,运输中 | received |
| received | 买家已收货,待验收 | passed / conditional / failed |
| passed | 验收通过 | closed |
| conditional | 有条件通过(需小批量验证) | closed |
| failed | 验收不通过 | rework / refunded / closed |
| rework | 返工中 | shipped |
| refunded | 已退款 | closed |
| cancelled | 已取消 | closed |
| closed | 已关闭 | — |
约束:
- 状态只能沿上表前进,禁止跳级回退;返工是唯一允许的「回到 shipped」路径。
- 所有状态变更写入
sample_flow_log,含操作人角色、时间、备注。 - 超时规则:供应商 24 小时未响应,任务自动提醒;买家收货后超过 7 天未验收,按「有条件通过」入档并标注超时确认(仅记录,不代替买家判断)。
5. 关键字段
- 样品任务:编号、关联商品/供应商、板层、板材、板厚、铜厚、尺寸、数量、表面处理、阻抗要求、交期、样品单价、收件信息、当前状态、创建/更新时间。
- 流程日志:任务编号、节点、操作角色、操作人、时间、备注、附件地址。
- 样品配额:供应商、周期(按周)、总额度、已用、剩余、冻结数量、重置时间。
- 瑕疵记录:任务编号、缺陷类型、位置描述、严重级别、图片地址、期望处理、供应商响应、处理结果。
6. 展示与合规
- 样品单价、交期、良率等一律标注「以供应商确认为准」,不使用「保证」「最快」「零缺陷」等表述。
- 供应商产能与配额数据仅作排产参考,页面需注明「参考值,实际以工厂确认为准」。
- 瑕疵记录涉及图片时,提示用户避免上传含个人信息的文件;附件存储依赖平台对象存储能力,未开通时仅记录文件名与说明。
7. 与现有能力的关系
- 数据写入沿用站点既有 Supabase 表规范,新表需单独评审后由平台工具执行迁移。
- 附件上传递增依赖对象存储,未开通前只保留文字描述与外部链接字段。
- 通知渠道(短信/邮件/站内推送)当前不具备,方案中的「提醒」以站内列表标记实现,不做外部投递承诺。
8. 验收清单
- 买家可从商品页与供应商页进入申请,表单必填项校验完整。
- 供应商接单后节点按顺序可上报,乱序操作被拒绝。
- 配额扣减与释放准确,取消任务后额度回到可用。
- 验收不通过时必须填写瑕疵记录,否则不可提交。
- 关闭后的任务在列表中可查,且不可再改状态。

