# OM-001 报价管理系统前台操作手册

**版本**：V1.0  
**整理日期**：2026-05-18  
**适用系统**：`http://homevista-quotation.yitouchina.cn/login`  
**测试账号**：`genggongfa`  
**账号角色**：`报价人员`

---

## 1. 手册说明

本手册基于 2026-05-18 的实际页面操作整理，覆盖当前账号可访问的前台报价端主流程：

1. 登录系统
2. 查看项目列表
3. 新建项目
4. 新建报价并配置报价计算器
5. 保存报价
6. 查看报价详情
7. 维护报价单资料
8. 导出报价
9. 提交审核

说明：

- 当前账号登录后进入前台报价端 `sales` 模块，未进入后台管理端。
- 本手册中的截图来自实际操作过程。
- 演示过程中创建了 1 个测试项目和 1 条测试报价，用于验证完整流程。

---

## 2. 登录系统

### 操作步骤

1. 打开登录页：`http://homevista-quotation.yitouchina.cn/login`
2. 输入账号：`genggongfa`
3. 输入密码：`genggongfa123`
4. 点击 `登录`
5. 登录成功后，系统进入 `项目列表`

### 页面说明

- 页面只需要输入账号和密码。
- 登录成功后，右上角显示当前登录人 `耿工`。
- 点击右上角用户区域，可看到 `修改密码` 和 `退出登录`。

### 截图

登录页：  

![image-20260518131839090](/Users/summer/Library/Application Support/typora-user-images/image-20260518131839090.png)

用户菜单：  

![用户菜单](/Users/summer/Library/Application Support/typora-user-images/image-20260518131933122.png)

---

## 3. 项目列表

### 操作步骤

1. 登录后默认进入 `项目列表`
2. 可使用搜索框按编号、名称、人员信息查询项目
3. 可按状态筛选项目
4. 点击 `新建项目` 创建新项目
5. 在已有项目行内点击 `报价` 进入报价计算器
6. 在已有项目行内点击 `编辑` 修改项目基础信息
7. 点击左侧 `展开报价列表` 可查看项目下历史报价

### 页面说明

- 列表字段包括：编号、名称、创建人、价格、状态、创建时间、操作。
- `已完成` 项目的 `报价` 按钮会禁用。
- 当前演示中，新建项目后列表即时刷新。

### 截图

项目列表：  
![创建项目成功](/private/tmp/homevista-project-created.png)

---

## 4. 新建项目

### 操作步骤

1. 在项目列表点击 `新建项目`
2. 填写 `项目名称`
3. 选填 `客户名称`
4. 检查 `项目负责人`
5. 选填 `备注`
6. 点击 `创建项目`

### 字段说明

- `项目名称`：必填
- `客户名称`：选填
- `项目负责人`：默认带出当前登录人，可修改
- `备注`：选填

### 截图

新建项目弹窗：  
![新建项目](/private/tmp/homevista-new-project-dialog.png)

---

## 5. 新建报价与配置报价计算器

### 操作步骤

1. 在目标项目行点击 `报价`
2. 进入 `报价计算器`
3. 在左侧选择要报价的模块
4. 以 `楼宇` 模块为例：
5. 点击 `新增大楼`
6. 填写或选择楼宇参数
7. 在 `大楼交付` 中至少选择 1 个交付项
8. 右侧 `报价预览` 会自动更新建议报价、税额和分成估算

### 本次实操示例

本次演示为最小可报价配置，实际选择了：

- 层数：`1层`
- 体型类型：`一字`
- 屋顶类型：`平屋顶`
- 大楼交付：`BUILDING VISTA Lite`

### 页面说明

- 左侧是配置区，右侧是报价预览区。
- 模块切换支持：`楼宇`、`专有部`、`色彩切换`、`共用部`、`办公室`、`动画`、`平面家具摆放`、`系统收费`。
- 报价预览区会实时展示：
  - 建议报价
  - 含税总价
  - 日本 / 南京分成估算
  - 模块构成明细

### 截图

报价计算器初始页：  
![报价计算器初始页](/private/tmp/homevista-quote-calculator.png)

楼宇模块配置页：  
![楼宇模块配置](/private/tmp/homevista-building-form.png)

完成最小配置后的报价预览：  
![报价预览](/private/tmp/homevista-quote-configured.png)

---

## 6. 保存报价

### 操作步骤

1. 在右侧报价预览区点击 `保存报价`
2. 在弹窗中选择保存方式：
   `新建项目` 或 `已有项目`
3. 本次演示选择 `已有项目`
4. 选择目标项目
5. 填写 `报价名称`
6. 选填 `备注`
7. 点击 `保存`

### 实际校验结果

本次演示在保存时，系统弹出了 `楼宇最低价保护`：

- 当前楼宇计算原始金额低于 `50万日元`
- 系统提示继续保存后，楼宇将按 `50万日元` 保存

点击 `确定保存` 后，报价保存成功并进入 `报价详情`

### 结果说明

- 保存前预览建议报价：`¥245,000`
- 触发最低价保护后，保存结果总价提升
- 保存后的报价详情含税总价为：`¥812,000`

### 截图

保存弹窗：  
![保存报价弹窗](/private/tmp/homevista-quote-saved.png)

选择已有项目：  
![保存到已有项目](/private/tmp/homevista-save-existing-project.png)

项目选择下拉：  
![项目选择下拉](/private/tmp/homevista-project-selector.png)

最低价保护提示：  
![最低价保护](/private/tmp/homevista-quote-save-result.png)

保存成功后进入详情：  

![image-20260518132117859](/Users/summer/Library/Application Support/typora-user-images/image-20260518132117859.png)

---

## 7. 查看报价详情

### 操作步骤

1. 报价保存成功后自动进入 `报价详情`
2. 页面顶部可看到：
   - 报价名称
   - 版本号
   - 报价编号
   - 创建时间
   - 币种
   - 报价员
3. 页面中部可查看：
   - 含税总价
   - 项目状态
   - 报价状态
   - 分项小计
   - 分成比例
4. 下方可查看 `报价明细`
5. 右侧可查看 `报价历程`
6. 审核动作会同步记录到 `审核记录`

### 本次实操结果

- 项目状态：`进行中`
- 报价状态：先为 `待提交审核`，提交后变为 `待审核`
- 页面按钮包括：
  - `报价单资料`
  - `编辑报价`
  - `导出`
  - `提交审核`

### 截图

报价详情页：  
![image-20260518132129685](/Users/summer/Library/Application Support/typora-user-images/image-20260518132129685.png)

---

## 8. 维护报价单资料

### 操作步骤

1. 在报价详情页点击 `报价单资料`
2. 进入报价单资料页面
3. 按分区填写或调整内容
4. 点击 `保存资料`

### 页面结构

页面分为三部分：

1. `一、基本信息`
2. `二、交付及服务安排`
3. `三、报价前提与说明`

### 当前页面表现

- `报价单编号`、`报价单日期`、`项目名称`、`客户名称` 等核心字段会自动带出
- 可维护如 `报价单位（成交处）`、`有效期限`、`制作周期/服务期间`、`部署方式` 等内容
- `报价前提与说明` 支持较长文本录入

### 截图

报价单资料页：  
![报价单资料](/private/tmp/homevista-quote-info-dialog.png)

---

## 9. 导出报价

### 操作步骤

1. 在报价详情页点击 `导出`
2. 进入导出页面
3. 选择 `导出语言`
4. 选择 `文件格式`
5. 在下方查看导出预览
6. 确认无误后点击 `导出`

### 页面说明

- 导出语言支持：
  - `中文`
  - `日本語`
  - `English`
- 文件格式支持：
  - `PDF`
  - `Excel`
- 页面下半部分为实际导出预览，当前版样式为 `见积书`

### 预览内容

导出预览会展示：

- 基本信息
- 金额汇总
- 项目分项与报价明细
- 交付及服务安排
- 报价前提与说明

### 截图

导出页面：  
![导出页面](/private/tmp/homevista-export-page.png)

---

## 10. 提交审核

### 操作步骤

1. 在报价详情页点击 `提交审核`
2. 提交成功后，报价状态从 `待提交审核` 变为 `待审核`
3. 页面中的 `审核记录` 与右侧 `报价历程` 会新增对应记录

### 实际结果

本次演示提交后：

- 状态变化：`待提交审核 → 待审核`
- 审核记录新增 1 条
- 报价历程新增 `提交审核` 节点

### 截图

提交审核后页面状态：  
![提交审核结果](/private/tmp/homevista-submit-review-result.png)

---

## 11. 使用建议

1. 先创建项目，再进入报价计算器，便于后续归档和查找。
2. 保存报价前，先检查右侧 `报价预览` 中的总价、税额和分成估算。
3. 如楼宇金额较低，注意系统可能触发 `最低价保护`。
4. 正式提交审核前，建议先补全 `报价单资料`，避免导出内容不完整。
5. 提交审核后，普通报价人员应在项目列表或详情页跟踪审核状态变化。

---

## 12. 本次实操结论

使用账号 `genggongfa / genggongfa123`，已完成以下实际验证：

1. 登录成功
2. 新建项目成功
3. 楼宇模块最小配置可生成报价预览
4. 保存报价成功
5. 最低价保护规则已触发并生效
6. 报价详情页可正常查看
7. 报价单资料页可正常打开
8. 导出页可正常打开并显示预览
9. 提交审核成功，状态与记录同步更新