Process Map
Butler Tax の業務プロセスを視覚化したマップです。各ステップをクリックすると、遷移条件・テストカバレッジが展開されます。
業務プロセス
用途：従業員が提出した経費や受け取った請求書の承認フローを管理する。承認完了後、銀行明細との消込対象となる。
経費領収書・受取請求書
書類登録
OCR自動読取
→
下書き
draft
→
承認待ち
pending_approval
→
承認済み
approved
差戻し →
差戻し
rejected → 再提出可
→
（完了へ合流）
ℹ️ 書類登録時に Gemini OCR が doc_type を自動判定する。登録前の確認画面で OCR 結果（日付・金額・取引先・明細）を編集でき、明細から税抜・消費税・税込を自動計算する。承認ルールは書類種別×金額条件で適用ルールが決まる。
pytestPlaywrightユーザーテスト
法人 Admin プロセス
法人 admin が触る設定・管理系フロー（初期登録 / 自社情報 / ユーザー招待 / 権限設定 / 部門管理）です。
Butler Tax — 法人 Admin プロセスマップ
法人初期登録・自社情報・ユーザー招待・権限設定・部門管理のフロー / API / DB
法人初期登録 onboarding フロー
ステップをクリックで詳細
ユーザー操作
LP / 登録開始/register
→アカウント種別選択通常 or 招待経由
→メール/PW 入力利用規約同意
→プラン選択/pricing
→Stripe Checkoutカード / 口座入力
→契約情報入力会社名・電話・住所
→ダッシュボード/dashboard/corporate
責務分離：auth-frontend / auth-backend（butler-platform）が登録・認証・契約を一元管理。
契約情報入力以降（
アラート閾値設定（
POST /users/register）が butler-tax-backend の担当。
PII（会社名・住所等）は butler-tax Firestore company_profiles、法人メタは MongoDB corporates、契約・課金は Platform platform_accounts.contract に集約。アラート閾値設定（
CorporateAlertSettingsPage.vue）は本マップ対象外。API エンドポイント / DB
| メソッド | エンドポイント | 説明 | DB / Storage | サービス |
|---|---|---|---|---|
| POST | /auth/register | Firebase Auth + platform_accounts 作成 | platform_accounts (MongoDB) | butler-platform auth-backend |
| GET | /auth/me | ロール / account_type / 契約状態取得 | platform_accounts (MongoDB) | butler-platform auth-backend |
| GET | /auth/users/{uid}/profile | 起動時プロファイル取得 | platform_accounts (MongoDB) | butler-platform |
| GET | /auth/users/{uid}/contract | 契約状態の復元 | platform_accounts.contract (MongoDB) | butler-platform |
| GET | /platform-invitations/verify | 招待トークン検証 | invitations (MongoDB) | butler-platform |
| POST | /platform-invitations/accept | 招待承諾 → Stripe Checkout URL 返却 | invitations (MongoDB) | butler-platform |
| POST | /stripe/create-checkout | Stripe Checkout Session 作成 | — | butler-platform stripe.py |
| POST | /stripe/webhook | checkout.session.completed → is_active=true | platform_accounts.contract (MongoDB) | butler-platform |
| PATCH | /auth/users/{uid}/contract | contract embed 更新 | platform_accounts.contract (MongoDB) | butler-platform |
| POST | /users/register | 法人情報登録 + Firestore + Stripe Customer | corporates / company_profiles | butler-tax-backend |
pytestPlaywright (E2E)ユーザーテストテスト未整備