MockForge AI Relational Mock Database & Fixture Generator

---

⚡ 課題：リレーショナルシードデータの悪夢

開発者や QA エンジニアは、シード用のフィクスチャを手作業で作成するために、何百時間も費やしています。

• 外部キー違反：users より先に orders を挿入すると、整合性制約エラーが発生し、統合テストがクラッシュします。
• 劣化するテスト用フィクスチャ：スキーマのマイグレーション（Prisma、Drizzle、Alembic）によって静的な JSON モックが無効になり、手動での更新を余儀なくされます。
• PII とコンプライアンスのリスク：サニタイズ済みの本番データベースをステージング環境にコピーすると、HIPAA、GDPR、SOC 2 に違反することがよくあります。
• クラウドデータベースのコスト：CI/CD ランナーごとにステージングデータベースのインスタンスを用意すると、インフラ費用が膨らみます。

MockForge は、SQL DDL または Prisma スキーマを解析して依存関係の DAG を構築し、CI/CD ランナーやブラウザー内で、一貫性のあるリレーショナルデータを数百万行合成することで、この問題を解決します。

---

🏛️ アーキテクチャ

MockForge は、外部データベースに依存することなく、完全にクライアント側、または一時的なサーバーレスエッジランタイムで動作します。

flowchart TD
    subgraph Inputs["Schema Input Layer"]
        DDL["SQL DDL (Postgres / MySQL / SQLite)"]
        Prisma["Prisma / Drizzle Schema"]
        OpenAPI["OpenAPI / Swagger Spec"]
    end

    subgraph CoreEngine["MockForge In-Memory Engine (< 88,000 rows/sec)"]
        Parser["AST Schema Parser & Foreign Key Graph Builder"]
        DAGSorter["Kahn's Topological DAG Sorter\n(Resolves Insertion Hierarchy & Cycles)"]
        Generator["Deterministic Synthetic Generator\n(Context-Aware Faker + Gemini 1.5 Flash)"]
        WASMDB["In-Memory WebAssembly SQLite Database\n(Real-Time FK & Unique Constraint Validator)"]
    end

    subgraph Exporters["Multi-Format Exporter Layer"]
        SQLExp["SQL INSERT Scripts (.sql)"]
        JSONExp["Nested Relational JSON"]
        CSVExp["Relational CSV Bundles"]
        PyExp["Pytest Fixtures (Python)"]
        TSExp["TypeScript / Prisma Seeders"]
    end

    subgraph ZeroCostEdge["Serverless Edge (api.mockforge.io)"]
        CFWorkers["Cloudflare Workers (Headless CI/CD Seed API)"]
    end

    Inputs --> Parser
    Parser --> DAGSorter
    DAGSorter --> Generator
    Generator --> WASMDB
    WASMDB --> SQLExp & JSONExp & CSVExp & PyExp & TSExp
    CFWorkers -.->|Headless DDL-to-Seed API| CoreEngine

---

🚀 クイックスタート

1. CLI クイックスタート

最新リリースからコンパイル済みバイナリをダウンロードするか、npm でインストールしてください。

npm install -g @ritualdev/mockforge

任意の SQL スキーマから、外部キー整合性を保ったリレーショナルレコードを 1,000 件生成します。

mockforge generate ./examples/schema.sql --count 1000 --format sql -o seed.sql

対応する出力形式：--format sql、--format json、--format csv、--format prisma。

---

2. Python SDK クイックスタート（pip install mockforge）

Pytest のフィクスチャ、Django、SQLAlchemy、自動テストパイプラインに最適です。

from mockforge import RelationalSynthesizer

# Define your schema
schema = """
CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT, email TEXT);
CREATE TABLE orders (id INTEGER PRIMARY KEY, user_id INTEGER REFERENCES users(id), amount REAL);
"""

# Synthesize relational dataset
synthesizer = RelationalSynthesizer()
seed_sql = synthesizer.generate_from_ddl(
    schema,
    row_counts={"users": 50, "orders": 200}
)

print(seed_sql[:200])
# All foreign keys are guaranteed valid and resolved in topological order!

完全な pytest 統合ガイドについては、examples/pytest_fixtures.pyを参照してください。

---

3. Node.js / TypeScript SDK

npm install @ritualdev/mockforge

import { MockForgeEngine } from '@ritualdev/mockforge';

const engine = new MockForgeEngine();
const result = await engine.synthesizeFromSql(`
  CREATE TABLE customers (id INT PRIMARY KEY, name VARCHAR(100));
  CREATE TABLE invoices (id INT PRIMARY KEY, customer_id INT REFERENCES customers(id), total DECIMAL);
`, { count: 500 });

console.log(`Generated ${result.totalRows} rows across ${result.tables.length} tables in ${result.elapsedMs}ms`);

---

🏢 エンタープライズ機能（$50K–$250K ACV の機能）

• 🛡️ 本番データベースのマスキングと匿名化（HIPAA / GDPR / SOC 2）：稼働中の Postgres/MySQL 本番データベースからサニタイズ済みスナップショットを MockForge に渡し、外部キーの関係を 100% 維持しながら、実際の顧客名、SSN、クレジットカード番号を整合性のある合成モックデータに置き換えます。
• 🌐 一時的なモック API サーバー（OpenAPI / Swagger / GraphQL）：CI/CD テストランナー（GitHub Actions、GitLab CI）内で、メモリ上の HTTP モックサーバーを即座に起動し、クラウドデータベースの起動による遅延なしで、スキーマ定義から動的な REST エンドポイントを提供します。
• 🔄 双方向 ORM マイグレーション同期ツール：Prisma、Drizzle、SQLAlchemy、Django ORM のマイグレーションと直接連携し、git のコミットごとに決定論的なテストフィクスチャを再生成します。

---

📊 パフォーマンスベンチマーク

• スループット：メモリ上で毎秒 88,000 行以上を生成・検証します。
• 外部キーの正確性：10,000 件を超えるリレーショナルテストの組み合わせで 100% の有効性を実現します。
• インフラコスト：月額 $0.00（VPS $0、クラウドデータベース費用 $0）。
• テスト検証：Node.js、WebAssembly、Python 3.8 以降で 58 件中 58 件のテストに合格しています。

---

---

💖 Dodo Payments でのスポンサー支援とサポート

MockForge は RitualDev Lab が開発しています。スポンサー支援は、クライアント側の WebAssembly SQLite/PGlite テストランナー、合成データ生成アルゴリズム、複数の方言に対応したスキーマフィクスチャツールの開発に直接役立てられます。

🤝 コミュニティとサポート

• 機能リクエストとバグ報告：公開 Issue トラッカーで Issue を作成してください。
• エンタープライズライセンス：複数ユーザー向けのボリュームライセンス、データベースマスキングパイプライン、カスタム ORM 同期ツールについては、[email protected] までお問い合わせください。
• コア開発：RitualDev Studio が開発・保守しています。

---