下载中心/附件K 收官说明

附件K 收官说明

下载原文件

附件K 整套文档总目录 + 版本控制规范 + 打包交付说明

文档编号:pcbjia-FINAL-V1.0 适用范围:pcbjia.com 主站与 Mall 商城频道、家狗服务商频道、技术社区(聊天室 + 论坛)、工具中心、外贸单证、积分激励等全部模块 状态:【评审通过】


一、全套交付包清单

统一命名规则:pcbjia-【模块名】-【版本号】。

1.1 主文档与附件

编号文档版本说明
00pcbjia-Mall-SRSV1.2主需求规格说明书
A开放 API 与 WebhookV1.0接口规范、签名、回调重试
B全局错误码字典V1.0业务码 + HTTP 码映射
C全角色权限矩阵V1.1采购/工程师/财务/供应商/平台
D报价引擎工艺参数库V1.0板材、层数、表面处理、加价项
E需求变更 CR 模板V1.0变更单字段与审批流
F项目验收标准V1.0功能、性能、安全红线
G运维与部署文档V1.1架构、容器、备份、监控、灾备
H测试全套文档V1.0计划、用例、压测、缺陷台账
I灰度与冷启动 SOPV1.0灰度批次、指标红线、竞品巡检
J需求池、Roadmap 与盈利测算待补齐本期未产出,见「遗留清单」
K总目录、版本控制、打包交付V1.0本文档

1.2 业务模板(/templates)

  • CR 需求变更单
  • CAR 品质 8D 报告模板
  • 缺陷台账
  • 灰度监控指标表
  • 供应商绩效评分表
  • 盈利测算模板
  • 种子客户邀约与回访 SOP
  • 上线故障复盘报告模板

1.3 设计与工程资产(/assets)

  • 业务主流程:BOM 上传 → DFM 预审 → 询价 → 比价 → 下单 → 履约 → CAR 闭环
  • 系统架构拓扑图
  • 数据库核心表 ER 图(配套 db_core_schema.sql)
  • 前端改造清单(配套 fe_refactor_v1.md)
  • 路由与接口清单(配套 router_api_v1.md)
  • 监控面板配置与压测脚本说明

二、版本控制规范

2.1 版本号规则

三段式 V主版本.次版本.修订号:

  • 主版本:架构重构、业务模式变更
  • 次版本:成批新增核心能力
  • 修订号:缺陷修复、规则微调、文案与参数调整

约束:

  1. 主 SRS 与其附件版本同步升级;单个附件微调只加修订号。
  2. 上线镜像 Tag 与文档版本号保持一致,避免「文档 V1.2 / 镜像 V1.1.9」错位。
  3. 任何修改必须关联 CR 单号,禁止无记录直接改文档。

2.2 文档状态

状态含义是否可作为开发依据
草稿编写中,未评审否
评审通过产品、技术、品质、财务共同评审是
已上线锁定对应版本已上线,仅允许新增修订是(只读主干)
归档封存版本下线,只读追溯否

2.3 存储与追溯

  1. 源码、文档统一入库,目录分 /docs、/design、/scripts、/templates。
  2. 提交备注格式:[版本号] CR-XXX 变更简述。
  3. 里程碑版本(灰度、全量、大版本)打 Tag 永久锁定。
  4. 禁止本地零散私存;对外交付以 Tag 导出的交付包为准。
  5. 历史版本不删除,修改只新增修订记录。

2.4 变更记录字段

修改人、修改时间、CR 单号、修改前后内容、影响范围(前端/后端/财务/测试)、评审记录。


三、打包交付规范

3.1 命名

pcbjia-Mall_交付包_Vx.y.z_YYYYMMDD.zip

3.2 目录结构

pcbjia-Mall_交付包_Vx.y.z
├─ 01_SRS主文档
│  ├─ pcbjia-Mall-SRS-Vx.y.md
│  └─ 01_附件合集(A-K)
├─ 02_业务模板
├─ 03_设计资产(流程图、ER 图、架构图、前端改造清单)
├─ 04_测试脚本(压测脚本、接口用例)
├─ 05_运维配置(监控面板、告警规则)
└─ README.md(版本说明、联系人、已知遗留风险)

3.3 输出格式

  • 内部团队:Markdown 源码随仓库迭代,便于比对差异。
  • 对外交付:导出 PDF + Word 并打包,PDF 为只读基准版本。

3.4 打包前检查清单

  • 主 SRS 与附件版本号一致
  • CR 变更单已归档并关联版本
  • 流程图、ER 图与正文一致
  • 错误码、接口、权限矩阵、报价参数无互相矛盾
  • 已知遗留风险在 README 单列
  • 测试验收标准与灰度红线完整
  • 小程序/后台等平台能力受限项已明确标注
  • 演示环境访问方式与限制已注明

四、方案边界

  1. 定位:主站 + 商城频道一体化,差异化走「前置 DFM 风控 + CAR 品质全链路追溯」,不做低价样板内卷。
  2. 账号体系与主站统一,BOM、Gerber、订单、工单、客户档案与主站打通。
  3. 后台可配置项(佣金、告警阈值、灰度开关、工艺白名单)均以配置驱动,不硬编码。
  4. 财务、分账、发票相关逻辑须留审计痕迹,满足对账与客诉核查。
  5. 高风险业务(资金、授信、DFM 自动判定、报价引擎)保留人工兜底开关。

4.1 平台能力边界(重要)

本项目建设在万小智 SaaS 平台上,以下能力不属于当前平台可交付范围,相关模块以「设计稿 + 流程说明 + 内容管理后台录入」方式交付,不做前端自建实现:

  • 在线支付、资金托管、保证金扣划、平台分账
  • 短信、邮件、企业微信、Web Push 等外部消息投递
  • 自建运营后台、数据大盘与报表系统(平台仅按数据表提供增删改查)
  • 第三方 OAuth 登录(仅支持邮箱 / 短信 OTP)
  • 对象存储直传(受存储开通状态限制,附件以文件名与外部链接登记)
  • Gerber 二进制真实解析与 DFM 几何计算(前端仅做示例与格式校验演示)

五、交付后迭代指引

  1. 新增需求:进需求池台账,周评审通过后出 CR 单,再更新文档与版本号。
  2. 上线前:按附件 F 验收标准与附件 H 测试文档执行。
  3. 线上故障:走故障 SOP,复盘归档并补回归用例。
  4. 竞品巡检:每周按附件 I 执行,区分「补齐基础能力」与「强化差异化」。
  5. 经营复盘:按月评估询价转化、交付准时率、CAR 不良率、服务商健康度。

六、遗留清单(本轮明确未完成)

项状态说明
附件J 需求池 / Roadmap / 盈利测算未产出需业务侧确认测算口径与目标值
P31 帮助中心 / 工单 / IM 客服未产出与现有聊天室能力需先做归并设计
报价质保期字段未落库表单有 6/12/24 月选项,数据表缺 warranty_months
履约完成率暂无数据需先定义口径(完成单 / 成交单,剔除取消与纠纷)
附件原件上传未接通存储能力未开通,现为文件名占位
案例影像与证书存档示意cases、certificates 表未建,页面为示意配图