Fulgoria ドキュメント

Fulgoria は、解析ではなく読むために設計された書類から、構造化データを抽出します。列をマークすることで一度レイアウトを教えれば、それ以降は同じ種類の書類をすべて読み取り、クリーンな CSV を提供します。以下のすべてはブラウザ内で行われます。

フロー

1. 書類を開く

PDF または画像を開く をクリックしてファイルを選ぶか、例を見る を選んでサンプルの銀行明細を読み込みます。デジタル PDF も、スキャンや写真も、どちらも受け付けます。スキャンと画像はローカル OCR（Tesseract.js）で読み取られるため、明細の画像であってもマシンから外に出ることなくテキストになります。

2. 列をマークする

Fulgoria は最初のパスとして列を自動検出します。書類の上を ドラッグ して各データがどこにあるかを示し、列を微調整します。次に、各列に役割を割り当てます。

date — 取引日
description — 摘要または受取人
debit / credit / amount with sign — 取引金額
balance — 繰越残高
text — 保持しておきたいその他の任意の列

各列に 自由な Excel 風のフォーマット（日付・数値のパターン、WYSIWYG）を適用したり、内容による 除外ルール を設定して、繰り返されるヘッダー、「合計」行、類似のノイズをスキップしたりすることもできます。

3. エクスポート前に編集する

スプレッドシート風のエディタ でどのセルでも修正でき、残高はリアルタイムで再計算 されます。検索＆置換、行の追加・削除、Excel からの貼り付け、元に戻す／やり直し、フィルダウン、補助付きカテゴリ分け、品質フラグ、編集可能な開始残高／終了残高に対応しています。

4. エクスポート

データがクリーンになったら、エクスポートします。

CSV — 取引データ。スプレッドシートや会計ツールにすぐ使えます。
テンプレート — ジオメトリを再利用可能な .ext.json または .ext.yaml ファイルとして（下記参照）。
Escriba に送る — クリーンな結果をローカルの Escriba へ渡します。

対応フォーマット

入力

デジタル PDF とスキャン／画像（PNG、JPG など）。複数ページの書類や複数口座の PDF — 例えば 1 つのファイル内のペソとドル — は、口座ごとに 1 枚のカードを生成します。

出力

取引データには CSV、レイアウトには .ext.json または .ext.yaml のテンプレートファイル。「Escriba に送る」のハンドオフが結果をスイートの他の部分へ渡します。

再利用可能なテンプレート

ある銀行の明細を初めてマークするとき、Fulgoria はそのレイアウトを テンプレート として保存できます。次回同じ種類の書類を開くと、自動的に認識 され、列がすでに配置されています — 再マークは不要です。

テンプレートは、ダウンロードした .json ファイルから読み込むか、アプリ内の保存済みテンプレートから選択できます。

プライバシー: 設計からして local-first

すべてがブラウザ内で動作します。PDF は あなたのマシン内 で開かれ、読み取られ、処理され、外部リクエストは一切ありません — フォントとライブラリはアプリにベンダリングされています。プライバシーは後付けの機能ではなく、アーキテクチャそのものです。

Fulgoria をセルフホストしても、薄いサーバーが書類を受け取ることはありません。静的ファイルを配信し、オプションのログインを処理するだけです。厳格な CSP とセキュリティヘッダーを適用し、.env、server.js、いかなるプライベートなサンプルも公開しません。

サーバーとログイン

本番環境向けに、Fulgoria は 薄いサーバー（server.js、Node/Express）を同梱しており、その唯一の役割は静的アプリを配信することと、.env から読み込んだ オプションのログイン でその背後を保護することです。

ログインあり
ログインなし

AUTH_ENABLED=true を設定し、AUTH_USER と AUTH_PASSWORD を構成します。セッションは SESSION_SECRET で署名され、SESSION_TTL_HOURS 時間持続します。HTTPS の背後では COOKIE_SECURE=true のままにしてください。

AUTH_ENABLED=false を設定すると、パスワードなしでアプリを配信します — ローカルでの利用や信頼できるプライベートネットワークに便利です。

bcrypt パスワードハッシュとセッションシークレットは次のように生成します。

node server.js --hash 'your-password'   # → AUTH_PASSWORD
openssl rand -hex 32                     # → SESSION_SECRET

設定リファレンス

すべての設定は .env にあります。

変数	デフォルト	用途
`PORT`	`3000`	サーバーポート。
`AUTH_ENABLED`	`true`	ログインのオン／オフを切り替えます。
`AUTH_USER`	`diego`	ログイン用のユーザー名。
`AUTH_PASSWORD`	(空)	プレーンテキストのパスワードまたは bcrypt ハッシュ。
`SESSION_SECRET`	(空)	セッションクッキーに署名します。
`SESSION_TTL_HOURS`	`12`	セッションの有効期間（時間単位）。
`COOKIE_SECURE`	`true`	HTTPS の背後では `true`、ローカルの `http://` では `false`。
`ESCRIBA_URL`	(空)	「Escriba に送る」の宛先。空の場合は `/` にフォールバックします。