# 样品申请与追踪（Sample Request & Tracking）方案说明

版本：P24 · v1.0
适用端：Web（PCB之家 PC + 移动端共用同一套数据）
定位：买家在正式批量下单前申请打样，供应商接单后按节点推进，双方在同一张「样品任务」里追踪进度、确认结果、记录瑕疵。本方案是设计稿与接口约定，落地前需按平台数据库规范重新评审字段。

## 1. 业务目标

1. 让买家把「先打样再批量」的流程留在站内，减少线下微信对账。
2. 让供应商的打样产能、样品配额、交期承诺可被记录和复盘。
3. 为后续批量订单提供可引用的样品基线（版本、工艺参数、验收结论）。

## 2. 角色与权限

| 角色 | 可做 | 不可做 |
| --- | --- | --- |
| 买家（需求方） | 发起样品申请、上传资料、确认收货、提交瑕疵记录、评价 | 修改供应商报价、修改流程日志 |
| 供应商（接单方） | 接单/拒单、报价、上报节点、上传出货凭证、填写工艺参数 | 修改买家提交的原始需求 |
| 运营（平台） | 查看全量样品任务、处理争议、冻结异常配额 | 代替买卖双方确认验收结论 |

说明：平台仅提供内容管理式增删改查，不做审核流引擎；本方案中的「运营处理」指运营通过管理后台读取记录后线下沟通，不承诺站内审批自动化。

## 3. 主流程

1. 买家在商品/供应商详情页点击「申请打样」，填写板层、尺寸、数量、工艺要求、期望交期与收件信息。
2. 系统按供应商 `sample_quota` 校验当周剩余额度，额度不足则提示等待或改约。
3. 供应商在「样品任务」中接单并给出样品单价、打样周期、可出货日期。
4. 双方确认后任务进入「打样中」，供应商按节点上报：工程确认 → 投料 → 成型 → 测试 → 出货。
5. 买家收货后 3 个工作日内确认结果：通过 / 有条件通过 / 不通过。
6. 不通过时买家提交瑕疵记录（缺陷类型、位置、图片、期望处理），供应商响应返工或退款方案。
7. 任务关闭后生成样品基线摘要，可在批量询价时引用。

## 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. 验收清单

1. 买家可从商品页与供应商页进入申请，表单必填项校验完整。
2. 供应商接单后节点按顺序可上报，乱序操作被拒绝。
3. 配额扣减与释放准确，取消任务后额度回到可用。
4. 验收不通过时必须填写瑕疵记录，否则不可提交。
5. 关闭后的任务在列表中可查，且不可再改状态。