docs(README): 更新前端生成Excel订单采购报表的技术文档

README.md

@@ -26,89 +26,67 @@ npm install --registry=https://registry.npmmirror.com
 
 
 
-模块TODO：
-1. [x] 公告管理
-2. [x] 订单管理
-3. [x] 理赔管理
-4. [ ] 综合搜索
-    1. [x] 发货状态查询
-    2. [x] 发票及开票信息查询
-5. [x] 投诉管理
-
-## 会议纪要 TODO（自动生成）
-
-来源：doc/库比森交流会议纪要.xlsx（Sheet1）
-
-- 预测功能
-  - [x] 预测数量默认值设为 0（急）
-  - [ ] 预测物料明细分页展示（否）
-  - [x] 若预算月份已存在，禁用“新增预测”（急）
-  - [ ] 明细表头增加“品牌”下拉，支持多品牌（否）
-  - [ ] 明细列表支持复选框批量删除，未提交数据可删除（中）
-  - [ ] 导出预测：不再重复选择年月；列表首列增加复选框按选择导出；工厂导入包含两个 sheet：数据明细 与 所有经销商物料汇总（去掉经销商列）（急）
-
-- 订单管理
-  - [x] 编辑明细首次保存留在当前页，可继续编辑；修复保存后返回列表看不到的问题（急）
-  - [x] 详情页：已提交的物料明细不可编辑；未提交可编辑数量并删除行（急）
-  - [ ] 明确单价是否含税，需与客户确认（否）
-  - [ ] 库存不足可提交订单，仅提示不限制（中）
-  - [ ] 订单主表显示行数；查询页可见每单行数（中）
-  - [ ] 支持模糊搜索物料，弹窗多选添加（中）
-  - [x] 订单列表：订单编码可点击直达详情，移除“查看”按钮（急）
-  - [ ] 订单提交后状态应变更，排查为何仍为“草稿”（急） ——U9接口
-  - [x] 已提交订单禁用“提交”按钮，状态列展示“已提交”（急）
-  - [ ] 搜索新增“物料”条件，可查含某物料的订单（中）
-  - [ ] 工厂端新增“订单查询/审核”功能，用于批准发货（急） -- 待确认
-  - [ ] 明细编辑页：操作列冻结，首列增加复选框用于删除（未标注）
-
-- 整体的 UI/规范
-  - [ ] 前端规范：搜索/查询入口统一放右侧（中）
-  - [ ] 后端规范：多表操作需加事务（否）
-  - [ ] 单据号统一采用客户规则并提供维护机制，避免随机生成（否）
-
-## 会议纪要 TODO（重排视图）
-
-说明：以下仅对上方“会议纪要 TODO（自动生成）”选中片段进行重排与格式化；未更改原内容。每个分类内按优先级：急 > 中 > 否 排列，保留完成状态与备注。
-
-- 预测功能
-  - 急
-    - [x] 预测数量默认值设为 0（急）
-    - [x] 若预算月份已存在，禁用“新增预测”（急）
-    - [ ] 导出预测：不再重复选择年月；列表首列增加复选框按选择导出；工厂导入包含两个 sheet：数据明细 与 所有经销商物料汇总（去掉经销商列）（急） 
-        - 两个预测导出，哪个不需要重复选择？
-        - 需要导入接口
-  - 中
-    - [ ] 明细列表支持复选框批量删除，未提交数据可删除（中）
-      - 预测功能的提交、未提交状态是怎么判定的
-  - 否
-    - [ ] 预测物料明细分页展示（否）
-    - [ ] 明细表头增加“品牌”下拉，支持多品牌（否）
-        - 表头增加品牌下拉什么意思？
-
-- 订单管理
-  - 急
-    - [x] 编辑明细首次保存留在当前页，可继续编辑；修复保存后返回列表看不到的问题（急）
-    - [x] 详情页：已提交的物料明细不可编辑；未提交可编辑数量并删除行（急）
-    - [x] 订单列表：订单编码可点击直达详情，移除“查看”按钮（急）
-    - [ ] 订单提交后状态应变更，排查为何仍为“草稿”（急） ——U9接口
-        - 接口逻辑里需要变更状态
-    - [x] 已提交订单禁用“提交”按钮，状态列展示“已提交”（急）
-  - 中
-    - [x] 库存不足可提交订单，仅提示不限制（中）
-    - [x] 订单主表显示行数；查询页可见每单行数（中）
-    - [x] 支持模糊搜索物料，弹窗多选添加（中） -- 什么ui结构？
-    - [ ] 搜索新增“物料”条件，可查含某物料的订单（中）
-      - 需要接口: 根据物料id搜索包含该物料的主订单
-    - [ ] 工厂端新增“订单查询/审核”功能，用于批准发货（急） -- 待确认 备注：原括号标注为“急”，为保持原文未调整优先级归类。
-  - 否
-    - [ ] 明确单价是否含税，需与客户确认（否）
-      - 确认是否需要
-    - [x] 明细编辑页：操作列冻结，首列增加复选框用于删除（未标注） 备注：此项未标注优先级，保留原状态。
-        - 完成，但是现在只有新增的时候才能编辑，已经提交的表单明细删除需要接口支持
-
-- 整体的 UI/规范
-  - 中
-    - [ ] 前端规范：搜索/查询入口统一放右侧（中）
-  - 否
-    - [ ] 后端规范：多表操作需加事务（否）
-    - [ ] 单据号统一采用客户规则并提供维护机制，避免随机生成（否）
+# 前端生成 Excel 订单采购报表技术文档
+
+---
+
+## 1. 设计目标
+
+- **每个订单一个 Sheet**，Sheet 名称为订单号（如 `ORD100`）
+- 支持中文、数字、金额格式化、公式自动计算
+- 包含标题、表头、数据行、**子总计（合）**、**总计（计）**
+- 支持样式：合并单元格、边框、背景色、列宽
+- 支持前端直接导出 `.xlsx` 文件（无需后端）
+
+---
+
+## 2. Excel 结构解析（基于图片样例）
+
+> **注意**：图片中的表格内容为 **样例数据**，仅用于展示结构与字段含义，**实际数据由后端 API 提供**
+
+### 2.1 整体结构（单个 Sheet 示例）
+
+| 行号 | 内容 | 说明 |
+|------|------|------|
+| 1 | `订单采购汇总 - ORD100` | 标题，合并 A1:G1，居中，加粗 |
+| 3 | 表头行 | 固定列名 |
+| 4 | 数据行 | 订单明细（本例仅1行） |
+| 5 | `合` | 子总计（当前订单小计） |
+| 6 | `计` | 总计（若单订单则与“合”相同） |
+
+---
+
+### 2.2 字段定义（表头 + 数据行）
+
+| 列 | 字段名 | 数据类型 | 示例值 | 说明 |
+|----|--------|----------|--------|------|
+| A | 订单号 | 字符串 | `ORD100` | 主键，Sheet 名称来源 |
+| B | 项目名称 | 字符串 | `项目A` | 项目描述 |
+| C | 供应商 | 字符串 | `供应商1` | 供应商名称 |
+| D | 采购数量 | 数字 | `1570128` | 整数或浮点数 |
+| E | 采购单价 | 字符串 | `23.5-25.0` | 支持范围或固定值 |
+| F | 采购金额 | 数字 | `36928.00` | `数量 × 单价`（可公式计算） |
+| G | 付款金额 | 数字 | `12.4952855` | 实际支付金额 |
+
+> **公式建议**：
+> - F列：`=D行 * 平均单价`（需解析 E 列范围取中值）
+> - “合”行：`=SUM(D4:D4)`、`=SUM(F4:F4)`、`=SUM(G4:G4)`
+> - “计”行：同“合”（单订单）或多订单时跨行求和
+
+---
+
+### 2.3 样式要求（参考图片）
+
+| 元素 | 样式 |
+|------|------|
+| 标题行（A1:G1） | 合并单元格、加粗、14号字、居中 |
+| 表头行 | 蓝色背景、白字、加粗 |
+| 数据行 | 标准字体，金额列保留2位小数 |
+| “合”/“计”行 | 浅黄色背景、加粗 |
+| 绿色高亮区域 | 可编辑输入区域（如 D5:G5） |
+| 红色边框 | 整表外边框（可选） |
+| 列宽 | 自动或固定（建议：A:15, B:20, 其余:12） |
+
+---
+
+## 3. 数据输入格式（前端接收的 JSON）