# 附件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主版本.次版本.修订号`：

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

约束：

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` 表未建，页面为示意配图 |