テーマ
顧客管理
目的
保険代理店 / 保険屋が接点を持つ「人」を一元管理し、契約・スケジュール・LINE 履歴・書類を顧客レコードに紐付ける。
顧客の状態
- リード: LINE 友だち追加 / Web フォーム経由などで取得した、顧客レコード化前の接点（LINE 公式連携 参照）。
- 顧客: 担当者を決めて管理する正式レコード。
- 休眠 / アーカイブ: 表示の優先度を下げる。データ自体は残る。
データ項目
| カテゴリ | 項目 |
|---|---|
| 基本 | 氏名 / フリガナ / 性別 / 生年月日 / 年齢自動算出 |
| 連絡先 | 電話 / メール / 住所 / LINE 友だち |
| 関係 | 続柄（家族グループ）/ 紹介者 |
| 業務 | 担当ユーザー / タグ（自由）/ ランク / メモ |
| メタ | 取得経路 / 初回接触日 / 直近接触日（自動更新） |
家族や法人の役員などは「家族グループ」で緩く束ねる（ハードな親子関係は持たない MVP 設計）。
一覧 / 検索
- 既定ビュー: 直近接触順
- 絞り込み: 担当者 / タグ / ランク / 生年月日範囲 / 契約有無 / 更新近接 / LINE 紐付け有無
- 検索: 氏名（姓名）/ フリガナ / 電話 / メール / メモ全文
- 並び替え: 五十音 / 直近接触 / 契約金額合計
CRUD と権限
| 操作 | OWNER | MEMBER | ADMIN |
|---|---|---|---|
| 一覧 / 検索 | ✅ | ✅ | 参照のみ |
| 作成 | ✅ | ✅ | ❌ |
| 更新 | ✅ | ✅(担当 or 全員、設定で切替) | ❌ |
| 削除（論理） | ✅ | ❌ | ❌ |
| 物理削除 | ❌ | ❌ | ✅ |
| インポート / エクスポート | ✅ | ❌ | ✅ |
MEMBER の編集範囲は OWNER の設定で「自分が担当の顧客のみ」 / 「テナント全体」を切替可能。
インポート / エクスポート
- CSV インポート（テンプレート提供）
- 既存顧客とのマッチングは「氏名 + 生年月日 + 電話下4桁」を既定キーに、衝突は手動マージ画面へ
- エクスポートは CSV / Excel。担当者の権限内のレコードのみに制限
マージ / 統合
- 重複顧客が見つかった場合、2件を1件に統合する操作を提供
- 主レコードを選択 → サブレコードのフィールドを取捨選択 → 紐付き（契約 / スケジュール / アクティビティ / LINE / 書類）はすべて主レコードへ移管
削除
- 既定はソフトデリート（
deleted_at） - 物理削除は ADMIN のみ。法令保管期間考慮で遅延ジョブ前提
- 削除前に紐付き件数を表示し、誤操作を防ぐ
要配慮個人情報
- 健康情報・マイナンバー・身分証番号などは「要配慮タグ付きフィールド」として別管理
- 値は アプリ層で暗号化してDBに保存（テナントDEK / AES-GCM）
- 閲覧は OWNER または OWNER の許可リストに登録された MEMBER のみ
- 閲覧 / 編集 / エクスポートはすべて監査ログへ
- 詳細はセキュリティ仕様 / セキュリティ設計を参照
監査
- 作成 / 編集 / 削除 / マージ / エクスポートの操作はすべて監査ログへ（ADMIN画面で閲覧）
- 要配慮情報のアクセスは追加の理由ログを必須化
未確定
- 法人顧客（契約者が法人）の扱い:
kind = individual | corporateをcustomers