bkend-cookbook

bkend.ai クックブックとトラブルシューティング

単一プロジェクトガイド

プロジェクト	レベル	主な機能
Todo アプリ	初級	基本的な CRUD、状態管理
ノートアプリ	初級	リッチテキスト、カテゴリー
ブログ	中級	投稿、タグ、ファイルアップロード
チャットアプリ	中級	リアルタイムメッセージング
E コマース	中級	商品、注文、決済
予約システム	中級	予約、カレンダー
ソーシャルフィード	上級	投稿、フォロー、フィード
ダッシュボード	上級	チャート、分析、ロール
マルチテナント	上級	組織単位のデータ
SaaS スターター	上級	サブスクリプション、請求、オンボーディング

詳細ガイドのプロジェクト（4 件。それぞれクイックスタートと 7 章で構成）

プロジェクト	認証	主な CRUD	ファイル	高度な機能	AI
ブログ	メール／ソーシャル	記事、タグ	画像	ブックマーク	AI 要約
レシピアプリ	メール／ソーシャル	レシピ、材料	写真	食事プラン、買い物リスト	AI によるおすすめ
ショッピングモール	メール／ソーシャル	店舗、商品、注文	商品画像	レビュー	AI 検索
ソーシャルネットワーク	メール／ソーシャル	プロフィール、投稿	メディア	フォロー、フィード	AI によるおすすめ

共通の実装パターン

1. Auth setup (email + social login)
2. Core CRUD (main data tables)
3. File upload (images/media)
4. Advanced features (search, filters, relationships)
5. AI integration (recommendations, summaries)
6. Troubleshooting & optimization

トラブルシューティング早見表

エラー	原因	解決策
401 Unauthorized	トークンの期限切れ	POST /v1/auth/refresh
403 Forbidden	権限不足	RBAC の設定を確認してください
404 Not Found	パス／ID の誤り	エンドポイントと環境を確認してください
409 Conflict	一意フィールドの重複	重複データを確認してください
429 Rate Limit	リクエスト上限超過（100/h）	Retry-After ヘッダーを確認してください
CORS Error	ドメインが登録されていません	bkend コンソールで登録してください
MCP Connection Failed	OAuth が未完了です	ブラウザー認証を完了してください
Schema Validation	BSON 型の不一致	backend_table_get でスキーマを確認してください

よくある質問

質問	回答
テーブルが表示されない	環境（dev/staging/prod）を確認してください
MCP ツールが表示されない	claude mcp list を実行して接続を確認してください
ソーシャルログインが機能しない	コンソールの Provider 設定を確認してください
ファイルのアップロードに失敗する	サイズ上限（画像 10MB、動画 100MB）を確認してください
クエリが遅い	backend_index_manage でインデックスを追加してください
データが同期されない	x-environment ヘッダーが一致していることを確認してください

公式ドキュメント（最新情報）

最新のクックブックとトラブルシューティングについては、WebFetch を使用してください。

• クックブック：https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/cookbooks/blog/01-quick-start.md
• トラブルシューティング：https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/troubleshooting/01-common-errors.md
• 目次全体：https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/SUMMARY.md