
DINHDANH Creator · Bài T02 · Thuật ngữ
appifio_clientvà bootstrap inject
Thư viện backend đã được hệ thống gắn sẵn vào trang - AI (và bạn) chỉ được gọi, không được viết lại class.
Mục tiêu: Hiểu vì sao luôn có appifio_client; dùng waitForAppStorage(); tránh check sai typeof === 'undefined'.
Trước: T01, F01 · Sau: T03 · Nhãn UI: tab Backend · Hỏi AI về backend · Easy / Advanced
1. Sơ đồ inject
window.appifio.global.apps (mã dự án / tên link DINHDANH, api_url, api_key, backend_version)window.appifio_client2. Thuật ngữ
| Thuật ngữ | Nghĩa | Nơi thấy |
|---|---|---|
| Bootstrap inject | Script hệ thống tự chèn vào mọi trang app | Không có nút - luôn chạy trên live/preview |
| appifio_client | Đối tượng gọi API Storage (DB + kho file + auth + route) | Console / code AI sinh |
| proxyClient | Hàng đợi khi client chưa load xong | Ẩn - lý do check typeof luôn “có” |
| waitForAppStorage() | Promise chờ client sẵn sàng | Global helper bootstrap |
| encoded_key / api_key | Token phiên trang (không phải admin token) | Tab Backend · “API key backend của bạn” |
3. Các bước kiểm chứng (không chuyên cũng làm được)
- Mở Creator → tab "Backend" - xác nhận có API key / Easy hoặc Advanced.
- Mở preview "Hiện tại" (sau khi đã Lưu) → F12 Console → gõ:
typeof appifio_client→ luôn ra"object"(getter), không phải undefined. - Gõ:
await waitForAppStorage()rồi thửawait appifio_client.appifio_listFiles()(hoặc method tương ứng) - nếu Advanced/Easy đúng quyền sẽ có kết quả. - Trong chat, chọn mode "Coder" hoặc nhấn "Hỏi AI về backend" (tab Backend) và yêu cầu: “Dùng appifio_client có sẵn, KHÔNG định nghĩa lại class AppStorageClient”.
- Nếu AI tự viết
class AppStorageClienthoặcfetch()thẳng endpoint → từ chối Diff (✗) và nhắc lại quy tắc tài liệu Aura Storage.
4. Đúng / Sai khi viết code
| ✅ Đúng | ❌ Sai |
|---|---|
await waitForAppStorage() rồi gọi method | typeof appifio_client === 'undefined' |
Gọi appifio_appendData / appifio_readList | Tự fetch API (bỏ auth, rate limit) |
Dùng mã dự án / tên link DINHDANH từ window.appifio.global.apps | Hardcode slug sai môi trường |
5. So sánh
- Firebase / Supabase client SDK: bạn tự import; DINHDANH inject sẵn.
- Bubble: data layer ẩn trong visual; DINHDANH lộ API JS có chủ đích cho AI/coder.
- WordPress REST: bạn tự auth; ở đây page session + admin token tách lớp.
6. Làm được / Không · Bảo mật
Làm được: CRUD JSON, kho file trên site, route, auth admin, upload (đúng role), backend function. Không: viết lại client; nhờ AI vô hiệu hóa giới hạn gửi; đọc mật khẩu dạng rõ.
Bảo mật: API key tab Backend scoped theo app - không dán công khai; phân biệt page api_key với admin token sau login.
7. Vấn đề thường gặp
| Tình huống | Xử lý |
|---|---|
| Code “chạy sớm” lỗi | await waitForAppStorage(); DOMContentLoaded đã được bootstrap xếp hàng |
| AI tạo client mới | Reject Diff; nhắc dùng appifio_client sẵn có (không viết lại thư viện) |
| Easy vs Advanced lệch hành vi | Xem tab Backend · bài T06 |
8. Lời khuyên · Checklist
- Prompt cố định: “Dùng appifio_client có sẵn, không rewrite method appifio_*”.
- Luôn try/catch + hiện thông báo thân thiện khi bị giới hạn gửi.
- Bạn biết vì sao
typeof appifio_client === 'undefined'luôn sai? - Bạn mở được tab Backend và thấy API key?
Tiếp: T03 - Flat JSON vs Indexed
Điều hướng nội bộ (cùng ngôn ngữ)