# VA mints企画書 ― 背景・方針・要領

## 第1 背景

### 1. 開発者の現在の立場
開発者は、かつて法律事務所に勤務していたが、現在は退職している。このため、**改正民事訴訟法フェーズ3全面施行後の法律事務所における事務処理上の問題点や、事務員の要望を直接把握することができない**という制約がある。現場のヒアリングに基づく要件定義ではなく、公表されている一次資料（操作マニュアル・Q&A・準備の手引）の精査に基づく要件定義とならざるを得ない。

### 2. 課題の所在（推察）
上記の制約はあるものの、mints提出ファイルの準備、特に**PDFファイルをmintsの制約（用紙サイズ・ファイル名・パスワード禁止・証拠番号標記等）に適合させる作業**には、相当な手数がかかっていることが推察される。具体的には次のような負担が想定される。

- 用紙サイズ（A4／A3）の実測確認とレターサイズ等の誤りの発見・修正
- ファイル名の拡張子込み100文字以内への調整、使用禁止文字の除去
- パスワード付きPDFの検出と解除
- 証拠番号（甲001等）の各ファイルへの付記と、証拠説明書との整合確認
- 枝番のあるファイルの結合とファイル名の範囲表記化
- 提出前にmints側でエラーとなる可能性のある不備の見落とし（一度提出すると当事者側で訂正できないため、事前チェックの重要性が高い）

これらは定型的な確認・変換作業であり、機械的な自動処理になじむ。

## 第2 方針

**mints提出準備を省力化するツールを作成し、VBAアセット（vba-assets.net）で公開することにより、法律事務所のIT化を推進する。**

現場の直接的な把握ができない以上、ツールの正確性は一次資料の精査精度に依存する。したがって、要件は「Ｑ＆Ａ・操作マニュアル・準備の手引」の現物に明記された制約に忠実に対応させることを最優先とし、公式規定のない事項（カラー・dpi等）についてはツール側で強制せず、任意設定にとどめる。

## 第3 細部要領

### 1. 対象範囲：「記録」対応の全形式＋対象外形式からの変換

**【2026-07-20追記：方針転換により本節の記載は一部廃止】** 下記の形式変換機能は、その後の方針転換（チェック専念方針。`docs/03_requirements.md`第8章参照）により**廃止**した。非対応形式は検出（分類C）とユーザーへの案内（「対応形式に変換のうえ再読み込みしてください」）にとどめ、自動変換は実装しない。本節は企画時点（開発着手前）の当初構想の記録として残す。

mintsの「記録」にアップロードできる全ファイル形式に対応する。これに加えて、**mints非対応の原本形式を対応形式へ変換する機能**を対象に含める。

| 形式 | 対応 |
|---|---|
| PDF | ○対応 |
| MP4（動画） | ○対応 |
| MP3（音声） | ○対応 |
| JPEG（画像） | ○対応 |
| PNG（画像） | ○対応 |
| DOCX/XLSX/PPTX等（記録外専用形式） | **変換元としてのみ対象**（変換先はPDF＝記録対応形式） |
| mints非対応の動画形式（例：MOV、AVI、WMV等） | **変換元としてのみ対象**（変換先はMP4） |
| mints非対応の音声形式（例：WAV、M4A、AAC等） | **変換元としてのみ対象**（変換先はMP3） |
| mints非対応の画像形式（例：TIFF、BMP、GIF、HEIC等） | **変換元としてのみ対象**（変換先はJPEG又はPNG） |

「記録外」への直接の提出処理（記録外専用形式のまま出力すること）は対象外とする。**（廃止済み・当初構想）** DOCX/XLSX等・非対応動画・非対応音声・非対応画像は、いずれも「記録」提出用の対応形式へ変換した上で出力するという一貫した整理のもとで対象に含める想定だったが、現在は変換を行わず、非対応形式は書き出し対象外（検出・案内のみ）とする。結果として、当ツールが書き出すファイルは常にPDF・MP4・MP3・JPEG・PNGのいずれかとなる（変換によってではなく、対象外形式を書き出さないことによる）。

### 2. 処理方式：フォルダ単位の一括処理
- ユーザーが指定した**フォルダ内の全ファイル**を対象に、現状（形式・サイズ・用紙寸法・パスワード有無・ファイル名等）を把握する。
- 把握した状態に基づき、必要な処理（適合化・検証。変換は行わない）を行う。
- 処理結果を、同じく**ユーザーが指定したフォルダ**へ出力する。

個別ファイルを都度指定する方式ではなく、**フォルダ単位のバッチ処理**とすることで、証拠が多数に上る事件でも一括対応できる設計とする。

### 3. 処理内容：報告書記載の制約事項への適合化
処理の内容は、既報告済みの「mints提出ファイル制約調査報告書（改訂版・全形式対応）」に記載された制約事項に適合させるための処理とする。同報告書第7章のチェックリスト（確度「一次」の項目を優先実装）を実装仕様の基礎とし、特に次の確定済み事項を処理ロジックの核とする。

- 全形式共通：ファイル名100文字以内・禁止文字除去、パスワード検出、200MB単位のバッチ分割
- PDF：A4/A3用紙寸法の実測検証、向きの適否確認、メタデータ除去
- 証拠番号：フォームの証拠番号欄形式（甲001等）に沿ったファイル名の整形・付記支援
- **形式変換【廃止（チェック専念方針による。2026-07-20）。当初構想の記録として残す】**：mints非対応形式を検出し、対応形式へ自動変換する（DOCX/XLSX/PPTX→PDF、TIFF/BMP/GIF/HEIC等→JPEG/PNG、MOV/AVI/WMV等→MP4、WAV/M4A/AAC等→MP3）。変換後のファイルに対しても、上記の共通制約検証（ファイル名・容量等）及び形式別検証（PDFの用紙寸法等）を適用する　※現在は変換を実装せず、検出・案内のみ（`docs/03_requirements.md`第2.1節・第8章参照）
- 公式規定のない事項（カラー・dpi等）：デフォルトでは原本の性質を変更せず、ユーザーが任意に選択できるオプションとして提供する

## 第4 今後の検討事項

**【2026-07-20追記】形式変換機能の廃止（第3.1節・第3.3節参照）により、下記1・2項は検討事項として消滅した（変換を行わないため）。3項は号証の連番・欠番チェック機能として実装方針を確定済み（`docs/03_requirements.md`4.7節参照）。4項も変換を行わないため生じない。本節は企画時点の記録として残す。**

- 動画・音声変換時の品質設定（ビットレート・解像度等）の既定値と、劣化を伴う変換であることのユーザーへの明示方法
- 変換元ファイルが「対応形式か非対応形式か」の判定方法（拡張子のみによる判定か、内部構造の検証を伴うか）
- フォルダ単位処理における証拠番号の自動採番・重複検出の要否
- 出力フォルダの構成（元ファイルとの対応関係をどう可視化するか。特に変換を伴う場合、変換前後のファイルの対応が分かるようにする必要がある）

以上
