Ranuk DataCanvas BI

DataCanvas — ChatGPT Plugin Extension (MCP)

Ranuk IT Solutions（Emilio Ranucoli）が開発・運営
あらゆるデータセット（CSV、TSV、JSON、Excel）を、ChatGPT のインターフェース（thread_panel のサイドパネルと global サイドバー）上でリアルタイムに動作するインタラクティブな分析ダッシュボードへと変換します。高精度なベクター PDF（>400KB）のエグゼクティブレポートをエクスポートでき、外部の SaaS マネタイズファネルも備えています。

---

🎯 エグゼクティブサマリー

DataCanvas は、ChatGPT のデータ分析における最大の制約である静的であることを解消します。ユーザーが表形式のデータを提供すると、プレーンテキストの表や Matplotlib で生成された静的な画像の代わりに、ライブフィルター、グラフ種類の動的な選択機能、反応型 KPI カードを備えたインタラクティブな会話パネルを表示します。

このモデルがビジネスを生み出す理由：

• 顧客獲得コスト（CAC）= $0： OpenAI のグローバルディレクトリ（~1.2B WAU）からのオーガニックトラフィックと、会話中のコンテキストトリガーによって集客します。
• 顧客側のコンピューティングコスト = $0： 分析用の集計処理は DuckDB-WASM と Apache ECharts を介して、ユーザーのブラウザー上で実行されます。
• 100% 外部でマネタイズ： OpenAI の規定を厳守します。プラグイン内でのデジタル決済は一切なく、Pro プラン（$19/月または $190/年）へのアップグレードはすべて、Ranuk IT Solutions が管理するドメイン上の Stripe Hosted Checkout を通じて行われます。手数料やレベニューシェアはありません。

---

🏗️ システムアーキテクチャ

sequenceDiagram
    autonumber
    actor User as Usuario en ChatGPT
    participant GPT as ChatGPT (LLM)
    participant MCP as Servidor MCP (FastAPI :7800)
    participant UI as Panel UI (Iframe Sandboxed)
    participant Engine as Ranuk Report Engine
    participant Stripe as Stripe Checkout (Externo)

    User->>GPT: "Armame un dashboard interactivo de este CSV"
    GPT->>MCP: Call tool: datacanvas_render_dashboard(title, raw_data)
    MCP-->>GPT: Return metadata OpenAIUiToolMetadata (ui://datacanvas/dashboard)
    GPT->>UI: Despliega Iframe en el panel lateral vía postMessage
    User->>UI: Filtra datos, alterna gráficos y examina KPIs
    UI->>UI: Agregación client-side sin costo de cómputo para el backend
    User->>UI: Click en "Exportar Reporte Ejecutivo PDF"
    alt Usuario Gratuito
        UI->>Engine: Genera reporte con watermark Ranuk
        Engine-->>UI: Descarga PDF oficial (>400KB) + Modal Upgrade
    else Click en "Desbloquear Pro / White-Label"
        UI->>User: window.open("https://datacanvas.ranuk.dev/checkout")
        User->>Stripe: Pago de suscripción ($19/mo)
        Stripe->>MCP: Webhook asienta cobro en income_ledger.json
    end

---

📦 リポジトリ構成

rk-mcp-datacanvas/
├── manifest.json              # Especificación oficial de OpenAI Plugin Extension
├── README.md                  # Manual de arquitectura, despliegue y operaciones
├── server/
│   ├── main.py               # Servidor FastAPI (Protocolo MCP JSON-RPC + UI Server)
│   ├── tools.py              # Definición analítica y schemas OpenAIUiToolMetadata
│   └── report_bridge.py      # Conexión al motor ranukita_report.py
├── ui/
│   └── index.html            # Frontend interactivo para el iframe (Tailwind + ECharts)
├── scripts/
│   ├── rk-mcp-pack.py        # Validador y empaquetador para Apps Management (.zip)
│   └── rk-mcp-growth.py      # Cron diario de health check, leads B2B y sync con ledger
├── tests/
│   └── test_mcp_server.py    # Suite de tests (MCP handshake, tools y reportes)
├── submission/
│   ├── video_script.md       # Guion de 75 segundos para el revisor de OpenAI
│   └── test_cases.json       # Casos de prueba reproducibles para el submission
└── dist/
    └── rk-mcp-datacanvas.zip # Paquete validado y listo para envío

---

💎 提供モデル：Free と Pro

機能	DataCanvas Free（プラグイン内）	DataCanvas Pro（$19/月または$190/年）
ChatGPT でのインタラクティブな可視化	無制限	無制限
動的グラフ（棒、折れ線、ドーナツ）	はい	はい + ヒートマップとファネル
DuckDB-WASM によるリアルタイムフィルター	はい	はい
PDF レポートのエクスポート	月3件（ウォーターマーク付き）	無制限、ホワイトラベル、>400KB
サイドバーでのテンプレート保存	1テンプレート	無制限
PostgreSQL / BigQuery との接続	いいえ	はい
企業向けオンプレミスライセンス	いいえ	利用可能（1回限りの支払いで $490）

---

🤖 運用マニュアル：タスクの分担

システムを自律的に動作させ、手作業の負担を最小限に抑えるため、Ranukita のエージェントチームと Emilio の間で役割を分担しています。

👤 Emilio のタスク（1回のみ — 約5分）：

1. OpenAI にパッケージをアップロード： OpenAI Developer Dashboard / Apps Management にアクセスして新しいアプリケーションを作成し、dist/rk-mcp-datacanvas.zip ファイルをアップロードします。
2. 提出用動画： スクリプト submission/video_script.md に沿って、75秒のウォークスルー動画を録画します。
3. パブリックドメイン： DNS トンネル datacanvas.ranuk.dev をローカルサーバー（例：ポート 7800 への Cloudflare Tunnel）に割り当てます。

🤖 Ranukita エージェントのタスク（24 時間 365 日自動）：

• 営業ディレクター： チェックアウトへのコンバージョン率を毎週確認し、台帳で収益目標を検証します。
• 営業担当者： レポートのダウンロード時に登録された法人メールアドレスを監視し、Enterprise ライセンス（$490〜$1,500）の提案を送信します。
• Dev-Bounties / NEXUS： MCP サーバーを稼働状態に保ち、データ形式に関する issue に対応し、回帰テストを実行します。
• 日次 cron（rk-mcp-growth.py）：
  • 毎日午前 10:00 に実行します。
  • サーバーの稼働状況を確認します。
  • Stripe の外部取引を ~/.ranukita/income_ledger.json に直接記録します。
  • 成長レポートを ~/.ranukita/buzon/ に出力します。

---

🚀 クイックスタートガイド

1. 検証テストを実行する

python3 -m unittest tests/test_mcp_server.py

2. MCP サーバーをローカルで起動する

python3 server/main.py
# El servidor iniciará en http://127.0.0.1:7800

3. Cloudflare トンネルで公開する（OpenAI でのテスト用）

cloudflared tunnel --url http://127.0.0.1:7800

4. 送信用パッケージを再生成する

python3 scripts/rk-mcp-pack.py

5. 成長 cron を手動で実行する

python3 scripts/rk-mcp-growth.py