下载中心/SRS 附件A-F

SRS 附件A-F

下载原文件

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订单已排产不允许变更变更时机校验
4001BOM 解析失败格式或编码异常
4002Gerber 解析失败文件损坏、非标准格式
4003DFM 高危缺陷禁止直接报价需人工评审
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 签字

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