Gojiberry Monthly Accounting

• 接続済みの場合 → Check 2 に進む
• 未接続の場合 → ユーザーに「Claude in Chrome が接続されていません。Chrome で Claude 拡張機能が有効になっていることを確認し、接続してください。」と依頼する。接続が確認できるまで待機する。

Check 2: Downloads Folder Access（ダウンロードフォルダのアクセス確認）

このワークフローでは PDF や CSV をダウンロードするため、ダウンロードフォルダへのアクセスが必要。

• Claude Code の場合：ダウンロードフォルダ（通常 ~/Downloads）にアクセスできることを確認する
• Cowork の場合：ダウンロードフォルダを作業フォルダとして追加するようユーザーに依頼する
• アクセスが確認できたら → Check 3 に進む

Check 3: Sheets API Authentication（Sheets API 認証確認）

プロジェクトディレクトリ内の Service Account JSON 鍵ファイルを使い、Domain-Wide Delegation で Google Sheets API への認証を確認する。

• 鍵ファイルを検出する
• ユーザーに「Sheets API の操作に使用する Google Workspace アカウントのメールアドレスを教えてください。」と確認する
• subject にユーザーのメールアドレスを指定して oauth2.googleapis.com でアクセストークンを取得する
• 対象スプレッドシートのメタデータ（シート名一覧）を取得して読み取りを確認する
• 認証成功の場合 → Check 完了。以降の Sheets API 操作はすべてこの subject で実行する
• 失敗の場合 → エラー内容をユーザーに通知し、Prerequisites（Domain-Wide Delegation の設定）を確認するよう依頼する

Preflight Complete

すべてのチェックが完了したら：

1. ユーザーに「経理部門シートの『記入者』カラムに記入する名前を教えてください。」と確認する
2. 対象月の確認を行う（Common: Month Calculation 参照）
3. 作業フォルダを作成する（Workspace Setup 参照）
4. 監査ログを初期化する（Audit Log 参照）
5. 「事前チェック完了。経理処理を開始します。」と通知し、Phase 1 に進む

Target Services（対象サービス）

Execution Order（実行順序）

必ず以下の順序で実行する：

1. Phase 1: Revenue Processing — Shopify Partner（売上処理）
2. Phase 2: Expense Processing — Bakuraku Card（経費処理）

各 Phase の開始時にユーザーに「Phase X を開始します」と通知する。

Common: Login Handling（共通：ログイン処理）

各サービスのページを開いた際、以下の判定を行う：

1. ページ内容からログイン状態を判定する
2. ログイン済みの場合 → そのままデータ取得を続行
3. 未ログイン（ログインページにリダイレクトされた等）の場合：
   • ユーザーに「{サービス名} にログインが必要です。Keeper Fill でログインを承認してください。完了したら OK と教えてください。」と伝える
   • ユーザーの「OK」を待つ
   • ログイン後のページを確認し、データ取得を続行

重要：ログインフォームにパスワードを直接入力してはならない。Keeper Fill がフォームを自動入力する。

Common: Month Calculation（共通：対象月の計算）

経理処理は月初に前月分を処理する。現在日付から前月を自動計算する。

• 現在が 2026年2月 → 対象月は 2026年1月
• 処理開始時にユーザーに「対象月: {YYYY年M月} で処理します。変更する場合は教えてください。」と確認する

Common: Workspace Setup（共通：作業フォルダ）

対象月の確定後、プロジェクトディレクトリ内に作業フォルダを作成する。

{プロジェクトディレクトリ}/
└── {YYYY-MM}/              ← 作業フォルダ（対象月）
    ├── downloads/          ← ダウンロードファイル保管
    └── audit.log           ← 監査ログ

• フォルダ名は対象月の YYYY-MM 形式（例：2026-01）
• downloads/ サブフォルダを作成する
• 作業中にダウンロードした PDF・CSV はすべて downloads/ フォルダに移動して保管する

Common: Audit Log（共通：監査ログ）

作業の監査・追跡を目的として、作業フォルダ内に audit.log を作成する。後から「何をどう判断し、何を書き込んだか」を辿れることが目的。

ログフォーマット

[YYYY-MM-DD HH:MM:SS] CATEGORY: message

CATEGORY は以下のいずれか：

• INIT — 作業開始・パラメータ確定
• SELECT — データ選択の判断根拠
• EXTRACT — ソースからのデータ抽出結果
• WRITE — スプレッドシートへの書き込み実行
• COMPLETE — Phase/作業完了

記録タイミングと内容

以下のタイミングで、以下の内容を記録する：

INIT（Preflight Complete 時）:

[timestamp] INIT: target_month=2026-01, operator={記入者名}, subject={メールアドレス}, workspace={作業フォルダパス}

SELECT（Step 1-2 完了時 — Payout 選択後）:

[timestamp] SELECT: shopify_payouts selected={件数} entries, payout_dates=[{日付1}, {日付2}]

EXTRACT（Step 1-3 完了時 — PDF データ抽出後）:

[timestamp] EXTRACT: payout {payout_date}: USD={金額}, JPY={金額}

（Payout ごとに1行ずつ）

WRITE（Step 1-4 実行後 — Revenue Raw Data 書き込み後）:

[timestamp] WRITE: revenue_raw_data sheet={シート名}, rows_written={件数}, range={書き込み範囲}

WRITE（Step 1-6 実行後 — 経理シート転記後）:

[timestamp] WRITE: accounting_billing sheet=請求依頼, spreadsheet={ID}, rows_written={件数}, start_row={行番号}

SELECT（Step 2-2 完了時 — CSV ダウンロード後）:

[timestamp] SELECT: bakuraku_csv file={ファイル名}, month={対象月}

EXTRACT（Step 2-3 完了時 — CSV データ抽出後）:

[timestamp] EXTRACT: bakuraku_expenses entries={件数}, total_amount={合計金額}JPY

WRITE（Step 2-4 実行後 — Expenses Raw Data 書き込み後）:

[timestamp] WRITE: expenses_raw_data sheet={シート名}, rows_written={件数}, range={書き込み範囲}

WRITE（Step 2-6 実行後 — 経理シート転記後）:

[timestamp] WRITE: accounting_payment sheet=支払依頼, spreadsheet={ID}, rows_written={件数}, start_row={行番号}

COMPLETE（全 Phase 完了時）:

[timestamp] COMPLETE: all phases finished, revenue_entries={件数}, expense_entries={件数}

Phase 1: Revenue Processing（売上処理）

Step 1-1: Open Shopify Partner Payments Page

Claude in Chrome で以下の URL を開く：