MINARAデータスタジオ
自然言語からライブ金融ダッシュボードを構築、レビュー、プレビュー、公開
🟢 初級者向け。 データスタジオ（Data Studio）は読み取り専用ダッシュボードを構築します。取引、送金、ウォレット接続、秘密鍵の入力は行いません。
データスタジオは、自然言語の要望をリアルタイムまたは読み込み時更新の金融データを使う React ダッシュボードへ変換します。プロジェクトには計画、ソースコード、検証済みビルドが含まれます。公開を選ぶと、共有できるローカルサイトも作成されます。
市場モニター、ウォッチリスト、ランキング、決算表、ポートフォリオ、ヒートマップ、K 線、リスク画面、イールドカーブ、板の深度など、再利用できるインタラクティブなページに適しています。
現在のワークフロー
- データスタジオを開き、作りたいダッシュボードを説明します。参考画像も添付できます。
- 入力欄で 計画 または 自動 を選びます。
- Agent がプロジェクト計画を作成し、データとコンポーネントの契約を解決してソースを書き、決定的なビルドとプレビュー検査を実行します。
- プレビュー、Code、計画、データと統計、設定で結果を確認します。同じプロジェクトをチャットで続けて修正できます。
- プレビューが完成したら、固定されたバージョンをカスタマイズ可能なローカルリンクへ公開できます。
チャットの作業ログとツール表示はメインの Chat モジュールと共通です。成功したターンでは、Agent の出力末尾にダッシュボードの成果物カードが表示されます。カードからプレビューを開き、プロジェクトルートへ移動できます。
計画モードと自動モード
計画は実装前に完全な提案を作成します。計画が保存されると、データスタジオはすぐに 計画 タブを開きます。実行を承認する前に内容と成果物を確認し、修正を依頼できます。承認すると新しい Agent turn が始まり、通常のデータスタジオツールが利用可能になります。
自動は実装をすぐに開始します。Agent はプロジェクトに plan.md を保存し、同じデータ、コンポーネント、ビルド、プレビュー検査を実行します。後続の依頼ではいつでもモードを切り替えられます。計画モードは固定の既定値ではありません。
プロジェクトファイルとバージョン
各プロジェクトは Minara の安定した workspace に保存され、一時的な Git worktree やランタイムディレクトリには依存しません。次の内容が保持されます。
- 現在の
plan.md src/配下の生成ソース- 変更されない成功ビルドの各バージョンと最新プレビュー成果物
セッションにアップロードしたファイルは独立した永続リカバリーストアにも保存されるため、プロセス再起動後も画像とファイルの参照を利用できます。
Code → プロジェクトルートからプロジェクトディレクトリを開けます。コンポーネント契約、コンパイル、必要なランタイム検査がすべて通ったビルドだけが正式なバージョンになります。失敗した修正が最後の正常なプレビューを上書きすることはありません。
プロジェクトを再び開くと、最初に プレビュー が表示されます。再起動後にソースは存在するもののプレビュー成果物がない場合、通常のプレビュー読み込み状態で自動ビルドを一度試します。失敗した場合は空状態に 復元 ボタンが表示されます。計画だけが存在してビルドがない場合、空状態から 計画 タブへ移動できます。
データアクセスと更新ルール
生成コードはデータスタジオ SDK から許可済みデータだけを取得します。Provider の認証情報はローカル gateway または publisher に保持され、生成ソースには入りません。
データスタジオは必要な動作に合わせてデータ経路を選びます。
- リアルタイムデータを求められた場合、必要な全フィールドを提供できる登録済みの公開、Key 不要 WebSocketを優先します。
- Key 不要 Public API は一度だけ読み込むことも、データソースが許可する間隔でポーリングすることもできます。
- 自分で設定した Key を使う API は、一度だけの読み込みとポーリングの両方に対応します。
- 対応する Key 付き Provider にローカル Key がない場合、Minara データ転送で一度だけ読み込めます。設定には Minara データ転送を使用中 と表示されます。
- Minara データ転送はポーリングできません。ポーリングが必要な場合は Public API または自分の Key を使います。
HTTP データは既定でページ読み込み時に一度だけ取得します。更新頻度が高いダッシュボードでは、間隔と使用量の案内が表示されます。更新中も有効な既存データを残し、変化したグラフと値だけを更新します。グラフ全体の再マウントや全画面 loading の繰り返しは行いません。
データと統計では呼び出し回数、エラー、レイテンシを確認できます。設定では各データソースが公開データ、ローカル Key、Minara 転送、利用不可のどれに該当するか確認できます。API Key は 設定 → API Keys で一元管理します。
金融 UI とチャートのルール
生成ダッシュボードは固定された @minara/studio primitives と共通チャートテーマを使用します。コードを書く前に、Agent は現在のコンポーネント Schema と Types を読みます。生成後の自動契約レビューは、未知の Prop、必須フィールドの不足、不正な import、非対応の JSX spread をブロックします。
コンポーネントは一般的な金融上の問いに対応します。
MetricCard、SignedValue、SparklineChartは単一値と小さなトレンドに使用します。LineChart、AreaChart、KLineChart、MixedLineBarChart、PerformanceChartは時系列、価格と出来高、パフォーマンス、ドローダウンに使用します。HorizontalBarChart、DataTable、AssetHeatmapChart、MatrixHeatmapChart、HistogramChartはランキング、明細、市場マップ、相関、分布に使用します。OrderBookDepthChart、VolumeProfileChart、YieldCurveChart、RangeBandChart、VolatilitySurfaceChartは専門的な金融ビューに使用します。
PnL、change、return など方向を持つ値は、符号と金融上の上昇・下落色を併用します。値の更新には短い色の遷移を使い、カード全体を点滅させません。通貨などの測定値には必ず単位を表示し、ヒートマップ内の金額にも通貨記号を付けます。色だけに情報を依存させません。
共通テーマが軸、グリッド、Tooltip、Legend、タイポグラフィ、間隔、上昇・下落色、アニメーションを管理します。生成プロジェクトは個別のチャート option を書き換えず、グローバル CSS の公開 --studio-chart-* 変数を上書きできます。完成したダッシュボードはデスクトップと 390 px モバイルで検査され、loading、空データ、部分的失敗、更新状態も確認されます。
公開と共有
公開フォームはプロジェクトから短いサイト ID を生成します。公開前に変更できます。リンクを知っている人はサインインなしでサイトを開けます。
次の 2 つの設定は既定で有効で、公開後も変更できます。
- ローカルネットワークからのアクセスを許可を有効にすると、publisher が LAN にバインドされ、このコンピューターの LAN IP アドレスと publisher ポートを使うリンクが表示されます。
- Minara を閉じた後も利用可能にするを有効にすると、ローカル publisher が動作を続け、コンピューターへのサインイン時に公開済みサイトを復元します。
LAN アクセスを無効にするとリンクはこのコンピューターだけで利用できます。バックグラウンド公開を無効にすると、サイトは起動中の Minara クライアントに依存します。公開を解除すると、そのプロジェクトの全リンクが無効になり、サイトの配信が停止します。
公開サイトはローカルまたは LAN 上でホストされます。LAN アクセスを有効にしても公開インターネットには露出しません。ホストコンピューターは電源が入り、到達可能な状態である必要があります。
安全境界
データスタジオは許可済みの読み取り専用データを取得し、自分のプロジェクトディレクトリ内にだけファイルを書きます。次の操作はできません。
- ウォレット、取引、swap、withdraw、order ツールの呼び出し
- MetaMask、WalletConnect、その他のブラウザウォレットへの接続
- API Key やその他の secret の生成ファイルへの埋め込み
- プレビューから任意の外部 URL へのリクエスト
- 公開ダッシュボードへの取引または資金移動コントロールの追加
取引を実行する場合は Chat、Portfolio、Trading、Strategy Studio、Autopilot を使用してください。それぞれのモジュールが専用のプレビューと確認ゲートを適用します。