本書は本プロジェクトの全シート (タブ) の列定義を横断的に追えるようにするための索引と凡例。
詳細な列定義は番台別ファイルへ分割する。
0. 目的・読み方
- 目的: 「あの列は何を入れるのか」「どのシートに参照されるのか」を 1 箇所で引けるようにする。
- 読み方:
- シート全体像を知りたい → 本ファイル §3 全タブ索引
- 特定シートの列定義を見る → 番台別ファイルの該当節
- 列リネーム履歴を確認 → §4 RENAME_MAP
- 11_mst_account / 15_mst_dict / 01_sys_config の詳細 → 既存
docs/master/*.md (本書は要約のみ)
- 32_wrk_invoice / 33_wrk_bank / 42_trn_journal のスタースキーマ観点 →
docs/arch/arch_data_model.md
1. SSOT との関係
本書は「読みもの」であり、実装と乖離した場合は実装側を正とする。
| 役割 | ソース |
|---|
| 列定義 (DDL) の SSOT | mas/100_config/101_sys_config.js:840-1069 の setupAllSchemas 内 schemas |
| 列リネーム履歴 | setupAllSchemas 内 RENAME_MAP (101_sys_config.js:1107-1137) |
| DTO 変換 (行 ⇔ オブジェクト) | mas/000_infra/003_contracts.js:211-260 (toDto / toRows) |
| ヘッダー名ベース参照 | mas/400_domain/410_subledger_engine.js:77 (buildHeaderIndex_) ほか各 Repository |
| 物理シート名 ↔ システムキー | 01_sys_config シート (Utils.getSheetNameByKey()) |
各シート節の冒頭には「DDL 管理: ✅ (101_sys_config.js:行範囲)」を明記しているので、本書が古くなった疑いがある場合は実装で確認できる。
2. 凡例
2.1 型表記
| 表記 | 意味 |
|---|
bool | TRUE / FALSE |
string | 文字列 |
number | 数値 (整数 / 小数) |
date | 日付 (yyyy-mm-dd) |
datetime | 日時 |
enum | 列挙値 (15_mst_dict や固定セットから選択) |
json | JSON 文字列 (シナリオ系) |
id | 主キー / 外部キーとなる ID 文字列 |
2.2 必須マーカー
| 表記 | 意味 |
|---|
| ● | 必須 (空欄不可・処理スキップ条件にもなる) |
| ○ | 任意 (空欄許容) |
| 自動 | システムが自動採番 / 自動転記する。手入力不要 |
2.3 FK / 参照表記
| 表記 | 意味 |
|---|
→ 11_mst_account.科目名 | 11_mst_account の科目名列と完全一致で参照 (名称ベース結合) |
→ 15_mst_dict[カテゴリ] | 15_mst_dict の指定カテゴリのプルダウン値から選択 |
→ 32_wrk_invoice.請求ID(INV) | ファクト間結合 (例: STL → INV) |
名称ベース結合のため、マスタ側の名称変更時はファクト側の不整合を生む。検出は docs/spec/spec_data_validation.md を参照。
2.4 バリデーション表記
setupAllSchemas の validations ブロックに対応:
| 表記 | 例 | 意味 |
|---|
range(min, max) | range(-1, 12) | 数値範囲 (両端含む) |
date_range(min, max) | date_range(2020-01-01, 2030-12-31) | 日付範囲 |
regex(pattern) | regex(^\d{13}$) | 正規表現 |
enum(値1, 値2, ...) | enum(有, 無) | 固定値リスト |
3. 全タブ索引 (実装ベース)
68 タブのうち、本書で列定義を持つ 22 タブと、既存 doc を持つ 4 タブを ✅、それ以外を未掲載として明示する。生成タブは「動的生成」と表示。
3.1 マスタ (10 番台)
3.2 予算 (20 番台 + 29-30)
3.3 サブ元帳・取込 (30 番台)
3.4 仕訳台帳 (40 番台)
3.5 既存 doc を持つシステム系 / 監査系
| 物理タブ名 | システムキー | 種別 | DDL管理 | 列定義doc |
|---|
| 01_sys_config | SYS_CONF | sys | ✅ | docs/master/mst_sys_config.md |
| 02_sys_dropdown | — | sys | 動的生成 | 未掲載 (プルダウン候補・15_mst_dict 等から =FILTER で生成) |
| 03_sys_params | SYS_PARAM | sys | 動的生成 | docs/master/mst_sys_config.md §03_sys_params |
| 51_list_pipeline_plan | SYS_LIST_PIPE | sys | ✅ | 未掲載 (Read-Only 一覧・21_bud_pipeline 派生) |
| 52_list_bs_details | SYS_LIST_BS | sys | ✅ | 未掲載 (Read-Only 一覧・BS 仕訳明細) |
| 90_test_results | SYS_TEST | sys | ✅ | 未掲載 (テスト結果ログ) |
| 98_audit_log | LOG_AUDIT | log | ✅ | 未掲載 (監査証跡 WORM・ADR-0013/MAS-179/MAS-213 参照) |
| 00_menu | CAT_MENU | sys | ✅ | 未掲載 (MAS-214 メニューカタログ) |
3.6 財務諸表・派生 (60-90 番台・本書スコープ外)
以下はすべて動的生成タブ。列構成はレポート出力ロジック側で決定する (本書では未掲載)。
| 番台 | 物理タブ名 | 生成元 |
|---|
| 60s P/L | 61_pl_monthly / 62_pl_ytd / 63_pl_monthly_plan / 64_pl_ytd_plan / 65_pl_variance / 67_report_investment_analysis / 68_report_investment_gonogo / 69_report_hiring_tco | mas/600_report/603_datamart_pl.js, 610_service_investment_analysis.js, 611_service_investment_gonogo.js, 612_service_hiring_tco.js |
| 70s B/S・PJ | 71_bs / 72_bs_snap / 73_bs_plan / 75_ss_equity_changes / 76_notes / 77_pj_raw / 78_pj_pl / 79_pj_monthly | mas/600_report/604_datamart_bs.js, 402_project_profitability.js |
| 80s CF | 81_cf_indirect / 81b_cf_indirect_ytd / 82_cf_indirect_plan / 82b_cf_indirect_plan_ytd / 83_cf_daily / 84_cf_daily_plan / 85_cf_daily_actual | mas/600_report/605_datamart_cf.js, 606_datamart_daily_cf.js |
| 90s 決算 | 91_fs_bs / 92_fs_pl / 93_kpi_dashboard / 94_fs_longterm_forecast / 95_sim_headcount | mas/600_report/607_datamart_fs.js |
4. 廃止予定列 (RENAME_MAP)
101_sys_config.js:1107-1137 の RENAME_MAP から抽出。setupAllSchemas 実行時、旧列名のデータを新列名へ自動移行する (新名 → [旧名候補]):
| 新列名 | 旧列名候補 |
|---|
| 発生日(P/L計上日) | 発生年月 / 発生日 / ご利用日 |
| 決済日_実績 | 決済日(C/F実績日) / 支払年月日 / 支払日(C/F実績日) / 決済実績日 |
| 決済日_計画 | 支払・回収期限 / 支払日(C/F計画日) / 決済予定日 |
| STL決済日_計画 | STL支払・回収期限 / STL支払日(C/F計画日) |
| 税込金額_決済 | 決済金額 / 税込金額_支払 |
| 決済区分 | 支払区分 |
| 決済ラグ(月) | 支払ラグ(月) |
| 決済手段 | 支払方法 |
| 科目名 | 入力用科目名 |
| 正式科目名 | 勘定科目 |
| 契約形態 | 契約サイクル |
| STL税込金額_決済 | STL決済金額 |
| 支払基準日 | 支払日 / 給与支払日 |
| 税抜金額_発注 | 発注総額(税抜) |
| 税抜金額_計画 | 請求額(税抜) / 税抜金額 |
| 税抜金額_実績 | 請求額(税抜) |
| 税抜金額_決済 | 請求額(税抜) / お支払い金額(￥) / 税抜金額_支払 |
| 消費税額_発注 | 消費税額 |
| 消費税額_計画 | 消費税額 |
| 消費税額_実績 | 消費税額 |
| 消費税額_決済 | 消費税額 / 消費税額_支払 |
| 税込金額_発注 | 発注総額(税込) |
| 税込金額_計画 | 請求総額(税込) / 税込金額 |
| 税込金額_実績 | 請求総額(税込) |
| 税込金額_決済 | 請求総額(税込) / ご利用金額(￥) / 税込金額_支払 |
| 取引先名 | 取引先名(推測) |
| 仕訳ステータス | ステータス |
| 仕訳ステータスコード | ステータスコード |
| STL取引先名 | STL取引先名(推測) |
命名規則の根拠は ADR-0004 ヘッダー列名の統一命名規則。
5. 未掲載タブ (今後の TODO)
本書のスコープ外。優先度は実需要に応じて検討:
- 37-40 シナリオ系 (F-67 / F-57 / MAS-071): payloadJSON 保存型のため列定義よりも JSON スキーマ定義が必要。各 dev_mas-* 仕様書側で定義
- 51-52 リスト系 (Read-Only 一覧): 派生元シート (21_bud_pipeline / BS 仕訳) の列を踏襲。重複定義を避けるため未掲載
- 60-90 番台 財務諸表・派生: 動的生成のため
mas/600_report/*.js の出力ロジック側に定義あり。データ定義書としては別タスク
- 02_sys_dropdown / 90_test_results / 98_audit_log / 00_menu: 内部システム用。需要に応じて追加