ahnyongjooandClaude Sonnet 5.5
964a841de1
- Code\rebar_pipeline, review_pipeline, pier-program을 정션에서 실제 폴더로 전환 - Code\rhino_mcp 및 CLAUDE_rhino배경.md 추가, .mcp.json은 PYTHONPATH로 새 위치 사용 - pier-program 내부 .git 제거(이력은 backup\pier-program_20261028.bundle에 보관) - worktree 가이드 반영(CLAUDE.local.md, HANDOFF.md) - D:\Rhino-MCP 경로 참조를 새 위치로 치환 Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
90 lines
3.6 KiB
Markdown
90 lines
3.6 KiB
Markdown
---
|
|
name: bkend-cookbook
|
|
classification: capability
|
|
classification-reason: Pattern guidance may overlap with model's built-in knowledge as it improves
|
|
deprecation-risk: medium
|
|
description: |
|
|
bkend.ai project tutorials (todo to SaaS) and common error troubleshooting.
|
|
Triggers: bkend tutorial, cookbook, troubleshooting, 튜토리얼, 에러 해결.
|
|
user-invocable: false
|
|
agent: hmcmkit:bkend-expert
|
|
allowed-tools:
|
|
- Read
|
|
- Write
|
|
- Edit
|
|
- Glob
|
|
- Grep
|
|
- Bash
|
|
- mcp__bkend__*
|
|
imports:
|
|
- ${PLUGIN_ROOT}/templates/shared/bkend-patterns.md
|
|
---
|
|
|
|
# bkend.ai Cookbook & Troubleshooting
|
|
|
|
## 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 |
|
|
|
|
## Full Guide Projects (4, each with quick-start + 7 chapters)
|
|
|
|
| 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 |
|
|
|
|
## 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 & optimization
|
|
```
|
|
|
|
## 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 |
|
|
|
|
## FAQ
|
|
|
|
| Question | Answer |
|
|
|----------|--------|
|
|
| Table not visible | Check environment (dev/staging/prod) |
|
|
| MCP tools not showing | Run `ai-agent mcp list` to verify connection |
|
|
| 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 |
|
|
|
|
## Official Documentation (Live Reference)
|
|
|
|
For the latest cookbook and troubleshooting, use WebFetch:
|
|
- Cookbooks: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/cookbooks/blog/01-quick-start.md
|
|
- Troubleshooting: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/troubleshooting/01-common-errors.md
|
|
- Full TOC: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/SUMMARY.md
|