SRS 附件包 A–F
文档编号:pcbjia-SRS-APP-V1.2 适用版本:V1.2 说明:本附件与主 SRS 配套,供开发、联调、测试与验收使用。
附件 A:开放 API 接口规范(对外)
A.1 通用约定
- 传输协议:HTTPS;请求方式:POST(JSON)。
- 鉴权:
AppKey + AppSecret + Timestamp + Sign。 - 签名:
Sign = MD5(AppKey + AppSecret + Timestamp + BodyJSON)。 - 字符编码:UTF-8。
- 域名:沙箱
sandbox-api.pcbjia.com;生产api.pcbjia.com。 - 限流:单应用 100 次/分钟,超限返回 429。
- 幂等:写操作(下单、确认、取消)必须传
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 功能
- 主干链路(BOM → Gerber → DFM → 询价 → 报价 → 下单 → 支付 → 履约 → 对账 → CAR)全链路跑通,无 P0 阻断。
- P0 用例全部通过;P1 通过率不低于 95%,遗留问题登记台账且不阻断上线。
- 权限、脱敏、保密按矩阵执行,越权全部拦截。
- 沙箱内接口全部调通,回调稳定且幂等。
- 审计日志留存前后值,不可删除。
F.2 性能
- BOM 1000 行解析 ≤ 15s。
- 普通 2/4 层 Gerber 解析 + DFM ≤ 30s。
- 报价引擎计算 ≤ 5s。
- 接口 95% 请求 < 800ms。
- 单文件上传上限 200MB,断点续传稳定。
- 支持 50 并发询价与下单,无脏数据。
F.3 安全
- 无 SQL 注入、XSS、越权漏洞。
- 上传校验后缀与文件头,禁止可执行文件。
- 密钥不硬编码,敏感字段加密存储。
- 导出带水印并记录审计。
- 支付回调签名校验,不可伪造。
F.4 文档
交付齐全:SRS、原型、数据库表、接口文档、测试用例、SOP、应急预案、BI 指标字典、FMEA。
F.5 签字
产品、技术、品质、财务负责人共同确认后方可进入灰度放量。

