## 03_tax_audit_mode.md
# データ参照モード 設計書（旧称：税務署モード）

## 1. 概要

### 1.1 目的
- 税務調査時に、調査対象（法人または個人事業）のデータのみを閲覧可能な専用モードを提供
- PCを直接見せる必要をなくす
- 探偵業法・個人情報保護法に基づく情報保護を徹底

### 1.2 基本方針
- 税務署には「データは全てこのURLでご覧いただけます」と伝える
- PCは見せない（理由は「個人情報取り扱い業者のため」）
- 調査対象期間の全データを閲覧可能に（隠し事なし）
- 保存期間（7年）分は開示可能
- 出力（PDF/印刷）は可能、編集・CSV出力は不可

### 1.3 名称について
- システム内での機能名：**データ参照モード**
- 会計TOPからのリンクテキスト：**会計データ参照**
- URLやトークン発行画面のタイトル：**データ参照モード**
- 税務署向け案内文では「データ参照システム」と表記

## 2. 税務署への対応フロー

### 2.1 調査通知時
```
【税務署から調査通知】
調査対象：法人（SCSPS）の第○期 または 個人事業（SPS）の令和○年分
　　↓
あなた：「ご案内をお送りします」
　　↓
システムでトークン発行
　　↓
調査前にURLを送付（事前案内）
```

### 2.2 事前告知文（送付用）
```
【税務調査に関するご案内】

平素よりお世話になっております。

このたびの税務調査につきまして、以下の専用URLにて
調査対象期間の会計データを全てご確認いただけます。

URL: https://accounting.scsps.jp/tax-audit/[トークン]
有効期限: 調査期間中（YYYY/MM/DDまで）

本URLでは以下のことが可能です：
✅ 調査対象期間の全データ閲覧
✅ PDF出力（必要な場合）
✅ 印刷（必要な場合）

なお、当社は探偵業法および個人情報保護法に基づく
個人情報取り扱い業者のため、調査員のPCを直接
ご覧いただくことはできません。あらかじめご了承ください。

何かご不明な点がございましたら、お気軽にご連絡ください。
```

### 2.3 調査当日の対応
| 税務署の要求 | あなたの回答 |
|-------------|------------|
| 「PCを見せてください」 | 「当社は個人情報取り扱い業者のため、PCはお見せできません。必要なデータは全てURLでご確認いただけます」 |
| 「このデータをPDFで」 | 「かしこまりました（ポチッと出力）」 |
| 「印刷してほしい」 | 「はい（ポチッと印刷）」 |
| 「CSVで欲しい」 | 「データの正確性を保つため、CSV出力は行っておりません。PDFまたは印刷でご対応いただけますか」 |
| 「別の期間も見たい」 | 「調査対象外ですが、必要な場合は別途トークンを発行します」 |

## 3. トークン発行機能

### 3.1 発行画面（会計システム内）
```
┌─────────────────────────────────────┐
│ 【税務署モード トークン発行】         │
│                                       │
│ 調査対象：                            │
│   ○ 法人（SCSPS）                     │
│   ○ 個人事業（SPS）                   │
│                                       │
│ 対象期間：                            │
│   ○ 第○期 / 令和○年（プルダウン選択）│
│   ○ 保存期間全期（7年分）             │
│   ○ 期間指定：[    ]〜[    ]          │
│                                       │
│ 有効期限：                            │
│   ○ 1日後  ○ 1週間後  ○ 1ヶ月後     │
│   ○ 調査終了日（手動入力）            │
│                                       │
│ オプション：                          │
│   □ PDF出力を許可（デフォルトON）     │
│   □ 印刷を許可（デフォルトON）        │
│                                       │
│ [トークン発行]                         │
└─────────────────────────────────────┘
```

### 3.2 発行結果表示
```
┌─────────────────────────────────────┐
│ 【トークン発行完了】                   │
│                                       │
│ URL: https://accounting.scsps.jp/     │
│      tax-audit/a7f9d3k2m4n5p6q7r8s9t0u│
│      1v2w3x4y5z                       │
│                                       │
│ 調査対象: 法人（SCSPS）                │
│ 対象期間: 第3期（2023.7.1-2024.6.30）  │
│ 有効期限: 2026-03-31                   │
│                                       │
│ [URLをコピー] [メールで送信] [印刷]    │
└─────────────────────────────────────┘
```

### 3.3 トークンデータ構造
```json
{
  "token": "a7f9d3k2m4n5p6q7r8s9t0u1v2w3x4y5z",
  "company": "SCSPS",
  "period_start": "2023-07-01",
  "period_end": "2024-06-30",
  "allow_pdf": true,
  "allow_print": true,
  "expires_at": "2026-03-31",
  "created_by": "SPS01-00001",
  "created_at": "2026-03-12",
  "accessed_at": null,
  "access_log": []
}
```

### 3.4 データ参照パス
- 個人事業： `/data/accounting/private/[年]/`
- 法人： `/data/accounting/corporate/[期]/`

## 4. 税務署モード表示画面

### 4.1 トップページ
```
┌─────────────────────────────────────┐
│ 税務調査用データ参照システム          │
│                                      │
│ 調査対象: 総合調査SPS株式会社         │
│ 対象期間: 第3期（2023.7.1-2024.6.30） │
│ 有効期限: 2026-03-31                  │
│                                      │
│ 【ご注意】                            │
│ ・このURLは税務調査専用です            │
│ ・当社は個人情報取り扱い業者のため     │
│   直接PCをご覧いただくことはできません │
│ ・必要なデータは全てこちらでご確認ください│
│ ・PDF出力・印刷が可能です              │
│ ・データの編集はできません              │
│                                      │
│ [PDF出力] [印刷]                      │
└─────────────────────────────────────┘
```

### 4.2 メニュー画面
```
┌─────────────────────────────────────┐
│ 【データ種別選択】                     │
│                                      │
│ ■ 総勘定元帳（科目別）                │
│   □ 現金                              │
│   □ 普通預金                          │
│   □ 売掛金                            │
│   □ 買掛金                            │
│   □ 売上高                            │
│   □ 仕入高                            │
│   □ 給料手当                          │
│   □ 旅費交通費                        │
│                                      │
│ ■ 試算表                              │
│ ■ 決算書                              │
│   □ 貸借対照表（BS）                  │
│   □ 損益計算書（PL）                  │
│   □ 個別注記表                        │
│                                      │
│ ■ 勘定科目内訳書                      │
│   □ 預貯金等の内訳                    │
│   □ 売掛金の内訳                      │
│   □ 買掛金の内訳                      │
│   □ 借入金の内訳                      │
└─────────────────────────────────────┘
```

### 4.3 データ表示画面（例：総勘定元帳）
```
┌─────────────────────────────────────┐
│ 総勘定元帳（第3期）                   │
│ 科目：現金                            │
│                                      │
│ 日付       | 摘要           | 借方  | 貸方  | 残高  │
│------------|----------------|-------|-------|-------│
│ 2023-07-05 | 売上 A社       |100,000|       |100,000│
│ 2023-07-10 | 通信費         |       | 5,000 | 95,000│
│ 2023-07-15 | 売上 B社       | 50,000|       |145,000│
│ 2023-07-20 | 消耗品費       |       | 3,000 |142,000│
│ ...                                 │
│------------|----------------|-------|-------|-------│
│ 期末残高                            |       |142,000│
│                                      │
│ [このページをPDF] [印刷]              │
└─────────────────────────────────────┘
```

### 4.4 出力機能

#### PDF出力
- 表示中の画面をそのままPDF化
- ヘッダーに自動付与：
  - 調査対象会社名
  - 対象期間
  - 出力日
  - 「税務調査用」のウォーターマーク（任意）

#### 印刷
- ブラウザの印刷機能を使用
- 用紙サイズ・向きは自動調整

#### 出力制限
- CSV出力：不可（データ改ざん防止）
- 編集：一切不可

## 5. セキュリティ

### 5.1 アクセス制限
- トークンを持っている人のみアクセス可能
- トークンは32桁ランダム文字列（推測不可能）
- トークンはハッシュ化して保存（生データ保存なし）

### 5.2 アクセスログ
- アクセス日時
- IPアドレス
- 閲覧した画面
- PDF出力・印刷の履歴
- すべて記録して監査証跡に

### 5.3 有効期限
- 設定した期限を過ぎると自動無効化
- 期限切れページには「有効期限切れ」と表示
- 調査延長時は再発行

## 6. 実装時の注意点

### 6.1 会計システムとの分離
- 税務署モードは会計システムのデータを参照するが、**別URL**
- 通常の会計システム（ログイン必要）とは完全に分離

### 6.2 データのリアルタイム性
- 会計システムに新規入力したデータは、税務署モードにも即時反映
- ただし編集はできないので、見せるデータとして安全

### 6.3 表示速度
- 大量データ（7年分）でもストレスなく表示できるよう最適化
- 科目ごとにページング処理

## 7. 運用ルール

### 7.1 トークン発行権限
- 管理者（permission_assign権限保有者）のみ発行可能
- 発行履歴は全て記録

### 7.2 事前告知
- 調査通知が来たら、すぐにトークン発行
- 調査前にURLを送付（「当日スムーズにご確認いただけます」）

### 7.3 調査終了後
- 有効期限切れを確認
- 必要に応じてログを保存（監査証跡）

## 8. 今後の拡張

### 8.1 税務署からの質問受付機能
- 専用フォームから質問を受け付け
- 回答もシステム内で管理

### 8.2 複数税務署対応
- 国税・地方税で別々のトークン発行
- それぞれの調査対象期間を個別設定

### 8.3 チャット機能
- 税務署とリアルタイムでやり取り
- 質問と回答の履歴が残る

## 9. 改訂履歴
| 日付 | 版 | 内容 |
|------|----|------|
| 2026-03-12 | 1.0 | 初版作成 |
| 2026-03-15 | 1.1 | データ参照パスを private/ / corporate/ に追記 |
| 2026-03-22 | 1.2 | 会計担当 | 名称を「税務署モード」から「データ参照モード」に変更。1.3節「名称について」を新設 |
```