## 05_tax_return.md
# 申告書出力機能 設計書

## 1. 概要

### 1.1 目的
- 個人事業（青色申告）の申告書類を、e-TAX入力用の参照資料として出力する
- 税務署提出用の正式書類ではなく、**「どこに何を入力すればよいか」が視覚的に分かる書類**を提供する
- 申告完了後は、確定したデータの保存用としても使用する

### 1.2 対象書類
| 区分 | 書類 | 備考 |
|------|------|------|
| 共通 | 表紙 | 会社名・期・期間を自動表示 |
| 共通 | 貸借対照表（BS） | |
| 共通 | 損益計算書（PL） | |
| 共通 | 個別注記表 | 会計方針など |
| 共通 | 勘定科目内訳書 | 預貯金・借入金・売掛金など |
| 個人事業 | 月別売上内訳 | 決算書2.pdf相当 |
| 個人事業 | 給料賃金の内訳 | 決算書2.pdf相当 |
| 個人事業 | 減価償却計算 | 決算書3.pdf相当 |
| 法人 | 別表（所得計算） | 法人税申告書本体 |
| 法人 | 欠損金繰越計算書 | 該当時のみ |
| 共通 | **総勘定元帳** | 税理士・税務署向け |

## 2. 出力オプション

### 2.1 用途別プリセット
| オプション | 含める書類 | 想定用途 |
|-----------|-----------|---------|
| **銀行提出用** | 表紙 + BS/PL + 注記表 + 内訳書 | 融資相談、取引銀行提出 |
| **税務署提出用** | 上記 + 別表 + 総勘定元帳 | 確定申告（法人/個人） |
| **税理士用** | 決算書 + 総勘定元帳 + 試算表 | 税理士確認用（ワンセット） |
| **株主用** | 表紙 + BS/PL（簡易） | 株主総会資料 |
| **完全版** | すべて | 社内保存、監査対応 |

### 2.2 出力形式
- **PDF**（デフォルト）：印刷・メール送信用
- 印刷（直接印刷）：必要時のみ
- CSV（オプション）：データ分析用

## 3. 保存形式

### 3.1 期ごとのフォルダ構成
```
/data/accounting/
├── private/                 # 個人事業
│   ├── 2024/                # 年ごと
│   │   ├── 決算書.pdf
│   │   ├── 総勘定元帳.pdf
│   │   ├── 内訳書.pdf
│   │   └── 添付書類/
│   │       ├── 領収書_YYYYMMDD.pdf
│   │       └── 請求書_YYYYMMDD.pdf
│   └── 2023/
│
└── corporate/               # 法人
    ├── 第4期/                # 期ごと
    │   ├── 決算書.pdf
    │   ├── 総勘定元帳.pdf
    │   ├── 内訳書.pdf
    │   ├── 別表.pdf
    │   └── 添付書類/
    │       ├── 領収書_YYYYMMDD.pdf
    │       └── 契約書_YYYYMMDD.pdf
    └── 第3期/
```

### 3.2 期識別子の命名ルール
| 区分 | 形式 | 例 | 保存先 |
|------|------|-----|--------|
| 個人事業 | YYYY | 2024（令和6年分） | `/data/accounting/private/2024/` |
| 法人 | YYYY_YYYY（開始年_終了年） | 2023_2024（第4期） | `/data/accounting/corporate/第4期/` |

### 3.3 ファイル名
- `決算書_2024.pdf`（個人事業）
- `決算書_第4期.pdf`（法人）
- `総勘定元帳_2024.pdf`
- `内訳書_2024.pdf`
- 添付書類は元のファイル名 or `領収書_日付.pdf`

### 3.4 申告時の自動フォルダ生成
- 確定申告（private/accounting/tax.html）または法人税申告（corporate/accounting/corporate.html）で「申告済みにする」を実行した際、以下の処理を自動で行う：
  1. フォルダの自動作成（存在しない場合）
  2. 申告関連書類の自動保存
  3. 仕訳データのロック（locked: true）

※ PDFの自動保存はブラウザ制限のため、ユーザーが手動で保存したファイルを所定フォルダに配置することを想定

1. **フォルダの自動作成**
   - 個人事業：`/data/accounting/private/[年]/`
   - 法人：`/data/accounting/corporate/[期]/`
   - 対象フォルダが存在しない場合は新規作成する

2. **申告関連書類の自動保存**
   - 決算書.pdf
   - 総勘定元帳.pdf
   - 内訳書.pdf
   - 確定申告.pdf（個人） / 法人税申告.pdf（法人）
   - 上記ファイルを該当フォルダに保存する

3. **仕訳データのロック**
   - 該当年/期の journals.json の全データに `locked: true` を設定
   - 以降、編集・削除不可とする

## 4. 出力ロジック

### 4.1 抽出条件
1. ユーザーが期間を指定
   - 個人事業：2024-01-01 〜 2024-12-31
   - 法人：2023-07-01 〜 2024-06-30
2. 指定期間内の仕訳データを抽出
   - 個人事業：`/data/accounting/private/[年]/journals.json`
   - 法人：`/data/accounting/corporate/[期]/journals.json`
3. 抽出データから各種書類を生成

### 4.2 集計処理
- 科目別に借方・貸方を集計
- BS/PLの形式に整形
- 内訳書は必要な科目の明細を抽出

### 4.3 総勘定元帳の生成
- 科目別に全取引を日付順に表示
- 各科目の開始残高・終了残高を計算
- 税理士・税務署向けに全科目出力（選択も可能）

#### 4.3.1 出力仕様（印刷・PDF）
詳細は `docs/02_print_spec.md` を参照。以下は総勘定元帳固有の仕様。
勘定科目の補助科目について
- 総勘定元帳では親科目のみ表示する
- 補助科目は集約し、相手方科目・摘要には表示しない
- 差引金額は親科目単位で計算する
- 補助科目の詳細は勘定科目内訳書で確認すること
- ページ構成：
  - 科目ごとに改ページ
  - 両面印刷対応：科目が奇数ページで終了した場合、次のページ（偶数）は白紙とし、次科目は必ず奇数ページ（表面）から開始する
  - 例：現金（1-3p）→ 4p白紙 → 普通預金（5p-）
  - 1ページの高さ = 34行分（固定）
  - 各行の消費高さ：
    - 通常行（改行なし）：1行分
    - 折り返し行：折り返し後の行数分（2行または3行）
  - ページ内の消費高さ合計が34行分を超えた時点で次ページへ
  - 改行が多いほど1ページに表示できるデータ行数は減少する
  - 折り返し判定：全角2・半角1で文字幅計算
    - 相手方科目（30mm）：幅18（全角9文字）超過で折り返し
    - 摘要（67mm）：幅48（全角24文字）超過で折り返し
  - 後続データがある場合：34行目は「次葉へ繰越」行（データ行は最大33行）
  - 後続データがない場合（最終ページ）：34行目までデータ行（月合計行可）

- **フォント**：游明朝（印刷・PDF共通）
- **ページ構成**：
  - 科目ごとに改ページ
  - 両面印刷対応：科目が奇数ページで終了した場合、次のページ（偶数）は白紙とし、次科目は必ず奇数ページ（表面）から開始する
  - 例：現金（1-3p）→ 4p白紙 → 普通預金（5p-）
  - 1ページあたり最大37行（合計行・繰越行・空白行もすべて1行としてカウント）
- **ヘッダー構成（各ページ先頭）**：
  - 大見出し「総　勘　定　元　帳」：14pt・センター揃え・文字間スペースあり
  - 装飾線（細線）：大見出し直下・固定70mm・センター揃え
  - 科目名：12pt・センター揃え・装飾線直下
  - 項目見出し行：9pt・センター揃え・科目名より8mm下
  - 項目見出し下罫線（標準線）
- **項目見出しの表記**（文字間スペースあり）：

| 列 | 見出し表記 |
|----|-----------|
| 日付 | 日付 |
| 相手方科目 | 相手方科目 |
| 摘要 | 摘　　　要 |
| 借方 | 借　方 |
| 貸方 | 貸　方 |
| 差引金額 | 差引金額 |

- **列構成**：

| 列 | 幅 | 文字揃え |
|----|-----|---------|
| 日付 | 12mm | 中央 |
| 相手方科目 | 30mm | 左 |
| 摘要 | 67mm | 左（縮小・折り返し対応） |
| 借方 | 22mm | 右 |
| 貸方 | 22mm | 右 |
| 差引金額 | 22mm | 右 |
| 合計 | 175mm | - |

- **データ行フォント**：9pt
- **摘要の表示制御**：67mm以内→9pt、超過→8ptに縮小、8ptでも超過→折り返し
- **罫線**：
  - 外枠：あり
  - 縦罫線：列間 0.25pt グレー
  - 横罫線（データ行間）：細線
  - 横罫線（月合計行下）：0.25pt×2本・色#555（データ行より濃いグレーで視覚的に区別）
  - 横罫線（項目見出し下）：標準線
- **月合計行**：
  - 日付列：空白
  - 相手方勘定科目列：空白
  - 摘要列・「○月合計」右寄せ
  - 借方・貸方：月間合計を表示
  - 差引金額列：空白
  - 合計行の下に2本線を引いて月の区切りを示す
- **繰越行**：
  - 次葉へ繰越：同一科目で37行を超えてページが変わるとき（ページ末尾に記載）
  - 発生条件：ページをまたぐときのみ
- **保存先**：`/data/accounting/private/[年]/総勘定元帳.pdf` / `/data/accounting/corporate/[期]/総勘定元帳.pdf`

## 5. 表紙デザイン

### 5.1 必須項目
- 書類タイトル（「決算報告書」「総勘定元帳」など）
- 会社名（総合調査SPS株式会社 / SPS）
- 期（第○期 / 令和○年分）
- 期間（自 YYYY-MM-DD 至 YYYY-MM-DD）
- 所在地
- 代表者名
- 出力日

### 5.2 オプション
- 会社ロゴ（images/logo/ から読み込み）
- 背景デザイン（シンプル or スタイリッシュ）

## 6. 申告済み処理との連動

### 6.1 PDF出力時
- 出力したPDFのパスをデータベース（またはJSON）に記録
- 「申告済」ボタンで該当期間のデータをロック
  - 個人事業：`/data/accounting/private/[年]/locked.json`
  - 法人：`/data/accounting/corporate/[期]/locked.json`

### 6.2 修正申告時
- 過去のPDFは「修正前」として別名保存
  - 例：`決算書_2024_修正前.pdf`
  - 例：`決算書_第4期_修正前.pdf`
- 修正後に新規PDF出力

## 7. 将来拡張：スマホ連携

### 7.1 レシート撮影機能
- スマホでレシートを撮影
- システムにアップロード
- OCR（文字認識）で日付・金額・店名を自動抽出
- 仕訳候補を表示（ユーザー確認後保存）

### 7.2 添付書類管理
- 撮影したレシート画像はPDF変換
- 自動的に `/添付書類/` フォルダに保存
- 仕訳データと紐付け（摘要に「領収書あり」等）

## 8. 出力イメージ

### 8.1 決算書PDF（個人事業）
```
┌─────────────────────────────────────┐
│        決 算 報 告 書                 │
│                                      │
│  令和6年分                             │
│  自 令和6年1月1日                      │
│  至 令和6年12月31日                     │
│                                      │
│  SPS（個人事業）                       │
│  京都府八幡市西山足立4-12              │
│                                      │
│━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━│
│  貸借対照表                           │
│  ...                                 │
└─────────────────────────────────────┘
```

### 8.2 決算書PDF（法人）
```
┌─────────────────────────────────────┐
│        決 算 報 告 書                 │
│                                      │
│  第4期                                │
│  自 令和5年7月1日                      │
│  至 令和6年6月30日                     │
│                                      │
│  総合調査SPS株式会社                   │
│  京都府八幡市西山足立4-12              │
└─────────────────────────────────────┘
```

### 8.3 総勘定元帳PDF
```
┌──────────────────────────────────────────────────────┐
│             総　勘　定　元　帳                          │  ← 14pt・センター・文字間スペースあり
│                  ───────────                          │  ← 装飾線 70mm固定・センター
│                  旅費交通費                             │  ← 12pt・センター
│                                                       │  ← 科目名から8mm下
│ 日付 | 相手方科目 |   摘　　　要   | 借　方 | 貸　方 | 差引金額 │  ← 9pt・標準線
├──────────────────────────────────────────────────────┤
│03/05 | 現金      | A社 交通費     | 12,000 |        |  12,000  │
│──────────────────────────────────────────────────────│  ← データ行間 細線
│03/12 | 普通預金  | B社 出張旅費   | 35,400 |        |  47,400  │
│──────────────────────────────────────────────────────│  ← データ行間 細線
│03/20 | 現金      | C社 駐車場代   |  2,200 |        |  49,600  │
│──────────────────────────────────────────────────────│  ← データ行間 細線
│      | 3月合計   |               | 49,600 |        |          │  ← 日付・差引金額なし
│══════════════════════════════════════════════════════│  ← 月合計行下 2本線
│04/03 | 現金      | D社 高速代     |  8,800 |        |  58,400  │
│──────────────────────────────────────────────────────│  ← データ行間 細線
│  ...                                                  │
│      | 次葉へ繰越 |               |284,600 |        |          │  ← 37行超過時
└──────────────────────────────────────────────────────┘
```

## 9. 改訂履歴
| 日付 | 版 | 内容 |
|------|----|------|
| 2026-03-12 | 1.0 | 初版作成 |
| 2026-03-15 | 1.1 | 保存先パスを private/ / corporate/ に修正 |
| 2026-03-16	1.2	3.4節「申告時の自動フォルダ生成」を追記 |
| 2026-03-17 | 1.3 | 目的を「e-TAX入力用参照資料」に明確化。総勘定元帳のPDF出力仕様（黒罫線・薄グレー背景・両面印刷対応・白紙ページ挿入ルール）を追記。 |
| 2026-03-22 | 1.4 | 全体管理者 | 4.3.1節を全面改訂。総勘定元帳印刷仕様（游明朝・37行制限・ヘッダー構成・列仕様・摘要制御・罫線）を詳細化。02_print_spec.mdへの参照を追加 | 印刷仕様書新設に伴い整合性を確保するため |
| 2026-03-22 | 1.5 | 会計担当 | 4.3.1節を全面更新。列幅175mm化・差引金額・文字間見出し・装飾線70mm・月合計行・2本線・次葉/次月繰越・37行カウントルールを追記。8.3節イメージ図を現仕様に合わせて修正 | 打ち合わせ確定仕様を反映 |
| 2026-03-24 | 1.7 | 会計担当 | 総勘定元帳は親科目のみ表示するルールを追加 | 補助科目は元帳では集約し、内訳書で詳細表示するため |
| 2026-03-27 | 1.8 | 会計担当 | 4.3.1節 ページング仕様を全面修正：37行→34行固定、改行時の行数減少ルール、折り返し判定基準、繰越行配置ルールを明記 |