# 業者展開ワークスアプリ データベース設計書（MVP凍結版 v1.0）

---
# 0. 使用するDB
DB名:saas

# 1. 設計方針

- マルチテナント前提（company_idで分離）
- 物件種別ごとに詳細テーブル分離
- 業者スコアは自動計算（保存は集計値）
- 添付はクラウド保存＋URL管理
- MVP範囲のみ設計（CRM統合なし）

---

# 2. テーブル一覧

1. companies
2. users
3. properties
4. property_land
5. property_building
6. property_income
7. property_military
8. property_risks
9. property_files
10. vendors
11. vendor_categories
12. vendor_category_relations
13. mail_logs
14. mail_log_vendors
15. vendor_responses
16. vendor_scores

---

# 3. テーブル定義

---

## 3.1 companies（会社情報）

| カラム名 | 型 | NULL | 説明 |
|-----------|------|------|------|
| id | bigint PK | NO | 会社ID |
| name | varchar(255) | NO | 会社名 |
| created_at | datetime | NO | 作成日 |
| updated_at | datetime | NO | 更新日 |

---

## 3.2 users（ユーザー）

| カラム名 | 型 | NULL | 説明 |
|-----------|------|------|------|
| id | bigint PK | NO | ユーザーID |
| company_id | bigint FK | NO | 会社ID |
| name | varchar(255) | NO | 名前 |
| email | varchar(255) | NO | ログインメール |
| password | varchar(255) | NO | パスワード |
| created_at | datetime | NO | 作成日 |
| updated_at | datetime | NO | 更新日 |

---

## 3.3 properties（物件共通情報）

| カラム名 | 型 | NULL | 説明 |
|-----------|------|------|------|
| id | bigint PK | NO | 物件ID |
| company_id | bigint FK | NO | 会社ID |
| property_type | varchar(50) | NO | land / building / income / military |
| address | varchar(255) | NO | 所在地 |
| price | bigint | NO | 価格 |
| memo | text | YES | 備考 |
| status | varchar(50) | NO | new / sent / negotiating / closed / cancelled |
| created_at | datetime | NO | 作成日 |
| updated_at | datetime | NO | 更新日 |

---

## 3.4 property_land（土地詳細）

| カラム名 | 型 | NULL | 説明 |
|-----------|------|------|------|
| property_id | bigint PK FK | NO | 物件ID |
| area_sqm | decimal(10,2) | YES | 面積㎡ |
| area_tsubo | decimal(10,2) | YES | 面積坪 |
| land_category | varchar(100) | YES | 地目 |
| zoning | varchar(100) | YES | 用途地域 |
| building_coverage_ratio | decimal(5,2) | YES | 建ぺい率 |
| floor_area_ratio | decimal(5,2) | YES | 容積率 |
| road_info | varchar(255) | YES | 接道状況 |

---

## 3.5 property_building（建物詳細）

| カラム名 | 型 | NULL | 説明 |
|-----------|------|------|------|
| property_id | bigint PK FK | NO | 物件ID |
| land_area | decimal(10,2) | YES | 土地面積 |
| building_area | decimal(10,2) | YES | 建物面積 |
| built_year | varchar(20) | YES | 築年月 |
| structure_type | varchar(100) | YES | 構造 |
| floor_plan | varchar(100) | YES | 間取り |
| parking_spaces | int | YES | 駐車場台数 |

---

## 3.6 property_income（収益物件詳細）

| カラム名 | 型 | NULL | 説明 |
|-----------|------|------|------|
| property_id | bigint PK FK | NO | 物件ID |
| unit_count | int | YES | 戸数 |
| current_rent | bigint | YES | 現況賃料 |
| full_rent | bigint | YES | 満室想定賃料 |
| surface_yield | decimal(5,2) | YES | 表面利回り |
| actual_yield | decimal(5,2) | YES | 実質利回り |

---

## 3.7 property_military（軍用地詳細）

| カラム名 | 型 | NULL | 説明 |
|-----------|------|------|------|
| property_id | bigint PK FK | NO | 物件ID |
| base_name | varchar(255) | YES | 基地名 |
| annual_rent | bigint | YES | 年間借地料 |
| multiple_ratio | decimal(5,2) | YES | 倍率 |
| remaining_years | int | YES | 契約残存年数 |

---

## 3.8 property_risks（注意事項）

| カラム名 | 型 | NULL | 説明 |
|-----------|------|------|------|
| id | bigint PK | NO | ID |
| property_id | bigint FK | NO | 物件ID |
| risk_type | varchar(100) | NO | termite / boundary / well など |
| risk_detail | text | YES | 詳細説明 |

---

## 3.9 property_files（資料管理）

| カラム名 | 型 | NULL | 説明 |
|-----------|------|------|------|
| id | bigint PK | NO | ID |
| property_id | bigint FK | NO | 物件ID |
| file_type | varchar(100) | NO | aerial / registry / map など |
| file_name | varchar(255) | NO | ファイル名 |
| file_url | varchar(500) | NO | クラウドURL |
| created_at | datetime | NO | 登録日 |

---

## 3.10 vendors（業者）

| カラム名 | 型 | NULL | 説明 |
|-----------|------|------|------|
| id | bigint PK | NO | 業者ID |
| company_id | bigint FK | NO | 会社ID |
| name | varchar(255) | NO | 業者名 |
| contact_name | varchar(255) | YES | 担当者名 |
| email | varchar(255) | NO | メール |
| created_at | datetime | NO | 作成日 |

---

## 3.11 vendor_categories（業者カテゴリ）

| カラム名 | 型 | NULL | 説明 |
|-----------|------|------|------|
| id | bigint PK | NO | ID |
| company_id | bigint FK | NO | 会社ID |
| category_name | varchar(255) | NO | カテゴリ名 |

---

## 3.12 vendor_category_relations（業者カテゴリ紐付け）

| vendor_id | bigint FK |
| category_id | bigint FK |

---

## 3.13 mail_logs（送信履歴）

| カラム名 | 型 | NULL | 説明 |
|-----------|------|------|------|
| id | bigint PK | NO | ID |
| property_id | bigint FK | NO | 物件ID |
| subject | varchar(255) | NO | 件名 |
| body | text | NO | 本文 |
| sent_at | datetime | NO | 送信日時 |

---

## 3.14 mail_log_vendors（送信対象業者）

| カラム名 | 型 | NULL | 説明 |
|-----------|------|------|------|
| id | bigint PK | NO | ID |
| mail_log_id | bigint FK | NO | 送信履歴ID |
| vendor_id | bigint FK | NO | 業者ID |
| response_status | varchar(50) | NO | no_reply / interested / negotiating / offered / ng |
| responded_at | datetime | YES | 返信日時 |

---

## 3.15 vendor_scores（業者スコア）

| カラム名 | 型 | NULL | 説明 |
|-----------|------|------|------|
| vendor_id | bigint PK FK | NO | 業者ID |
| avg_response_time | decimal(10,2) | YES | 平均返信時間 |
| interest_rate | decimal(5,2) | YES | 興味率 |
| deal_count | int | YES | 成約数 |
| offer_rate | decimal(5,2) | YES | 条件提示率 |
| total_score | decimal(5,2) | YES | 総合スコア |

---

# 4. MVP凍結範囲

本設計はv1.0（単体販売版）の確定仕様とする。
CRM連携・LINE連携・AI自動返信解析は含まない。