# REP-001: ユーザー一覧帳票

## 概要
システムに登録されているユーザーの一覧を出力する帳票。検索条件に基づいてフィルタリングされたユーザー情報を各形式で出力する。

## 出力形式対応
- **PDF**: A4縦、複数ページ対応
- **Excel**: 1シート、データ部は行追加可能
- **CSV**: ヘッダー付き

## レイアウト・テンプレート
- **PDFテンプレート**: [Figma - ユーザー一覧帳票PDF](FigmaデザインのURLを挿入)
- **Excelテンプレート**: `templates/REP001_user_list_template.xlsx`
- **CSVフォーマット**: 下記「出力項目」参照

## 出力項目
| 項目No | 項目名 | データ型 | 桁数 | 備考 |
|-------|-------|---------|------|------|
| 1 | ユーザーID | 文字列 | 10 | - |
| 2 | ユーザー名 | 文字列 | 50 | - |
| 3 | メールアドレス | 文字列 | 255 | - |
| 4 | 権限 | 文字列 | 20 | 管理者/一般ユーザー |
| 5 | ステータス | 文字列 | 10 | 有効/無効 |
| 6 | 登録日 | 日時 | - | YYYY/MM/DD HH:MM |
| 7 | 最終ログイン日時 | 日時 | - | YYYY/MM/DD HH:MM |

## ソート順
1. ユーザーID 昇順

## 処理フロー
```mermaid
sequenceDiagram
    participant U as ユーザー
    participant S as 画面
    participant A as API
    participant D as データベース
    participant R as 帳票生成処理

    U->>S: 帳票出力ボタン押下
    U->>S: 出力形式選択（PDF/Excel/CSV）
    S->>A: 帳票データ取得API呼び出し
    A->>D: ユーザーデータ検索
    D->>A: データ返却
    A->>R: 帳票生成依頼
    R->>R: テンプレート読込
    R->>R: データ埋め込み
    R->>R: ファイル生成
    R->>A: 帳票ファイル返却
    A->>S: ファイルダウンロードURL返却
    S->>U: ファイルダウンロード
```


## PDF固有仕様
| 項目 | 仕様 |
|---|---|
| 用紙サイズ | A4縦 |
| ヘッダー | 「ユーザー一覧」、出力日時、ページ番号 |
| フッター | システム名、出力者名 |
| 1ページあたり行数 | 最大30行 |
| 改ページ | 30行ごとに自動改ページ |

## Excel固有仕様
| 項目 | 仕様 |
|---|---|
| シート名 | 「ユーザー一覧」 |
| ヘッダー行 | 1行目：タイトル、2行目：出力日時、4行目：項目名 |
| データ開始行 | 5行目 |
| セルスタイル | ヘッダー：背景色グレー、太字 |
| 列幅 | 自動調整 |

## CSV固有仕様
| 項目 | 仕様 |
|---|---|
| ヘッダー行 | あり（1行目） |
| データ開始行 | 2行目 |
| 特殊文字対応 | カンマ、改行を含む場合はダブルクォートで囲む |

---

# REP-002: 月次売上集計帳票

## 概要
月ごとの売上を集計し、部門別・商品別の内訳を出力する帳票。月次バッチ処理で自動生成され、管理者に配信される。

## 出力形式対応
- **PDF**: A4横、複数ページ対応
- **Excel**: 複数シート（サマリー、詳細）

## レイアウト・テンプレート
- **PDFテンプレート**: [Figma - 月次売上集計帳票PDF](https://www.notion.so/Figma%E3%83%87%E3%82%B6%E3%82%A4%E3%83%B3%E3%81%AEURL%E3%82%92%E6%8C%BF%E5%85%A5)
- **Excelテンプレート**: `templates/REP002_monthly_sales_template.xlsx`

## 出力項目（サマリー）
| 項目No | 項目名 | データ型 | 桁数 | 備考 |
|---:|---|---|---:|---|
| 1 | 対象年月 | 文字列 | 7 | YYYY/MM形式 |
| 2 | 総売上金額 | 数値 | - | 円、カンマ区切り |
| 3 | 前月比 | 数値 | - | %、小数点以下1桁 |
| 4 | 前年同月比 | 数値 | - | %、小数点以下1桁 |
| 5 | 取引件数 | 数値 | - | 件 |

## 出力項目（部門別詳細）
| 項目No | 項目名 | データ型 | 桁数 | 備考 |
|---:|---|---|---:|---|
| 1 | 部門コード | 文字列 | 10 | - |
| 2 | 部門名 | 文字列 | 50 | - |
| 3 | 売上金額 | 数値 | - | 円、カンマ区切り |
| 4 | 構成比 | 数値 | - | %、小数点以下1桁 |
| 5 | 取引件数 | 数値 | - | 件 |

## 処理フロー
```mermaid
flowchart TD
	A[月次バッチ起動] --> B[対象年月取得]
	B --> C[売上データ集計]
	C --> D[部門別集計]
	D --> E[商品別集計]
	E --> F[前月・前年データ取得]
	F --> G[比較計算]
	G --> H{出力形式選択}
	H -->|PDF| I[PDFテンプレート読込]
	H -->|Excel| J[Excelテンプレート読込]
	I --> K[データ埋め込み]
	J --> K
	K --> L[ファイル生成]
	L --> M[ファイルサーバー保存]
	M --> N[管理者へメール通知]
	N --> O[処理完了]
```

## PDF固有仕様
| 項目 | 仕様 |
|---|---|
| 用紙サイズ | A4横 |
| ページ構成 | 1ページ目：サマリー、2ページ目以降：部門別・商品別詳細 |
| グラフ | 売上推移グラフ、部門別円グラフを含む |
| ヘッダー | 「月次売上集計表」、対象年月、出力日時 |

## Excel固有仕様
| 項目 | 仕様 |
|---|---|
| シート構成 | シート1：サマリー、シート2：部門別、シート3：商品別 |
| グラフ | サマリーシートに売上推移グラフを埋め込み |
| 数式 | 構成比は数式で算出 |
| 条件付き書式 | 前月比・前年同月比がマイナスの場合は赤字表示 |

---

# REP-003: 取引履歴帳票

## 概要
指定期間の取引履歴をCSV形式で出力する帳票。データ分析や他システム連携に使用される。

## 出力形式対応
- **CSV**: ヘッダー付き

## 出力項目
| 項目No | 項目名 | データ型 | 桁数 | 備考 |
|---:|---|---|---:|---|
| 1 | 取引ID | 文字列 | 20 | - |
| 2 | 取引日時 | 日時 | - | YYYY/MM/DD HH:MM:SS |
| 3 | 顧客ID | 文字列 | 10 | - |
| 4 | 顧客名 | 文字列 | 100 | - |
| 5 | 商品コード | 文字列 | 15 | - |
| 6 | 商品名 | 文字列 | 100 | - |
| 7 | 数量 | 数値 | - | - |
| 8 | 単価 | 数値 | - | 円 |
| 9 | 金額 | 数値 | - | 円 |
| 10 | 支払方法 | 文字列 | 20 | 現金/クレジット/その他 |
| 11 | ステータス | 文字列 | 20 | 完了/キャンセル/返品 |

## ソート順
1. 取引日時 昇順
2. 取引ID 昇順

## 処理フロー
```mermaid
sequenceDiagram
    participant U as ユーザー
    participant S as 画面
    participant A as API
    participant D as データベース
    participant F as ファイル生成

    U ->> S: 期間指定
    U ->> S: CSV出力ボタン押下

    S ->> A: 取引履歴取得API呼び出し
    A ->> D: 取引データ検索
    D ->> A: データ返却（最大10万件）

    alt データ件数 > 10万件
        A ->> S: 警告メッセージ返却
        S ->> U: 「期間を短縮してください」表示
    else データ件数 ≤ 10万件
        A ->> F: CSV生成依頼
        F ->> F: CSV形式変換
        F ->> A: CSVファイル返却
        A ->> S: ダウンロードURL返却
        S ->> U: ファイルダウンロード
    end
```

## CSV固有仕様
| 項目 | 仕様 |
|---|---|
| 最大出力件数 | 100,000件 |
| 件数超過時の対応 | エラーメッセージ表示、期間短縮を促す |
| 特殊文字エスケープ | カンマ、ダブルクォート、改行を含む場合は適切にエスケープ |

---

## 帳票仕様記載のガイドライン
各帳票の個別仕様を記載する際は、以下のテンプレートを使用する：

### 帳票仕様テンプレート
```markdown
# REP-XXX: [帳票名]

## 概要
[帳票の目的と用途を簡潔に記述]

## 出力形式対応
- **PDF**: [用紙サイズ、ページ構成]
- **Excel**: [シート構成]
- **CSV**: [特記事項]

## レイアウト・テンプレート
- **PDFテンプレート**: [Figmaリンク]
- **Excelテンプレート**: [ファイルパス]
- **CSVフォーマット**: [参照先]

## 出力項目
| 項目No | 項目名 | データ型 | 桁数 | 備考 |
|-------|-------|---------|------|------|
| [記載] | [記載] | [記載] | [記載] | [記載] |

## ソート順
[ソート条件を記載]

## 処理フロー
[Mermaidフロー図またはシーケンス図で記載]

## PDF固有仕様（該当する場合）
| 項目 | 仕様 |
|-----|------|
| [記載] | [記載] |

## Excel固有仕様（該当する場合）
| 項目 | 仕様 |
|-----|------|
| [記載] | [記載] |

## CSV固有仕様（該当する場合）
| 項目 | 仕様 |
|-----|------|
| [記載] | [記載] |

```
---

## 備考
- 帳票テンプレートファイル（PDF用Figmaデザイン、Excel用テンプレート）は別途管理し、本仕様書にはリンク・パスを記載する
- テンプレート変更時は最新版に更新し、バージョン管理を行う
- 新規帳票追加時は帳票一覧にも追記する