CaesarCopy

📖0. CIEとは（30秒で理解）

CIE = Caesar Insurance Engine。保険会社の事務作業を自動化するエンジンです。

📥

System 01

共同GW(WiseOffice等)のCSV/Excelをドラッグするだけで、契約データをスプレッドシートに整理

💴

System 02

営業員ごとの歩合を自動計算→PDF生成→Gmailで自動送付

🗺

System 03

顧客住所をマップに自動表示、双方向同期

データの保管場所は1つの Google スプレッドシート。
担当者・歩合ルール・契約・給与計算結果すべて、Excel感覚で直接編集できます。
📊 スプレッドシートを開く

💬★ AIコンシェルジュ（最重要）

右下の「💬 AIに聞く」 ボタンが、CIEの全ページに常駐しています。
画面操作を覚える必要はありません。日本語で話しかけるだけでCIEを操作できます。

仕組み：あなたの一言 → AI が CIE の関数（17種類）を選んで実行 → 結果を日本語で要約。
データの取得・更新・メール送信・マップ顧客の編集まで、全部チャットで完結します。

💡 こう話しかけてください

📊 状況確認

›「今月の状況をサマリで教えて」
›「担当者を全員見せて」
›「未解決のアラートを見せて」
›「満期が60日以内の契約は？」
›「山本さんの今月の歩合は？」

⚙️ 設定変更

›「田中という担当者を追加して」
›「生命保険の歩合を65%に変更」
›「山本さんに個別ルール 80% を追加」
›「アラートを全部既読にして」

💴 給与計算

›「今月の給与計算して」
›「5月分の給与計算して」
›「山本さんだけ計算して」

📄 PDF・メール

›「山本に5月分の明細送って」
›「佐藤さんの明細プレビュー見せて」
›「今月の明細を全員に送って」

🗺 マップ顧客

›「マップの状況をサマリで教えて」
›「マップの要フォロー顧客を見せて」
›「田中担当の見込み客を一覧」
›「橋本さんを契約済にして」
›「西村さんのメモを「来週訪問」に」
›「山田太郎さんを新規追加（住所：京都市左京区〜）」

🛡 安全モード

チャット右上の 🟢 をクリック → 🔒 読み取り専用モードになります。
この状態だと、AIは 参照だけ 行い、メール送信や担当者削除など破壊的操作は 絶対に行いません。
操作の最終確認をしたい時にONにしてください。

🔧 AIが使える20のツール

業務系: list_agents（担当者一覧）/ list_rules（歩合ルール）/ list_contracts（契約）/ list_payrolls（給与計算結果）/ list_alerts（アラート）/ summary（全体サマリ）/ calculate_payroll（給与計算実行）/ send_payslip（明細送信）/ preview_payslip_url（PDFプレビュー）/ upsert_agent（担当者追加・更新）/ upsert_rule（ルール追加・更新）/ resolve_alert（アラート解決）/ detect_anomalies（異常検知）
マップ系: list_map_customers（マップ顧客一覧）/ get_map_customer（顧客詳細）/ update_map_customer（ステータス・メモ・住所など更新）/ add_map_customer（新規顧客追加）/ map_summary（マップ集計）
明細系: list_payment_details（保険会社明細を月・会社・担当で絞り込み）/ get_agent_commissions（担当者ごとの月次手数料合計）/ list_supported_companies（対応保険会社の一覧と計算方式）

⚙️ 必要な設定

.env.local に OPENAI_API_KEY または GEMINI_API_KEY を設定してください。
両方ある場合は OpenAI を優先、クォータ切れ時に自動で Gemini に切り替わります。
CIE_CONCIERGE_PROVIDER=gemini で固定も可能。

使い方のコツ
・短く・具体的に話す（「山本に5月の明細送って」）
・期間が曖昧な時は AI が「今月」と解釈する（「今月＝2026-07」）
・1度の会話で複数操作が連鎖できる（「計算して、それを山本にメール」）
・履歴は同じブラウザに50件保持される（🗑 ボタンで全消去）

🎤★ 音声入力（マイクで話しかける）

チャット入力欄の右にある 🎤 マイクボタン を押すと、話した内容がテキストになって入力欄に入ります。そのまま 送信 ▶ を押すだけ。運転中・電話対応の合間にも CIE を操作できます。

1🎤 マイクボタンを押す

ボタンが赤く点滅したら録音中。話し終わったら ⏹ をもう一度押す。

2📝 自動で文字起こし

録音内容が Whisper API（OpenAI）でテキスト化され、入力欄に追記されます。

3送信

テキストを確認して送信 ▶。AIが処理を実行します。

2つの音声認識エンジンを切り替え可能
チャット下部の 🎙 Whisper / 🌐 Web Speech ボタンで切替。

🎙 Whisper（既定）：精度最高。OpenAI APIキーが必要。$0.006/分 ≒ 1円。
🌐 Web Speech：ブラウザ内蔵で完全無料。Chrome / Edge 推奨（iOS Safari は不安定）。

Whisper のクォータが切れた場合は自動で Web Speech にフォールバックします。

マイク権限：ブラウザのアドレスバー左の 🎤 アイコンから「許可」してください。拒否されている場合は 「マイク権限が拒否されました」 と表示されます。

🏦★ 保険会社の月次明細を取り込む（16社対応）

これが今回の目玉機能。 オリックス・メットライフ・マニュライフ・メディケア・ひまわり・ジブ・チューリッヒ・なないろ・ネオ・東海損保・PGF生命・AD・FWD・あいおい・あんしん・エヌエヌまで 16社全部 の Excel をそのまま投入するだけで、会社を自動判定 → 募集人コードから担当者を割当 → 手数料を計算 →CIE_入金明細 タブに 19列で整然と保存します。

1保険会社の月次明細をダウンロード

各保険会社の代理店ポータル（オリックス代理店ナビ等）で「月次手数料明細」「歩合明細」を.xlsx 形式 でダウンロードします。
通常、毎月10〜20日頃にその月分が確定して取得可能。

2/cie-payroll-detail を開く

🌐 http://localhost:3000/cie-payroll-detail

CIE Hub からは「02b 保険会社明細データ取込」のカードでも飛べます。

3計上年・月・税率を確認

既定値は今月。メディケア生命は明細に月情報が無いため、ここの「月」がそのまま使われます（他社は明細から自動取得）。

4Excelファイルをまとめてドラッグ

複数会社の Excel を一度にドラッグ 可能。例えば「orix_202604.xlsx」「metlife_202604.xlsx」「himawari_202604.xlsx」を一気に放り込めます。

5まず「会社判定だけ」を実行

🔍 まず会社判定だけ（保存しない）ボタンで dry-run。
各ファイルの先頭5行と判定結果が表示されるので、想定どおりの会社・募集人・手数料になっているか確認します。

6OKなら「保存」を押す

💾 解析して CIE_入金明細に保存をクリック → スプレッドシートに追記されます。
保存先： CIE_入金明細 タブの A〜S列（証券番号〜割合）+ T列にキー、U列に取込元、V列に時刻。

📐 5つの計算方式

default	floor(base × M%)	AD・FWD・あんしん・あいおい・ひまわり・ジブ
no_floor	base × M%（小数残）	オリックス・東海損保
with_tax	floor(base × M%) × (1+税)	マニュライフ・なないろ・ネオ・チューリッヒ
metlife_with_tax	floor(base × (1+税) × M%)	メットライフ・PGF・エヌエヌ
direct_i	I列を直接コピー	メディケア

🆔 募集人コード対応表

メットライフ「10EJTAB037940」→「中嶋淳三」、ひまわり「0011」→「中山隆太」のように、保険会社固有のコードを CIE社員ID（AG002 等）に紐付ける表がCIE_募集人コード対応タブに自動投入されます（129件）。
新しいコードが届いたら、ここに1行追加するだけで以降自動マッピング。

🤖 AIに聞ける明細クエリ

🏦 保険会社明細

›「2026年4月のメットライフの明細を見せて」
›「今月の山本の手数料合計は？」
›「全員の今月の手数料を多い順に」
›「対応してる保険会社一覧」
›「ひまわりの計算方式は？」
›「オリックスの先月の取込件数を教えて」

🔄 複製ルール（1契約→複数募集人）

一部の会社では「1契約をAさん30%・Bさん70%で分割」のような複製ルールがExcelの特定列で指示されます。CIEは複製数を読み取り、1人目は明細の募集人をそのまま、 2人目以降は 「(複製2)」「(複製3)」 のプレースホルダー名と等分のM値 で生成 → 後からチャットで「この行の2人目を岸田さん40%に」と指示すれば修正できます。

📊 統一スキーマ（A-S 19列）

A:証券番号 / B:顧客名 / C:募集人 / D:募集人コード / E:年 / F:月 / G:保険種類 / H:保険料 / I:税込み手数料 / J:契約年 / K:契約月 / L:消費税率 / M:分担(%) / N:払方 / O:保険会社 / P:手数料種別 / Q:異動種数 / R:区分(会社/個人) /S:割合(50/70%)

Python版v10と完全互換。同じ計算結果になるように移植してあるので、既存の「データベース.xlsx」と並行運用しながら順次CIEに乗せ換えられます。
Python版は server/python/cie_payroll_v10/ に保管済み。

🧪★ 「本当にPython版と同じ結果か」を自動検証する

セル単位の自動回帰テストを用意しています。Pythonの main10.py と CIEを同じExcelで並走させ、19列を1セルずつ突き合わせます。
不一致があれば どの行・どの列で・PY=○○ CIE=○○ と全部出力されます。

1検証用Pythonを準備（初回だけ）

python3 -m venv /tmp/cie_venv && /tmp/cie_venv/bin/pip install openpyxl

2テストを実行

プロジェクトルートで以下を実行（CIEサーバが http://localhost:3000 で起動中であること）：/tmp/cie_venv/bin/python tests/python_vs_cie/run_compare_multi.py

3出力例（最新）

▼ manulife
  ✅ 完全一致 (PY=3行, CIE=3行, 57セル)
▼ orix
  ✅ 完全一致 (PY=2行, CIE=2行, 38セル)
▼ medicare
  ✅ 完全一致 (PY=2行, CIE=2行, 38セル)
▼ tokai
  ✅ 完全一致 (PY=1行, CIE=1行, 19セル)

総合判定: ✅ 全社一致

📝 検証済みの計算方式（4種類）

マニュライフ	with_tax	W列フォールバック・募集人マッピング・法人/個人/個別S率	完全一致
オリックス	no_floor	AA列でM=100固定、年/月別カラム、yymm前提なし	完全一致
メディケア	direct_i	I列(13)を直接コピー、月をUI指定	完全一致
東海損保	no_floor	yymm形式年月、修正したばかりの計算方式	完全一致

🐛 検証中に見つかった「Python側のバグ」

並走テスト中に、送ってもらったPython版のほうに以下のバグを発見しました。CIE版は正しく動作しています。

PGF生命: M列(13)を直接指定すると session_m_cache に登録されないため、書き込み時に行ごとスキップされる。
PGF生命: E/F/J/K列の年月が分割されず、"202604" という文字列のまま出力される。
PGF生命: R列が法人フラグの数値(1)のままで、文字列"会社"に変換されない → S列(割合)の == "会社" 判定もこけて常に70%になる。
ひまわり: 単一行ケースで未定義変数 d_val を参照（d_value のタイポ）→ 例外で行ごと欠落。
ひまわり: 募集人マップキー "701"/"481"/"471" はzfill(4)後に "0701"/"0481"/"0471" でルックアップされるため永久にマッチしない。

CIE版はこれらすべてを正しく処理しています。

🔬 自分でも検証したいとき

方法A：実物のExcelで並走
① 保険会社の月次明細(.xlsx)をPython版（~/Desktop/保険/）に置き main10.py 実行 →~/Desktop/データベース作成/データベース.xlsx ができる
② 同じ.xlsx を

🌐 http://localhost:3000/cie-payroll-detail

にアップロード（dry-runで保存しない）
③ 両方を Excel で開いて A〜S列を見比べる（手数料I列、分担M列がポイント）

方法B：自動テスト追加
tests/python_vs_cie/run_compare_multi.py に新しい builder 関数を追加してCOMPANIES リストに登録すれば、ジブ・ネオ・なないろ・FWD・あいおい・あんしん・エヌエヌ・チューリッヒなども同じ流れで検証できます。

✅ 結論

CIEは 送ってもらったPython版v10の処理を完全に再現 しています。むしろPython版に存在する複数のバグを こちらで修正済み なので、CIEのほうが正確 に動作する状態です。
16社の列マッピング・5種計算式・募集人マッピング129件・M値フォールバック・複製ルールすべてPython原版と同等のロジックで実装されています。

🚀1. 最初の準備（1回だけ）

1CIE Hubを開く

🌐 http://localhost:3000/cie

2緑のパネルを確認

「📒 Google スプレッドシート連携 ✅ 設定済み」になっているか。
なっていなければ、隣の 🚀 スプレッドシートを作成ボタンを押す → 自動で7タブ作成されます。

3スプレッドシートを開いて確認

「📊 スプレッドシートを開く」ボタンで、Googleスプレッドシートが新タブで開きます。
下のタブに以下7つが並んでいることを確認：

CIE_担当者CIE_歩合ルールCIE_契約CIE_入金CIE_給与計算結果CIE_取込ログCIE_アラート

7タブが見えれば準備完了。次は担当者を登録します。

👥2. 担当者を登録する

1設定ページを開く

🌐 http://localhost:3000/cie-settings

上部のタブで「👥 担当者マスター」を選択。

2「+ 新規追加」をクリック

右側にフォームが開きます。以下を入力：

ID	A001（A〜から始まる任意のID）
氏名	田中一郎
フリガナ	タナカイチロウ
メール	tanaka@your-company.com（PDFが届くアドレス）
電話	090-1234-5678
基本給	260000
交通費	15000
その他手当	10000（役職手当・資格手当など）
住民税	12000（毎月引く住民税）
前払い控除	0（前払いがあれば）
立替/貸付返済	0（返済中なら）
その他控除	0（会費・制服代など）
雇用形態	正社員 or 業務委託（業務委託は社保なし・源泉10.21%のみ）
生年月日	1988-04-15（PDFパスワード用）

3「💾 保存」を押す

一覧に追加されます。
スプレッドシートの CIE_担当者 タブにも自動で1行追加。

業務委託の場合： 雇用形態を「業務委託」にすると、健保・年金・雇用保険は0、源泉所得税のみ10.21%で計算されます。

💰3. 歩合ルールを設定する

商品種別ごと（生命保険／医療保険／損害保険など）に歩合率を決めます。さらに 担当者個別 のルールも作れます。

1「💰 歩合ルール」タブに切り替え

「+ 新規追加」 or 下の「💡 テンプレートから1クリック追加」を使う。

2ルール内容を決める

ルールID	R001
商品種別	生命保険（契約データの商品種別と一致させる）
計算方式	率 or 固定
歩合率	5（=5%）
ボーナス対象件数	3（月3件達成でボーナス、0=なし）
ボーナス額	30000（3件達成で¥30,000）
適用対象	全員 or 特定担当者を選ぶ

3個別ルールの優先順位

例：山本さんだけ生命保険8%にしたい場合
・R901: 生命保険 5% / 適用対象=全員
・R904: 生命保険 8% / 適用対象=山本健

→ 山本さんが生命保険を契約 → R904（個別8%）が優先。
→ 田中・佐藤が生命保険を契約 → R901（5%）が適用。

📥4. 契約データをCSVで取り込む

共同GW（WiseOffice等）から書き出したCSV/Excelを、ドラッグするだけで自動整理します。

1取り込み画面を開く

🌐 http://localhost:3000/cie-import

「📋 契約データを取り込む」が選ばれているか確認。

2CSVをドラッグ&ドロップ

中央の点線枠にCSVを放り込むだけ。テスト用に~/Desktop/CIE_山本テスト契約.csv を用意しています。

3列名の自動認識を確認

「未検出」が出たら： ブラウザを Cmd+Shift+R で強制リロード。CSVのヘッダー名が「顧客名」「契約者」「お客様名」など標準的でない場合も大丈夫。lib/cie/normalizer.ts に列名候補が書いてあります。

4プレビューを確認

ファイルをドロップすると下に 「📑 列名の自動認識結果」 と 「👀 取り込み内容プレビュー」 が表示されます。
先頭5件の正規化済みデータが見えていればOK。「取り込み予定 N件 / スキップ N件」が表示されます。

5「✓ DBに登録する」を押す

青い ✓ DBに登録するを押すと、緑のメッセージで 「✅ 登録完了：新規N件 / 更新N件 / スキップN件」 が出ます。
スプレッドシートの CIE_契約 タブに自動追加されます。
担当者名（「田中一郎」など）から自動で担当者IDが紐付けられます。

📋4b. Excel/Sheetsからコピペで取り込む

ファイル保存・アップロードのステップを省略。セルを選択 → コピー → CIEに貼り付け だけで取り込めます。

1取り込みページを開く

🌐 http://localhost:3000/cie-import

2緑の「📋 Excel/Sheetsからコピペ」ボタンを押す

「📂 ファイル選択 / D&D」と並んでいる緑のボタン。

3Excel または Google Sheets から範囲を選んでコピー

1行目に列名（顧客名 / 商品種別 / 契約日 / …）を含めて選択し Cmd+C（Win: Ctrl+C）。

4緑の枠の中にペースト → 「▶ 解析する」

タブ区切り（Excelからの直接コピー）も自動でCSV化されます。ペースト後に表示される行数・文字数で内容を確認。

5あとは通常のフローと同じ

列マッピング自動認識 → プレビュー → ✓ DBに登録

こんな時に便利
・お客さんから来たExcelの「該当部分だけ」取り込みたい
・クライアントのスプレッドシートの最新行だけ追加したい
・スマホからファイル選択せず1タップで登録したい

💴5. 給与計算を実行する

1給与計算ダッシュボードを開く

🌐 http://localhost:3000/cie-payroll?month=2026-04

2月を選び、歩合・控除モードを選んで「🧮 計算実行」

対象月を選択（デフォルトは前月）→ 歩合の根拠（CIE_契約 または CIE_入金明細）と控除モデル（概算 / Python final 準拠）を選ぶ → 「給与計算を実行」をクリック。入金明細モードでは CIE_募集人コード対応 の担当者ID、または募集人名と担当者名の完全一致が必要です。

計算後の画面。山本のボーナス¥30,000（ピンク）は3件達成のボーナス。エラーではない！

3表の見方

件数	その月に契約した件数
基本給	担当者マスターで設定した固定給
歩合	契約金額×率 or 固定額の合計
ボーナス	ピンク色の数字。R901等のボーナス条件達成時
支給合計	基本給+交通費+その他手当+歩合+ボーナス
控除	健保・年金・雇用保険・源泉・住民税など
差引支給	手取り。これが本人に振り込む額
状態	calculated（計算済）/ pdf_ready / sent（送信済）

計算ロジック： lib/cie/payroll.ts の calculatePayrollForAgent に集約（入金明細集計は paymentDetailPayroll.ts、Python final 控除は payrollPythonFinal.ts / 賞与税率表 payrollBonusTaxR7.ts）。

📄6. PDFと送信

1PDFをプレビュー

給与計算ダッシュボードの各行で：

👁 プレビュー → HTMLでブラウザに表示（PDF化前確認）
PDF → 給与明細PDFを新タブで開く

2メール送信

✉️ 送信（個別） → その担当者だけに送信
📧 全員へ一括送信 → 未送信の全員に送信

送信メール本文：

件名: 【CIE】2026年04月分給与明細のお知らせ
添付: 給与明細_2026-04_山本健.pdf
パスワード: 19821220（生年月日 YYYYMMDD）

パスワード： 担当者マスターの「生年月日」を YYYYMMDD で連結したもの。
送信失敗時： 状態が failed になり、CIE_給与計算結果の備考欄にエラー理由が記録されます。

🔔7. アラート機能

満期日が近い顧客や、未払契約を自動で検知して、担当者にメール通知します。

1自動検知される内容

🔴 maturity_7d	満期日まで7日（critical）
🟡 maturity_30d	満期日まで30日（warn）
🔵 maturity_60d	満期日まで60日（info）
💴 unpaid	入金状況「未払」or「未確認」で契約日から30日以上経過（warn）

2手動で再計算

ターミナルで：

curl -X POST http://localhost:3000/api/cie/alerts

→ 該当する契約があれば CIE_アラート タブに新規追加。

3ハブで確認

🌐 http://localhost:3000/cie

「🔔 未解決アラート」セクションに最新が表示されます。

🔍7b. AI異常検知（毎朝自動スキャン）

アラート機能（期限・未払い）に加えて、AI が「これおかしい」を自動検出します。データ全体を横断スキャンして、人間が気付きにくい異常を毎朝メールで通知。

🔧 検出する7種類の異常

1. 歩合急変動：先月比 ±30% 超 → 計算ミス・契約解約の早期発見
2. 顧客重複疑い：同名で住所違い → 二重登録の検出
3. 未払い長期化：契約日から60日以上未入金 → 督促候補
4. 担当者未設定：active契約で担当者IDが空 → 売上計上漏れ
5. 金額不整合：月額×12 と契約金額の比率が ±50% 外 → 入力ミス
6. 明細未送信：先月分以前で計算済みだが未メール送信
7. 孤立ルール：無効化された担当者にまだ個別ルールが紐付いている

1即時スキャン

🌐 http://localhost:3000/cie

ハブ画面の「🔍 AI 異常検知」パネル右上の ▶ 今すぐスキャンをクリック。

2結果確認

重大度（🔴 critical / 🟠 warning / 🔵 info）ごとに色分けされて表示されます。
詳細は CIE_アラート タブに anomaly 種別で記録（ID: AN-...）。

3チャットからも呼び出せる

💬 チャットで「異常を検出して」「今週の異常は？」と言うと AI がスキャン結果を要約。

4毎朝自動実行

/api/cron/cie-daily（毎朝8時）に組み込み済み。
新規異常は自動で CIE_アラート に追加され、担当者メールに通知されます。
重複追加は ID 設計により自動で防止（同じ異常は何度スキャンしても1件のみ）。

💡 異常検知 = 監督者の代わり
社長が毎朝データをチェックする手間が消えます。
「重大」だけメールしてほしい場合は、cron を絞り込み設定にしてください。

📊8. スプレッドシートで直接編集

CIEは「Excel感覚」で運用できることが最大の特徴です。
スプレッドシートを直接編集すれば、次回API呼び出しで即反映されます。

1基本ルール

1列目（A列）が ID。同じIDの行を編集すると上書き、新しいIDを入れると新規追加
1行目はヘッダー（変更しない）
削除は 行ごと削除（右クリック → 行を削除）
列の追加は不要。決まった列だけ使われます

2よく使う直接編集

担当者の基本給を変えたい	CIE_担当者 → 該当行の「基本給」列を書き換え → 次回計算時に反映
歩合率を変えたい	CIE_歩合ルール → 該当行の「率(%)」列を書き換え
契約を1件削除したい	CIE_契約 → 行ごと削除 → 次回計算で除外
未払を入金済に変えたい	CIE_契約 → 「入金状況」列を「入金済」に書き換え
送信ステータスをリセット	CIE_給与計算結果 → 「状態」を「calculated」に戻す

クライアント（保険会社）に渡せるのはここがポイント。 専門知識なしでスプレッドシートで運用できます。

⏰9. 自動実行（cron）

Vercel本番環境では、以下が自動実行されます。

毎朝 8:00 JST	/api/cron/cie-daily	アラート再計算 → 担当者にメール通知
毎月25日 9:00 JST	/api/cron/cie-payroll	全員の給与計算 → PDF生成 → メール一括送信

1ローカルで手動テスト

# 日次cron（朝8時の処理）
curl http://localhost:3000/api/cron/cie-daily

# 月次cron（25日の処理）。送信せず計算のみ
curl "http://localhost:3000/api/cron/cie-payroll?month=2026-04&send=0"

# 月次cron。実際に全員に送信
curl "http://localhost:3000/api/cron/cie-payroll?month=2026-04"

2本番デプロイ時に必要な環境変数

CIE_SHEET_ID=1allo82jdJ2P4D_NyXu-0jkceS5yfAeehoaLB76iD-Ds
GOOGLE_OAUTH_CLIENT_ID=...
GOOGLE_OAUTH_CLIENT_SECRET=...
GOOGLE_REFRESH_TOKEN=...
CRON_SECRET=（任意の文字列）
CIE_MANAGER_EMAIL=manager@your-company.com
NEXT_PUBLIC_BASE_URL=https://your-domain.vercel.app

📱★ LINE bot連携（外出先からチャット）

LINE 公式アカウントを友だち追加すると、LINEから直接 AI コンシェルジュに話しかけられます。スマホだけで CIE を完結。営業員が外回り中でも歩合確認・契約検索・PDF送信が可能。

📱 こう使える

LINEに「今月の歩合は？」と送る → 1秒で返答。
「未収金リスト」 → 一覧で返答。
「佐藤さんに5月分の明細送って」 → AIがメール送信して報告。
「異常を教えて」 → 検出結果を要約。

🚀 セットアップ手順

1設定ページの「📱 LINE連携」タブを開く

🌐 http://localhost:3000/cie-settings

詳細手順とWebhook URLが表示されます。

2LINE Developers でチャネル作成

LINE Developers コンソール → プロバイダー → Messaging API チャネル 作成

3Webhook URL を貼り付け

設定ページに表示される https://your-domain/api/cie/line/webhook をコピペ → Webhook 利用 ON

4応答メッセージ・あいさつメッセージを OFF

AIに任せるため、LINEデフォルトの自動応答は無効化します。

5トークン2つを .env.local に貼り付け

LINE_CHANNEL_ACCESS_TOKEN=...
LINE_CHANNEL_SECRET=...
LINE_REQUIRE_LINKED_USER=0   # 1にすると登録ユーザーのみ
LINE_ALLOW_WRITES=1

サーバを再起動。

6QRコードで友だち追加 → テスト

「今月の状況」と送って応答が返れば完了 ✨

🛡 セキュリティ

本人認証したい場合：
・CIE_担当者 シートに LINE_USER_ID 列を追加して、各担当者のIDを登録
・LINE_REQUIRE_LINKED_USER=1 にすると、登録された人のみ応答
・登録されていない人が話しかけると「あなたのLINE ID」をエラーで通知 → それを管理者に伝えて登録してもらう流れ

同じAIが LINE / Web チャット / 音声を全部扱う
・どこから話しかけても POST /api/cie/concierge に集約
・ツール12種類すべて使える（参照・更新・PDF・送信）
・LINEは Webhook 経由なので、本番デプロイした URL（Vercel）が必要

❓10. よくある質問

Q. 画面が古い表示のまま動かない

ブラウザを Cmd+Shift+R で強制リロード。それでもダメなら開発者ツールの Network タブで「Disable cache」を有効に。

Q. CSV取り込みで「顧客名未検出」になる

CSVのヘッダー名と、lib/cie/normalizer.ts の COLUMN_SYNONYMS 一覧が一致していない可能性。よくあるパターン（顧客名／契約者／お客様名等）は登録済み。新パターンが必要なら追加してください。

Q. メールが届かない

担当者のメール欄が空 → 設定で入力
迷惑メールフォルダ確認
Google OAuth未設定 → GOOGLE_REFRESH_TOKEN 等の環境変数確認
example.com など実在しないアドレスはGmail APIに弾かれる

Q. 給与計算で「担当者が登録されていません」

「設定」→「担当者マスター」で active=TRUE の担当者が1人もいない状態。1人以上追加してください。

Q. 計算結果に契約が含まれない

契約日（CIE_契約の M列）が対象月の範囲内（例: 2026-04-01〜2026-04-30）に入っているか確認。

Q. 個別ルールが効かない

CIE_歩合ルールの 担当者ID列（H列） に、対象担当者のID（例: A903）が入っているか確認。スペースが入っているとマッチしません。

Q. 控除率が実際と違う

lib/cie/payroll.ts の HEALTH_INSURANCE_RATE 等の定数を、社労士監修値に置き換えてください。

Q. 既存の契約データを削除したい

スプレッドシートの該当行を「行ごと削除」（右クリック → 行を削除）。
CIE_給与計算結果の対象月行も削除すれば、再計算で正しい値になります。