データモデル技術設計書

設計思想

なぜスタースキーマか

BizLP GAS Accounting は、スプレッドシート上に暗黙的なスタースキーマを採用している。

スタースキーマでは、中心にトランザクションデータを格納するファクトテーブルを配置し、その周囲に分析軸となるディメンションテーブルを一対多で接続する。対照的に、スノーフレークスキーマではディメンションをさらにサブテーブルに正規化するが、以下の理由からスタースキーマを選択した:

非正規化を許容する理由

Google Spreadsheet はリレーショナルDBではない。SQL の JOIN に相当する操作は GAS の indexOf / buildHeaderIndex_ による手動ルックアップで代替しており、参照コストが高い。このため、ファクトテーブル（32_wrk_invoice 等）には以下の非正規化を意図的に適用している:

SSOT (Single Source of Truth) としての INV

全ての財務諸表（P/L・B/S・C/F）およびPJ別損益の集計は 32_wrk_invoice (INV) を起点とする。42_trn_journal (TRN) は監査証跡であり、集計ソースとしては使用しない。

詳細は ADR-0001: SSOTとしてのINV を参照。

ファクトテーブル

本システムのファクトテーブルは、トランザクションの発生を記録するテーブル群である。

主キー形式: 全て <TYPE>_YYYYMMDD_NNNN。計画 3 額 = 税抜/消費税/税込（INV 列）。実績 3 額 = 同（TRN 列）。

32_wrk_invoice (INV) — 請求・債権債務台帳

33_wrk_bank (STL) — 入出金・消込台帳

ディメンションテーブル

ディメンションテーブルは、ファクトの分析軸を提供するマスタデータである。

結合メカニズム

本システムでは SQL の JOIN に代わり、以下のメカニズムでファクト↔ディメンションを結合する:

1. ファクトテーブルにディメンション値を「名称」で直接埋め込み（非正規化）
   INV.科目名 = "旅費交通費"   ← 11_mst_account.科目名 と文字列完全一致

2. 集計時に必要な派生属性のみマスタ参照
   buildHeaderIndex_(mstAcctData) で科目マスタを連想配列化
   → 科目名をキーに 諸表区分・表示区分・固変区分 を取得

3. 参照はヘッダー名ベース（列番号ハードコード禁止）
   const idx = headers.indexOf("科目名");

設計トレードオフ: 名称ベースの結合は、マスタ側の名称変更時にファクト側の不整合を生む。これは 06. データ整合性チェック の科目マスタ存在チェックで検出する。

11_mst_account — 勘定科目マスタ

14_mst_project — プロジェクトマスタ

ER図

erDiagram
    MST_ACCT ||--o{ WRK_INVC : "科目名"
    MST_ACCT ||--o{ WRK_BANK : "差額処理科目"
    MST_PART ||--o{ WRK_INVC : "取引先名"
    MST_PART ||--o{ WRK_BANK : "取引先名"
    MST_ORGN ||--o{ WRK_INVC : "組織名"
    MST_ORGN ||--o{ WRK_BANK : "組織名"
    MST_PROJ ||--o{ WRK_INVC : "PJ名"
    MST_DICT ||--o{ WRK_INVC : "ステータス/区分"
    MST_DICT ||--o{ WRK_BANK : "ステータス/区分"
    MST_DICT ||--o{ MST_PROJ : "PJ区分/契約形態"

    WRK_ORDR ||--o{ WRK_INVC : "親発注ID(ORD)"
    WRK_INVC ||--o{ WRK_BANK : "消込対象請求ID(INV)"
    WRK_INVC ||--o| TRN_JOUR : "自動仕訳JNL_ID"
    WRK_BANK ||--o| TRN_JOUR : "自動仕訳JNL_ID"

    MST_ACCT {
        string 主科目コード PK
        string 科目名 UK
        string 諸表区分
        string 大分類
        string 表示区分
        string 固変区分
        number デフォルト税率
    }

    MST_PART {
        string 取引先コード PK
        string 取引先名
        string 取引先区分
    }

    MST_ORGN {
        string 組織コード PK
        string 組織名
    }

    MST_PROJ {
        string PJコード PK
        string プロジェクト名
        string PJ区分
        string 配賦区分
    }

    MST_DICT {
        string カテゴリ PK
        string 設定コード PK
        string 表示名
    }

    WRK_ORDR {
        string 発注ID_ORD PK
        string 取引先名 FK
        string PJ名 FK
        number 税込金額_発注
        number 発注残高
    }

    WRK_INVC {
        string 請求ID_INV PK
        string 親発注ID_ORD FK
        date 発生日
        date 決済日_計画
        string 請求ステータス FK
        string 科目名 FK
        string 取引先名 FK
        string PJ名 FK
        string 組織名 FK
        number 税込金額_計画
        number 未決済残高
        string 自動仕訳JNL_ID FK
    }

    WRK_BANK {
        string 決済ID_STL PK
        string 消込対象請求ID_INV FK
        date 決済日_実績
        string 決済ステータス FK
        number 税込金額_決済
        string 自動仕訳JNL_ID FK
    }

    TRN_JOUR {
        string 取引ID PK
        date 発生日
        string 科目名 FK
        number 税込金額_実績
        string 仕訳ステータス
    }

ER図の読み方

• 実線: ファクト↔ディメンションの結合（名称ベースの文字列一致）
• ||--o{: 一対多（1つのマスタレコードが複数のファクト行で参照される）
• ||--o|: 一対零or一（1つのINV/STLに対して0件or1件のTRNが紐づく）
• FK列: スプレッドシート上は外部キー制約なし。データ整合性チェック (03_data_validator.js) で検証

データフロー図

flowchart TB
    subgraph MST["10s マスタデータ"]
        MST_A["11_mst_account
勘定科目"]
        MST_P["12_mst_partner
取引先"]
        MST_O["13_mst_organization
組織"]
        MST_J["14_mst_project
プロジェクト"]
        MST_D["15_mst_dict
コード辞書"]
    end

    subgraph BUD["20s 予算・契約マスタ"]
        B1["21_bud_pipeline
売上パイプライン"]
        B2["22_bud_headcount
人員・給与"]
        B3["23_bud_subscription
SaaS"]
        B4["24_bud_capex_loan
設備投資"]
        B5["25_bud_finance
資金移動"]
        B6["26_bud_adhoc
単発経費"]
    end

    subgraph WRK["30s サブ元帳"]
        ORD["31_wrk_order
発注台帳 (ORD)"]
        INV["32_wrk_invoice
請求台帳 (INV)
★ SSOT"]
        STL["33_wrk_bank
入出金台帳 (STL)"]
    end

    subgraph TRN["40s 総勘定元帳"]
        JNL["42_trn_journal
仕訳台帳 (TRN)
監査証跡"]
    end

    subgraph OUT["60s-90s 財務諸表"]
        PL["61/62 P/L"]
        BS["71/73 B/S"]
        CF["73/74 C/F"]
        PJ["78/79 PJ損益"]
        DCF["83-85 日次CF"]
        FS["91/92 財務諸表"]
    end

    MST --> BUD
    BUD -->|"RPA起票
401_bat_rpa.js"| ORD
    BUD -->|"RPA起票"| INV
    ORD -.->|"ORD_ID紐づけ"| INV
    INV -->|"Action A
承認→仕訳転記"| JNL
    INV -->|"Action A
STL自動作成"| STL
    STL -->|"Action B
消込→決済仕訳"| JNL
    STL -->|"Action B
残高更新"| INV

    INV -->|"PHASE 1
承認済INV"| OUT
    STL -->|"PHASE 2
消込済STL"| OUT

    MST_A -.->|"科目分類"| OUT

    style INV fill:#4a90d9,color:#fff,stroke:#2c5f8a
    style JNL fill:#95a5a6,color:#fff,stroke:#7f8c8d

データフローの段階

テーブル拡張ガイドライン

タブ番号体系

全タブ一覧（処理段階ツリー）

[10s MST] マスタデータ ─────────────────────────────────
  11_mst_account    科目マスタ（正式科目名・科目名・表示区分・固変区分）
  12_mst_partner    取引先マスタ
  13_mst_organization 組織マスタ
  14_mst_project    プロジェクトマスタ（配賦区分: 配賦元/先/対象外）
  15_mst_dict       コード辞書（プルダウン値の定義）
    ↓
[20s BUD] 予算・契約マスタ ──────────────────────────────
  21_bud_pipeline    売上パイプライン（確度・MRR・スポット）
  22_bud_headcount   人員・給与マスタ（社保・源泉税の自動計算）
  23_bud_subscription SaaS・サブスク管理
  24_bud_capex_loan  設備投資・借入管理
  25_bud_finance     資金移動・財務取引
  26_bud_adhoc       単発経費（領収書→自動登録連携）
  27_bud_resource    要員稼働率（PJ別工数配賦）
  28_bud_allocation  共通費配賦ルール
    ↓ RPA起票 (401_bat_rpa.js)
[30s WRK] サブ元帳 ─────────────────────────────────────
  31_wrk_order      発注・契約台帳 (ORD)
  32_wrk_invoice    請求・債権債務台帳 (INV) ← Single Source of Truth
  33_wrk_bank       入出金・消込台帳 (STL)
  34_wrk_card       クレカ明細（JCBインポート→STLマッチング）
  35_wrk_receipt    領収書・請求書（PDF→Gemini API解析）
    ↓ 仕訳エンジン (403_subledger_engine.js)
[40s TRN] 総勘定元帳 ───────────────────────────────────
  41_trn_budget     予算仕訳
  42_trn_journal    仕訳台帳 (JNL) — 監査証跡
    ↓ データマート (6xx_datamart_*.js)
[60s-90s] 財務諸表・管理会計レポート ──────────────────
  61/62_pl           P/L（単月/YTD）
  63/64_pl_plan      P/L計画（単月/YTD）
  71/73_bs           B/S（実績/計画）
  73/74_cf           C/F 間接法（実績/計画）
  78_pj_pl           PJ別P/L（通期・共通費配賦込み）
  79_pj_monthly      PJ別月次採算（限界利益）
  83/84/85_cf_daily  CF日次（計上/計画/実績）
  91/92_fs           財務諸表レンダリング（B/S・P/L）

新規タブ追加の手順

1. 番号の割り当て: 上記番号帯から適切な範囲を選択。同番号帯内で空き番号を使用
2. システムキーの定義: 01_sys_config に システムキー_GAS を追加 (例: WRK_NEWT)
3. スキーマの定義: 101_sys_config.js の setupAllSchemas 内に列定義を追加
4. IDプレフィックスの定義: 002_constants.js の ID_PREFIXES に追加 (例: NEW_)
5. ディメンション結合の設計: ファクトテーブルの場合、どのマスタと結合するかを決定
   • 結合キーはヘッダー名ベース（列番号ハードコード禁止）
   • 非正規化する属性（INVに直接埋め込む値）を明確にする
6. DDL実行: setupAllSchemas を実行してスキーマを同期
7. 仕様書の更新: docs/ 配下に対応する spec_xxx.md を作成

列追加のルール

付録: アーキテクチャ決定記録

スタースキーマ型データモデルの採用根拠は ADR-0047: スタースキーマ型データモデルを採用する を参照。

本付録は元々「ADR-0008: スタースキーマ型データモデルの採用」として埋め込まれていたが、正規 ADR-0008 (Vertex AI 集約) との番号衝突を解消するため、ADR-0047 として独立採番した (2026-05-16)。決定内容に変更はない。