XML to PDF Converter

公文書ZIPファイル（XML/XSL形式）をPDFに変換するWebアプリケーション

概要

このアプリケーションは、日本の公的機関で使用される電子申請ファイル（ZIP形式）を受け取り、内部のXML/XSLドキュメントをPDFに変換します。

主な機能

• ✅ ZIPファイルのドラッグ&ドロップアップロード
• ✅ ネストされたZIPファイルの自動展開
• ✅ 複数被保険者を1つのPDFにまとめる
• ✅ 日本語ファイル名自動生成（{名前}様{他N名}_{通知書名}.pdf）
• ✅ XSLT変換によるXML→HTML変換
• ✅ Puppeteerを使用したPDF生成
• ✅ 日本語フォント完全対応
• ✅ A4サイズ最適化
• ✅ ブラウザプールによる高速化（2回目以降0.6秒）
• ✅ リアルタイムログ表示（Server-Sent Eventsによるストリーミング）
• ✅ ログのコピー機能（クリップボードへの一括コピー）
• ✅ 結果ZIPストリーミング配信（base64廃止・ピークメモリ削減）
• ✅ PDFリネーム機能（労保系固定名 / 社保育休産休 / 雇保資格取得喪失・育児系）
• ✅ 元号略号→令和○年(度)形式の自動整形（月額変更・賞与）
• ✅ 旧フォーマット出力PDFの自動除外（重複防止）

対応ドキュメント形式

通知書番号	通知書名	出力ファイル名例
7027001	厚生年金保険養育期間標準報酬月額特例申出受理通知書	奥 絵梨花様_厚生年金保険養育期間標準報酬月額特例申出受理通知書.pdf
7130001	健康保険・厚生年金保険被保険者標準報酬決定通知書（算定基礎・B連結）	令和7年度算定_山田太郎様他1名_健康保険・厚生年金保険被保険者標準報酬決定通知書.pdf
7200001	厚生年金保険70歳以上被用者標準報酬月額相当額決定のお知らせ（算定基礎・A個別）	令和7年度算定_山田太郎様_厚生年金保険70歳以上被用者標準報酬月額相当額決定のお知らせ.pdf
henrei	返戻のお知らせ	山田太郎様_返戻のお知らせ.pdf
kagami	日本年金機構からのお知らせ	田中一郎様_日本年金機構からのお知らせ.pdf

PDFリネームルール（一括変換時）

ZIP内の既存PDF（XML/XSLから生成されないファイル）を、フォルダ名から判定して自動的にリネームします。優先順位の高い順に適用されます。

1. 固定名（会社単位手続き）

{被保険者名}様_ プレフィックスを付けず、固定の通知書名にします。

対象	フォルダ名パターン	出力ファイル名
労保 年度更新	..._[労保]年度更新_{タイムスタンプ}_公文書_*	令和{n}年度_労働保険概算・確定保険料申告書.pdf
労保 年度更新（建設）	..._[労保]年度更新(建設)_{タイムスタンプ}_公文書_*	令和{n}年度_労働保険概算・確定保険料申告書(建設).pdf
労保 保険関係成立届	..._[労保]保険関係成立届_..._公文書_*	労働保険関係成立届.pdf
労保 名称所在地変更	..._[労保]名称所在地変更_..._公文書_*	労働保険名称所在地変更届.pdf
労保 概算保険料申告（継続）	..._[労保]概算保険料申告(継続)_..._公文書_*	労働保険概算保険料申告書.pdf
社保 新規適用	..._[社保]新規適用_..._公文書_*	（社会保険）適用通知書.pdf

• 元号変換: 西暦 − 2018（例: 2025 → 令和7年度）
• すべて _公文書_ を含むフォルダのみ対象（コメントフォルダは除外）

2. 「{被保険者名}様_{固定通知書名}」（社保 個人単位）

公文書フォルダ内の任意PDFを、被保険者名 + 固定通知書名にリネームします。

対象	出力ファイル名
..._[社保]育児休業等申出書_..._公文書_*	{被保険者名}様_健康保険・厚生年金保険育児休業等取得者確認通知書.pdf
..._[社保]産前産後休業等申出書_..._公文書_*	{被保険者名}様_健康保険・厚生年金保険産前産後休業取得者確認通知書.pdf
..._[社保]養育期間標準報酬月額特例...	{被保険者名}様_厚生年金保険養育期間標準報酬月額特例申出受理通知書.pdf

被保険者名はフォルダ名の _[社保]xxx_ の 直前のフィールド から抽出します。これにより以下の両方の構造に対応：

• 4フィールド: {番号}_{会社名}_{被保険者名}_[社保]xxx_...
• 5フィールド: {番号}_{会社名}_{被保険者番号}_{被保険者名}_[社保]xxx_...

3. 「{被保険者名}様_{元のサフィックス}」（雇保 個人単位）

数字始まり（ハイフン連番含む）のファイル名の数字部分を被保険者名に置換します。

対象	元ファイル名例	出力ファイル名
..._[雇保]資格取得_......_[雇保]資格喪失(離職票交付あり)_......_[雇保]育児休業出生後休業給付_......_[雇保]育児時短就業給付_......_[雇保]育児休業出生時休業給付_...	2501793096_xxx.pdf202602021152166333-0001_xxx.pdf	{被保険者名}様_xxx.pdf

• 名前抽出は社保と同じ「_[雇保]xxx_ 直前のフィールド」方式（4F/5F両対応）
• 内部の半角スペースは保持（例: 高橋 なつみ様_...）

PDF生成時の命名フォールバック（[社保]系）

XML/XSLから新規生成するPDFで、XMLから被保険者名や通知書名がうまく取れないケース（DataRoot形式の喪失で <TITLE> が無い等）でも、フォルダ名から補完して以下の名前で生成します：

フォルダ	出力ファイル名
..._{被保険者名}_[社保]資格取得_...	{被保険者名}様_健康保険・厚生年金保険資格取得確認および標準報酬決定通知書.pdf
..._{被保険者名}_[社保]資格喪失_...	{被保険者名}様_健康保険・厚生年金保険資格喪失確認通知書.pdf
..._{被保険者名}_[社保]育児休業等申出書_...	{被保険者名}様_健康保険・厚生年金保険育児休業等取得者確認通知書.pdf
..._{被保険者名}_[社保]産前産後休業等申出書_...	{被保険者名}様_健康保険・厚生年金保険産前産後休業取得者確認通知書.pdf
..._{被保険者名}_[社保]養育期間標準報酬月額特例_...	{被保険者名}様_厚生年金保険養育期間標準報酬月額特例申出受理通知書.pdf
..._[社保]新規適用_...	（社会保険）適用通知書.pdf（被保険者名は付与しない）

XML側で名前/タイトルが正しく取れている場合はXMLの値を優先します（フォールバックは欠損時のみ）。

⚠️ 出力ZIPで社名が省略される場合があります

入力ZIPのフォルダ名は概ね {番号}_{社名}_{被保険者番号}_{被保険者名}_[xxx]{手続き}_… の形をしています。社名が極端に長い場合（例: Tokyo Artisan Intelligence株式会社）や、フォルダ内の被保険者名・帳票名（通知書名）が長い場合、Windows エクスプローラの ZIP エントリパス長制限（89 文字、後述）にフォルダプレフィックス＋ファイル名の合計が収まらなくなります。

このとき、出力ZIPでは フォルダ名の社名フィールドのみを末尾から必要分だけ切り詰めて短縮 します（compressFolderNameForBudget）。番号・被保険者番号・被保険者名・手続きタグ・帳票名（通知書名）は触らず、社名側で長さを吸収します。

• 例: 0004_Tokyo Artisan Intelligence株式会社_3817608_青木 理沙_[雇保]資格取得_2026・・・/ （67 字）
• 短縮後: 0004_Tokyo Artisan Intel_3817608_青木 理沙_[雇保]資格取得_2026・・・/

ねらい: 被保険者名と帳票名は本人特定・書類識別の核なのでフル保持し、社名は前後の番号やタグで識別が付くため末尾を素直に切る方が業務影響が小さい、という判断です。省略記号（…）は付けず、収まる長さで素直に切ります。

社名圧縮しても合計 89 字に収まらない極端なケースのみ、最後の砦として fitEntryNameToShellLimit がファイル名側（被保険者名の末尾）を追加で削ります。

日付プレフィックスの整形

社保の月額変更・賞与の生成PDFは、フォルダ内の日付情報からファイル名にプレフィックスを付与します。元号略号始まりの形式から完全名・ゼロパディング除去形式に整形：

手続き	元の日付（XML抽出）	ファイル名プレフィックス
月額変更（標準報酬改定通知書 / 70歳以上被用者月額改定通知）	R08年04月	令和8年4月改定_
賞与（賞与額決定通知書 / 70歳以上被用者賞与）	R08年01月25日	令和8年1月25日_

旧フォーマット出力PDFの除外

過去の本コンバーター出力（R08年01月25日_xxx.pdf のような元号略号始まり日付プレフィックス）は、再投入時に 新フォーマットで再生成されたPDFと重複 するため、otherFiles からスキップします。判定パターン: ^[SHR]\d{1,4}年\d{1,2}月(\d{1,2}日)?_

開発環境のセットアップ

必要な環境

• Node.js 20以上
• npm または yarn

ローカル開発（推奨）

Puppeteerを使用するため、開発環境でも必要な依存関係をインストールする必要があります。

# 依存関係のインストール
npm install

# Puppeteerブラウザのインストール（初回のみ）
npx puppeteer browsers install chrome

# 開発サーバーの起動
npm run dev

ブラウザで http://localhost:3000 を開いてアプリケーションを確認できます。

Docker開発環境

本番環境と同じ環境で開発・テストする場合はDockerを使用します。

# Dockerイメージのビルド
docker build -t xml-to-pdf-converter .

# コンテナの起動
docker run -p 3000:3000 xml-to-pdf-converter

ブラウザで http://localhost:3000 を開いてアプリケーションを確認できます。

開発時のヒント

• ローカル開発では npm run dev が最も高速（Turbopack使用）
• PDF生成のテストは /api/test-chromium エンドポイントでChromiumの動作確認が可能
• 日本語フォントの表示を確認する場合はDockerコンテナでのテストを推奨

This is the beginning of the README. Read the rest at the original. Read the full README ↗