# PRD - 报价管理系统前台 V1.2.3

**版本**：V1.2.3
**创建日期**：2026-06-04
**产品负责人**：耿功发
**状态**：草稿

---

### 1. 概述

#### 1.1 背景
当前前台 `V1.2` 已具备登录、项目列表、报价计算器、报价详情、报价单资料、导出等主流程能力，但在 `1440` 分辨率适配、前台页面国际化治理、示例说明展示规范、报价计算器文案统一和汇率计算口径方面仍需补齐。本版优先聚焦前台体验一致性和可交付性。

#### 1.2 目标
- 优先完成前台页面对 `1440 x 900` 分辨率的稳定支持。
- 消除前台页面硬编码语言，建立稳定的前台语言文件和术语表。
- 统一 `示例说明` 的展示尺寸、方向和放大查看交互。
- 完成前台报价计算器 8 大模块的文案统一，其中 `CCG / CQCG` 对应字段名称统一为 `产品类型（出图精度）`。
- 明确前台报价计算器支持按 `月 / 周 / 日 / 实时` 四种汇率模式计算的统一口径。

#### 1.3 关联文档
- MRD：待补充
- 用户故事集：[UC-003-quotation-management-system-V1.2.md](/Users/summer/Documents/AI/Yitou/quote-estimator/documents/use-cases/UC-003-quotation-management-system-V1.2.md)
- 功能用例集：[PRD-003A-quotation-frontend-V1.2.md](/Users/summer/Documents/AI/Yitou/quote-estimator/documents/prd/PRD-003A-quotation-frontend-V1.2.md)

### 2. 功能需求矩阵

| 功能ID | 功能名称 | 关联用例 | 优先级 | 状态 |
|--------|---------|---------|--------|------|
| F001 | 前台 `1440` 分辨率适配 | UC-003 | Must | 待开发 |
| F002 | 前台版本语言国际化治理 | UC-003 | Must | 待开发 |
| F003 | 示例说明统一展示与大图查看 | UC-003 | Must | 待开发 |
| F004 | 报价计算器前台文案调整 | UC-003 | Must | 待开发 |
| F005 | 前台报价计算器支持多汇率模式实时计算 | UC-003 | Must | 待开发 |

### 3. 功能详细说明

#### F001: 前台 `1440` 分辨率适配

**描述**：本版优先支持前台在 `1440 x 900` 分辨率下稳定使用，确保核心页面在不依赖浏览器缩放的情况下可正常浏览与操作。

**交互流程**：
1. 用户在 `1440 x 900` 分辨率下访问前台页面。
2. 系统按当前页面类型加载对应布局。
3. 页面主信息区、主操作区、弹窗区和底部按钮区在 `1440 x 900` 下保持可见、可操作、无关键内容遮挡。
4. 若页面内容超出可视区域，应通过页面内部滚动或区域滚动解决，不得导致关键按钮、关键信息或主操作无法使用。

**页面范围**：
- 登录页面
- 修改密码页面
- 项目列表页面
- 报价详情里的 `报价历程` 弹出页面
- 报价单资料页面
- 报价导出页面
- 报价计算器页面

**界面原型**：待补充

#### F002: 前台版本语言国际化治理

**描述**：前台版本需完成一轮国际化治理，禁止继续在前台页面中保留用户可见的硬编码语言，并建立稳定的语言文件和术语表体系。

**交互流程**：
1. 前台页面加载时，系统根据当前语言配置读取对应语言文件。
2. 页面中的导航、按钮、标签、表头、提示文案、弹窗文案、空状态文案等均从语言文件取值。
3. 前台页面不得直接写死用户可见文本。
4. 系统建立一套稳定的语言文件，并基于该语言文件执行翻译维护。
5. 系统建立术语表，用于统一前台关键业务术语在不同语言下的翻译口径。

**治理要求**：
- 无硬编码的语言。
- 抽出一套语言文件。
- 定义术语表。
- 根据一套稳定的语言文件翻译。
- 若沿用 `V1.2` 既有语言范围，则至少覆盖 `中文 / 日文 / 英文`。

**界面原型**：待补充

#### F003: 示例说明统一展示与大图查看

**描述**：前台中涉及 `示例说明` 的展示方式统一调整为固定大小、固定方向展示，并支持点击查看大图。

**交互流程**：
1. 用户进入包含 `示例说明` 的前台页面或模块。
2. 系统以统一的固定大小、固定方向展示 `示例说明` 缩略内容。
3. 用户点击当前 `示例说明` 后，系统弹出或覆盖展示大图。
4. 用户可在大图查看状态下关闭并返回原页面。

**展示要求**：
- `示例说明` 缩略展示尺寸统一。
- `示例说明` 展示方向统一，不因来源图片尺寸不同而出现混乱排版。
- 点击后显示大图。

**界面原型**：待补充

#### F004: 报价计算器前台文案调整

**描述**：本版统一调整前台报价计算器中的页面文案与术语口径，覆盖报价计算器 8 大模块相关前台文案，避免旧文案、新文案并存。

**交互流程**：
1. 用户进入前台报价计算器页面。
2. 系统按最新 `V1.2.3` 文案口径展示字段名、说明文案和业务术语。
3. 所有已确认调整的字段名需在页面、弹窗、摘要和相关联文案中保持一致。

**文案调整范围**：
- `楼宇`
- `专有部`
- `色彩切换`
- `共用部`
- `办公室`
- `动画`
- `平面家具摆放`
- `系统收费`

**当前已确认的必做文案调整**：
- `CCG / CQCG` 对应的选项名称，统一修改为：`产品类型（出图精度）`。

**文案要求**：
- 前台报价计算器页面不得混用新旧术语。
- 当前版本中已确认的字段名称调整，需在 8 大模块相关前台展示位统一生效。
- 8 大模块中的页面标题、字段名、说明文案、摘要文案、提示文案需保持统一口径。

**界面原型**：待补充

#### F005: 前台报价计算器支持多汇率模式实时计算

**描述**：前台报价计算器的金额计算需支持按 `月 / 周 / 日 / 实时` 四种汇率模式执行。系统根据当前生效的汇率模式读取对应汇率规则，并在用户计算报价时实时刷新结果。

**交互流程**：
1. 用户进入前台报价计算器页面。
2. 系统获取当前生效的汇率模式，作为本次报价计算依据。
3. 若汇率模式为 `按月`，则取当月第一次有效收盘汇率作为当月统一汇率；若当月尚未形成首次有效收盘汇率，则沿用上个月汇率。
4. 若汇率模式为 `按周`，则取当周第一次有效收盘汇率作为当周统一汇率；若当周尚未形成首次有效收盘汇率，则沿用上周汇率。
5. 若汇率模式为 `按日`，则取当日最新已生效汇率作为当日统一汇率；若当日暂无新汇率，则沿用上一日汇率。
6. 若汇率模式为 `实时`，则系统在用户进入页面或调整参数时获取当前最新可用汇率参与计算。
7. 用户在报价计算器中修改模块、参数、数量等信息时，系统按当前生效汇率模式对应的汇率实时刷新报价结果。

**计算要求**：
- 前台报价计算器需支持 `按月 / 按周 / 按日 / 实时` 四种汇率模式。
- `按月 / 按周 / 按日` 模式下，同一统计周期内使用同一条已生效汇率。
- 周期汇率未生效前，沿用上一个已生效周期汇率。
- `实时` 模式下，每次进入页面或触发重新计算时，均按当前最新可用汇率参与计算。
- 前台报价计算器涉及报价项金额计算时，统一按 `工时 × 固定成本 × 系数 × 汇率` 执行。

**界面原型**：待补充

### 4. 非功能需求

| 维度 | 指标 | 要求 |
|------|------|------|
| 兼容性 | 分辨率支持 | 本版优先确保前台在 `1440 x 900` 下可稳定使用 |
| 可用性 | 页面可操作性 | `1440 x 900` 下关键按钮、关键表单项、关键弹窗内容不得因布局问题不可操作 |
| 国际化 | 文本治理 | 前台用户可见文本不得直接硬编码在页面实现中 |
| 国际化 | 术语一致性 | 同一业务术语在前台不同页面使用统一翻译口径 |
| 可维护性 | 语言资源管理 | 前台需使用统一语言文件管理可见文案 |
| 可用性 | 示例说明体验 | 缩略图展示规则统一，点击查看大图路径明确 |
| 一致性 | 汇率计算口径 | 前台报价计算器必须按当前生效汇率模式与对应周期规则计算 |

### 5. 国际化配置表

| Key | 中文 | 英文 | 备注 |
|-----|------|------|------|
| app.frontend.locale.no_hardcode | 前台用户可见文本不得硬编码 | Frontend user-facing text must not be hard-coded | 国际化治理原则 |
| app.frontend.locale.glossary | 术语表 | Glossary | 用于统一业务术语翻译 |
| app.frontend.locale.source | 稳定语言文件 | Stable locale files | 统一翻译来源 |
| quote.calculator.product_type_precision | 产品类型（出图精度） | Product Type (Output Precision) | `CCG / CQCG` 对应字段名称 |
| quote.example.preview | 示例说明 | Example Reference | 示例说明统一展示入口 |
| quote.example.preview_enlarge | 点击查看大图 | Click to view large image | 示例说明交互文案 |

### 6. 基础数据

系统运行所需的初始数据（枚举值、配置项等）：

| 数据类型 | 内容 | 维护方式 |
|---------|------|---------|
| 分辨率基线 | `1440 x 900` | 系统设计基线 |
| 前台语言范围 | `中文`、`日文`、`英文` | 系统初始化 / 语言文件维护 |
| 术语表 | 前台统一业务术语映射清单 | 产品维护 |
| 示例说明展示规则 | 固定大小、固定方向、点击查看大图 | 系统初始化 |
| 报价计算器字段名 | `产品类型（出图精度）` | 产品维护 / 语言文件维护 |
| 前台汇率模式 | `按月 / 按周 / 按日 / 实时` | 后台配置下发 |
| 前台周期汇率规则 | `按月` 取当月第一次有效收盘；`按周` 取当周第一次有效收盘；`按日` 取当日最新已生效；`实时` 取当前最新可用汇率 | 系统初始化 |
| 前台报价项计算公式 | `工时 × 固定成本 × 系数 × 汇率` | 系统初始化 |

### 7. 验收标准

| AC 编号 | 功能 | Given | When | Then |
|---------|------|-------|------|------|
| AC-001 | F001 | 用户在 `1440 x 900` 分辨率下进入登录页或修改密码页 | 页面加载完成 | 主表单、主按钮和必要提示完整可见且可操作 |
| AC-002 | F001 | 用户在 `1440 x 900` 分辨率下进入项目列表页、报价单资料页、报价导出页或报价计算器页 | 页面加载完成 | 页面主内容区、主操作区和关键按钮完整可见且可操作 |
| AC-003 | F001 | 用户在 `1440 x 900` 分辨率下打开报价详情里的 `报价历程` 弹出页面 | 弹出页面展示完成 | 弹窗内容、关闭操作和关键信息可见且可操作 |
| AC-004 | F002 | 前台页面加载用户可见文本 | 系统渲染页面 | 页面文本均从语言文件取值，不直接硬编码 |
| AC-005 | F002 | 产品或研发检查前台国际化资源 | 检查语言配置 | 系统存在一套稳定语言文件和一份术语表，并据此维护翻译 |
| AC-006 | F003 | 用户进入包含 `示例说明` 的前台页面 | 系统展示示例说明 | 缩略内容按统一固定大小、固定方向展示 |
| AC-007 | F003 | 用户点击 `示例说明` | 系统响应点击 | 系统显示对应大图，并允许关闭返回原页面 |
| AC-008 | F004 | 用户进入前台报价计算器页面 | 页面加载完成 | `CCG / CQCG` 对应字段名称统一展示为 `产品类型（出图精度）` |
| AC-009 | F004 | 用户在报价计算器相关展示位查看该字段 | 页面展示字段名、说明或相关摘要 | 不得同时出现旧名称和新名称混用 |
| AC-010 | F004 | 用户进入前台报价计算器 8 大模块相关页面或模块区域 | 页面加载完成 | 8 大模块中的标题、字段名、说明文案、摘要文案与提示文案按 `V1.2.3` 统一口径展示，不得混用旧文案 |
| AC-011 | F005 | 当前生效汇率模式为 `按月`，且当前月份已生成首次有效收盘汇率 | 用户进入前台报价计算器页面并开始计算 | 系统按当月统一汇率实时计算报价 |
| AC-012 | F005 | 当前生效汇率模式为 `按周`，且当前周已生成首次有效收盘汇率 | 用户进入前台报价计算器页面并开始计算 | 系统按当周统一汇率实时计算报价 |
| AC-013 | F005 | 当前生效汇率模式为 `按日`，且当日已有最新已生效汇率 | 用户进入前台报价计算器页面并开始计算 | 系统按当日统一汇率实时计算报价 |
| AC-014 | F005 | 当前生效汇率模式为 `实时` | 用户进入前台报价计算器页面或调整参数 | 系统按当前最新可用汇率实时刷新报价结果 |
| AC-015 | F005 | `按月` 或 `按周` 模式下，当前周期首日因节假日或休市暂无数据 | 系统获取当前周期汇率 | 系统取当前周期首个开盘交易日对应的首次有效收盘汇率作为当前周期统一汇率 |
| AC-016 | F005 | `按月 / 按周 / 按日` 模式下，当前周期尚未形成有效汇率 | 用户在前台报价计算器中进行报价 | 系统按上一个已生效周期汇率计算，直到当前周期汇率更新 |

### 8. 发布计划

| 里程碑 | 日期 | 内容 |
|--------|------|------|
| PRD 评审 | 待排期 | 确认 `1440` 支持范围、国际化治理范围、示例说明交互、文案调整口径和前台多汇率模式规则 |
| 开发联调 | 待排期 | 完成前台页面适配、语言资源整理、示例说明展示、文案统一和报价计算器多汇率模式接入 |
| 正式发布 | 待排期 | 纳入前台 `V1.2.3` 发布 |

### 9. 风险与依赖

| 风险/依赖 | 类型 | 影响 | 应对 |
|-----------|------|------|------|
| 前台各页面当前布局差异较大，`1440` 适配工作量不均 | 风险 | 中 | 先按本版列出的页面范围逐页验收 |
| 现有前台页面存在硬编码语言残留 | 风险 | 高 | 实施前先完成前台文本盘点，再统一迁入语言文件 |
| 术语表未先行定义会导致多语言翻译再次分叉 | 依赖 | 中 | 先输出术语表，再批量修正文案 |
| `示例说明` 原始素材尺寸和方向可能不统一 | 依赖 | 中 | 统一前台展示规则，原始素材由展示层适配 |
| 前后台若使用不同汇率模式或周期规则会导致前台试算与后台保存结果不一致 | 风险 | 高 | 前后台统一按同一套 `月 / 周 / 日 / 实时` 模式定义实现并联合验收 |