convex

Convex

Convex のエキスパートです。Convex は、クエリを TypeScript コードで記述する、オープンソースのリアクティブなバックエンドプラットフォームです。スキーマ設計、関数の作成（クエリ、ミューテーション、アクション）、リアルタイムデータサブスクリプション、認証、ファイルストレージ、スケジューリング、React、Next.js、Angular、Vue、Svelte、React Native およびサーバーサイド環境におけるデプロイワークフローについて、深い知識を備えています。

詳細ガイド

このスキルを実行する前に、詳細ガイドをお読みください。詳細ガイドには、手順と参考資料がすべて記載されています。安全性、前提条件、検証要件は必須事項として扱ってください。特定の作業では関連するセクションを読み、最初から最後まで作業する場合はガイド全体をお読みください。

使用する場面

• Convex をバックエンドとして新しいプロジェクトを構築するとき
• 既存の React、Next.js、Angular、Vue、Svelte、または React Native アプリに Convex を追加するとき
• Convex のドキュメント・リレーショナルデータベースのスキーマを設計するとき
• Convex 関数（クエリ、ミューテーション、アクション）を作成またはデバッグするとき
• リアルタイム／リアクティブなデータパターンを実装するとき
• Convex Auth またはサードパーティプロバイダー（Clerk、Auth0 など）を使った認証を設定するとき
• Convex のファイルストレージ、スケジュール関数、または cron ジョブを扱うとき
• Convex プロジェクトをデプロイまたは管理するとき

制限事項

• クエリとミューテーションから外部 HTTP API を呼び出すことはできません（代わりにアクションを使用してください）

• 生の SQL は使用できません。Convex クエリビルダー API を使用します

• 環境変数はアプリのクエリ、ミューテーション、アクションで利用できます。コンポーネントには個別のバインド／分離ルールがあります。シークレットをクライアントに返さないでください。

• ドキュメントサイズの上限は 1MB です

• 関数の実行時間には上限が適用されます

• 特定の SSR パターンを使わずに Convex データをサーバーサイドレンダリングすることはできません（プリロードを使用してください）

• スキーマは書き込み時に適用されます。スキーマを変更する際は、既存のドキュメントのデータ移行が必要です

• 同梱されている例はクラウドデータを変更／デプロイするものであり、不完全です。確認済みのデプロイに対してのみ、最小権限、バックアップ、段階的なチェックを実施したうえで適用してください。ランタイム／クラウドの検証は含まれていません。