# 前端页面改造清单（对齐现有站点路由）

文档编号：pcbjia-MALL-FE-REFACTOR-V1.0
用途：前端开发直接落地依据，按 P0 / P1 / P2 分级，不推翻现有布局框架，优先复用已有组件。

---

## 前置说明

- 商城频道必须与主站账号体系一致，不建立独立账号。
- 差异化能力保留：DFM 预审、BOM 与 Gerber 联合评审、多服务商比价、CAR 品质工单入口。
- 三端区分：客户端商城、供应商后台、平台运营后台（运营后台受平台能力限制，仅按数据表增删改查）。

现有对应路由：

| 模块 | 路由 |
| --- | --- |
| 商城首页 | `/mall` |
| 购物车 | `/mall/cart` |
| 报价 | `/request-quote`、`/pricing/impedance` |
| DFM | `/dfm-analysis`、`/dfm-checklist`、`/dfm-online-check` |
| 订单 | `/orders`、`/mall/orders` |
| 服务商 | `/jiagou/providers`、`/jiagou/providers/:id` |
| 标单 | `/jiagou/bids`、`/jiagou/bids/:id` |
| 工作台 | `/jiagou/workspace` |
| 规则 | `/jiagou/rules` |
| 聊天室 | `/pcb-chat` |
| 论坛 | `/forum` |
| 下载中心 | `/downloads` |

---

## 一、P0 阻断级（灰度前必须完成）

### 1.1 商城首页 `/mall`

1. 顶部导航与主站统一，登录后展示企业名称与子账号入口，菜单区分【采购】【工程师】角色。
2. 板块顺序：快速入口 → 工艺方案卡片 → 服务商精选 → 平台能力 → 公告与系统通知。
3. 快速入口优先：上传 Gerber 报价、BOM 配单、我的询价、我的订单、品质 CAR 工单。
4. 工艺卡片须标注是否支持自动报价、是否需要人工评审。
5. 移除占位模块；顶部增加平台状态提示（自动报价开关、维护公告）。
6. 全局告警条：风控预警、停机维护、限流提示，文案可配置。

### 1.2 上传与预审页（Gerber + BOM）

1. 双通道切换：快速样板通道 / 完整工程预审通道。
2. 上传支持多文件、压缩包、拖拽、断点续传；后缀校验与恶意文件拦截。
3. BOM 上传后实时预览、解析日志、异常行高亮、重复位号告警。
4. Gerber 上传后在线预览层结构、逐层切换、钻孔预览；解析失败给出明确原因（缺层、损坏、非标准 RS274X）。
5. DFM 报告面板：缺陷分级（致命/高危/一般/提示）、坐标、缩略图、IPC-A-600 条款引用、改善建议。
6. 客户可勾选「已知风险继续询价」或「修改工程文件」。
7. 预审完成后一键发起询价，BOM、Gerber、DFM 报告绑定同一询价单。
8. 高难工艺（盲埋孔、阻抗、FPC）自动提示转人工评审并说明时效。

> 当前实现说明：线上未接入真实 Gerber 解析与 DFM 计算，页面以格式校验与示例报告呈现，报告顶部标注「演示样例 / 基于已上传文件检测」。

### 1.3 询价列表与详情

1. 列表字段：询价编号、项目名称、上传时间、状态、比价数量、报价截止、关联文件。
2. 状态：预审中、待报价、比价完成、已下单、已取消、已过期。
3. 详情：左侧工程文件与 DFM 报告，右侧服务商报价卡片；供应商底价仅采购角色可见，工程师角色脱敏。
4. 比价汇总可导出 PDF（含缺陷清单）。
5. 操作：选定下单、重新询价、取消询价、发起沟通。

### 1.4 订单列表与详情

1. 列表：订单号、关联询价、成交服务商、金额、付款状态、生产进度、发货状态、CAR 标记。
2. 详情全链路溯源：BOM、Gerber、DFM 报告、原始报价、进度、物流、质检、CAR 入口。
3. 节点可视化：预审 → 报价确认 → 付款 → 排产 → 生产 → 质检 → 发货 → 签收。
4. 退款、改单、取消按状态锁定（排产后不可直接取消）。
5. 财务信息仅客户财务角色可见。

### 1.5 登录与子账号

1. 登录与主站统一，单点登录，不重复注册。
2. 子账号角色：采购 / 工程师 / 财务 / 只读，严格按权限矩阵。
3. 授信额度页：可用额度、已占用、账期提醒。

### 1.6 CAR 品质工单

1. 新建：自动绑定订单，导入 Gerber、BOM、订单信息，支持不良照片与切片报告。
2. 流转：新建 → 分配 → 服务商确认 → 临时对策 → 永久对策 → 8D 上传 → 评审 → 闭环。
3. 8D 模板在线填写、预览、导出。
4. 列表支持按不良类型、IPC 缺陷检索。
5. 待处理 CAR 强提醒。

### 1.7 全局 IM

1. 询价、订单、CAR 内一键唤起，自动关联单据上下文。
2. 支持图片、PDF、压缩包；已读未读；离线缓存。
3. 消息与统一消息中心同步。

---

## 二、P1 核心迭代

客户端：

1. BOM 版本差异对比（物料增减、封装、数量）。
2. 替代料推荐与库存、交期对比。
3. 个人项目档案库（询价、工程文件、订单、CAR 归档）。
4. 发票申请与台账（申请入口 + 状态展示，开具动作在平台侧）。
5. 物流轨迹内嵌。
6. 报价单、订单、DFM 报告导出加水印与审计编码。

供应商后台：

1. 工作台：待报价、待履约、待处理 CAR、绩效摘要。
2. 报价编辑：平台预填工艺参数，填写单价、交期、备注，可存模板。
3. 进度上报：工序节点、出货单。
4. 绩效看板（仅自身数据）：准时率、不良率、响应时长。
5. 结算台账与对账单预览。

平台运营后台（仅数据表增删改查）：

1. 灰度开关、工艺白名单、单笔询价上限、告警阈值配置项。
2. 报价参数库配置项。
3. 客户与服务商档案、资质审核状态。
4. 审计日志查询。

---

## 三、P2 体验优化

1. 移动端 H5：Gerber 大图预览降级，优先看进度、工单、消息。
2. 全局搜索：询价号、订单号、CAR 号、料号模糊检索。
3. 消息中心分类：报价、订单、CAR、系统公告。
4. 帮助中心弹窗：缺陷释义、工艺说明、IPC 文档跳转。
5. 表单记忆：常用工艺、收货地址、开票信息。
6. 大文件导出队列与完成通知。
7. 暗黑模式与字号适配。

---

## 四、全局前端规则

1. 数据脱敏按权限矩阵，底价、银行账号、手机号自动脱敏。
2. 导出、下载、预览写入审计日志（前端记录事件，落库在平台侧）。
3. 高风险操作二次确认：删除询价、取消订单、提交 CAR、确认报价。
4. 表单校验统一：红色提示、后置校验、行业化文案。
5. 加载与异常兜底：计算超时、接口报错、限流给出明确提示。
6. 缓存：报价结果与 DFM 报告前端缓存，参数变化自动失效。

---

## 五、红线

1. 禁止前端硬编码报价规则、佣金、工艺加价。
2. 禁止仅靠前端隐藏做权限控制，服务端必须二次校验。
3. Gerber 解析、DFM 运算、报价计算放服务端，前端只做预览。
4. 禁止本地持久化敏感财务与底价数据。

---

## 六、交付物

1. 本改造清单
2. 路由清单（见 `router_api_v1.md`）
3. 全局组件规范：上传、表格、状态标签、比价卡片、进度节点
4. 交互原型：沿用现有站点迭代
5. 埋点清单：询价发起、BOM 解析、下单、CAR 提交转化