bkend-cookbook
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
Chinesebkend.ai Cookbook & Troubleshooting
bkend.ai 食谱指南与故障排除
Single Project Guides
单项目指南
| Project | Level | Key Features |
|---|---|---|
| Todo App | Beginner | Basic CRUD, state management |
| Note App | Beginner | Rich text, categories |
| Blog | Intermediate | Posts, tags, file upload |
| Chat App | Intermediate | Real-time messaging |
| E-commerce | Intermediate | Products, orders, payments |
| Booking System | Intermediate | Reservations, calendar |
| Social Feed | Advanced | Posts, follows, feeds |
| Dashboard | Advanced | Charts, analytics, roles |
| Multi-tenant | Advanced | Organization-scoped data |
| SaaS Starter | Advanced | Subscriptions, billing, onboarding |
| 项目 | 难度等级 | 核心功能 |
|---|---|---|
| 待办应用 | 入门级 | 基础CRUD、状态管理 |
| 笔记应用 | 入门级 | 富文本、分类管理 |
| 博客 | 进阶级 | 文章、标签、文件上传 |
| 聊天应用 | 进阶级 | 实时消息 |
| 电商应用 | 进阶级 | 商品、订单、支付 |
| 预订系统 | 进阶级 | 预约、日历 |
| 社交信息流 | 高级 | 帖子、关注、信息流 |
| 数据仪表盘 | 高级 | 图表、数据分析、角色权限 |
| 多租户系统 | 高级 | 组织范围数据隔离 |
| SaaS启动模板 | 高级 | 订阅、计费、用户引导 |
Full Guide Projects (4, each with quick-start + 7 chapters)
完整项目指南（共4个，每个包含快速启动+7个章节）
| Project | Auth | Core CRUD | Files | Advanced | AI |
|---|---|---|---|---|---|
| Blog | Email/Social | Articles, Tags | Images | Bookmarks | AI summary |
| Recipe App | Email/Social | Recipes, Ingredients | Photos | Meal Plan, Shopping List | AI recommendations |
| Shopping Mall | Email/Social | Stores, Products, Orders | Product images | Reviews | AI search |
| Social Network | Email/Social | Profiles, Posts | Media | Follows, Feeds | AI recommendations |
| 项目 | 认证方式 | 核心CRUD操作 | 文件管理 | 高级功能 | AI集成 |
|---|---|---|---|---|---|
| 博客 | 邮箱/社交登录 | 文章、标签 | 图片 | 书签 | AI摘要 |
| 食谱应用 | 邮箱/社交登录 | 食谱、食材 | 照片 | 膳食计划、购物清单 | AI推荐 |
| 商城 | 邮箱/社交登录 | 店铺、商品、订单 | 商品图片 | 评价 | AI搜索 |
| 社交网络 | 邮箱/社交登录 | 个人资料、帖子 | 媒体文件 | 关注、信息流 | AI推荐 |
Common Implementation Pattern
通用实现流程
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 & optimization1. 认证设置（邮箱+社交登录）
2. 核心CRUD操作（主数据表）
3. 文件上传（图片/媒体）
4. 高级功能（搜索、筛选、关联关系）
5. AI集成（推荐、摘要）
6. 故障排除与优化Troubleshooting Quick Reference
故障速查指南
| Error | Cause | Solution |
|---|---|---|
| 401 Unauthorized | Token expired | POST /v1/auth/refresh |
| 403 Forbidden | Insufficient permissions | Check RBAC settings |
| 404 Not Found | Wrong path/ID | Verify endpoint and environment |
| 409 Conflict | Unique field duplicate | Check duplicate data |
| 429 Rate Limit | Request limit exceeded (100/h) | Check Retry-After header |
| CORS Error | Domain not registered | Register in bkend console |
| MCP Connection Failed | OAuth incomplete | Complete browser auth |
| Schema Validation | BSON type mismatch | Check schema with backend_table_get |
| 错误类型 | 原因 | 解决方案 |
|---|---|---|
| 401 未授权 | 令牌过期 | 调用POST /v1/auth/refresh接口 |
| 403 禁止访问 | 权限不足 | 检查RBAC设置 |
| 404 未找到 | 路径/ID错误 | 验证端点与环境 |
| 409 冲突 | 唯一字段重复 | 检查重复数据 |
| 429 请求受限 | 请求超出限制（100次/小时） | 查看Retry-After响应头 |
| CORS错误 | 域名未注册 | 在bkend控制台注册域名 |
| MCP连接失败 | OAuth未完成 | 完成浏览器端认证 |
| Schema验证失败 | BSON类型不匹配 | 使用backend_table_get检查Schema |
FAQ
常见问题解答（FAQ）
| Question | Answer |
|---|---|
| Table not visible | Check environment (dev/staging/prod) |
| MCP tools not showing | Run |
| Social login not working | Check Provider settings in console |
| File upload fails | Verify size limits (image 10MB, video 100MB) |
| Slow queries | Add indexes via backend_index_manage |
| Data not syncing | Check x-environment header matches |
| 问题 | 解答 |
|---|---|
| 表格不可见 | 检查环境（开发/预发布/生产） |
| MCP工具未显示 | 运行 |
| 社交登录无法使用 | 检查控制台中的服务商设置 |
| 文件上传失败 | 验证大小限制（图片10MB，视频100MB） |
| 查询缓慢 | 通过backend_index_manage添加索引 |
| 数据未同步 | 检查x-environment请求头是否匹配 |
Official Documentation (Live Reference)
官方文档（实时参考）
For the latest cookbook and troubleshooting, use WebFetch: