erp-next/doc/福安德智慧报价平台-完整开发方案.md

# 福安德智慧报价平台 — 完整开发方案

> 基于 RuoYi-Vue v3.9.2 (Spring Boot 4.0.3 + JDK 17 + Vue 2 + Element UI)
> 融合 PPT《报价比对系统》5大板块 + XLSX《电气自动化设备综合管理系统_V1》27个Sheet数据
> 对接现有项目12个已完成模块

---

## 目录

- [一、项目全景与数据资产](#一项目全景与数据资产)
- [二、板块一：物料信息](#二板块一物料信息)
- [三、板块二：物料详情](#三板块二物料详情)
- [四、板块三：供应商管理](#四板块三供应商管理)
- [五、板块四：报价商门户（供应商端）](#五板块四报价商门户供应商端)
- [六、板块五：甲方报价单](#六板块五甲方报价单)
- [七、报价单管理与指派系统](#七报价单管理与指派系统)
- [八、电气设备数据初始化方案](#八电气设备数据初始化方案)
- [九、开发优先级与里程碑](#九开发优先级与里程碑)
- [十、关键接口清单](#十关键接口清单)
- [十一、权限与安全设计](#十一权限与安全设计)

---

## 一、项目全景与数据资产

### 1.1 PPT五大板块映射

| PPT板块 | 对应功能 | 现有进度 | 开发类型 |
|---------|---------|---------|---------|
| 智采系统-物料信息 | 物料CRUD + 分类树 + 性能参数JSON | `biz_material` 已有基础字段 | 扩展增强 |
| 智采系统-物料详情 | 详情页 + 3个Tab(历史报价/甲方报价/同比) | 未开发 | 新建 |
| 智采系统-供应商管理 | 供货清单 + 报价单管理 + 指派界面 | `biz_supplier` 已有基础 | 扩展增强 |
| 智采系统-报价商 | 供应商门户(已报项/可报项/报价界面) | 未开发 | 新建 |
| 给甲方报价单 | 子RFQ拆解 + 成本回填 + 历史版本 + 横向对比 | `biz_client_quote` 基础已有 | 核心增强 |

### 1.2 XLSX数据资产清单

Excel中包含了完整的电气设备业务数据，共27个Sheet：

| Sheet | 名称 | 行数 | 用途 |
|-------|------|------|------|
| 1 | 00_导航首页 | 24 | 系统导航和功能入口说明 |
| 2 | 01_项目报价单(fad给甲方) | 52 | 甲方报价模板(含品牌/型号/数量/折扣率) |
| 3 | 02_报价汇总 | 27 | 按类汇总 + 加价系数 + 对外报价 |
| 4 | 10_变频器比价 | 48 | 汇川/禾望/西门子/ABB 三家比价 |
| 5 | 11_整流单元比价 | 37 | 整流/制动/回馈单元比价 |
| 6 | 12_PLC比价 | 15 | CPU+模块比价 |
| 7 | 13_低压电器比价 | 22 | 断路器/接触器/热继电器比价 |
| 8 | 14_电缆线槽比价 | 25 | 电缆/控制线/线槽综合比价 |
| 9-19 | 20_变频器型号库 ~ 30_网关型号库 | 321+ | 全品类型号数据库 |
| 20 | 31_品牌汇总 | 22 | 各品牌型号数量统计 |

### 1.3 核心业务流程

```
甲方需求 → 创建甲方报价单 → 拆解为内部RFQ(子报价单)
    → 指派供应商(可报项) → 供应商报价 → 比价选择
    → 成本回填甲方报价单 → 生成最终甲方报价 → 甲方确认
    → 生成采购单 → 交付 → 评价/异议处理
```

---

## 二、板块一：物料信息

### 2.1 现有基础

`biz_material` 表已有字段：
- `material_id`, `tenant_id`, `category_id`, `material_code`, `material_name`
- `spec`, `unit`, `brand`, `description`
- `status`, `create_by`, `create_time`, `update_by`, `update_time`, `remark`

### 2.2 扩展字段

```sql
ALTER TABLE biz_material ADD COLUMN (
    -- PPT要求字段
    manufacturer     VARCHAR(100)    COMMENT '厂家/品牌(与brand一致，作为冗余筛选)',
    model_size       VARCHAR(200)    COMMENT '型号/尺寸(如MD500T37G, TMY-60×6)',
    performance_params TEXT          COMMENT '性能参数(JSON格式: {"功率":"37kW","电压":"380V"})',
    material         VARCHAR(100)    COMMENT '材质(铜/铝合金/PVC等)',
    purpose          VARCHAR(500)    COMMENT '用途(如"通用负载","风机水泵")',
    remarks          TEXT            COMMENT '备注',
    category_tree_path VARCHAR(500)  COMMENT '分类路径(冗余,如"1/5/23")',
    spec_comparison_group VARCHAR(100) COMMENT '横向对比分组标识',

    -- 扩展业务字段
    min_stock        INT DEFAULT 0   COMMENT '最低库存预警',
    unit_weight      DECIMAL(10,4)   COMMENT '单重(kg)',
    image_url        VARCHAR(500)    COMMENT '物料图片',
    data_source      VARCHAR(20) DEFAULT 'manual' COMMENT '数据来源(manual/import/excel)',
    version          INT DEFAULT 1   COMMENT '乐观锁版本号'
);

-- 型号唯一索引(防止重复录入同规格物料)
ALTER TABLE biz_material ADD UNIQUE INDEX idx_model_manufacturer (manufacturer, model_size);
```

### 2.3 性能参数JSON规范

性能参数使用JSON格式存储，前端动态渲染为键值对表格：

```json
// 变频器示例
{
  "功率": "37kW",
  "电压": "380V",
  "电流": "72A",
  "过载能力": "150%/60s",
  "通讯接口": "RS485/PROFINET",
  "防护等级": "IP20"
}

// 电缆示例
{
  "芯数×截面": "3×70+1×35",
  "额定电压": "0.6/1kV",
  "外径": "42mm",
  "载流量": "210A",
  "护套材质": "PVC铠装"
}
```

**前端组件**：使用Element UI动态表单（`el-form` + `el-table`），每行=参数名+参数值+单位，支持增删行。保存时组装为JSON字符串，读取时`JSON.parse`后渲染为只读表格。

### 2.4 前端页面结构

```
物料信息列表页 (/bid/material)
├── 左侧：物料分类树 (复用 biz_material_category)
│   ├── 树节点点击 → 右侧表格过滤
│   └── 面包屑导航(基于category_tree_path)
├── 右侧：物料表格
│   ├── 顶部筛选栏
│   │   ├── 厂家下拉(去重,从manufacturer字段DISTINCT)
│   │   ├── 型号模糊搜索(输入前缀智能联想)
│   │   ├── 分类级联选择器
│   │   └── 关键词搜索
│   ├── 表格列：编码 | 名称 | 厂家 | 型号 | 材质 | 用途 | 单位 | 操作
│   └── 操作按钮：详情 | 编辑 | 删除 | 加入对比篮
└── 新增/编辑对话框(抽屉形式)
    ├── 基础信息(名称/分类/厂家/型号/材质/用途/单位)
    ├── 性能参数动态表单(支持增删行)
    ├── 规格明细(可扩展多规格)
    └── 图片上传(物料图/铭牌)
```

### 2.5 后端接口扩展

在 `BizMaterialController` 中新增：

| 接口 | 方法 | 说明 |
|------|------|------|
| `/bid/material/detail/{id}` | GET | 物料详情(含性能参数解析+历史报价摘要) |
| `/bid/material/manufacturer/list` | GET | 厂家下拉列表(去重) |
| `/bid/material/import` | POST | Excel批量导入(EasyExcel解析) |
| `/bid/material/export` | GET | 导出为Excel模板 |
| `/bid/material/suggest` | GET | 型号智能联想(q参数前缀匹配) |
| `/bid/material/comparison-group/{groupId}` | GET | 按对比组获取物料 |

---

## 三、板块二：物料详情

### 3.1 页面架构

采用"1+N"信息架构——1个基础信息区 + N个动态关联Tab：

```
物料详情页 (/bid/material/detail/:id)
├── 顶部基础信息卡片(两栏)
│   ├── 左栏(16/24)：基础信息表(物料ID/厂家/型号/材质/用途)
│   │   └── 性能参数表格(从JSON动态渲染)
│   └── 右栏(8/24)：价格趋势ECharts迷你折线图
│       └── 近6个月最低报价走势(从biz_quotation_item聚合)
├── Tab 1：供应商历史报价清单
├── Tab 2：我方给甲方的历史报价
└── Tab 3：不同品牌/规格同比
```

### 3.2 Tab 1：供应商历史报价清单

**数据来源**：`biz_quotation_item` → `biz_quotation` → `biz_supplier`

**展示字段**：
| 字段 | 说明 |
|------|------|
| 报价日期 | biz_quotation.submit_time |
| 供应商名称 | biz_supplier.supplier_name |
| 单价(元) | biz_quotation_item.unit_price |
| 数量 | biz_quotation_item.quantity |
| 交期(周) | biz_quotation_item.delivery_days / 7 |
| 报价单号 | biz_quotation.quote_no |
| 操作 | 查看详情(点击下钻到报价单) |

**关键交互**：
- 点击单价 → 抽屉展示原始报价单详情
- 价格预警：高于近3个月平均价15% → 行背景红色高亮
- 按时间倒序排列

**后端API**：
```java
// BizMaterialController
@GetMapping("/{id}/supplier-quotes")
public AjaxResult getSupplierQuoteHistory(@PathVariable Long id) {
    // 查询 biz_quotation_item JOIN biz_quotation JOIN biz_supplier
    // WHERE material_id = id ORDER BY submit_time DESC
}
```

### 3.3 Tab 2：我方给甲方的历史报价

**数据来源**：`biz_client_quote_item` → `biz_client_quote`

**展示字段**：
| 字段 | 说明 |
|------|------|
| 报价日期 | client_quote.create_time |
| 甲方名称 | client_quote.client_name |
| 我方含税单价 | client_quote_item.unit_price |
| 折扣率 | client_quote_item.discount_rate |
| 最终成交价 | 含税单价 × 折扣率 |
| 状态 | sent/accepted/rejected(带标签) |
| 关联RFQ | client_quote.rfq_id → biz_rfq.rfq_no |

**功能扩展**：
- 落选标注原因(新增client_quote_item.reject_reason字段)
- 版本对比(基于parent_quote_id)

### 3.4 Tab 3：不同品牌/规格同比

#### 新建对比关系表

```sql
CREATE TABLE biz_material_comparison (
    id                BIGINT AUTO_INCREMENT PRIMARY KEY,
    group_id          VARCHAR(50) NOT NULL COMMENT '对比组ID(如"VFD-37kW-380V")',
    group_name        VARCHAR(200) COMMENT '对比组名称(如"37kW 380V变频器对比组")',
    material_id       BIGINT NOT NULL COMMENT '物料ID',
    counterpart_brand VARCHAR(100) COMMENT '对标品牌',
    counterpart_model VARCHAR(200) COMMENT '对标型号',
    comparison_notes  TEXT COMMENT '对比说明(差异点)',
    sort_order        INT DEFAULT 0 COMMENT '组内排序',
    status            CHAR(1) DEFAULT '0' COMMENT '状态',
    create_by         VARCHAR(64),
    create_time       DATETIME,
    update_by         VARCHAR(64),
    update_time       DATETIME,
    UNIQUE KEY uk_group_material (group_id, material_id),
    KEY idx_material (material_id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='物料横向对比组';
```

**功能逻辑**：

1. **管理员维护对比组**（在物料详情页可直接操作）
   - 为某个物料添加"对标物料"(跨品牌)
   - 如汇川MD500T37G ↔ 禾望HV500-37G ↔ 西门子G120 PM240 37kW

2. **自动对比展示**
   - 系统自动从 biz_comparison 对比结果中拉取对标物料的最新供应商报价
   - 对比维度：单价 | 功率 | 过载能力 | 通讯接口 | 防护等级 | 适用场合

3. **数据初始化**
   - 利用Excel Sheet 10-14的比价数据预置对比组
   - 如Sheet 10中"37kW变频器"对应的汇川/禾望/西门子/ABB四家数据

#### 前端展示

```
┌─────────────────────────────────────────────────────────────┐
│  37kW 380V变频器 对比组                                      │
├──────────────┬──────────┬──────────┬──────────┬────────────┤
│              │ 汇川      │ 禾望      │ 西门子    │ ABB        │
│              │ MD500T37G │ HV500-37G│ G120 37kW│ ACS880-01  │
├──────────────┼──────────┼──────────┼──────────┼────────────┤
│ 最低报价(元)  │ 6,200    │ 5,800    │ 10,500   │ 8,900      │
│ 功率(kW)     │ 37       │ 37       │ 37       │ 37         │
│ 过载能力      │ 150%/60s │ 150%/60s │ 140%/60s │ 150%/60s   │
│ 通讯接口      │ RS485    │ RS485    │ PROFINET │ PROFINET   │
│ 防护等级      │ IP20     │ IP20     │ IP20     │ IP21       │
│ 综合评价      │ ★★★★☆   │ ★★★★★   │ ★★★☆☆   │ ★★★★☆     │
├──────────────┼──────────┴──────────┴──────────┴────────────┤
│ 推荐选型      │ 禾望HV500-37G (性价比最优)                   │
└──────────────┴─────────────────────────────────────────────┘
```

---

## 四、板块三：供应商管理

### 4.1 现有基础

`biz_supplier` 表已有字段：supplier_id, supplier_name, contact, phone, email, address, status

### 4.2 供应商详情页重构

在现有 `/bid/supplier` 基础上，将列表页改为"列表+详情"结构，点击供应商进入详情页：

```
供应商详情页 (/bid/supplier/detail/:id)
├── Tab 1: 基础信息 (现有功能)
│   ├── 供应商名称/联系人/电话/邮箱/地址
│   └── 资质文件上传(营业执照/授权证书)
├── Tab 2: 供货清单 (新建)
│   ├── 供应商-物料关系维护
│   └── 历史报价快速查看
├── Tab 3: 报价单管理 (增强)
│   ├── 参与的RFQ列表
│   └── 报价单状态跟踪
├── Tab 4: 历史报价趋势 (新建)
│   └── ECharts折线图
└── Tab 5: 账号管理 (新建)
    └── 供应商登录账号创建/权限管理
```

### 4.3 供货清单

#### 新建供应商-物料关系表

```sql
CREATE TABLE biz_supplier_material (
    id                BIGINT AUTO_INCREMENT PRIMARY KEY,
    supplier_id       BIGINT NOT NULL,
    material_id       BIGINT NOT NULL,
    supply_status     TINYINT DEFAULT 1 COMMENT '0停供 1正常 2备选',
    last_quote_price  DECIMAL(18,4) COMMENT '最新报价(缓存)',
    last_quote_time   DATETIME COMMENT '最新报价时间',
    delivery_cycle    INT DEFAULT 0 COMMENT '供应周期(天)',
    min_order_qty     DECIMAL(15,4) DEFAULT 1 COMMENT '最小起订量',
    preferred         TINYINT DEFAULT 0 COMMENT '是否优选供应商',
    create_time       DATETIME,
    UNIQUE KEY uk_supplier_material (supplier_id, material_id),
    KEY idx_supplier (supplier_id),
    KEY idx_material (material_id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='供应商物料供应关系';
```

**前端交互**：
- 点击物料名称 → 跳转物料详情页(`/bid/material/detail/:id`)
- 支持在物料详情页"添加供应商"反向维护
- 批量导入：根据Excel比价数据自动建立供应关系

### 4.4 报价单管理

供应商参与的RFQ及报价单管理，增强现有 `biz_rfq`：

```sql
ALTER TABLE biz_rfq ADD COLUMN (
    contract_no           VARCHAR(100)  COMMENT '合同号',
    client_name           VARCHAR(100)  COMMENT '甲方名称',
    project_name          VARCHAR(200)  COMMENT '项目名称',
    delivery_required_date DATE         COMMENT '要求交货日期',
    delivery_weeks        INT           COMMENT '要求交货周期(周)',
    quote_deadline        DATETIME      COMMENT '供应商报价截止日',
    total_budget          DECIMAL(18,4) COMMENT '预算总额',
    winner_supplier_id    BIGINT        COMMENT '中标供应商ID',
    winner_quotation_id   BIGINT        COMMENT '中标报价单ID'
);
```

**报价单列表页字段**：询价单号 | 合同号 | 甲方 | 项目名称 | 状态 | 报价截止日 | 已报价/邀请数 | 操作

**状态流转**：`draft(草稿) → published(已发布) → in_progress(报价中) → closed(已关闭) → completed(已完成)`

### 4.5 指派供应商界面

**触发点**：RFQ发布时选择被邀请的供应商

```
┌─ 指派供应商对话框 ─────────────────────────────────┐
│                                                     │
│  询价单号: RFQ-2026-001                              │
│  标题: 自动化生产线控制系统采购                         │
│                                                     │
│  ☐ 全选                         搜索供应商: [______] │
│                                                     │
│  ☑ 深圳市华顺达电子有限公司      上次合作: 2026-01    │
│  ☑ 苏州博远精密设备有限公司      上次合作: 2026-01    │
│  ☐ 上海瑞达工控科技有限公司      新供应商             │
│  ☑ 广州联盟电气集团             报价历史优秀           │
│  ☐ 武汉华中精工机械有限公司      评价4.8分            │
│                                                     │
│  发送方式: [📧 邮件通知] [💬 站内信] [📱 短信通知]    │
│                                                     │
│              [取消]          [确认指派]               │
└─────────────────────────────────────────────────────┘
```

**指派后**：系统向供应商发送通知，供应商登录后可看到"可报项"

---

## 五、板块四：报价商门户（供应商端）

### 5.1 账户体系设计

```sql
-- 在 sys_user 增加供应商类型字段(已有 tenant_id)
ALTER TABLE sys_user ADD COLUMN (
    user_type       TINYINT DEFAULT 1 COMMENT '1内部员工 2供应商账号',
    supplier_id     BIGINT COMMENT '关联供应商ID(仅user_type=2时有效)',
    account_status  TINYINT DEFAULT 1 COMMENT '0待审核 1正常 2冻结'
);
```

**权限控制**：
- 供应商账号(`user_type=2`) → 仅能看到本供应商数据(通过`supplier_id`过滤)
- RuoYi `@PreAuthorize`注解 + 自定义数据权限拦截器
- 路由层面：供应商端访问 `/supplier/**` 路径，内部员工无法访问

### 5.2 供应商路由体系

新建独立路由模块，与后台管理路由隔离：

```javascript
// ruoyi-ui/src/router/supplier.js
export const supplierRoutes = [
  {
    path: '/supplier',
    component: Layout,
    hidden: true, // 不在管理后台侧边栏显示
    children: [
      { path: 'dashboard', component: () => import('@/views/supplier/dashboard'), meta: { title: '供应商首页' } },
      { path: 'rfq/pending', component: () => import('@/views/supplier/rfq-pending'), meta: { title: '可报项' } },
      { path: 'rfq/quoted', component: () => import('@/views/supplier/rfq-quoted'), meta: { title: '已报项' } },
      { path: 'quote/edit/:rfqId', component: () => import('@/views/supplier/quote-edit'), meta: { title: '报价填写' } },
      { path: 'profile', component: () => import('@/views/supplier/profile'), meta: { title: '我的信息' } },
    ]
  }
];
```

### 5.3 供应商首页 (`/supplier/dashboard`)

```
┌────────────────────────────────────────────────────────────┐
│  欢迎您，深圳市华顺达电子有限公司                             │
├──────────┬──────────┬──────────┬──────────┬───────────────┤
│  可报项   │  已报项   │  中标数   │  中标率   │  累计成交额    │
│    3      │   12     │    5     │  41.7%   │  ¥1,286,500  │
├──────────┴──────────┴──────────┴──────────┴───────────────┤
│  ⏰ 紧急提醒：RFQ-2026-003 报价截止还剩 2天！              │
│  📋 最新中标的报价单：RFQ-2026-001 (2026-01-15中标)       │
└────────────────────────────────────────────────────────────┘
```

### 5.4 可报项 (`/supplier/rfq/pending`)

**数据来源**：`biz_rfq_supplier` WHERE `supplier_id = ?` AND `status = 'published'` AND `quote_deadline > NOW()`

**列表字段**：
| 字段 | 说明 |
|------|------|
| RFQ编号 | biz_rfq.rfq_no |
| 甲方/项目 | biz_rfq.client_name / project_name |
| 报价截止日 | biz_rfq.quote_deadline (红色<3天) |
| 物料数量 | biz_rfq_item COUNT |
| 操作 | 立即报价(按钮) |

**紧急提醒**：截止前24小时发送站内信(复用RuoYi消息中心)

### 5.5 已报项 (`/supplier/rfq/quoted`)

**数据来源**：`biz_quotation` WHERE `supplier_id = ?`

**列表字段**：
| 字段 | 说明 |
|------|------|
| RFQ编号 | rfq_no |
| 报价日期 | quotation.create_time |
| 物料数量 | quotation_item COUNT |
| 报价总额 | quotation.total_amount |
| 状态 | pending(待开标)/won(已中标)/lost(未中标) |
| 操作 | 查看详情 / 修改报价(截止前可改) |

### 5.6 报价填写界面 (`/supplier/quote/edit/:rfqId`)

采用**分步表单**：

```
Step 1 → 物料清单确认 (只读展示RFQ物料)
Step 2 → 逐项填价 (核心步骤)
Step 3 → 预览提交
```

**Step 2 填价界面**：

```
物料清单表格：
┌──────────┬────────┬──────┬──────┬──────────┬────────┬──────────┐
│ 物料名称  │ 规格    │ 数量  │ 单位  │ 单价(元)* │ 交期(周)│ 备注     │
├──────────┼────────┼──────┼──────┼──────────┼────────┼──────────┤
│ PLC控制器 │ CPU... │ 5    │ 套   │ [___]    │ [___]  │ [______] │
│ 变频器    │ 三相...│ 8    │ 台   │ [___]    │ [___]  │ [______] │
│ 电源模块  │ 24V... │ 20   │ 台   │ [___]    │ [___]  │ [______] │
└──────────┴────────┴──────┴──────┴──────────┴────────┴──────────┘
  含税/未税切换: [●含税] [○未税]  自动计算增值税13%
```

**关键交互**：
- 必填校验：单价 > 0，交期 ≤ RFQ要求
- 智能提示：当输入单价低于该物料历史最低价的80%时 → 警告弹窗"报价异常偏低，请确认"
- 附件上传：产品彩页、资质证书、型式试验报告(新表`biz_quotation_attachment`)
- 自动保存草稿(LocalStorage + 后端每3分钟自动保存)
- 提交前预览比价结果(提示"您的报价在当前排名第X/共Y家")

### 5.7 供应商端API

| 接口 | 方法 | 说明 |
|------|------|------|
| `/supplier/dashboard/stats` | GET | 统计数据总览 |
| `/supplier/rfq/pending` | GET | 可报项列表(分页) |
| `/supplier/rfq/quoted` | GET | 已报项列表(分页) |
| `/supplier/quote/draft/{rfqId}` | GET | 获取草稿报价 |
| `/supplier/quote/save-draft` | POST | 保存报价草稿 |
| `/supplier/quote/submit` | POST | 提交报价 |
| `/supplier/quote/{id}/attachments` | POST | 上传附件 |
| `/supplier/profile` | GET/PUT | 供应商信息维护 |

---

## 六、板块五：甲方报价单

### 6.1 现有基础

`biz_client_quote` 已有基础CRUD，`biz_client_quote_item` 已有明细表。现有页面已支持基本的新建/编辑/PDF导出。

### 6.2 数据模型增强

```sql
-- 增强甲方报价单
ALTER TABLE biz_client_quote ADD COLUMN (
    rfq_id              BIGINT        COMMENT '关联内部RFQ',
    cost_total          DECIMAL(18,4) COMMENT '内部成本合计(供应商中标价汇总)',
    margin_rate         DECIMAL(5,2)  COMMENT '毛利率%',
    quote_version       INT DEFAULT 1 COMMENT '报价版本号',
    parent_quote_id     BIGINT        COMMENT '父报价单ID(版本迭代)',
    project_name        VARCHAR(200)  COMMENT '项目名称',
    validity_date       DATETIME      COMMENT '报价有效期',
    payment_terms       VARCHAR(500)  COMMENT '付款条件',
    delivery_terms      VARCHAR(500)  COMMENT '交货条款',
    status              VARCHAR(20)   COMMENT 'draft/sent/accepted/rejected/revised',
    margin_rate_setting DECIMAL(5,2) DEFAULT 15.00 COMMENT '加价系数(%)',
    tax_rate            DECIMAL(4,2) DEFAULT 13.00 COMMENT '税率(%)'
);

-- 新建甲方报价-物料-供应商关联表(记录每个物料选定的供应商)
CREATE TABLE biz_client_quote_item_source (
    id                  BIGINT AUTO_INCREMENT PRIMARY KEY,
    quote_item_id       BIGINT NOT NULL COMMENT 'biz_client_quote_item.id',
    supplier_id         BIGINT COMMENT '选定的供应商ID',
    supplier_quote_id   BIGINT COMMENT '供应商报价单ID(biz_quotation.quotation_id)',
    unit_cost           DECIMAL(18,4) COMMENT '供应商中标单价(含税)',
    selected_reason     VARCHAR(500) COMMENT '选择该供应商原因',
    internal_note       TEXT COMMENT '内部备注',
    create_by           VARCHAR(64),
    create_time         DATETIME,
    update_by           VARCHAR(64),
    update_time         DATETIME,
    KEY idx_quote_item (quote_item_id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='甲方报价物料来源';
```

### 6.3 业务流程图

```
┌──────────────┐
│  甲方询价需求  │
└──────┬───────┘
       ▼
┌──────────────────┐
│  创建甲方报价单   │ ← 手动输入甲方需求物料
│  (biz_client_quote)│
└──────┬───────────┘
       ▼
┌──────────────────┐
│  生成内部RFQ     │ ← 从甲方物料自动拆解为RFQ
│  (点击"发起询价") │     按品类分多个子RFQ
└──────┬───────────┘
       ▼
┌──────────────────┐
│  指派供应商报价   │ ← 每个子RFQ指派不同供应商
│  (供应商端报价)   │     变频器→A/B/C, 电缆→D/E
└──────┬───────────┘
       ▼
┌──────────────────┐
│  比价选择供应商   │ ← 使用现有智慧比价引擎
│  (选定最优方案)   │
└──────┬───────────┘
       ▼
┌──────────────────┐
│  成本回填         │ ← 自动回填选中供应商价格到
│  (自动/手动同步)  │     biz_client_quote_item_source
└──────┬───────────┘
       ▼
┌──────────────────┐
│  计算对外报价     │ ← 成本 × (1 + 加价系数)
│  生成PDF → 发送甲方 │     可手动调整覆盖
└──────────────────┘
```

### 6.4 甲方报价单详情页重构

```
甲方报价单详情页 (/bid/clientquote/detail/:id)
├── 顶部操作栏
│   ├── 保存草稿 | 导出PDF | 发送甲方 | 版本迭代
│   └── 状态标签(draft/sent/accepted/rejected)
│
├── 基本信息卡片
│   ├── 客户名称 | 项目名称 | 有效期 | 币种
│   ├── 关联RFQ(下拉选择) | 合同号
│   └── 付款条件 | 交货条款
│
├── 物料清单表格(可编辑)
│   ├── 行数据：序号 | 类别 | 物料名称 | 品牌 | 型号规格
│   │          | 数量 | 单位 | 供应商中标价(成本)
│   │          | 加价系数 | 对外含税单价 | 小计
│   ├── 操作：添加行 | 删除行 | 批量导入
│   └── 特殊列：询价状态(未询价/报价中/已回价/已定价)
│       └── 已定价 → 显示供应商名称，点击查看来源
│       └── 未询价 → 点击"发起询价"→ 弹出选择供应商 → 生成子RFQ
│
├── 右侧成本汇总面板(固定)
│   ├── 物料成本合计: ¥XXX (自动汇总供应商中标价)
│   ├── 加价系数: 15% (可调整)
│   ├── 对外报价(含税): ¥XXX = 成本 × (1 + 加价系数)
│   ├── 预计毛利率: XX.X% (实时计算)
│   └── 操作按钮：同步最新采购价 | 重新计算
│
├── Tab: 智能选型对比
│   └── 选中物料 → 弹出对比窗口 → 展示同规格多品牌对比
│       → 一键替换物料型号和成本
│
└── Tab: 历史版本
    └── 版本列表(通过parent_quote_id关联)
        → 版本对比(高亮显示差异)
```

### 6.5 子RFQ生成逻辑

```java
// 从甲方报价单生成内部RFQ
@PostMapping("/bid/clientquote/{id}/generateRfq")
public AjaxResult generateSubRfq(@PathVariable Long id, @RequestBody GenerateRfqRequest req) {
    // 1. 获取甲方报价单主表
    // 2. 根据选中的行物料,按category_id分组
    //    如: 变频器类一组,PLC类一组,电缆类一组
    // 3. 为每组创建子RFQ:
    //    - rfq_title = 甲方报价单项目名 + "(" + 类别名称 + ")"
    //    - deadline = 甲方报价单有效期前7天
    //    - parent_client_quote_id = 甲方报价单ID
    // 4. 将选中物料复制到biz_rfq_item
    // 5. 指派供应商(从req.supplier_ids)
    // 6. 返回生成的RFQ ID列表
}
```

### 6.6 成本回填机制

**自动回填触发点**：
1. 采购单确认时(`biz_purchase_order.status → 'confirmed'`)
2. 甲方报价单页面手动点击"同步最新采购价"

**回填逻辑**：
```java
// 自动回填
@PostMapping("/bid/clientquote/{id}/syncCost")
public AjaxResult syncCost(@PathVariable Long id) {
    // 1. 获取所有子RFQ的最新成交报价
    // 2. 将选中供应商的成交价写入biz_client_quote_item_source
    // 3. 更新biz_client_quote.cost_total
    // 4. 重新计算margin_rate
    // 5. 记录价格变动日志
}
```

**价格变动日志表**：
```sql
CREATE TABLE biz_price_change_log (
    id              BIGINT AUTO_INCREMENT PRIMARY KEY,
    source_type     VARCHAR(20) COMMENT '来源类型(quotation/client_quote)',
    source_id       BIGINT COMMENT '来源ID',
    material_id     BIGINT COMMENT '物料ID',
    old_price       DECIMAL(18,4),
    new_price       DECIMAL(18,4),
    change_reason   VARCHAR(500) COMMENT '变更原因',
    operator        VARCHAR(64),
    create_time     DATETIME
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='价格变动日志';
```

### 6.7 两个报价历史

**历史1：我方给甲方的报价历史**
- 数据源：`biz_client_quote` 通过 `parent_quote_id` 形成版本链
- 功能：版本对比 → 选择两个版本高亮显示价格差异

**历史2：供应商给我方的报价历史**
- 数据源：`biz_quotation_item` 中该物料的历史记录
- 功能：在甲方报价单物料行点击"查看成本来源" → 抽屉展示时间轴

---

## 七、报价单管理与指派系统

### 7.1 报价单详情页 (`/bid/rfq/detail/:id`)

```
RFQ详情页 (/bid/rfq/detail/:id)
├── 顶部：基础信息(合同号/甲方/截止日/状态)
├── 左侧：已邀请供应商列表
│   ├── 供应商名称 | 报价状态(未报价/已报价/已逾期)
│   ├── 已报价 → 显示报价金额及操作(查看详情)
│   └── 未报价 → 显示"催办"按钮(发送通知)
├── 右侧：物料明细及各家报价对比表格
│   ├── 与XLSX Sheet 10-14格式一致
│   ├── 行：物料，列：各供应商单价(最低价绿色高亮)
│   └── 差额/差价自动计算
├── 底部操作栏
│   ├── 确认中标 → 弹出选择中标供应商对话框
│   ├── 重新询价 → 复制当前RFQ生成新版本
│   ├── 导出比价报告(PDF) → 复用现有导出功能
│   └── 关闭询价
```

### 7.2 供应商报价填写界面(供应商端)

见5.6节详细描述。

### 7.3 比价报告PDF

模板格式参考XLSX Sheet 10-14，包含：
- 表头：RFQ编号、项目名称、日期
- 物料对比表：每行展示各供应商报价、最低价标记
- 推荐方案：综合评分推荐最优供应商
- 统计摘要：总价对比、节省金额

---

## 八、电气设备数据初始化方案

### 8.1 数据范围

利用XLSX Sheet 20-31的型号库数据，预置如下初始数据：

| 品类 | 型号数量 | 数据来源Sheet | 对应品牌 |
|------|---------|--------------|---------|
| 变频器 | ~322 | 31_品牌汇总 | 汇川/禾望/西门子/ABB |
| 整流制动单元 | ~100 | 21_整流制动单元库 | 汇川/禾望/西门子 |
| PLC CPU | ~55 | 22_PLC_CPU型号库 | 西门子/三菱/欧姆龙 |
| PLC扩展模块 | ~98 | 23_PLC_扩展模块库 | 西门子/三菱/欧姆龙 |
| 低压电器 | ~75 | 24_低压电器型号库 | 正泰/施耐德 |
| 触摸屏 | ~20 | 25_触摸屏型号库 | 威纶通/昆仑通态/西门子 |
| 铜牌母线 | ~20 | 26_铜牌母线型号库 | TMY铜排 |
| 动力电缆 | ~23 | 27_电缆型号库 | YJV22系列 |
| 控制线 | ~21 | 28_控制线型号库 | KVVP系列 |
| 线槽 | ~18 | 29_线槽型号库 | PVC/钢制 |
| 工业网关 | ~12 | 30_网关型号库 | 汇川/研华 |
| **合计** | **~764** | | |

### 8.2 供应商初始化

基于XLSX比价数据中的供应商，初始化以下供应商：

| 供应商 | 供应品类 | 数据范围 |
|--------|---------|---------|
| A供应商(汇川/正泰等) | 变频器/整流/低压电器 | Sheet 10-14 |
| B供应商(禾望等) | 变频器/整流/PLC | Sheet 10-14 |
| C供应商(西门子/施耐德等) | 变频器/PLC/低压电器 | Sheet 10-14 |

### 8.3 对比组初始化

根据Sheet 10-14比价数据，建立初始对比组：

| 对比组 | 包含品牌 | 数据来源 |
|--------|---------|---------|
| 37kW 380V变频器 | 汇川MD500T37G / 禾望HV500-37G / 西门子G120 / ABB ACS880 | Sheet 10 |
| 55kW 380V变频器 | 汇川MD500T55G / 禾望HV500-55G / 西门子G120 PM240 | Sheet 10 |
| 整流单元75kW | MDR100T75 / HBD-075 / BLM-075 | Sheet 11 |
| CPU 1515-2 PN | 三家供应商报价对比 | Sheet 12 |
| 断路器NXM-125S | 正泰/施耐德/其他 | Sheet 13 |
| 动力电缆YJV 3×70+1×35 | 三家供应商报价对比 | Sheet 14 |

### 8.4 导入策略

**方案一：SQL脚本导入（推荐首批）**
- 将型号库数据编写为 `INSERT` 语句
- 写入 `sql/demo_data.sql` 或新建 `sql/excel_import_data.sql`
- 每个物料生成 `material_code` (如 `M-EL-001`)

**方案二：Excel批量导入功能（后续维护）**
- 通过 `/bid/material/import` 接口
- 上传Excel文件 → EasyExcel解析 → 数据校验 → 批量写入
- 提供下载导入模板功能

---

## 九、开发优先级与里程碑

### 第一阶段：基础数据层（第1-2周）

| 优先级 | 任务 | 涉及文件 |
|--------|------|---------|
| P0 | 物料表字段扩展 + 性能参数JSON动态表单 | `biz_material` + 前端物料表单 |
| P0 | 物料分类树+表格联动 | 复用现有 `BizMaterialCategoryController` |
| P1 | 物料详情页基础框架 + Tab1(供应商历史报价) | 新建 `material/detail.vue` |
| P1 | 供应商-物料关系表 + 供货清单Tab | 新建 `biz_supplier_material` |
| P1 | 物料横向对比组表 + 维护界面 | 新建 `biz_material_comparison` |
| P2 | Excel电气设备型号库数据导入(首批~764条) | 扩充 `demo_data.sql` |

### 第二阶段：业务流程层（第3-5周）

| 优先级 | 任务 | 涉及文件 |
|--------|------|---------|
| P0 | RFQ增强(合同号/甲方/截止日/指派界面) | `biz_rfq` 扩展 + RFQ详情页重构 |
| P0 | 供应商门户独立路由 + 可报项/已报项列表 | 新建 `views/supplier/*` |
| P0 | 供应商报价填写界面(分步表单) | 新建 `supplier/quote-edit.vue` |
| P1 | 供应商账号管理(账号创建/权限分配) | `sys_user` user_type扩展 |
| P1 | 甲方报价单增强(子RFQ生成) | `BizClientQuoteController` |
| P1 | 成本回填机制(自动+手动触发) | 新建 `biz_client_quote_item_source` |
| P2 | 物料详情Tab2(甲方历史报价) | 扩展 `material/detail.vue` |

### 第三阶段：智能分析层（第6-8周）

| 优先级 | 任务 | 涉及文件 |
|--------|------|---------|
| P1 | 物料详情Tab3(横向同比+推荐算法) | 扩展 `material/detail.vue` |
| P1 | 甲方报价单智能选型对比 | `BizComparisonService` 扩展 |
| P2 | 价格趋势ECharts折线图(物料详情页) | 物料详情右栏 |
| P2 | 供应商报价历史趋势ECharts | 供应商详情Tab4 |
| P2 | 价格预警机制(高于均价15%红色高亮) | 前端表格渲染 |
| P3 | 比价报告PDF增强 | 复用现有JSPDF导出 |

### 第四阶段：优化完善（第9-10周）

| 优先级 | 任务 | 涉及文件 |
|--------|------|---------|
| P2 | 版本对比(甲方报价单历史版本diff) | 扩展 `client-quote` |
| P2 | 批量导入Excel型号库(维护界面) | `/bid/material/import` |
| P3 | 供应商端多语言/国际化 | i18n配置 |
| P3 | 性能优化(物料列表大数据量分页) | 后端分页+前端虚拟滚动 |
| P3 | Docker部署配置更新 | `deploy/` |

---

## 十、关键接口清单

### 物料模块
| 接口 | 方法 | 说明 | 优先级 |
|------|------|------|--------|
| `/bid/material/detail/{id}` | GET | 物料详情+历史报价摘要 | P0 |
| `/bid/material/{id}/supplier-quotes` | GET | 供应商历史报价清单 | P0 |
| `/bid/material/{id}/client-quotes` | GET | 我方给甲方历史报价 | P1 |
| `/bid/material/{id}/comparison` | GET | 横向对比数据 | P1 |
| `/bid/material/manufacturer/list` | GET | 厂家下拉列表(去重) | P0 |
| `/bid/material/import` | POST | Excel批量导入 | P1 |
| `/bid/material/export` | GET | 导出模板 | P1 |
| `/bid/material/suggest` | GET | 型号智能联想 | P2 |

### 供应商模块
| 接口 | 方法 | 说明 | 优先级 |
|------|------|------|--------|
| `/bid/supplier/{id}/materials` | GET | 供货清单(分页) | P0 |
| `/bid/supplier/{id}/materials` | POST | 添加供应物料 | P1 |
| `/bid/supplier/{id}/quotes` | GET | 报价单管理列表 | P1 |
| `/bid/supplier/{id}/price-trend` | GET | 历史报价趋势 | P2 |
| `/bid/supplier/{id}/accounts` | GET | 供应商账号列表 | P1 |
| `/bid/supplier/{id}/accounts` | POST | 创建供应商账号 | P2 |

### RFQ模块
| 接口 | 方法 | 说明 | 优先级 |
|------|------|------|--------|
| `/bid/rfq/{id}/assign` | POST | 指派供应商 | P0 |
| `/bid/rfq/{id}/comparison` | GET | 比价结果(现有增强) | P0 |
| `/bid/rfq/{id}/bid-report` | GET | 导出比价报告PDF | P1 |
| `/bid/rfq/{id}/winner` | POST | 确认中标供应商 | P1 |

### 供应商端
| 接口 | 方法 | 说明 | 优先级 |
|------|------|------|--------|
| `/supplier/dashboard/stats` | GET | 统计数据总览 | P0 |
| `/supplier/rfq/pending` | GET | 可报项列表 | P0 |
| `/supplier/rfq/quoted` | GET | 已报项列表 | P0 |
| `/supplier/quote/draft/{rfqId}` | GET | 获取草稿报价 | P0 |
| `/supplier/quote/save-draft` | POST | 保存报价草稿 | P0 |
| `/supplier/quote/submit` | POST | 提交报价 | P0 |
| `/supplier/quote/{id}/attachments` | POST | 上传附件 | P1 |

### 甲方报价单
| 接口 | 方法 | 说明 | 优先级 |
|------|------|------|--------|
| `/bid/clientquote/{id}/generateRfq` | POST | 生成子RFQ | P0 |
| `/bid/clientquote/{id}/syncCost` | POST | 同步采购成本 | P1 |
| `/bid/clientquote/{id}/compareSpec` | GET | 智能选型对比 | P1 |
| `/bid/clientquote/{id}/versions` | GET | 历史版本列表 | P2 |
| `/bid/clientquote/version-compare` | POST | 版本对比diff | P2 |
| `/bid/clientquote/{id}/export-pdf` | GET | 导出PDF | P0(现有) |

---

## 十一、权限与安全设计

### 11.1 权限矩阵

| 角色 | 物料 | 供应商 | RFQ | 供应商报价 | 比价 | 甲方报价 | 供应商门户 |
|------|------|--------|-----|-----------|------|---------|-----------|
| 管理员 | CRUD | CRUD | CRUD | CRUD | 查看 | CRUD | 不可访问 |
| 采购员 | 查看 | 查看/编辑 | CRUD | 查看 | 查看/操作 | 查看 | 不可访问 |
| 销售员 | 查看 | 查看 | 查看 | 查看 | 查看 | 创建/编辑 | 不可访问 |
| 供应商 | 查看(仅关联) | 查看(仅自己) | 查看(受邀) | 查看(仅自己) | 不可见 | 不可见 | 报价/查看 |

### 11.2 数据权限

- **租户隔离**：所有业务表已有 `tenant_id`，查询SQL必须带 `tenant_id = ?`
- **供应商隔离**：供应商账号 `user_type=2`，所有查询追加 `supplier_id = ?`
- **价格脱敏**：供应商看不到其他供应商的报价价格（但可以看到自己的排名）

### 11.3 安全措施

- **价格字段加密**：敏感价格字段在数据库中使用AES加密存储，接口返回时按角色脱敏
- **乐观锁防并发**：`biz_quotation` 增加 `version` 字段，供应商报价提交时CAS检查
- **操作日志**：所有CRUD操作使用RuoYi `@Log` 注解记录
- **文件上传校验**：限制附件类型(pdf/jpg/png)，大小≤10MB

---

## 附录：Excel数据对照表

### XLSX → 系统表映射

| Excel Sheet | 对应系统表 | 说明 |
|------------|-----------|------|
| 01_项目报价单 | `biz_client_quote` + `biz_client_quote_item` | 甲方报价模板映射 |
| 02_报价汇总 | `biz_client_quote` (汇总字段) | 汇总逻辑直接实现 |
| 10-14_比价表 | `biz_quotation` + `biz_comparison`(已有) | 比价数据初始化来源 |
| 20-30_型号库 | `biz_material` | 初始物料数据(764条) |
| 31_品牌汇总 | 统计查询 | 直接SQL统计实现 |

### XLSX比价表 → 系统比价引擎字段映射

| Excel列 | 系统字段 | 说明 |
|---------|---------|------|
| A供应商型号 | quotation_item.material_name/spec | 报价物料 |
| A供应商报价 | quotation_item.unit_price | 供应商A报价单价 |
| B供应商型号 | quotation_item.material_name/spec | 报价物料 |
| B供应商报价 | quotation_item.unit_price | 供应商B报价单价 |
| 最低价 | BizComparisonVO.minPrice | 当前最低价(系统自动计算) |
| 推荐 | BizComparisonVO.recommendedSupplier | 评分最优推荐 |

---

> 本文档基于PPT《报价比对系统》(6页) + XLSX《电气自动化设备综合管理系统_V1》(27Sheet) + 现有项目源码(RuoYi-Vue v3.9.2, 12个已完成模块)综合分析生成，可直接作为迭代开发的技术参考。
>
> 最后更新：2026-05-27