Selega ドキュメント
Selega は estados contables(EECC)を legalización するためのコントロール・ツールです。財務諸表一式の正規化された数値を取り込み、それらに対して一連の数値クロスチェックを実行し、管轄ごとのチェックリストをたどり、結果を提案します。このページでは各部分を説明します。
フロー:アップロード → ライブ検証 → 結果
Section titled “フロー:アップロード → ライブ検証 → 結果”- 数値を取り込む。 Selega は、財政状態計算書(ESP)、損益計算書(ER)、純資産変動計算書(EEPN)、キャッシュ・フロー計算書(EFE)、付属明細、注記にまたがる、正規化された数値スキーマを埋めます。スキーマは3通りの方法で埋められます。
- 手作業で、グリッドに入力 — 常に利用可能。
- ローカル抽出エンジンで — PDF キャンバス上のフォーマットごとのテンプレート、領域ごとの OCR(Tesseract)と来歴情報付き。ネットワーク不要、プライベート。これが既定の経路です。
- ゲート付き AI エンジンで — 任意のフォーマットに汎化しますが、データをクラウドに送信するため、既定ではオフでオプトイン式です(下記の ゲート付き AI を参照)。
- ライブ検証。 数値が入ってくると、クロスチェックが継続的に実行されます。各数値は、クロスチェックが裏付けると緑に、整合しないチェックに含まれると琥珀色に塗られます。レビュー担当者が確認します。整合しない数値は一つも通過しません。
- チェックリスト。 数値チェックと並行して、管轄の形式的コントロールのチェックリストがレビューされます。
- 結果。 決定エンジンが失敗したチェックを集約し、結果を提案します — 合法化、観察、署名認証、または拒否/返却。
正規化されたスキーマ
Section titled “正規化されたスキーマ”Selega は財務諸表一式を、数値とフラグのフラットなスキーマ(src/core/schema.js で定義)としてモデル化し、それらが由来する PDF フォーマットには依存しません。数値は以下にまたがります。
- ESP(財政状態): 総資産、総負債、純資産、期末および期首の現金預金。
- EEPN(純資産変動): 期末純資産、当期結果。
- ER(損益計算書): 最終結果。
- EFE(キャッシュ・フロー): 方法(直接法/間接法)、期首および期末の現金、現金変動、営業/投資/財務の各フロー、現金の RECPAM。
- 付属明細: 当期の固定資産減価償却、費用付属明細における減価償却。
- 注記/表紙: SIPA 社会保障債務、会社の種類、監査役を不設置とする旨の注記、純資産マイナスに関する注記。
数値クロスチェック
Section titled “数値クロスチェック”クロスチェックは Selega の核心です。それらは普遍的であり — FACPCE 基準は全国に適用されるため — 同一のセットがすべての管轄の起点となります。評議会ごとに変わるのは、形式的コントロールのカタログとその帰結です。クロスチェックはデータとして(ルールパック内の JSON クロスチェック・セットとして)保存され、汎用エンジンによって評価されるため、管理者はコードに触れることなくビジュアルビルダーから編集できます。
既定のセットには以下のクロスチェックが同梱されています。比較には、丸めを吸収するための小さな許容差(既定で通貨1単位)を使用します。各チェックは、比較(両辺が等しくなければならない)か、存在チェック(ある条件下で数値または注記が存在しなければならない)のいずれかです。既定では、このセット内のすべてのクロスチェックは直接拒否の帰結を持ちますが、帰結はクロスチェックごとに設定可能です。
| # | クロスチェック | 検証する内容 |
|---|---|---|
| 1 | 会計等式(A = P + PN) | 総資産が総負債と純資産の合計に等しい(ESP)。 |
| 2 | 純資産:ESP = EEPN | ESP の純資産が EEPN の期末純資産に等しい。 |
| 3 | 結果:ER = EEPN | 損益計算書の最終結果が EEPN に繰り越された結果に等しい。 |
| 4 | 現金:ESP = EFE(期末) | ESP の期末現金預金が EFE の期末現金に等しい。 |
| 5 | EFE 変動 = 期末 − 期首 | 現金変動が期末現金から期首現金を差し引いた額に等しい。 |
| 5b | EFE 変動 = 営業 + 投資 + 財務 | 現金変動が営業・投資・財務の各フローの合計に等しい。 |
| 6 | 結果:ER = EFE(間接法) | 最終結果が EFE の結果と整合する。EFE の方法が間接法の場合のみ。 |
| 7 | 減価償却:ER = EFE(間接法) | 損益計算書の減価償却が EFE の減価償却に等しい。間接法のみ。 |
| 8 | 法人所得税:ER = EFE(間接法) | 損益計算書の法人所得税が EFE の法人所得税に等しい。間接法のみ。 |
| 9 | EFE に表示される現金の RECPAM | 現金の RECPAM 専用の行が存在する。EFE の方法が直接法の場合のみ。 |
| 10 | 減価償却:固定資産付属明細 = 費用付属明細 | 当期の減価償却が2つの付属明細の間で一致する。 |
| 11 | 社会保障 法律17.250 第10条 | SIPA 社会保障債務に関する記載が存在する。 |
| 12 | 純資産マイナス注記 | 純資産がゼロを下回る場合、必須の注記が存在しなければならない。 |
| 13 | 監査役不設置注記 | SA / SAS 会社については、監査役を不設置とする旨の注記(第284条)が存在しなければならない。 |
クロスチェックの結果
Section titled “クロスチェックの結果”各クロスチェックは4つの状態のいずれかに評価されます。OK(整合する)、DIFIERE(整合しない — 関係する数値が琥珀色にフラグ付けされる)、NA(現在の条件下では該当しない、例:EFE が直接法のときの間接法専用チェック)、または FALTA(必須の数値が欠落している)。
決定エンジン
Section titled “決定エンジン”DIFIERE として返ってきたクロスチェックは観察事項に変換され、それぞれがそのクロスチェックで定義された帰結を伴います。決定エンジン(src/core/decision.js)は次に、帰結の優先度によって集約結果を計算します。
- 直接拒否 → 業務は拒否/返却されます。tasa borrador が支払われていた場合は、代わりに訂正のため返却されます。
- Subsanable(訂正可能) → tasa borrador が支払われていれば訂正のため返却されます。そうでなければ、専門家が訂正しないことを選んだ場合は合法化されます。
- 署名認証 → 署名のみの認証に格下げされます。
- ブロッキングの観察事項なし → 合法化されます。
tasa urgente が何らかの観察事項と組み合わさると、その急行ステータスを失い、業務は一般の再受付リストに戻されます。あり得る結果は次のとおりです。Se legaliza(合法化)、Se devuelve para corregir(訂正のため返却、tasa borrador)、Se certifica solo la firma(署名のみ認証)、Se deniega / se devuelve(拒否/返却)。
- Selega はアルゼンチンの24管轄のレジストリを同梱しています。各管轄は、完全に定義済みであるか、補完すべきテンプレートのいずれかです。
- 各評議会は独自のルールパックを定義します。形式的コントロールのカタログ、有効化されるクロスチェック、そして帰結です。管轄でローカルに編集されたルールパックは、リポジトリに同梱されたものを上書きします。
- クロスチェックは普遍的です(FACPCE 基準は全国に適用されます)。評議会ごとに変わるのは形式的コントロールと帰結です。
- 管理者は、特定のインストールが対応する管轄を選択し、ヘッダーからアクティブな管轄を切り替えます。
ロールとレビュー・ワークフロー
Section titled “ロールとレビュー・ワークフロー”Selega には5つのロール — agent、supervisor、auditor、admin、superadmin — があり、設定可能なレビュー・ワークフロー、信号機式の受信トレイ、エクスポート可能な読み取り専用の案件ファイルを備えています。アクセスは、視覚的に(ロールが行えないことを無効化)も、バックエンドで実際にも、ゲートされます。
ゲート付き AI
Section titled “ゲート付き AI”AI は既定でオフであり、プラグ可能です。ローカルエンジン(Ollama、例:CPU 上の Qwen2.5-VL)またはクラウド(OpenRouter)に対して実行でき、ローカルファーストです。クラウド経路は3つの条件でゲートされます。Admin で有効化されていること、API キーが存在すること、そして文書ごとの認可です — これがデータをボックス外へ送信する唯一の経路だからです。API キーはサーバー側に存在します(Admin から読み込まれた場合は書き込み専用で保存)。
Selega の状態は PostgreSQL(compose ファイルの db サービス、DATABASE_URL 経由で接続)に存在します。データベースは selega-pg ボリュームに永続化されます — それは legalización の記録なので、バックアップしてください。アプリケーションコンテナ自体は /app を読み取るだけで、OCR の出力を /tmp に書き込みます。
すべては環境変数(12-factor)で設定されます — 完全な表については Selega をインストール を参照してください。運用上、設定するのは POSTGRES_PASSWORD(必須)、管理者メールアドレス、TLS の背後にいるかどうか(SELEGA_SECURE_COOKIE)、ホストポート、そしてオプションでクラウド AI キー(Admin から読み込む方がよい)です。管轄ごとのルール、クロスチェック、チェックリスト、ユーザーは、すべて UI の Administration および System パネルから編集します — コード変更は不要です。
Vanilla JS(ES modules、フレームワークなし)· Node.js(独自の HTTP サーバー)· PostgreSQL(pg)· Docker · pdf.js / Tesseract.js / pdf-lib をベンダリング · ローカル AI 向けにオプションの Ollama。