Noco-Starter Free — để AI làm đúng trên NocoBase ngay từ đầu
Bộ khung đặt sẵn vào thư mục dự án để Claude Code (hoặc AI agent khác) đọc trước khi làm: luật đặt tên, kiểu dữ liệu đúng, cách đọc tiết kiệm token và 20 bẫy đắt giá nhất — đúc kết từ các dự án NocoBase thật của BAMFLOW.
AI dựng app NocoBase nhanh, nhưng hay sai ở những chỗ đắt nhất
Không có luật chơi, mỗi lần làm là một kiểu. Lỗi chỉ lộ ra khi đã có dữ liệu thật.
Đặt tên lung tung
Bảng tiếng Anh lẫn tiếng Việt, cột có dấu, khoá ngoại mỗi nơi một kiểu — càng về sau càng khó sửa.
Sai kiểu dữ liệu
Tiền lưu bằng double nên tổng cộng lệch vài đồng; ngày giờ lệch múi giờ.
Cháy token
AI đọc cả database, cả cây giao diện mỗi lần hỏi — chậm, tốn tiền, dễ quên ngữ cảnh.
Lỗi âm thầm
Sửa quyền xong lộ dữ liệu, workflow chết mà giao diện không báo, lưu "thành công" nhưng không ghi.
6 thành phần, đọc một lần là AI làm đúng
CLAUDE.md — bộ não
Thứ tự làm việc, nơi tra cứu, luật an toàn: không lộ token, không xoá khi chưa có filter, luôn đọc lại sau khi ghi.
Quy ước đặt tên & kiểu field
Tên bảng, tên cột, cặp type + interface đúng cho tiền, ngày, trạng thái, quan hệ…
Đọc NocoBase tiết kiệm token
Chỉ đọc đúng phần cần, đúng cách — nhanh hơn, rẻ hơn mà không sai.
TOP-20 bẫy đắt giá
Mất dữ liệu, lộ quyền, workflow chết âm thầm, lỗi tiếng Việt — mỗi bẫy có triệu chứng, nguyên nhân, cách sửa.
NocoBase local trong 5 phút
Docker Compose dựng sẵn + script smoke test kiểm tra đăng nhập, API, phiên bản.
Kết nối MCP
Mẫu .mcp.json để Claude Code thao tác trực tiếp với NocoBase qua API key, không lộ khoá.
Dùng được trong khoảng 10 phút
Hướng dẫn đầy đủ từng lệnh nằm trong README.md của bộ kit.
Cài công cụ
Node.js ≥ 22, Docker Desktop và Claude Code.
Giải nén kit
Đổi tên thư mục thành tên dự án của bạn.
Có NocoBase
Dùng server sẵn có, hoặc dựng bản local theo dev/README.md.
Nối API key
Tạo key role admin, điền vào settings.local.json và .mcp.json.
Ra lệnh cho AI
Mở Claude Code trong thư mục: "tạo bảng khách hàng và đơn hàng".
Bản free là điểm khởi đầu
Khi dự án lớn hơn — phân quyền nhiều cấp, workflow, giao diện — bản base và core có sẵn quy ước, template và script đã chạy thử.
| Nội dung | Free | Base | Core |
|---|---|---|---|
| CLAUDE.md + luật an toàn, kết nối MCP | ✓ | ✓ | ✓ |
| Quy ước đặt tên / field, tiết kiệm token | ✓ | ✓ | ✓ |
| NocoBase local bằng Docker + smoke test | ✓ | ✓ | ✓ |
| Bẫy đã vấp (tra bằng từ khoá) | 20 | 244 | 244 |
| Quy ước quan hệ, CLI / tiếng Việt, tương thích phiên bản | — | ✓ | ✓ |
| Quy ước workflow · phân quyền theo cấp · giao diện | — | — | ✓ |
| Template phỏng vấn nghiệp vụ, chuyển AppSheet → NocoBase | — | — | ✓ |
| Script dựng bảng, phân quyền, trang, workflow | — | — | ✓ |
Miễn phí thật, chỉ cần giữ ghi nguồn
Bạn được
- Dùng, sao chép, chỉnh sửa cho mọi dự án — kể cả dự án thu phí của bạn hoặc của khách hàng.
- Chia sẻ lại miễn phí (nguyên bản hoặc đã sửa), kèm ghi nguồn "Noco-Starter Free by BAMFLOW".
- Dùng mã trong
dev/theo giấy phép MIT.
Bạn không được
- Bán, cho thuê hay cấp phép lại bộ kit như một sản phẩm.
- Đưa bộ kit vào gói template, sản phẩm hay khoá học có thu phí.
- Xoá phần ghi nguồn.
Toàn văn trong file LICENSE của bộ kit. Bộ kit cung cấp "nguyên trạng", không kèm bảo đảm.
Đang dùng AppSheet và muốn chuyển sang NocoBase?
Phân tích app hiện có bằng AppSheet Analyzer miễn phí, học NocoBase 15 buổi trên bài toán thật, hoặc để BAMFLOW triển khai cùng bạn.