前端页面改造清单(对齐现有站点路由)
文档编号: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`
- 顶部导航与主站统一,登录后展示企业名称与子账号入口,菜单区分【采购】【工程师】角色。
- 板块顺序:快速入口 → 工艺方案卡片 → 服务商精选 → 平台能力 → 公告与系统通知。
- 快速入口优先:上传 Gerber 报价、BOM 配单、我的询价、我的订单、品质 CAR 工单。
- 工艺卡片须标注是否支持自动报价、是否需要人工评审。
- 移除占位模块;顶部增加平台状态提示(自动报价开关、维护公告)。
- 全局告警条:风控预警、停机维护、限流提示,文案可配置。
1.2 上传与预审页(Gerber + BOM)
- 双通道切换:快速样板通道 / 完整工程预审通道。
- 上传支持多文件、压缩包、拖拽、断点续传;后缀校验与恶意文件拦截。
- BOM 上传后实时预览、解析日志、异常行高亮、重复位号告警。
- Gerber 上传后在线预览层结构、逐层切换、钻孔预览;解析失败给出明确原因(缺层、损坏、非标准 RS274X)。
- DFM 报告面板:缺陷分级(致命/高危/一般/提示)、坐标、缩略图、IPC-A-600 条款引用、改善建议。
- 客户可勾选「已知风险继续询价」或「修改工程文件」。
- 预审完成后一键发起询价,BOM、Gerber、DFM 报告绑定同一询价单。
- 高难工艺(盲埋孔、阻抗、FPC)自动提示转人工评审并说明时效。
> 当前实现说明:线上未接入真实 Gerber 解析与 DFM 计算,页面以格式校验与示例报告呈现,报告顶部标注「演示样例 / 基于已上传文件检测」。
1.3 询价列表与详情
- 列表字段:询价编号、项目名称、上传时间、状态、比价数量、报价截止、关联文件。
- 状态:预审中、待报价、比价完成、已下单、已取消、已过期。
- 详情:左侧工程文件与 DFM 报告,右侧服务商报价卡片;供应商底价仅采购角色可见,工程师角色脱敏。
- 比价汇总可导出 PDF(含缺陷清单)。
- 操作:选定下单、重新询价、取消询价、发起沟通。
1.4 订单列表与详情
- 列表:订单号、关联询价、成交服务商、金额、付款状态、生产进度、发货状态、CAR 标记。
- 详情全链路溯源:BOM、Gerber、DFM 报告、原始报价、进度、物流、质检、CAR 入口。
- 节点可视化:预审 → 报价确认 → 付款 → 排产 → 生产 → 质检 → 发货 → 签收。
- 退款、改单、取消按状态锁定(排产后不可直接取消)。
- 财务信息仅客户财务角色可见。
1.5 登录与子账号
- 登录与主站统一,单点登录,不重复注册。
- 子账号角色:采购 / 工程师 / 财务 / 只读,严格按权限矩阵。
- 授信额度页:可用额度、已占用、账期提醒。
1.6 CAR 品质工单
- 新建:自动绑定订单,导入 Gerber、BOM、订单信息,支持不良照片与切片报告。
- 流转:新建 → 分配 → 服务商确认 → 临时对策 → 永久对策 → 8D 上传 → 评审 → 闭环。
- 8D 模板在线填写、预览、导出。
- 列表支持按不良类型、IPC 缺陷检索。
- 待处理 CAR 强提醒。
1.7 全局 IM
- 询价、订单、CAR 内一键唤起,自动关联单据上下文。
- 支持图片、PDF、压缩包;已读未读;离线缓存。
- 消息与统一消息中心同步。
二、P1 核心迭代
客户端:
- BOM 版本差异对比(物料增减、封装、数量)。
- 替代料推荐与库存、交期对比。
- 个人项目档案库(询价、工程文件、订单、CAR 归档)。
- 发票申请与台账(申请入口 + 状态展示,开具动作在平台侧)。
- 物流轨迹内嵌。
- 报价单、订单、DFM 报告导出加水印与审计编码。
供应商后台:
- 工作台:待报价、待履约、待处理 CAR、绩效摘要。
- 报价编辑:平台预填工艺参数,填写单价、交期、备注,可存模板。
- 进度上报:工序节点、出货单。
- 绩效看板(仅自身数据):准时率、不良率、响应时长。
- 结算台账与对账单预览。
平台运营后台(仅数据表增删改查):
- 灰度开关、工艺白名单、单笔询价上限、告警阈值配置项。
- 报价参数库配置项。
- 客户与服务商档案、资质审核状态。
- 审计日志查询。
三、P2 体验优化
- 移动端 H5:Gerber 大图预览降级,优先看进度、工单、消息。
- 全局搜索:询价号、订单号、CAR 号、料号模糊检索。
- 消息中心分类:报价、订单、CAR、系统公告。
- 帮助中心弹窗:缺陷释义、工艺说明、IPC 文档跳转。
- 表单记忆:常用工艺、收货地址、开票信息。
- 大文件导出队列与完成通知。
- 暗黑模式与字号适配。
四、全局前端规则
- 数据脱敏按权限矩阵,底价、银行账号、手机号自动脱敏。
- 导出、下载、预览写入审计日志(前端记录事件,落库在平台侧)。
- 高风险操作二次确认:删除询价、取消订单、提交 CAR、确认报价。
- 表单校验统一:红色提示、后置校验、行业化文案。
- 加载与异常兜底:计算超时、接口报错、限流给出明确提示。
- 缓存:报价结果与 DFM 报告前端缓存,参数变化自动失效。
五、红线
- 禁止前端硬编码报价规则、佣金、工艺加价。
- 禁止仅靠前端隐藏做权限控制,服务端必须二次校验。
- Gerber 解析、DFM 运算、报价计算放服务端,前端只做预览。
- 禁止本地持久化敏感财务与底价数据。
六、交付物
- 本改造清单
- 路由清单(见
router_api_v1.md) - 全局组件规范:上传、表格、状态标签、比价卡片、进度节点
- 交互原型:沿用现有站点迭代
- 埋点清单:询价发起、BOM 解析、下单、CAR 提交转化

