全銀ポン — 事業計画・仕様メモ

作成: 2026-09-03。Excel / CSV / PDF の振込一覧を全銀協フォーマット（FBデータ）に変換し、 ネットバンキングにそのまま取り込めるようにするWebツール。ブラウザ内だけで処理する。

このリポジトリには 計画（このファイル） と 動くMVP（index.html + src/）が入っている。

🚀 公開・販売開始のためにあなたが手を動かす作業は docs/launch-checklist.md にまとめてある。 DNS・特商法・Stripe・秘密鍵のバックアップ・Search Console。上から順に進めれば公開できる。

作業の決まりごとは AGENTS.md、集客と認知の計画は docs/growth-plan.md、 検索・AI検索まわりの点検記録は docs/seo-ai-audit.md、法令の確認メモは docs/compliance-check.md。

zengin-pon/
  index.html          画面（4ステップのウィザード: ファイル → 列の確認 → 振込元 → 確認・DL）
  style.css
  config.js           公開設定（Google連携のクライアントID等。秘密情報は置かない）
  src/zengin.js       変換エンジン（依存なし・Node/ブラウザ両用）
  src/organize.js     表の自動整理（見出し推定・結合セル分解・値の形からの列推定・合計行除外）
  src/dict.js         金融機関辞書の読み込み＋名前→コードの逆引き
  src/gsheets.js      Googleスプレッドシート連携（Picker + drive.file + Drive export）
  src/app.js          画面ロジック（SheetJS / pdf.js は CDN）
  src/license.js      Proライセンスの検証と自動更新（Ed25519 公開鍵）
  src/holidays.js     銀行休業日の判定
  src/site.js         メニューの開閉とアクセス解析の読み込みだけ（ヘッダー／フッターは HTML に静的に埋め込む）
  src/tool-yucho.js   無料ツール: ゆうちょ 記号番号の変換
  src/tool-kana.js    無料ツール: 口座名義のカナ変換
  zengin-format.html  全銀フォーマットの仕様解説（検索の入口）
  free-tools/         無料ツール（ゆうちょ変換・名義カナ変換）
  legal.html about.html accessibility.html  法令上の位置づけ／運営者情報／アクセシビリティ方針
  llms.txt robots.txt .well-known/security.txt  AI・検索・脆弱性報告むけの案内
  tools/site-template.js  共通部品（メニュー、フッター、OGP、Organization）
  tools/build-site.js     共通部品の埋め込み＋ sitemap.xml の生成（--check で埋め込み忘れを検出）
  tools/build-bank-pages.js 銀行コードのページ 1,146枚の生成
  tools/indexnow.js       公開後に Bing 系へ更新を通知
  functions/          Stripe Webhook とライセンス更新API（Firebase・codebase "zenginpon"）
  docs/launch-checklist.md  公開までの手作業
  test/organize.test.js 自動整理のテスト（5件）
  test/license.test.js  ライセンス発行と検証のテスト（4件）
  data/banks.json     金融機関辞書（tools/build-dict.js で生成、元は zengin-code）
  data/branches/      銀行ごとの支店一覧（必要な分だけ取得）
  data/merged.json    統廃合の旧→新コード表（手で管理）
  data/history/       金融機関・支店の統廃合・改称・番号の振り直しの履歴（tools/build-history.js で生成。2015年〜）
  tools/build-history.js  zengin-code/source-data の git 履歴を比べて data/history/ を作る（全履歴の clone が必要）
  tools/verify_zengin.py  全銀ファイルを1バイトずつ検査する独立した検査器
  tools/make_input_samples.py  入力形式ごとの検証用ファイル（samples/formats/）を作る
  test/robust.test.js / test/dict.test.js  書き方の揺れ・銀行名と支店名の照合のテスト
  tools/build-dict.js 辞書ビルド。DICT_VERSION=YYYY-MM-DD node tools/build-dict.js [source-data dir]
  .github/workflows/update-dict.yml  毎月の辞書自動更新PR
  test/zengin.test.js node test/zengin.test.js で実行（12件）
  samples/            総合振込・給与振込のサンプルCSV

ローカル起動: python -m http.server 8877 （このディレクトリで）→ http://127.0.0.1:8877/ （8765 と 8790 は別プロジェクトが使用） テスト: node test/zengin.test.js / node test/organize.test.js / node test/license.test.js

---

1. 結論（先に）

• 技術的リスクは低い。 全銀フォーマットは固定長120バイト×4種のレコードで、仕様は公開されている。 MVPはこのリポジトリで既に動いている（Excel/CSV→全銀、名義の半角カナ変換、法人略語、ゆうちょ変換、検証、ダウンロード）。
• 事業的リスクは「無料の代替が多い」こと。 freee・マネーフォワード・弥生給与はFBデータを標準出力する。 ネット銀行（楽天・住信SBI・GMOあおぞら・PayPay等）はCSVを直接受け付ける。銀行自身が無料のExcel変換ツールを配っている例もある。
• したがって狙うのは 「給与・支払を今もExcelで回していて、メガバンク・地銀・信金のネットバンキング（全銀形式のみ）を使っている小規模事業者」 と、 「顧問先の振込データを何社分も作る社労士・税理士事務所」。この層は今でも手入力か、古いフリーソフトを使っている。
• 差別化は (1) ブラウザ完結でデータを預からない（口座情報を外部に出さない安心感） (2) 名義カナの自動変換と事前チェック（銀行側でエラーになる前に止める） (3) PDF入力（給与ソフトの「振込一覧表PDF」しか手元にないケース） (4) 列割り当ての記憶で2回目以降は本当に一発。

---

2. 市場と競合

区分	例	所感
クラウド給与・会計	freee, マネーフォワード, 弥生, ジョブカン, SmartHR	FBデータ標準対応。ここのユーザーは買わない
ネット銀行	楽天, 住信SBI, GMOあおぞら, PayPay, auじぶん	CSV直接取込あり。全銀形式不要
銀行提供ツール	各行のExcel雛形・変換マクロ	無料だが自行専用・古い・Mac不可が多い
フリーソフト/Excelマクロ	Vector等の全銀変換マクロ	無料〜数千円。更新停止・マクロ警告・サポートなし
有料単機能ツール	数千円買い切り〜月額数百円のFB作成ソフト	少数。Windowsインストール型が主流。Web完結型は少ない
Web完結・無料	総合振込.jp	本企画と同じ発想（Excel→FBデータ、ブラウザ内処理、4ステップUI）。無料・広告収益型（freee/MF/弥生のアフィリエイト）。給与・総合対応、xlsx/xls/csv、列名自動認識

総合振込.jp が無料で存在する意味（2026-09-03 確認）

• 「Excel→全銀変換」そのものは、もう無料が相場。変換機能だけに課金するのは難しい。
• 同サイトは広告（会計ソフトのアフィリエイト）で回している。同じモデルで後発が勝つのは難しい。
• 差別化して課金できる余地は次の4つ。
  1. 金融機関辞書との照合と統廃合の警告（同サイトには無い。銀行で弾かれる前に気づける）
  2. 複数の振込元プロファイル（社労士・税理士事務所が顧問先ごとに切り替える）
  3. PDF入力（給与ソフトの「振込一覧表PDF」しか手元に無いケース）
  4. サポートと継続性（辞書の毎月更新、銀行別の取込条件の整備、問い合わせ対応）
• 現実的な価格帯は「無料枠あり＋事務所向け有料（月額 1,000〜3,000円）」。個人事業主から広く薄く取るのは無理筋。

ターゲット

1. 従業員5〜50人、給与計算はExcel／社労士任せ、振込はメガバンク・地銀・信金の法人ネットバンキング
2. 社労士・税理士事務所（顧問先ごとに依頼人情報を切り替えて何本も作る → 「複数プロファイル」機能が刺さる）
3. 支払（総合振込）を毎月Excelで管理している業種（建設・運送・卸・不動産管理）

価格（2026-09-10 確定。詳細は 3f）

プラン	価格	内容
Free	¥0	1回20件まで。登録不要
Pro	¥480/月払い または ¥4,800/年払い	件数無制限、テンプレート保存、振込元プロファイル、履歴、バックアップ

---

3. 全銀フォーマット仕様（実装済み）

全レコード120バイト固定長。文字コードは JIS X 0201（Shift_JIS の1バイト部分）。 使える文字: 数字・英大文字・半角カナ・記号 ( ) - . / ¥ ｢ ｣ ・空白。 濁点は分離（ﾊﾞ = ﾊ + ﾞ）。行末は CR+LF が一般的（銀行により「区切りなし」指定あり）。

ヘッダーレコード（データ区分 1）

項目	桁	型	内容
データ区分	1	N	1
種別コード	2	N	21=総合振込 11=給与振込 12=賞与振込
コード区分	1	N	0=JIS
振込依頼人コード	10	N	銀行から付与される委託者コード
振込依頼人名	40	C	半角カナ
振込日	4	N	MMDD
仕向銀行番号	4	N
仕向銀行名	15	C	空白可
仕向支店番号	3	N
仕向支店名	15	C	空白可
預金種目	1	N	1=普通 2=当座
口座番号	7	N
ダミー	17	C	空白

データレコード（データ区分 2）

項目	桁	型	総合振込	給与・賞与振込
データ区分	1	N	2	2
被仕向銀行番号	4	N
被仕向銀行名	15	C	空白可	空白可
被仕向支店番号	3	N
被仕向支店名	15	C	空白可	空白可
手形交換所番号	4	N	空白	空白
預金種目	1	N	1/2/4/9	1/2 のみ
口座番号	7	N
受取人名	30	C	半角カナ	半角カナ
振込金額	10	N
新規コード	1	N	0/1/2	0/1/2
（21）顧客コード1 / （11,12）社員番号	10	N
（21）顧客コード2 / （11,12）所属コード	10	N
（21）振込指定区分	1	N	7=電信 8=文書	—
（21）識別表示	1	C	Y=EDIあり	—
ダミー	7 / 9	C	空白	空白

トレーラ（8）・エンド（9）

• トレーラ: 8 + 合計件数(6) + 合計金額(12) + 空白(101)
• エンド: 9 + 空白(119)

名義カナ変換ルール（Zengin.toZenginChars）

• 全角カナ・ひらがな → 半角カナ、濁点分離、全角英数 → 半角、英小文字 → 大文字
• 拗音・促音 ｬｭｮｯ → 大文字（銀行慣行。オプションでオフ）
• 法人略語: 株式会社→ｶ、有限会社→ﾕ、合同会社→ﾄﾞ、医療法人→ｲ、一般社団法人→ｼﾔ、NPO→ﾄｸﾋ など約40種。 先頭は ｶ)、末尾は (ｶ、中間は (ｶ)。営業所→(ｴｲ、出張所→(ｼﾕﾂ
• 中点「・」→「.」、各種ハイフン → -、「￥」「\」→ ¥
• 変換できない文字（漢字など）は残してエラー表示 → 画面で直接修正できる

ゆうちょ銀行（記号・番号 → 店番・口座番号）

• 総合口座（記号 1xxx0）: 店番 = 記号2〜3桁目 + 8、普通、口座番号 = 番号の末尾「1」を除く7桁
• 振替口座（記号 0xxxx）: 店番 = 記号2〜3桁目 + 9、当座、口座番号 = 番号を7桁0埋め
• 銀行コード 9900

---

3b. 銀行コード・支店コードの扱い（統廃合・名称変更への対応）

原則: コードが正、名前は飾り

全銀フォーマットで銀行が見るのは 銀行コード（4桁）と支店コード（3桁） だけ。銀行名・支店名の欄は 任意で、ほとんどの銀行がコードから自動で補う。だから統廃合で名前が変わっても、コードが正しければ通る。 問題になるのは コード自体が変わる／廃止される ケースで、これは「辞書」で検知するしかない。

金融機関辞書（data/）

• 元データ: zengin-code/source-data（MIT）。全銀協の公開ページから 収集されたもので、ほぼ毎月更新されている（直近 2026-08-24）。1,146 金融機関・28,944 支店。
• tools/build-dict.js で data/banks.json（全行）と data/branches/XXXX.json（支店、必要な銀行分だけ読む）に変換して同梱。
• アプリ本体を触らずに辞書だけ差し替えられる。 .github/workflows/update-dict.yml が毎月2日に最新版を取得し、 差分があれば PR を作る。マージすれば GitHub Pages に反映される。画面の下部に「金融機関一覧: YYYY-MM-DD 版」と出る。

画面での使い方

状況	画面の扱い	出力
コードが辞書にある	銀行名・支店名を表示。空欄なら辞書のカナで補完（オプションで停止可）	出力できる
銀行コードが辞書にない	「確認」（黄）: 統廃合か入力ミスの可能性	出力できる（銀行で弾かれる可能性を明示）
支店コードがその銀行の一覧にない	「確認」（黄）	出力できる
data/merged.json に旧コードとして登録済み	「確認」（黄）: 新コードと切替日、支店番号の扱いを表示	出力できる
桁数不正・空欄・使えない文字	「エラー」（赤）	出力できない

警告を「出力不可」にしない理由: 辞書の更新が銀行の変更より遅れることがあるため。 最終判断は銀行側のチェックに委ね、こちらは「気づかせる」役に徹する。

統廃合が起きたときの運用

1. 月次の自動PRで辞書が更新される（新コードが載り、旧コードが消える）。
2. 旧コードが消えた金融機関を data/merged.json に「旧→新、切替日、支店番号の扱い（引き継ぎ／再採番）」として手で追記する。 これで旧コードのままの Excel を持ち込んだ利用者に「新コード XXXX に直してください」と案内できる。
3. 支店の再採番がある合併（同じ支店コードが別支店になる）では自動変換はしない。利用者が銀行からの通知で直すのが正しい。 ツールは「この銀行は YYYY-MM-DD に合併し支店番号が変わっています」と出すだけにする。
4. ゆうちょ銀行は記号・番号→店番・口座番号の変換規則が固定なので辞書に依存しない。

辞書の限界（正直に書く）

• zengin-code は個人メンテのOSS。止まった場合は全銀協の公開ページ（金融機関コード検索）から自前で収集する スクリプトを tools/ に追加する。データ形式は同じにしてあるので差し替えは容易。
• 「支店の統廃合で支店コードが変わった」レベルの履歴は辞書に無い。旧支店コードは単に「一覧にない」警告になる。

3c. 「並びが揃っていない表」の自動整理（src/organize.js）

前提: 利用者のExcelは全銀の項目順になっていない。AIは使わず、全部ルールで整理する（2026-09-03 決定: AI API・クラウドOCR・AIによる誤入力判定は使わない。データを外に出さない設計と、判定の再現性を優先）。

起きること	対応
見出しが2行目以降、タイトル行が上にある	見出し語の一致数と「数値が無い行」で見出し行を採点して選ぶ。手動で行を選び直せる
見出しが無い	値の形（4桁／3桁／5〜8桁／金額／カナ／漢字名／銀行文字列／支店文字列／普通・当座）で各列を判定して割り当てる。画面に「推定」バッジ
見出しがあっても中身が違う（「銀行」列に銀行名）	見出し一致でも値の形が矛盾する列は採らない
1セルに複数項目（0005-001、普通 1234567、三菱UFJ銀行 渋谷支店、山田太郎（ヤマダタロウ））	6割以上の行で同じ分解ができる列は「元→項目」という仮想列に分けて右に追加する
銀行コードが無く銀行名しかない	金融機関辞書で名前→コードを逆引き（「信用金庫」等の語でコード帯を絞る。候補が複数なら「確認」で提示）
支店コードが無く支店名しかない	同じく支店一覧から逆引き
合計・小計行	「合計」等の語、または名義も口座も無く金額だけの行を除外
口座番号と金額の区別（どちらも数字だけ）	先頭0や7桁固定なら口座番号、下2桁00が多ければ金額。見出しがあればそちらが優先

限界: 縦持ち（1人1ブロック）の表や、1セルに3つ以上の自由記述が混ざるものは対象外。 推定は必ず画面で確認させる（「推定」バッジと「例」列）。同じ見出しのファイルは手直しを記憶する。

3d. Googleスプレッドシート連携（src/gsheets.js）

「ピッカーで選んで直接読む」方式。仕組みは3ステップ。

1. Google Identity Services でログインし、スコープ drive.file（利用者が選んだファイルだけ触れる権限）のトークンを得る
2. Google Picker（Googleが用意しているファイル選択ダイアログ）でスプレッドシートを選ばせる。Picker で選んだファイルは drive.file の対象になる
3. Drive API の files.export で xlsx として取得し、いまの SheetJS 経路に流す

通信は利用者のブラウザと Google の間だけ。自社サーバーは通らない。drive.file は非機密スコープなので Google の審査は不要。 必要な設定と手順は config.js の冒頭に書いた（GCPプロジェクト、Drive API / Picker API 有効化、OAuth同意画面、クライアントID、APIキー）。 未設定の間はボタンを押すと「ファイル→ダウンロード→Excel」の案内を出す。

3e. サイト構成・デザイン・差別化・アクセス対策（2026-09-03）

ページ構成

ページ	役割	SEO
index.html	LP（ヒーロー→ツール本体→特徴→使い方→料金→FAQ抜粋）	主キーワード「全銀フォーマット 変換」「FBデータ 作成 Excel」「給与振込 データ 作成」。SoftwareApplication 構造化データ
guide.html	使い方、銀行別の取込方法、注意事項	「BizSTATION 全銀 取込」等の銀行名×取込の検索
pricing.html	3プラン＋他手段との比較表＋支払条件
security.html	送信しない仕組み、確認方法、保存情報、法令上の位置づけ、免責	情シス・士業の稟議用
faq.html	40問（FAQPage 構造化データ）	ロングテール
banks/index.html + banks/XXXX.html	銀行コード・支店コード検索（1,146ページ、毎月自動更新）	「○○銀行 △△支店 支店コード」検索の受け皿。最大の集客装置
terms.html privacy.html tokushoho.html 404.html	規約類（noindex）
sitemap.xml robots.txt		data/ samples/ はクロール除外

共通ヘッダー・フッターは、2026-09-18 から tools/build-site.js が HTML に静的に埋め込む（下の 3g）。デザイントークンは style.css 先頭（ネイビー #14305c × オレンジ #ff7a1a、生成りの背景、Noto Sans JP）。イラストはインラインSVG（外部画像なし・軽量）。 AI生成のヒーロー画像や Figma での調整は、この構造の上に載せ替える前提。

差別化（総合振込.jp など無料ツールに対して）

1. 自動整理 — 並び順・見出し・結合セル・合計行を気にせず読める。「どんなExcelでもOK」を前面に
2. 銀行名→コードの逆引き と 統廃合警告（辞書は毎月更新、銀行ページで裏取りできる）
3. Googleスプレッドシート直結 と PDF入力
4. 銀行休業日チェック（振込指定日が土日祝・年末年始なら次の営業日を案内）
5. Proに振込元プロファイル複数保存（士業事務所の顧問先切替に対応）
6. セキュリティ説明の丁寧さ（確認手順・保存情報・法令上の位置づけを1ページに）— 稟議を通しやすくする
7. 今後: 全銀→Excel の逆変換（入金データの読み取り）、口座振替データ、振込手数料の試算

料金（確定案）

プラン	価格	制限・内容
Free	¥0	1回20件まで、全機能、登録不要
Pro	¥480/月払い または ¥4,800/年払い	無制限、テンプレート保存、履歴、バックアップ、振込元プロファイル複数、メールサポート、2台まで

総合振込.jp（¥500/月・無料10行）より少し安く・無料枠を広く。事務所向けの別プランは作らない（2026-09-03 決定）。Pro に「振込元プロファイル複数」を含めて事務所需要も吸収する。 弊社はインボイス登録なし → 適格請求書は発行できない旨をサイトに明記。 未実装: 20件制限、ライセンスキー認証、テンプレート保存、履歴、バックアップ（Misefits の functions を流用して実装する）。

アクセス対策

• 銀行コード検索ページ（1,146ページ）を毎月更新して、支店コード検索の流入を取る。各ページ末尾でツールへ誘導
• Search Console に sitemap を登録。OGP画像 assets/ogp.png を作る（未作成）
• 銀行別の取込手順記事（BizSTATION／みずほe-ビジネスサイト／Web21／りそな／ゆうちょBiz／信金）を guide.html から独立ページに育てる
• 「給与計算 Excel テンプレート（全銀変換対応）」を無料配布し、テンプレ流入→ツール利用につなげる
• 社労士・税理士向け: 「顧問先の振込データを5分で」記事、士業コミュニティでの紹介、OEM提案
• 総合振込.jp が広告収益型なので、こちらは「広告なし・データ非送信」を明確に対比する

3f. 課金の仕組み（2026-09-10 実装）

サーバー不要の署名付きライセンスキーにした。Misefits の Firestore 方式より軽く、「通信しない」という売りとも整合する。

発行側（手元のPC）                          利用者のブラウザ
tools/issue-key.js ── Ed25519 秘密鍵 ──▶ ZP1-<payload>.<署名>  ──▶ src/license.js が公開鍵で検証 → localStorage に保存
   ~/.zengin-pon/license-private.pem              payload = {v:1, p:"pro", e:"有効期限", id}

• 秘密鍵: C:\Users\chaha\.zengin-pon\license-private.pem（リポジトリ外。失くすと発行できないのでパスワードマネージャーにも控える）。 公開鍵は src/license.js の PUBLIC_KEY。鍵の再生成は tools/gen-keypair.js（既存ファイルは上書きしない）。
• 発行: node tools/issue-key.js --months 12（年払い）／--months 1（月払い）／--until 2027-03-31。台帳 tools/issued-keys.csv に追記（gitignore）。
• 更新: Cloud Functions が自動で発行・送信する（下記）。手動発行は返金・特例対応用。
• 台数制限（2台）は技術的に強制しない（規約上の約束）。

月払いの自動化（functions/）

既存の Firebase プロジェクト misefits に codebase zenginpon として相乗りする（新規プロジェクト・Blaze設定が不要、 codebase が別なので Misefits の関数は消えない。Firestore ルールはこのリポジトリから配らない）。

考え方: 月払いも年払いも Stripe のサブスクリプション（自動更新）。オフラインで検証できる署名付きキーは そのままだと解約後も期限まで使えてしまうので、キーの寿命を短くして（最長30日）定期的に取り直す。 取り直すたびにサーバーが Stripe の契約状態を見に行くので、解約されればそこで止まる。

関数	役割
zenginponStripeWebhook	checkout.session.completed / invoice.paid でキーを発行し、Firestore に保存してメール送信。customer.subscription.updated で解約の予約を知らせ、customer.subscription.deleted で解約日を記録して終了のメールを送る。イベントID（zenginponEvents）で二重処理を防ぎ、メールを送れなければ 500 で Stripe に再送させる
zenginponLicense	GET ?id=<ライセンスID>。Stripe に契約状態を直接問い合わせて、契約中なら新しいキー、Stripe で解約・期限切れを確かめたら 410、Stripe に照会できず判断できなければ 503（ブラウザはキーを消さない）。10分以内に照会済みなら照会を省く。CORS はサイトと localhost のみ

判定とメールの文面は functions/billing.js（有休ポンと同じ設計。2026-10-15 にそろえた）。 発行する期限は min(使ってよい最終日, 今日 + 30日)。使ってよい最終日は契約の状態で決める（entitledUntilOf）: 契約中は期間の末日＋3日、日付指定の解約（cancel_at）はその日＋3日、再請求中（past_due）は期間の初日から30日＋3日まで、 未払い（unpaid）・一時停止は今の期間の初日＋3日、解約済みは終了日＋3日、一度も払われていない契約（incomplete）には出さない。

状況	起きること
契約中（月払い・年払いとも）	取り直すたびに「今日+30日」まで延びる。利用者は何もしなくてよい
期間末で解約	期間の末日+3日を超えて延びない → その後 410 → ブラウザが手元のキーを削除して Free に戻る
即時解約・未払い	次の確認（最長7日以内）で 410 → 同上
オフライン・Stripe の障害（503）・5xx	何もしない。手元のキーの期限（最長30日）までは使える

• 確かめ方: test/functions.test.js（Webhook・キー更新の全経路。イベントは Stripe の実際の形）、test/renew.test.js（サーバーのキーをブラウザが読めるか・自動更新の判定）、tools/preflight.mjs（設定の照合。CI でも実行）。

• ライセンスIDはサブスクリプションIDのハッシュで、更新しても変わらない。

• ブラウザは「期限が10日以内」または「前回の確認から7日以上」で取り直す（src/license.js の refreshIfNeeded）。 送るのはライセンスIDだけ。config.js の LICENSE_API が空なら完全オフライン動作（更新も失効もしない）。

• デプロイ手順は docs/launch-checklist.md の 3-4。

• Free の制限: 出力対象が20件まで（超過分は表で「Free上限外」）。列の割り当ての記憶（テンプレート）は Pro のみ。Free はページを閉じるまで。

• Pro の機能: 件数無制限、テンプレート保存、振込元プロファイル複数、変換履歴（設定で有効化、最新20件、再ダウンロード）、バックアップ／復元（JSON）。

• 「⚙ 設定 → すべて削除」で zenginpon.* の localStorage を全消去（共有PC向け）。

販売開始の最短手順（Webhook なしで始める）

1. Stripe で Payment Link を2本作る（Pro 月払い ¥480 / 年払い ¥4,800、メール収集ON）。料金ページの「申し込む（準備中）」をそのリンクにする。
2. 決済通知メールを受けたら node tools/issue-key.js --months 1|12 --memo "<メール>" でキーを発行し、テンプレ文面で送る（24時間以内）。
3. 月に数十件を超えたら、Misefits の functions/index.js を流用して Stripe Webhook → 自動発行・自動送信に切り替える（署名は Cloud Functions の Secret に秘密鍵を置いて同じ issue ロジックを呼ぶ）。
4. 月払いの更新は、Stripe のサブスク更新 Webhook で毎月キーを再発行するか、初回に「12か月分のキー」を渡して解約時に失効させない運用（簡単だが解約後も使える）のどちらか。当面は年払いを推し、月払いは Webhook 実装後に本格化。

3g. 検索・AI検索・法務・初心者むけ画面・制作実績（2026-09-18）

方針。 Google は2026年5月の公式ガイドで「AI検索むけの特別な対策は不要。従来のSEOの基本が効く」と明言し、 FAQ のリッチリザルトも同月に廃止した。小手先はやらず、独自で役に立つページ・内部リンク・正確な事実に投資する。

追加したもの	ねらい
ヘッダー／フッター／パンくず／OGP／構造化データの静的埋め込み（tools/build-site.js）	JavaScript を実行しないクローラーにもメニューと運営者表記が見える。全ページに canonical と OGP
zengin-format.html（仕様解説。レコード表、文字、詰め方、エラー原因、用語集）	「全銀フォーマットとは」「FBデータ」「120バイト」で調べる人の入口。AIが引用しやすい「最初の2文で答える」構成
free-tools/yucho.html free-tools/kana.html	「ゆうちょ 記号番号 変換」「口座名義 カナ 株式会社 略」の長尾。登録不要で1つの悩みをすぐ解決 → 本体へ誘導
llms.txt、robots.txt の AI クローラー明記、.well-known/security.txt、IndexNow	読める・正しく引用される状態にする。順位やおすすめを操作するものではない
トップの構造化データを @graph（Organization＋WebSite＋WebApplication）に	運営者「ここ企画」と会社サイトの Organization を同じ @id でつなぐ
legal.html（銀行法・資金決済法・特商法・個情法・電気通信事業法・消費者契約法・景表法）	「登録が要らない理由」を条文つきで公開。稟議・士業の確認に使える
pricing.html#confirm（申込み前の確認事項）	特商法12条の6（最終確認画面）に沿って、分量・価格・支払時期・自動更新・解約・返金を1つの表に
privacy.html#external（外部送信の一覧）、委託先、外国にある第三者	電気通信事業法の外部送信規律、個情法28条に沿う情報提供
accessibility.html、スキップリンク、フォーカス表示、動きを減らす設定への対応、ドロップ領域のキーボード操作	障害者差別解消法の合理的配慮。JIS X 8341-3:2016 AA に「配慮」（試験未実施なので「準拠」とは書かない）
「サンプルで試す」ボタン2種、振込元のお試し入力、整理前→整理後の図、用語のヘルプ	手元にファイルが無くても30秒で最後まで体験できる。お試しの値は保存しない
about.html（運営者情報・制作メモ）、フッターの「企画・開発・運営：ここ企画」	ここ企画の制作実績として読める形にする

ページを足すとき・共通部品を直すときの手順は AGENTS.md の 2。CI（.github/workflows/check-site.yml）が テストと「埋め込み忘れ」を push のたびに確認する。

---

4. 銀行ごとの取込条件（要・実機確認）

銀行/サービス	形式	メモ
三菱UFJ BizSTATION	全銀（CRLF）	依頼人コード必須
みずほ e-ビジネスサイト	全銀（CRLF）	給与は種別11/12
三井住友 Web21	全銀
りそな ビジネスダイレクト	全銀
ゆうちょ Biz	全銀	記号番号変換が必要
信金（WEB-FB）	全銀	「改行なし」指定の信金がある
地銀各行	全銀	拡張子 .txt/.dat 指定あり
楽天・住信SBI・GMOあおぞら・PayPay	CSV または 全銀	CSV直接取込あり

「レコード区切り」「拡張子」は画面のオプションで切替可能。 次のステップ: 主要行の取込マニュアルを集め、上表を「銀行別プロファイル」として選ぶだけにする。

---

5. アーキテクチャ

ブラウザ（GitHub Pages / 静的）
  ├─ SheetJS（xlsx/csv 読込）        CDN
  ├─ pdf.js（テキスト層PDF → 表）    CDN
  ├─ src/zengin.js（変換・検証・JIS X 0201 エンコード）
  └─ localStorage（依頼人情報・列割り当て・ライセンスキー）

Firebase（Misefits と同じ構成を流用）
  ├─ Cloud Functions: stripeWebhook（決済完了 → ライセンスキー発行・メール送信）
  │                   verifyLicense（キー検証・端末登録）
  └─ Firestore: licenses/{key}
Stripe: Checkout（サブスク or 買い切り）

• 振込データはサーバーに一切送らない。 これは技術判断であると同時に最大のセールスポイント。 利用規約・プライバシーポリシーに明記する。
• ライセンス検証はクライアント側のため、技術的には回避可能。価格を「サポートと安心の対価」に置く前提で許容する。
• 公開: studio8080/zengin-fb → GitHub Pages → zenginpon.kokokikaku.com（Squarespace の DNS に CNAME 追加。~/.claude/CLAUDE.md の注意事項参照）。

---

6. ロードマップ

v0.1（このMVP・完了）

• Excel / CSV 読込、見出し行の自動検出、列の自動割り当て＋記憶

• 総合振込 / 給与振込 / 賞与振込

• 名義カナ自動変換・法人略語・ゆうちょ変換・行ごとの検証・画面上で修正

• 120バイト固定長生成、JIS X 0201 出力、CRLF/LF/なし、拡張子選択

• PDF（テキスト層あり）の簡易表抽出（β）

• 4ステップのウィザードUI（総合振込.jp を参考に、種別カード・大きなドロップ領域・列割り当て表に「例」列・状態カード）

• 金融機関辞書（1,146行・28,944支店）による銀行名表示、名称補完、存在チェック（黄色の「確認」）、統廃合表の仕組み、毎月の自動更新PR

• 表の自動整理（見出し推定・結合セル分解・値の形からの列推定・銀行名／支店名→コード逆引き・合計行除外）

• Googleスプレッドシート連携のコード（config.js に GCP の設定を入れれば有効になる）

決定事項（2026-09-03）

• AI API・クラウドOCR・AIによる誤入力判定は使わない。スキャン画像PDFは非対応と明記する
• 価格の相場は総合振込.jp Pro（月額500円／年額4,800円、無料10行）。同等機能で上乗せは不可。事務所向けプランで単価を取る

v0.5（販売開始まで）

• GCPでOAuthクライアントIDとAPIキーを作り、Googleスプレッドシート連携を実機で確認（config.js の手順）
• 主要10行の取込マニュアルに基づく「銀行別プロファイル」
• data/merged.json に直近数年の統廃合（旧→新コード）を実データで埋める
• 依頼人プロファイル複数保存（事務所向け・有料機能の柱）
• 実銀行での取込テスト（自社口座で少額 1件を実際に送る）
• LP・料金ページ・特商法表記・利用規約・プライバシーポリシー（Misefits の tokushoho.html / privacy.html を雛形に）
• Stripe + ライセンスキー（Misefits の functions を流用）
• 無料枠の制限ロジック（例: 3行まで／透かし）

v1.0以降

• PDF の精度向上（列境界の学習、給与ソフト別テンプレート）
• 逆変換（全銀ファイル → Excel）— 銀行から来た入金データの読み取りにも需要がある
• 口座振替（引落）フォーマット、総合振込の EDI 情報
• デスクトップ版（Tauri）— 「ブラウザすら不安」という層向け

---

7. 法務・注意点

• ファイル生成だけで送金は行わないので、資金移動業・電子決済等代行業の登録は不要。根拠の整理は legal.html に公開し、 社内メモは docs/compliance-check.md。銀行への送信や口座情報の取得（API連携）を足すと結論が変わるので、足す前に必ず再確認する。
• 特定商取引法に基づく表記、利用規約（生成データの誤りによる損害の免責と、ユーザーが銀行画面で内容確認・承認する旨）、プライバシーポリシー（データを送信しない旨）を用意する。
• 弊社はインボイス（適格請求書発行事業者）未登録。領収書は Stripe の自動メールのみで、適格請求書は発行できない旨をサイトに明記済み。
• 振込先口座情報は個人情報。ブラウザ完結でも、localStorage に残す項目は依頼人情報と列割り当てだけにし、振込先データは保存しない（現状そうなっている）。