# SRS 附件包 A–F

文档编号：pcbjia-SRS-APP-V1.2
适用版本：V1.2
说明：本附件与主 SRS 配套，供开发、联调、测试与验收使用。

## 附件 A：开放 API 接口规范（对外）

### A.1 通用约定
1. 传输协议：HTTPS；请求方式：POST（JSON）。
2. 鉴权：`AppKey + AppSecret + Timestamp + Sign`。
3. 签名：`Sign = MD5(AppKey + AppSecret + Timestamp + BodyJSON)`。
4. 字符编码：UTF-8。
5. 域名：沙箱 `sandbox-api.pcbjia.com`；生产 `api.pcbjia.com`。
6. 限流：单应用 100 次/分钟，超限返回 429。
7. 幂等：写操作（下单、确认、取消）必须传 `idempotent_key`，服务端做幂等控制。

### A.2 接口清单

| 分组 | 接口 | 说明 |
| --- | --- | --- |
| 客户侧 | /api/inquiry/create | 发起寻源询价（关联 BOM/Gerber） |
| 客户侧 | /api/inquiry/list | 查询询价列表与报价状态 |
| 客户侧 | /api/order/create | 确认报价生成订单 |
| 客户侧 | /api/order/query | 订单详情、进度、物流 |
| 客户侧 | /api/car/create | 提交客诉 CAR |
| 客户侧 | /api/car/list | 查询 CAR 工单 |
| 供应商侧 | /api/inquiry/pull | 拉取分配给自己的询价 |
| 供应商侧 | /api/quotation/submit | 回传报价 |
| 供应商侧 | /api/order/progress | 上报生产进度 |
| 供应商侧 | /api/order/delivery | 上传出货单与物流信息 |
| 回调 | /webhook/event | 事件推送 |

### A.3 Webhook 事件
`quotation.finish`（供应商提交报价）、`order.pay.success`、`order.delivery`、`car.create`、`car.close`、`supplier.freeze`。

### A.4 回调重试
失败后间隔 1、3、10、30、60 分钟重试，最多 5 次；仍失败进入失败队列并在后台告警。

## 附件 B：全局错误码字典

| 错误码 | 说明 | 场景 |
| --- | --- | --- |
| 0000 | 成功 | 正常返回 |
| 1001 | 鉴权失败 | AppKey/签名错误、密钥过期 |
| 1002 | 接口权限不足 | 越权调用、密钥无该接口权限 |
| 1003 | 请求参数非法 | 必填缺失、格式错误 |
| 1004 | 幂等 key 重复 | 重复提交订单或报价 |
| 2001 | 授信额度不足 | 账期下单额度不足 |
| 2002 | 询价已过期 | 报价有效期截止 |
| 2003 | 询价已关闭 | 客户已取消 |
| 3001 | 供应商冻结不可接单 | 供应商状态冻结 |
| 3002 | 订单已排产不允许变更 | 变更时机校验 |
| 4001 | BOM 解析失败 | 格式或编码异常 |
| 4002 | Gerber 解析失败 | 文件损坏、非标准格式 |
| 4003 | DFM 高危缺陷禁止直接报价 | 需人工评审 |
| 5001 | 支付回调校验失败 | 通知被篡改 |
| 5002 | 对账差异无法结算 | 财务校验拦截 |
| 9999 | 服务内部异常 | 记录日志并告警 |

## 附件 C：全角色权限矩阵

图例：读 = 可查看；写 = 可编辑；— = 不可见。

| 模块 | 平台管理员 | 供应链 | 品质 | 财务 | 运营 | 客户采购 | 客户工程师 | 客户财务 | 供应商商务 | 供应商品质 | 供应商财务 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 客户档案 | 读写 | 读 | 读 | 读 | 读写 | 读 | 读 | 读 | — | — | — |
| 供应商档案 | 读写 | 读写 | 读 | 读 | 读 | 读 | 读 | 读 | 读 | 读 | 读 |
| BOM / Gerber | 读 | 读 | 读 | — | 读 | 读写 | 读写 | 读 | 读 | 读 | — |
| 报价 | 读 | 读 | 读 | — | 读 | 读 | 读 | 读 | 读写 | 读 | 读 |
| 订单 | 读写 | 读 | 读 | 读 | 读 | 读 | 读 | 读 | 读写 | 读 | 读 |
| 价格与成本 | 读写 | 读 | — | 读 | 读 | 读 | — | 读 | 读 | — | 读 |
| CAR 工单 | 读写 | 读 | 读写 | 读 | 读 | 读 | 读 | 读 | 读写 | 读写 | 读 |
| 绩效打分 | 读写 | 读写 | 读 | — | 读 | — | — | — | 读 | 读 | — |
| 结算与质保金 | 读写 | 读 | — | 读写 | — | 读 | — | 读 | 读 | — | 读写 |
| 发票台账 | 读写 | 读 | — | 读写 | — | 读 | — | 读 | 读 | — | 读写 |
| BI 大盘 | 读 | 读 | 读 | 读 | 读 | 读（本企业） | 读（脱敏） | 读 | 读（自身） | 读（自身） | 读（自身） |
| 审计日志 | 读写 | 读 | 读 | 读 | 读 | 读（本企业） | 读（本企业） | 读（本企业） | 读（自身） | 读（自身） | 读（自身） |
| 保密项目 | 读写 | 读 | 读 | — | 读 | 读 | 读 | 读 | — | — | — |
| 系统配置 | 读写 | — | — | — | — | — | — | — | — | — | — |

## 附件 D：报价引擎工艺参数库

板材：FR-4、高 TG FR-4、铝基板、高频板（PTFE/陶瓷）、厚铜、柔性 FPC。
板厚：0.6、0.8、1.0、1.2、1.6、2.0 mm，特殊板厚加价。
层数：1、2、4、6、8、10、12、14 层以上阶梯计价。
表面处理：HASL、无铅 HASL、沉金、镀金、沉银、沉锡、OSP。
工艺附加项：V-CUT、阻抗控制、盲埋孔、金手指、塞孔、厚铜、丝印/阻焊颜色、加急（24h/48h）。
计价因子：面积、PCS 数量、层数、工艺难度、交期、板材、表面处理、最小线宽线距、最小孔径。
规则：基础价 + 工艺附加费 + 加急费；支持按供应商配置独立参数，版本化管理，停用不影响历史报价。

## 附件 E：需求变更申请单模板

```
【pcbjia 需求变更单 CR-XXXX】
变更标题：
提出人 / 时间：
关联 SRS 版本：V1.2
变更类型：新增功能 / 修改逻辑 / 修复缺陷 / 删减功能
变更描述：
业务背景：
影响模块：报价引擎 / 订单 / CAR / 财务 / 权限 / API
影响范围：前端、后端、数据库、接口、测试用例
风险评估：高 / 中 / 低；是否影响存量订单、资金、客诉
预估工时：
评审意见（供应链 / 品质 / 财务 / 技术）：
审批结果：通过 / 驳回 / 暂缓
新版本号：V1.3
附件：原型、流程图、参考文档
```

## 附件 F：项目验收标准

### F.1 功能
1. 主干链路（BOM → Gerber → DFM → 询价 → 报价 → 下单 → 支付 → 履约 → 对账 → CAR）全链路跑通，无 P0 阻断。
2. P0 用例全部通过；P1 通过率不低于 95%，遗留问题登记台账且不阻断上线。
3. 权限、脱敏、保密按矩阵执行，越权全部拦截。
4. 沙箱内接口全部调通，回调稳定且幂等。
5. 审计日志留存前后值，不可删除。

### F.2 性能
1. BOM 1000 行解析 ≤ 15s。
2. 普通 2/4 层 Gerber 解析 + DFM ≤ 30s。
3. 报价引擎计算 ≤ 5s。
4. 接口 95% 请求 < 800ms。
5. 单文件上传上限 200MB，断点续传稳定。
6. 支持 50 并发询价与下单，无脏数据。

### F.3 安全
1. 无 SQL 注入、XSS、越权漏洞。
2. 上传校验后缀与文件头，禁止可执行文件。
3. 密钥不硬编码，敏感字段加密存储。
4. 导出带水印并记录审计。
5. 支付回调签名校验，不可伪造。

### F.4 文档
交付齐全：SRS、原型、数据库表、接口文档、测试用例、SOP、应急预案、BI 指标字典、FMEA。

### F.5 签字
产品、技术、品质、财务负责人共同确认后方可进入灰度放量。