仕様書テンプレートガイド

本ガイドは、BizLP GAS Accounting の全仕様書 (spec_*.md) に統一的な章立てを適用するためのテンプレート集である。新規作成・リライト時には、対象ファイルの性質に応じて適切なテンプレートを選択し、章構成に従うこと。

共通ルール

必須要素

MDTM YAML フロントマター（必須）

docs/dev/*.md の各仕様書ファイルは、ファイル先頭に下記のフロントマターを必ず付与する:

---
id: MAS-NNN                # 3桁ゼロ埋め固定。docs/_internal/id_mapping_table.csv で採番
aliases: ["F-NN", "F-0NN"] # 旧ID表記の揺れを全て含める（後方互換）。リスト形式必須
type: Story                # Epic | Story | Task | Bug | Research のいずれか
status: Open               # Open | InProgress | Done | Canceled | Duplicate
# parent: MAS-NNN          # 親案件があれば指定（無ければキー自体を省略）
---

• 新規採番は docs/_internal/id_mapping_table.csv を SSoT として参照・追記する
• aliases には旧ID（F-1 / F-01 / F-001 のような桁数揺れも全て）を配列で含める
• status は実装進捗を反映（仕様書段階=Open、MVP 完了等=InProgress、全完了=Done）

記述スタイル

テンプレートA: RPA/バッチ処理仕様

対象ファイル

spec_rpa_hc.md, spec_rpa_saas.md, spec_rpa_capex.md, spec_rpa_pipeline.md, spec_rpa_finance.md, spec_rpa_adhoc.md, spec_stl_auto.md

章構成

<!-- テンプレート: A (RPA/バッチ処理) -->
# タイトル — 対象タブ名

## 1. 基本情報
> **焦点質問**: このRPAは何のデータから、どのようなINVを自動生成するか？

| 項目 | 内容 |
|------|------|
| 関数名 | generateXxxInvoices |
| ファイル | 401_bat_rpa.js |
| 入力 | NN_bud_xxx |
| 出力 | 32_wrk_invoice + 31_wrk_order |
| メニュー | 「⚙️ ...」 |

## 2. 前提条件・依存関係
| 項目 | 内容 |
|------|------|
| SSOT | 32_wrk_invoice |
| マスタ依存 | 11_mst_account（科目名完全一致）... |
| 前提 | 有効フラグ=TRUEの行のみ処理対象 |

## 3. 入力スキーマ
| # | 列名 | 型 | 入力/自動 | 説明 | 制約 |

## 4. 処理ロジック（マトリクス）
| STEP | 処理 | 入力列 | ソース | 出力/変数 | 条件 |

## 5. 出力サマリー
生成されるINV行の一覧テーブル

## 6. 業務ルール
技術用語を排除した業務説明。算出式は日本語数式。

## 7. 冪等性（二重起票防止）
isDuplicate_ / JNL_IDチェックの説明

## 8. エラーハンドリング
| エラー条件 | 処理 | ユーザー通知 |

## 9. テスト仕様
| テストID | テスト名 | 前提条件 | 期待結果 |

## 付録
### 付録A: 変更履歴
### 付録B: ADR

テンプレートB: データマート/財務諸表仕様

対象ファイル

spec_pl.md, spec_bs.md, spec_cf.md, spec_daily_cf.md, spec_plan.md

章構成

<!-- テンプレート: B (データマート/財務諸表) -->
# タイトル — 出力タブ番号

## 1. 概要
> **焦点質問**: この財務諸表は何を示し、経営者はここから何を読み取るか？

| 項目 | 内容 |
|------|------|
| 出力タブ | NN_xxx |
| 関数 | dmBuildXxx_ |
| ファイル | 6xx_datamart_xxx.js |

## 2. データソース
| ソース | 読み込み条件 | 用途 |

## 3. 対象判定・フィルタ条件
| # | 条件 | 処理 | 理由 |

## 4. 処理ロジック
| STEP | 処理 | 入力 | 出力 | 条件 |

## 5. 財務ロジック (FRD)
> ※ 本セクションは経理担当・CFOが検証可能な表現で記述。
> 技術用語は使用しない。算出式は日本語数式。
> → 技術詳細: §4 参照

### 5.1 [ルール名]
...

## 6. 出力スキーマ
| セクション | 表示区分 | 科目例 | 符号 |

## 7. エッジケース・境界条件
| ケース | 条件 | 処理 |

## 8. テスト仕様
| テストID | テスト名 | 前提条件 | 期待結果 |

## 付録
### 付録A: 実装ファイル
### 付録B: ADR

テンプレートC: エンジン/コア処理仕様

対象ファイル

spec_engine.md, spec_datamart_ingest.md, spec_pipeline_ingest.md, spec_pipeline_plan.md

章構成

<!-- テンプレート: C (エンジン/コア処理) -->
# タイトル — 関数名 or モジュール名

## 1. 基本情報
> **焦点質問**: このモジュールはシステム全体のどの位置で、何を処理するか？

| 項目 | 内容 |
|------|------|
| ファイル | 403_subledger_engine.js |
| 主要関数 | processInvoiceApprovals, ... |

### アーキテクチャ図（Mermaid）
```mermaid
flowchart TB
  ...
```（反映すべきデータフローを図示）

## 2. インターフェース定義
| 関数 | 引数 | 戻り値 | トリガー |

## 3. データスキーマ
| # | 列名 | 型 | 入力/自動 | 説明 |

## 4. 処理ロジック
### 4.1 [サブ処理名]
| STEP | 処理 | 入力 | 出力 | 条件 |

## 5. 財務ロジック (FRD)
> ※ 技術用語排除。算出式は日本語数式。

## 6. 冪等性・整合性保証
| 保証項目 | メカニズム | 検証方法 |

## 7. テスト仕様
| テストID | テスト名 | 前提条件 | 期待結果 |

## 付録
### 付録A: ヘルパー関数一覧
### 付録B: メンテナンスツール
### 付録C: ADR

テンプレートD: 機能改修/設計仕様

対象ファイル

spec_ord.md, spec_cc_import.md, spec_receipt_import.md, spec_project_accounting.md, spec_corporate_tax.md, spec_data_validation.md, spec_tab_renumber.md, spec_plan_bs_fix.md

章構成

<!-- テンプレート: D (機能改修/設計) -->
# タイトル — 対象タブ or 機能名

## 1. 概要
> **焦点質問**: この改修は何の課題を解決し、どのような変更を加えるか？

### 背景・課題
...

## 2. 設計判断
| 選択肢 | メリット | デメリット | 選定 |
（ADR形式。既存ADRがあればリンク、なければ新規記述）

## 3. 変更内容
### 3.1 スキーマ変更
| 対象タブ | 変更列 | 変更内容 |

### 3.2 ロジック変更
| STEP | 処理 | 入力 | 出力 | 条件 |

### 3.3 UI変更
| 対象 | 変更内容 |

## 4. 影響範囲
| 影響対象 | 影響内容 | 対応 |

## 5. テスト仕様
| テストID | テスト名 | 前提条件 | 期待結果 |

## 付録
### 付録A: 改修ファイル一覧
### 付録B: Before-After
### 付録C: ADR

マスタ定義の統一フォーマット

対象ファイル

mst_account.md, mst_dict.md, mst_sys_config.md

章構成

# タイトル — タブ名

## 1. 概要
> **焦点質問**: このマスタは何を定義し、どの処理で参照されるか？

## 2. スキーマ定義
| # | 列名 | 型 | 必須 | 説明 | 参照元spec |

## 3. 登録ルール
| ルール | 詳細 |
（追加・変更・削除の制約、バリデーション）

## 4. 依存関係
| 参照元ファイル | 参照方法 | 用途 |

## 5. 初期データ
setupAllSchemas で投入されるデフォルト値・DDL設定

テンプレート選定ガイド