1. 概要
焦点質問: このマスタは何を定義し、どの処理で参照されるか?
本マスタはシステム設定に関する2つのシートで構成される。
| 項目 | 01_sys_config | 03_sys_params |
|---|
| 役割 | シート登録簿 — 全タブのシステムキー・GID・物理名・論理名を管理 | システムパラメータ — 税率・設立年月等の実行時設定値を保持 |
| 参照API | Utils.getSheetByKey(key, fallback) / Utils.getSheetNameByKey(key) | Constants.getParam(key, defaultVal) |
| 実装ファイル | 004_utils.js (Utils名前空間) | 002_constants.js (Constants名前空間) |
| DDL管理 | setupAllSchemas() でヘッダー・初期行を自動投入 | DDL管理外(動的に生成・上書き) |
2. スキーマ定義
2.1 01_sys_config(シート登録簿)
| # | 列名 | 型 | 必須 | 説明 |
|---|
| A | システムキー_GAS | string | YES | コード内でシートを特定するキー(Utils.getSheetByKey の第1引数) |
| B | シートID_GID | number | — | Google Sheets の GID(シート固有ID)。参照のみ |
| C | 物理シート名_現在のタブ名 | string | YES | スプレッドシート上の実際のタブ名 |
| D | 論理名_用途 | string | — | シートの用途説明 |
ヘッダー行の背景色: #d9ead3(薄緑)、太字。
2.2 03_sys_params(システムパラメータ)
| パラメータキー | 用途 | デフォルト値 | 参照元 |
|---|
| CFG_TAX_BRACKET | 法人税累進境界額 | 8,000,000 | 602_datamart_main.js |
| CFG_TAX_NAT_LOW | 国税実効税率(低) | 0.165 | 602_datamart_main.js |
| CFG_TAX_LOC_LOW | 地方税実効税率(低) | 0.049 | 602_datamart_main.js |
| CFG_TAX_NAT_HIGH | 国税実効税率(高) | 0.256 | 602_datamart_main.js |
| CFG_TAX_LOC_HIGH | 地方税実効税率(高) | 0.080 | 602_datamart_main.js |
| CFG_MIN_TAX_ANNUAL | 地方税均等割(年額) | 70,000 | 602_datamart_main.js |
| CFG_FOUNDING_YEAR | 設立年(月割計算用) | 2025 | 602_datamart_main.js |
| CFG_FOUNDING_MONTH | 設立月 | 11 | 602_datamart_main.js |
| CFG_ALLOWANCE_RATE | 貸倒引当金繰入率 | 0.006 | 604_datamart_bs.js |
| CFG_ISSUED_SHARES | 発行済株式数 | 3,000 | 604_datamart_bs.js |
Constants.getParam() はシート起動時に1回だけ全行をキャッシュし、以降はメモリから返す。キーが未登録またはシート未存在の場合は defaultVal を返す。
3. 登録ルール
| ルール | 詳細 |
|---|
| キー自動補完 | 01_sys_config の C列(物理シート名)を編集すると onEdit でA列(システムキー)・D列(論理名)を自動補完 |
| キー命名規則 | {区分}_{略称} 形式。区分はタブ番号帯に準拠(SYS/MST/BUD/WRK/TRN/PL/BS/CF 等) |
| 初期行の自動投入 | setupAllSchemas() 実行時、既存キーに無い行のみ appendRow で追加(既存行は上書きしない) |
| 03_sys_params の型変換 | getParam は defaultVal が number の場合 Number() で変換、それ以外は String() で返す |
| 03_sys_params の編集 | パラメータ値はスプレッドシート上で直接編集。GAS再実行時にキャッシュが更新される |
4. 依存関係
4.1 01_sys_config の参照元
| 参照元ファイル | 参照方法 | 用途 |
|---|
004_utils.js | Utils.getSheetNameByKey(key) — 01_sys_config を走査してキー→シート名を解決 | 全モジュールのシート取得基盤 |
004_utils.js | Utils.getSheetByKey(key, fallback) — 上記 + フォールバック付きシート取得 | 全 .js ファイルから呼び出し |
101_sys_config.js | setupAllSchemas() — ヘッダー設定・初期行投入 | DDLセットアップ |
101_sys_config.js | onEdit(e) — C列編集時にA列・D列を自動補完 | UXアシスト |
401_bat_rpa.js | Utils.getSheetByKey 経由 | RPA起票先シート取得 |
501_cc_importer.js | Utils.getSheetByKey 経由 | クレカ明細インポート先取得 |
602_datamart_main.js | Utils.getSheetByKey 経由 | 財務諸表の入出力シート取得 |
403_subledger_engine.js | Utils.getSheetByKey 経由 | Action A/B のサブ元帳・仕訳シート取得 |
201_data_validator.js | Utils.getSheetByKey 経由 | バリデーション対象シート取得 |
402_project_profitability.js | Utils.getSheetByKey 経由 | PJ別損益のシート取得 |
802_audit.js | Utils.getSheetByKey 経由 | 監査ログのシート取得 |
901_test_runner.js | Utils.getSheetByKey 経由 | テスト対象シート取得 |
4.2 03_sys_params の参照元
| 参照元ファイル | 参照方法 | 用途 |
|---|
602_datamart_main.js | Constants.getParam('CFG_TAX_*') | 法人税累進課税ブラケット・設立年月のオーバーライド |
604_datamart_bs.js | Constants.getParam('CFG_ALLOWANCE_RATE') | 貸倒引当金 法定繰入率 |
604_datamart_bs.js | Constants.getParam('CFG_ISSUED_SHARES') | 発行済株式数(株主資本等変動計算書用) |
5. 初期データ
5.1 setupAllSchemas で自動投入されるシート登録行
SYS — システム管理
| システムキー | 物理シート名 | 論理名 |
|---|
| SYS_CONF | 01_sys_config | SYS_システム構成・テーブル定義 |
| SYS_DROP | 02_sys_dropdown | SYS_プルダウン生成API |
| SYS_PARAM | 03_sys_params | SYS_パラメータ設定 |
MST — マスタ
| システムキー | 物理シート名 | 論理名 |
|---|
| MST_ACCT | 11_mst_account | MST_勘定科目 |
| MST_PART | 12_mst_partner | MST_取引先 |
| MST_ORGN | 13_mst_org | MST_組織 |
| MST_PROJ | 14_mst_project | MST_プロジェクト |
| MST_DICT | 15_mst_dict | MST_汎用リスト |
| WRK_MAST | 16_wrk_master | マスタ登録申請 |
BUD — 予算
| システムキー | 物理シート名 | 論理名 |
|---|
| BUD_PIPE | 21_bud_pipeline | 予算_売上パイプライン(狩猟/農耕) |
| BUD_HC | 22_bud_headcount | 予算_人員計画・採用シミュレータ |
| BUD_SUBS | 23_bud_subscription | 予算_SaaS・サブスク(支払)管理 |
| BUD_CAPEX | 24_bud_capex_loan | 予算_設備投資・借入金シミュレータ |
| BUD_FIN | 25_bud_finance | 予算_資金移動・財務取引 |
| BUD_ADHOC | 26_bud_adhoc | 予算_単発予算(将来枠) |
| BUD_RSCE | 27_bud_resource | 予算_要員稼働率(PJ別) |
| BUD_ALLOC | 28_bud_allocation | 予算_配賦ルール |
WRK — サブ元帳(ERP)
| システムキー | 物理シート名 | 論理名 |
|---|
| WRK_ORDR | 31_wrk_order | サブ元帳_受発注・契約台帳 |
| WRK_INVC | 32_wrk_invoice | サブ元帳_請求・債権債務台帳(AP/AR) |
| WRK_BANK | 33_wrk_bank | サブ元帳_入出金・消込台帳 |
| WRK_CARD | 34_wrk_card | クレカ明細 |
| WRK_RCPT | 35_wrk_receipt | 領収書/請求書 |
TRN — トランザクション
| システムキー | 物理シート名 | 論理名 |
|---|
| TRN_BUDG | 41_trn_budget | 台帳_予算仕訳 |
| TRN_JOUR | 42_trn_journal | 台帳_仕訳台帳 |
SYS_LIST — 一覧(Read-Only)
| システムキー | 物理シート名 | 論理名 |
|---|
| SYS_LIST_PIPE | 51_list_pipeline_plan | 一覧_パイプライン展開明細(Read-Only) |
| SYS_LIST_BS | 52_list_bs_details | 一覧_BS仕訳ログ明細(Read-Only) |
P/L — 損益計算書
| システムキー | 物理シート名 | 論理名 |
|---|
| PL_M_ACT | 61_pl_monthly | P/L単月 計上 |
| PL_Y_ACT | 62_pl_ytd | P/L累積 計上 |
| PL_M_PLAN | 63_pl_monthly_plan | P/L単月 計画 |
| PL_Y_PLAN | 64_pl_ytd_plan | P/L累積 計画 |
B/S — 貸借対照表
| システムキー | 物理シート名 | 論理名 |
|---|
| BS_ACT | 71_bs | B/S残高 計上 |
| BS_SNAP | 72_bs_snap | B/Sスナップ 計上 |
| BS_PLAN | 73_bs_plan | B/S残高 計画 |
SS/FS — 決算書類
| システムキー | 物理シート名 | 論理名 |
|---|
| SS_EQ | 75_ss_equity_changes | 株主資本等変動計算書 |
| SS_NOTES | 76_notes | 個別注記表 |
| FS_BS | 91_fs_bs | 決算B/S |
| FS_PL | 92_fs_pl | 決算P/L |
PJ — プロジェクト別
| システムキー | 物理シート名 | 論理名 |
|---|
| PJ_RAW | 77_pj_raw | PJ別ローデータ |
| PJ_PL | 78_pj_pl | PJ別損益計算書 |
| PJ_MONTHLY | 79_pj_monthly | PJ別月次採算表 |
C/F — キャッシュフロー
| システムキー | 物理シート名 | 論理名 |
|---|
| CF_IND_ACT | 81_cf_indirect | CF間接法 計上 |
| CF_IND_ACT_YTD | 81b_cf_indirect_ytd | CF間接法 計上(累積) |
| CF_IND_PLAN | 82_cf_indirect_plan | CF間接法 計画 |
| CF_IND_PLAN_YTD | 82b_cf_indirect_plan_ytd | CF間接法 計画(累積) |
| CF_D_ACT | 83_cf_daily | CF日次 計上 |
| CF_D_PLAN | 84_cf_daily_plan | CF日次 計画 |
| CF_D_REAL | 85_cf_daily_actual | CF日次 実績 |
その他
| システムキー | 物理シート名 | 論理名 |
|---|
| SYS_TEST | 90_test_results | テスト結果 |
5.2 タブ番号体系
| 番号帯 | 区分 | 説明 |
|---|
| 01-03 | SYS | システム管理・設定・パラメータ |
| 11-16 | MST/WRK | マスタデータ・申請 |
| 21-28 | BUD | 予算入力・シミュレーション |
| 31-35 | WRK | サブ元帳(受発注→請求→決済のERPフロー)+ クレカ/領収書 |
| 41-42 | TRN | トランザクション(予算・仕訳明細) |
| 51-52 | LIST | 一覧・デバッグ用(Read-Only) |
| 61-64 | P/L | 損益計算書(単月/累積 x 計上/計画) |
| 71-79 | B/S/SS/PJ | 貸借対照表・決算書類・PJ別管理会計 |
| 81-85 | C/F | キャッシュフロー(間接法 単月/累積 + 日次 x 計上/計画/実績) |
| 90-92 | FS/TEST | 決算書類・テスト結果 |
5.3 列の色分けルール
| 列種別 | 背景色 | 用途 |
|---|
| 入力列 | 薄青 (#dce6f1) | ユーザーが手動入力する列 |
| 自動列 | 薄灰 (#f3f3f3) | システムが自動設定する列(編集不要) |
5.4 データフロー概要
予算入力(2x)
↓ RPA自動起票
サブ元帳(3x): 31_order → 32_invoice → 33_bank
↓ Action A/B (仕訳エンジン)
トランザクション(4x): 42_trn_journal
↓ マート更新 (buildBudgetTrendDataMart)
財務諸表(6x-8x): P/L → B/S → C/F