## 07_05_tax_return.md

版：v2.0　実装の状況は `work_order_db_migration.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. **書類の保存フォルダの自動作成**（PDFはファイルで保存する。仕訳データはDB）
   - 個人事業：`/data/accounting/private/[年]/`
   - 法人：`/data/accounting/corporate/[期]/`
   - 対象フォルダが存在しない場合は新規作成する

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

3. **仕訳データのロック**
   - 該当年/期の仕訳（`journals`）の `locked` を真にする（トランザクションで更新）
   - 以降、編集・削除不可とする

## 4. 出力ロジック

### 4.1 抽出条件
1. ユーザーが期間を指定
   - 個人事業：2024-01-01 〜 2024-12-31
   - 法人：2023-07-01 〜 2024-06-30
2. 指定期間内の仕訳データを、`journals`・`journal_entries` から抽出する（会社区分と日付の範囲で絞る）
3. 抽出データから各種書類を生成

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

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

#### 4.3.1 出力仕様（PDF）
- **罫線**：黒罫線（外枠太線、ヘッダー下太線、行間細線）＋ 薄グレー背景（#f5f5f5）
- **画面表示**：カラー（既存テーマに従う）
- **ページ構成**：
  - 科目ごとに改ページ
  - 両面印刷対応：科目が奇数ページで終了した場合、次のページ（偶数）は白紙とし、次科目は必ず奇数ページ（表面）から開始する
  - 例：現金（1-3p）→ 4p白紙 → 普通預金（5p-）
- **保存先**：`/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のパスをDBに記録する（記録のテーブルは設計未確定。`00_07_database.md` 5.4節）
- 「申告済」ボタンで該当期間の仕訳をロックする（`journals.locked` を真にする）。期間ごとの申告済みの記録（旧 `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
```
┌─────────────────────────────────────┐
│        総 勘 定 元 帳                  │
│  科目：現金                            │
│  期間：令和6年1月1日 〜 令和6年12月31日 │
│                                      │
│  日付         | 摘要           | 借方  | 貸方  | 残高  │
│  令和6.01.05 | 売上 A社       |100,000|       |100,000│
│  令和6.01.10 | 通信費         |       | 5,000 | 95,000│
│  ...                                 │
│━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━│
│  次月繰越                             │
└─────────────────────────────────────┘
```

## 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-10-08 | 1.4 | ファイル名規則を「フォルダ番号＋ファイル番号」形式に変更したことに伴い、参照名と保存先表記を機械的に置換（内容の変更なし） |
| 2026-10-29 | 2.0 | DB前提に書き直し。仕訳の抽出・ロックを `journals` に（3節、4.1節、6.1節）。申告済みの記録の持ち方は設計未確定と明記 |