﻿# OM-002 見積管理システム フロントエンド操作マニュアル

**バージョン**：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` モジュールに入ります。后台管理画面には入りません。
- 本書は中文版の操作手順をベースに、日本語表示で再整理したものです。
- 実画面では一部の文言が中国語のまま残っている箇所があります。以下の説明は、実際の画面表示に合わせています。

---

## 2. ログイン

### 操作手順

1. ログインページを開く：`http://homevista-quotation.yitouchina.cn/login`
2. アカウント `genggongfa` を入力
3. パスワード `genggongfa123` を入力
4. `ログイン` をクリック
5. ログイン後、`プロジェクト一覧` に遷移

### 画面説明

- ログイン画面では `アカウント` と `パスワード` の 2 項目を入力します。
- 右上に言語切替があります。
- ログイン後は右上に現在の利用者 `耿工` が表示されます。

### スクリーンショット

ログイン画面：  
![ログイン画面](/private/tmp/homevista-login-ja-full.png)

---

## 3. 右上ユーザーメニュー

### 操作手順

1. ログイン後、右上のユーザーアイコンまたは `耿工` をクリック
2. メニュー内で以下の操作が可能
   - `パスワード変更`
   - `ログアウト`

### 画面説明

- メニュー内にはユーザー名 `genggongfa` が表示されます。
- 実画面では権限名部分に中国語 `报价人员` が残っています。

### スクリーンショット

ユーザーメニュー：  
![ユーザーメニュー](/private/tmp/homevista-user-menu-ja-full.png)

---

## 4. プロジェクト一覧

### 操作手順

1. ログイン後、初期画面として `プロジェクト一覧` が表示されます。
2. 検索欄で番号、名称、担当者情報を検索できます。
3. `ステータス` で絞り込みできます。
4. `新規プロジェクト` から案件を新規作成できます。
5. 行内の `見積` から見積計算画面へ進みます。
6. 行内の `編集` からプロジェクト情報を編集できます。

### 画面説明

- 一覧の主な列は `番号 / 名称 / 作成者 / 価格 / ステータス / 作成日時 / 操作` です。
- `完了` 状態の案件では、見積作成ボタンが無効になる場合があります。
- 一部の補助文言は中国語のまま残っていますが、主要操作ボタンは日本語化されています。

### スクリーンショット

プロジェクト一覧：  
![image-20260518133604821](/Users/summer/Library/Application Support/typora-user-images/image-20260518133604821.png)

---

## 5. 新規プロジェクト作成

### 操作手順

1. `新規プロジェクト` をクリック
2. `プロジェクト名` を入力
3. 必要に応じて `顧客名` を入力
4. `プロジェクト責任者` を確認
5. 必要に応じて `備考` を入力
6. `作成` をクリック

### 入力項目

- `プロジェクト名`：必須
- `顧客名`：任意
- `プロジェクト責任者`：初期値としてログインユーザーが表示
- `備考`：任意

### 補足

本実機確認では、前回の中文版手順に沿ってデモ案件を作成済みです。  
日本語版手順でも操作の流れは同一です。

### スクリーンショット

新規プロジェクトダイアログ：  
![新規プロジェクトダイアログ](/private/tmp/homevista-new-project-ja-full.png)

---

## 6. 見積計算の設定

### 操作手順

1. 対象案件の行で `見積` をクリック
2. `見積計算` 画面に遷移
3. 左側で対象モジュールを設定
4. `楼宇` モジュールを例に、`新增大楼` から建物インスタンスを追加
5. 建物条件、形状、屋根タイプなどを設定
6. `大楼交付` で少なくとも 1 つの交付項目を選択
7. 右側の見積プレビューを確認

### 今回の実機設定例

デモ見積では以下を設定しました。

- 階数：`1层`
- 形状タイプ：`一字`
- 屋根タイプ：`平屋顶`
- 交付項目：`BUILDING VISTA Lite`

### 画面説明

- 左側：設定エリア
- 右側：見積プレビュー
- プレビューでは以下が自動更新されます。
  - 推奨見積金額
  - 税込合計
  - 日本 / 南京の分配参考値
  - モジュール別明細

### スクリーンショット

見積計算 初期画面：  
![見積計算 初期画面](/private/tmp/homevista-quote-calculator-ja-full.png)

最小構成を設定した後の見積プレビュー：  
![見積プレビュー](/private/tmp/homevista-quote-configured-ja-full.png)

---

## 7. 見積保存

### 操作手順

1. 右側プレビュー内の `保存見積` をクリック
2. 保存方式を選択
   - `新建项目`
   - `已有项目`
3. 今回の実機確認では既存案件への保存を実施
4. 対象案件を選択
5. 見積名称を入力
6. 必要に応じて備考を入力
7. 保存を確定

### 実機確認で発生した仕様

今回の保存時、`楼宇最低价保护` が発生しました。

- 楼宇金額が 50 万円未満の場合、最低価格保護が発動
- 確認ダイアログで保存継続可否を選択
- `确定保存` を押すと保存成功

### 結果

- 保存前の推奨見積：`¥245,000`
- 最低価格保護適用後の税込合計：`¥812,000`
- 保存成功後、自動的に `見積詳細` へ遷移

### スクリーンショット

保存ダイアログ：  
![保存ダイアログ](/private/tmp/homevista-save-dialog-ja-full.png)

---

## 8. 見積詳細

### 操作手順

1. 保存成功後、自動的に `見積詳細` を表示
2. 画面上部で以下を確認
   - 見積名称
   - バージョン
   - 見積番号
   - 作成日時
   - 通貨
   - 見積担当
3. 中央で以下を確認
   - 税込合計
   - 案件ステータス
   - 審査ステータス
   - 小計
   - 分配比率
4. 下部で `見積明細` を確認
5. 右側で `見積履歴` を確認

### 実機確認結果

- 案件状態：`進行中`
- 審査状態：`審査待ち`
- 上部ボタン：
  - `見積資料`
  - `エクスポート`

### スクリーンショット

見積詳細画面：  
![見積詳細画面](/private/tmp/homevista-quote-detail-ja2-full.png)

---

## 9. 見積資料の編集

### 操作手順

1. 見積詳細で `見積資料` をクリック
2. 資料編集画面へ進む
3. 各セクションの内容を確認・入力
4. `保存資料` で保存

### 主な構成

1. `基本情報`
2. `交付及びサービス手配`
3. `見積前提および説明`

### 補足

- 見積番号、日付、案件名、顧客名などは自動反映されます。
- 有効期限、見積会社、納期、交付方法などは必要に応じて更新できます。

### スクリーンショット

見積資料画面：  
![image-20260518134957485](/Users/summer/Library/Application Support/typora-user-images/image-20260518134957485.png)

---

## 10. エクスポート

### 操作手順

1. 見積詳細で `エクスポート` をクリック
2. エクスポート設定画面へ進む
3. `導出言語` を選択
4. `ファイル形式` を選択
5. 下部のプレビューを確認
6. 内容に問題がなければ出力を実行

### 画面説明

- 対応言語：
  - `中文`
  - `日本語`
  - `English`
- 対応形式：
  - `PDF`
  - `Excel`
- 下部プレビューでは `見積書` レイアウトが表示されます。

### スクリーンショット

エクスポート画面：  
![image-20260518134844993](/Users/summer/Library/Application Support/typora-user-images/image-20260518134844993.png)

---

## 11. 審査申請

### 操作手順

1. 見積詳細で `審査申請` 相当のボタンを実行
2. 申請成功後、状態が `下書き/待提交审核` から `審査待ち` に変わる
3. `審査記録` と `見積履歴` に申請記録が追加される

### 実機確認結果

- 状態遷移：`待提交审核 → 審査待ち`
- 審査記録が 1 件追加
- 見積履歴にも `提交审核` の記録が追加

### スクリーンショット

審査待ち状態の見積詳細：  
![審査待ち状態の見積詳細](/private/tmp/homevista-quote-detail-ja2-full.png)

---

## 12. 利用上の推奨事項

1. まず案件を作成し、その後に見積計算へ進むと履歴管理しやすくなります。
2. 保存前に右側プレビューで合計金額、税額、分配比率を必ず確認してください。
3. 楼宇金額が低い場合は最低価格保護の発動に注意してください。
4. 正式な審査申請前に `見積資料` を補完しておくと、エクスポート内容が整います。
5. 審査申請後は、一覧または詳細画面で状態変化を追跡してください。

---

## 13. 今回の検証結果

アカウント `genggongfa / genggongfa123` にて、以下を実機確認済みです。

1. ログイン成功
2. 右上言語切替を `日本語` に変更
3. プロジェクト一覧の表示確認
4. デモ案件での見積計算確認
5. 最低価格保護の発動確認
6. 見積保存成功
7. 見積詳細表示成功
8. 見積資料画面表示成功
9. エクスポート画面表示成功
10. 審査申請後の状態更新確認
