附件K 整套文档总目录 + 版本控制规范 + 打包交付说明
文档编号:pcbjia-FINAL-V1.0 适用范围:pcbjia.com 主站与 Mall 商城频道、家狗服务商频道、技术社区(聊天室 + 论坛)、工具中心、外贸单证、积分激励等全部模块 状态:【评审通过】
一、全套交付包清单
统一命名规则:pcbjia-【模块名】-【版本号】。
1.1 主文档与附件
| 编号 | 文档 | 版本 | 说明 |
|---|---|---|---|
| 00 | pcbjia-Mall-SRS | V1.2 | 主需求规格说明书 |
| A | 开放 API 与 Webhook | V1.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 | 灰度与冷启动 SOP | V1.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主版本.次版本.修订号:
- 主版本:架构重构、业务模式变更
- 次版本:成批新增核心能力
- 修订号:缺陷修复、规则微调、文案与参数调整
约束:
- 主 SRS 与其附件版本同步升级;单个附件微调只加修订号。
- 上线镜像 Tag 与文档版本号保持一致,避免「文档 V1.2 / 镜像 V1.1.9」错位。
- 任何修改必须关联 CR 单号,禁止无记录直接改文档。
2.2 文档状态
| 状态 | 含义 | 是否可作为开发依据 |
|---|---|---|
| 草稿 | 编写中,未评审 | 否 |
| 评审通过 | 产品、技术、品质、财务共同评审 | 是 |
| 已上线锁定 | 对应版本已上线,仅允许新增修订 | 是(只读主干) |
| 归档封存 | 版本下线,只读追溯 | 否 |
2.3 存储与追溯
- 源码、文档统一入库,目录分
/docs、/design、/scripts、/templates。 - 提交备注格式:
[版本号] CR-XXX 变更简述。 - 里程碑版本(灰度、全量、大版本)打 Tag 永久锁定。
- 禁止本地零散私存;对外交付以 Tag 导出的交付包为准。
- 历史版本不删除,修改只新增修订记录。
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 单列
- 测试验收标准与灰度红线完整
- 小程序/后台等平台能力受限项已明确标注
- 演示环境访问方式与限制已注明
四、方案边界
- 定位:主站 + 商城频道一体化,差异化走「前置 DFM 风控 + CAR 品质全链路追溯」,不做低价样板内卷。
- 账号体系与主站统一,BOM、Gerber、订单、工单、客户档案与主站打通。
- 后台可配置项(佣金、告警阈值、灰度开关、工艺白名单)均以配置驱动,不硬编码。
- 财务、分账、发票相关逻辑须留审计痕迹,满足对账与客诉核查。
- 高风险业务(资金、授信、DFM 自动判定、报价引擎)保留人工兜底开关。
4.1 平台能力边界(重要)
本项目建设在万小智 SaaS 平台上,以下能力不属于当前平台可交付范围,相关模块以「设计稿 + 流程说明 + 内容管理后台录入」方式交付,不做前端自建实现:
- 在线支付、资金托管、保证金扣划、平台分账
- 短信、邮件、企业微信、Web Push 等外部消息投递
- 自建运营后台、数据大盘与报表系统(平台仅按数据表提供增删改查)
- 第三方 OAuth 登录(仅支持邮箱 / 短信 OTP)
- 对象存储直传(受存储开通状态限制,附件以文件名与外部链接登记)
- Gerber 二进制真实解析与 DFM 几何计算(前端仅做示例与格式校验演示)
五、交付后迭代指引
- 新增需求:进需求池台账,周评审通过后出 CR 单,再更新文档与版本号。
- 上线前:按附件 F 验收标准与附件 H 测试文档执行。
- 线上故障:走故障 SOP,复盘归档并补回归用例。
- 竞品巡检:每周按附件 I 执行,区分「补齐基础能力」与「强化差异化」。
- 经营复盘:按月评估询价转化、交付准时率、CAR 不良率、服务商健康度。
六、遗留清单(本轮明确未完成)
| 项 | 状态 | 说明 |
|---|---|---|
| 附件J 需求池 / Roadmap / 盈利测算 | 未产出 | 需业务侧确认测算口径与目标值 |
| P31 帮助中心 / 工单 / IM 客服 | 未产出 | 与现有聊天室能力需先做归并设计 |
| 报价质保期字段 | 未落库 | 表单有 6/12/24 月选项,数据表缺 warranty_months |
| 履约完成率 | 暂无数据 | 需先定义口径(完成单 / 成交单,剔除取消与纠纷) |
| 附件原件上传 | 未接通 | 存储能力未开通,现为文件名占位 |
| 案例影像与证书存档 | 示意 | cases、certificates 表未建,页面为示意配图 |

