【Core SSoT】Rust-Native Core Architecture Blueprint（コアアーキテクチャ絶対設計書）

⚠️ THE GENERATIVE SSoT: RUST SUPREMACY & ABSOLUTE PERFORMANCE 本ドキュメントは、「もしものはなし」のトラスト・コアエンジンにおける、Rustのメモリ安全性と非同期処理を極限まで活用したアーキテクチャを定義する。一ミリの隙、一文字の矛盾、一バイトの塵すら一切の例外なく許容しない、株式会社オープンナレッジの技術的競争優位の絶対的根源である。

1. 究極の技術目標と哲学（超現実主義的・狂気的搾取）

「もしものはなし」は単なる終活アプリではない。B2B2Cトラストハブとして、数千の士業と数百万のシニアの「極めて機微な人生の清算データ」を処理する。この膨大なトランザクションを、**「ゼロの限界費用」「ゼロのデータ漏洩」「ゼロの待機時間」**で捌くための唯一解が、純粋なるRust・Coreエンジンである。

• Zero-Knowledge Trust (絶対的暗号の数学的証明):
  • システム運営者（オープンナレッジ自身）でさえも、ユーザーの財産・遺言データを復号・閲覧することは数学的・物理的に不可能でなければならない。
  • シャミア秘密分散法（SSS）を用い、秘密鍵を N=5 に分割し K=3 で復元する。この一連の分割・暗号化処理は、CORS越えのEdge WASMまたはNative FFIにおいて、ガベージコレクションによるスパイクを一切生じさせず、p99レイテンシ 50ms以内で完遂されなければならない。
• Zero-Cost Abstraction (開発工数の極小化とAI生成):
  • 車輪の再発明は「技術的エントロピー」を生む。成熟したRustエコシステム（Tokio, Axum, sqlx）をAI（Gemini/Claude）を用いて高速に糊付け（Glue）し、初期開発工数を他言語比で1/5以下に圧縮する。

2. コア・モジュール構成（Strict Hexagonal Architecture）

コアロジック（特許・秘匿対象となる暗号化や知財アルゴリズム）と、周辺のI/O層（DB、API）を物理的なクレート（Workspace）レベルで完全に隔離する。これにより、一バイトのビジネスロジックの漏洩も防ぐ。

graph TD
    subgraph "External Adapters (Port Layer - Inbound)"
        API[Axum REST API / HTTP3 Edge]
        WASM[wasm-bindgen / Astro Island Integration]
        FFI[flutter_rust_bridge / Native Mobile]
    end
    
    subgraph "Application Core (Pure Rust - Zero IO)"
        AppService[Application UseCases]
        
        subgraph "Domain & Cryptography (Trade Secrets / Blackbox)"
            Entity[Strict Entities / UUIDv7 / Type-Safe Structs]
            SSS[SSS Cryptography Engine / Math Verification]
            Policy[RBAC & Zero-Trust Access Control Policy]
        end
    end
    
    subgraph "Infrastructure Adapters (Port Layer - Outbound)"
        DB[PostgreSQL / SQLx Compile-Time Verification]
        Stripe[Stripe Checkout / Idempotent Payment]
    end

    API --> AppService
    WASM --> AppService
    FFI --> AppService
    AppService --> Entity
    AppService --> SSS
    AppService --> Policy
    AppService --> DB
    AppService --> Stripe

3. 細胞レベルで選定された超効率的クレート群

いかなる妥協も許さない、実戦投入可能かつAI生成と極めて親和性の高いクレート選定。

1. Web/API層: axum + tower
   • Tokioエコシステムとの完全な統合。ミドルウェア（CORS, Rate Limiting, Trace）を直感的に構築し、1コアあたり毎秒10万リクエスト以上の圧倒的スループットを叩き出す。
2. 非同期ランタイム: tokio
   • マルチスレッド並行処理の事実上のデファクトスタンダード。スレッドプールの枯渇を監視し、AIドリブンなスケーリングを可能にする。
3. データ永続化: sqlx (with PostgreSQL)
   • 絶対的ルール: 実行時SQLエラーはバグではなく「規律違反」である。コンパイル時にDBスキーマとSQL文の整合性を数学的に検証（query! マクロ）し、N+1問題や型不一致を細胞レベルで撲滅する。
4. データ直列化: serde
   • ゼロコスト抽象化の要。JSONのパースにおいてメモリ割り当てを最小限に抑止し、最速のI/Oを実現する。
5. WASM / FFI 統合: wasm-bindgen & flutter_rust_bridge
   • 同一のコアロジックを、Web（ブラウザ内WASM）とiOS/Android（ネイティブFFIバイナリ）に寸分の狂い・一文字の矛盾もなく展開するための至高のブリッジ。

4. 定量的パフォーマンスの絶対目標（SLOへの直結）

• APIレイテンシの極限化: JWT検証 + DB Read (PostgreSQL / RLS適用) + SSS暗号化処理 + JSON返却 = p99において 30ms未満 を絶対死守。
• WASM暗号化速度: SSSキー分割（N=5, K=3）処理 = メインスレッドを1ミリ秒たりともブロックしてはならない。5ms未満。
• フットプリント: コンテナ1台あたりアイドルメモリ 50MB未満。WASMバイナリサイズは wasm-opt -Oz により 1MB以下 に圧縮し、Edge CDNでのキャッシュ効率を最大化する。