octkp/charge-test-data-generator

Charge Test Data Generator

課金機能テスト用のSQLを生成するスキル。企業の課金状態を特定のパターンに設定する。

SQL出力先

対応するDB（bamanager or xba）と環境（aoba or cuba）によってディレクトリを分ける。

qa_sqls/
├── xba/
│   ├── aoba/    # aoba7環境用（bank_code: 0117）
│   │   └── {SQL No}_{パターン名}.sql
│   └── cuba/    # cuba7環境用（bank_code: 0542）
│       └── {SQL No}_{パターン名}.sql
└── bamanager/
    ├── aoba/    # aoba7環境用（bank_code: 0117）
    │   └── {SQL No}_{パターン名}.sql
    └── cuba/    # cuba7環境用（bank_code: 0542）
        └── {SQL No}_{パターン名}.sql

フルパス:

• xba: /Users/takano_y/.claude/skills/charge-test-data-generator/qa_sqls/xba/{環境}/{パターン名}.sql
• bamanager: /Users/takano_y/.claude/skills/charge-test-data-generator/qa_sqls/bamanager/{環境}/{パターン名}.sql

テストパターン

課金タイプ変更

| パターン | company_charge_type | company_next_charge_type | |---------|---------------------|--------------------------| | 月払い→月払い | MONTHLY | MONTHLY | | 月払い→年払い | MONTHLY | ANNUAL | | 年払い→月払い | ANNUAL | MONTHLY | | 年払い→年払い | ANNUAL | ANNUAL |

課金タイミング

| パターン | 説明 | |---------|------| | 先月課金・今月課金予定 | 契約期間が先月末で終了 | | 今月初課金 | 課金開始日が今月 | | 年払い期間中 | 年払い契約期間の途中 | | 契約満了直前 | 年払い契約が今月末で満了 |

---

プレテスト（test7）パターン一覧

プレテスト環境（aoba7/cuba7）で使用するパターン。SQL Noをファイル名のプレフィックスとして使用する。

カテゴリ1: 日付操作が必要なケース（D-01〜D-06）

| パターン | 説明 | SQL操作 | 検証目的 | |----------|------|---------|----------| | D-01 | 年払い申込後、無料期間終了 | 無料期間終了日を過去日付に設定 | 無料期間満了後の課金データ生成確認 | | D-02 | 契約満了日の23:59→0:01をまたぐ | 契約終了日を検証日の前日に設定 | 日付境界での契約更新処理確認 | | D-03 | 年払い契約11ヶ月目（残1ヶ月） | 契約開始日を11ヶ月前に設定 | 契約満了間近での退会予約動作確認 | | D-04 | 年払い契約満了月の1日 | 契約終了日を検証月末に設定 | 契約更新メール・イベント生成確認 | | D-05 | 月払い→年払い変更予約後の契約満了 | 月払い契約終了日を検証日の前日に設定 | 年払いへの切替処理確認 | | D-06 | 年払い→月払い変更予約後の契約満了 | 年払い契約終了日を検証日の前日に設定 | 月払いへの切替処理確認 |

カテゴリ2: 金融機関設定操作が必要なケース（F-01）

| パターン | 説明 | SQL操作 | 検証目的 | |----------|------|---------|----------| | F-01 | 年払いON→OFF後の既存年払いユーザー契約満了 | ①年払いONで年払い契約作成→②年払いOFF→③契約終了日を過去に設定 | 強制月払い切替確認 |

カテゴリ3: バッチ処理タイミング確認が必要なケース（B-01〜B-04）

| パターン | 説明 | SQL操作 | 検証目的 | |----------|------|---------|----------| | B-01 | 課金データ作成バッチ実行後 | バッチ実行または同等のデータ状態作成 | 年払い課金データの正常生成確認 | | B-02 | 契約更新バッチ実行（年払い継続） | 契約満了日経過後のバッチ実行 | 年払い→年払いの更新確認 | | B-03 | 契約更新バッチ実行（年払い→月払い） | 変更予約済み＋契約満了日経過後のバッチ実行 | プラン切替の更新確認 | | B-04 | メール送信バッチ（AM9:00） | 契約満了月1日の状態作成 | メール送信＋イベント生成確認 |

カテゴリ4: 特殊条件の組み合わせ（X-04）

| パターン | 説明 | SQL操作 | 検証目的 | |----------|------|---------|----------| | X-04 | 年払い2年目更新直前 | 2年目の契約満了日を検証日の翌日に設定 | 2回目以降の更新処理確認 |

カテゴリ5: 課金開始日操作が必要なケース（K-02）

| パターン | 説明 | SQL操作 | 検証目的 | |----------|------|---------|----------| | K-02 | 年払い満了→月払い変更＋課金開始日が未来日 | 年払い契約満了＋課金開始日を未来日に設定 | 再無料期間発生時の挙動確認 |

カテゴリ6: 課金設定操作が必要なケース（CH-01）

| パターン | 説明 | SQL操作 | 検証目的 | |----------|------|---------|----------| | CH-01 | 年払い契約満了月＋課金無効 | 課金処理フラグをOFFに設定＋契約満了月1日の状態作成 | 契約更新確認メールが送信されないこと |

---

企業データ対応表（test7環境）

SQL Noをファイル名のプレフィックスとして使用。

金融機関コード

| 環境 | 金融機関コード | |------|----------------| | aoba7 | 0117 | | cuba7 | 0542 |

企業ID対応表

| SQL No | パターン | 説明 | aoba7 | cuba7 | |--------|----------|------|-------|-------| | 01 | D-01 + B-01 | 無料期間終了〜契約更新バッチ一連（初回年払い） | 123714352 | 123902124 | | 02 | B-02 | 契約更新バッチ実行（年払い継続） | 123657570 | 123528242 | | 03 | B-03 | 契約更新バッチ実行（年払い→月払い） | 123637984 | 123529190 | | 04 | D-02 | 契約満了日の23:59→0:01をまたぐ | 123583608 | 123529302 | | 05 | D-03 | 年払い契約11ヶ月目（残1ヶ月） | 123612848 | 123531604 | | 06 | D-04 + B-04 | 契約満了月1日（メール送信確認含む） | 123581219 | 123532307 | | 07 | D-05 + F-01 | 月払い→年払い変更予約後の契約満了 | 123582185, 123578422 | 123535186, 123555135 | | 08 | D-06 + F-01 | 年払い→月払い変更予約後の契約満了 | 123571118, 123570501 | 123566220, 123573857 | | 09 | X-04 | 年払い2年目更新直前 | 123560480 | 123588971 | | 10 | K-02 | 年払い満了→月払い変更＋課金開始日が未来日 | 123560475 | 123628544 | | 11 | CH-01 | 年払い契約満了月＋課金無効 | 123553837 | 123892092 |

SQLファイル命名規則

{SQL No}_{パターン番号}_{説明}.sql

例：

• 01_D-01_B-01_初回の年払いパターン.sql
• 02_B-02_年払い継続パターン.sql
• 03_B-03_年払いから月払いパターン.sql

---

参照ドキュメント

• docs/プレテスト（test7）企業データ管理表.md - 企業IDとパターンの対応表
• docs/開発側データ操作が必要なパターン.md - 各パターンの詳細説明と優先度

SQLフォーマット

基本形式（companiesのみ）

-- 目的: [テストパターンの説明]
-- 対象テーブル: companies

-------------------------------
-- 変数設定
-------------------------------
SET v.company_id = '企業ID';

-- companiesテーブル更新用
SET v.charge_type = 'MONTHLY';
SET v.next_charge_type = 'MONTHLY';
SET v.charge_amount = '3000';
SET v.next_charge_amount = '3000';
SET v.charge_start_at = 'YYYY-MM-01';
SET v.charge_period_start_date = 'YYYY-MM-DD';
SET v.charge_period_end_date = 'YYYY-MM-DD';
SET v.is_charge_target = '1';

-------------------------------
-- 1. 現在の状態を確認
-------------------------------
SELECT * FROM companies
WHERE company_id = current_setting('v.company_id')::int;

-------------------------------
-- 2. テストデータ更新
-------------------------------
UPDATE companies
SET
    company_charge_type = current_setting('v.charge_type'),
    company_next_charge_type = current_setting('v.next_charge_type'),
    company_charge_amount = current_setting('v.charge_amount')::int,
    company_next_charge_amount = current_setting('v.next_charge_amount')::int,
    company_charge_start_at = current_setting('v.charge_start_at')::date,
    company_charge_period_start_date = current_setting('v.charge_period_start_date')::date,
    company_charge_period_end_date = current_setting('v.charge_period_end_date')::date,
    company_is_charge_target = current_setting('v.is_charge_target')::int
WHERE company_id = current_setting('v.company_id')::int
RETURNING *;

拡張形式（charges, charge_items含む）

課金データの作成が必要な場合（契約更新テストなど）に使用。

-- 目的: [テストパターンの説明]
-- 対象テーブル: companies, charges, charge_items

-------------------------------
-- 変数設定
-------------------------------
SET v.company_id = '企業ID';
-- ... 各種変数

-------------------------------
-- トランザクション開始
-------------------------------
BEGIN;

-------------------------------
-- 1. 現在の状態を確認
-------------------------------
-- companies
SELECT * FROM companies
WHERE company_id = current_setting('v.company_id')::int;

-- charges
SELECT * FROM charges
WHERE charges.charge_company_id = current_setting('v.company_id')::int
ORDER BY charges.charge_date DESC;

-- charge_items
SELECT * FROM charge_items
WHERE charge_items.ci_charge_id IN (
    SELECT charges.charge_id FROM charges
    WHERE charges.charge_company_id = current_setting('v.company_id')::int
)
ORDER BY charge_items.ci_charge_id DESC, charge_items.ci_seq;

-------------------------------
-- 2. テストデータ更新
-------------------------------
-- 2-1. charge_historiesクリア
DELETE FROM charge_histories WHERE ...;

-- 2-2. chargesクリア
DELETE FROM charges WHERE ...;

-- 2-3. charges作成
INSERT INTO charges (...) VALUES (...);

-- 2-4. charge_items作成
INSERT INTO charge_items (...) SELECT ...;

-- 2-5. companies更新
UPDATE companies SET ... WHERE ... RETURNING *;

-------------------------------
-- トランザクション終了
-------------------------------
COMMIT;

ルール

• ASでのカラム名変更禁止
• テーブルエイリアス禁止（フルテーブル名を使用）
• 日本語名への変換禁止
• 確認SQLにLIMITは不要
• xbaでcharges更新時、企業に紐づく既存chargesのcharge_envをtest7に統一する

主要カラム

companies

| カラム | 説明 | 値 | |--------|------|-----| | company_charge_type | 現在の課金タイプ | MONTHLY / ANNUAL | | company_next_charge_type | 次回の課金タイプ | MONTHLY / ANNUAL | | company_charge_amount | 課金金額（税抜） | 月払い: 3000 / 年払い: 33000 | | company_next_charge_amount | 次回課金金額（税抜） | 月払い: 3000 / 年払い: 33000 | | company_charge_start_at | 課金開始日 | 日付（1日固定） | | company_charge_period_start_date | 契約期間開始日 | 日付 | | company_charge_period_end_date | 契約期間終了日 | 月払い: 月末 / 年払い: +11ヶ月末 | | company_is_charge_target | 課金対象フラグ | 0 / 1 |

制約

• company_charge_start_at は日が1日固定（CHECK制約）
• chargesテーブルは同一企業・課金タイプで期間重複不可（EXCLUDE制約）