# 报价系统 1.3.0 需求说明

### 修订记录

| 日期 | 修订人 | 修订内容 | 依据 |
|------|-------|---------|------|
| 2026-07-07 | 沈彤辉 | 删除业务日志板块 | 07-07 需求评审会议 |
| 2026-07-07 | 沈彤辉 | 汇率改为全局单一值手动录入，去模式概念 | 07-07 需求评审会议 |
| 2026-07-07 | 沈彤辉 | 删除 CG管理/CG下载/制作单导出，新增 API 输出接口 | 07-07 需求评审会议 |
| 2026-07-07 | 沈彤辉 | 系统收费纳入分成，默认日本 0% 南京 100% | 07-07 需求评审会议 |

---

### F001 隐藏税项配置菜单

`报价配置` 下的 `税项配置` 菜单隐藏。当前税项不参与计算，按钮留着容易误操作。

### F002 分成比例 — 系统收费纳入

已有分成比例功能，本次只加一件事：把 `系统收费` 纳入分成结构，默认日本 0%、南京 100%。后续要调直接改比例就行。

### F003 汇率设置

**只有一个全局汇率**，人民币兑日元，保留两位小数，管理员手动录入。不搞什么月/周/日模式，也不需要自动抓取。

**汇率快照规则**：
- 创建报价时取当前汇率，存进报价单
- 待提交审核、待审核状态沿用创建时的汇率，不因后续汇率变化自动变
- 被退回或审核不通过重新编辑时，取当前最新汇率重算
- 报价详情里显示当次用的汇率（给销售看），导出给客户的文件不显示

**价格计算顺序**：先按工时、固定成本、系数算出人民币价格，再乘汇率得日元价格。最终取整沿用旧规则。

### F004 工时设置

价格公式从 `工时 × 300 × 20` 改为 `工时 × 固定成本 × 系数 × 汇率`。

后台按报价项维护：工时、固定成本、系数。每个报价项都应有公式，不同项的固定成本可以不同（比如 CG 100、开发 220）。批量设置可以走脚本，不一定做页面。

**旧数据迁移**：用脚本处理，不手工改。

迁移公式：`系数 = (旧日元价格 ÷ 20) ÷ (工时 × 固定成本)`。固定成本默认值先用 100，迁移后后台能改。

示例 — 阳台外立面数：
- 原：1.5h × 300 × 20 = 9000 日元
- 还原：9000 ÷ 20 = 450（人民币基准价）
- 系数：450 ÷ (1.5 × 100) = 3
- 新公式：1.5 × 100 × 3 × 汇率，汇率=20 时仍得 9000 日元

### F005 合同下载（占位）

- 前端：入口隐藏
- 后端：先做模板配置能力——管理员能上传/更新 Word 模板，配置占位符和项目字段的映射
- 完整下载功能等运营部提供正式合同模板后再做（需确认：模板格式、甲乙方字段、合同金额、报价明细是否作附件、输出 Word 还是 PDF）

### F006 报价输出接口

提供 API 让外部系统读取报价项和公式（排期、SOP、AI 等用）。输出：报价项名称、工时、固定成本、系数、公式。要设计权限校验——谁能调、管理员怎么授权、内外系统都要校验。

---

### 验收标准

| AC | 功能 | Given | When | Then |
|----|------|-------|------|------|
| AC-01 | F001 | 进入报价配置 | 看二级菜单 | 没有税项配置 |
| AC-02 | F002 | 进入分成比例 | 看模块列表 | 系统收费在列表里，默认日本0%南京100% |
| AC-03 | F002 | 改日本分成比例 | 保存 | 南京自动=100%-日本 |
| AC-04 | F003 | 管理员录入汇率 | 保存 | 全局汇率更新，记录 ID+值+时间 |
| AC-05 | F003 | 创建报价 | 报价生成 | 按当前汇率计算，汇率快照存进报价单 |
| AC-06 | F003 | 待提交审核/待审核的报价 | 后台汇率变了 | 报价金额不变 |
| AC-07 | F003 | 退回/不通过的报价 | 重新编辑 | 按最新汇率重算 |
| AC-08 | F003 | 看报价详情 | — | 显示当次汇率 |
| AC-09 | F003 | 导出报价给客户 | — | 不显示汇率 |
| AC-10 | F004 | 进报价配置 | 看工时设置 | 能维护工时/固定成本/系数 |
| AC-11 | F004 | 有旧报价项 | 执行迁移 | 系数 = (旧日元价÷20) ÷ (工时×固定成本) |
| AC-12 | F004 | 创建/查看/导出报价 | — | 金额按 工时×固定成本×系数×汇率 算 |
| AC-13 | F005 | 前端 | — | 下载管理入口隐藏 |
| AC-14 | F005 | 后端 | 管理员操作 | 能上传/更新合同模板，配置占位符映射 |
| AC-15 | F006 | 外部系统调 API | 有权限 | 返回报价项和公式 |
| AC-16 | F006 | 外部系统调 API | 没权限 | 返回错误 |

### 风险与依赖

| 事项 | 类型 | 说明 |
|------|------|------|
| 合同模板 | 依赖 | 需运营部提供正式模板后才能做完整下载功能；后端模板配置可以先做 |