- 1. Sơ đồ luồng form guest
- 2. Bảng thuật ngữ
- 3. Các bước tuần tự (how-to kỹ thuật)
- 4. Giải thích tính năng liên quan
- appendData indexed vs tự ghi file
- Tab Backend - kiểm policy
- CMS panel Liên hệ
- 5. So sánh 3 giải pháp form
- 6. Làm được / không làm được
- 7. Bảo mật form guest
- 8. Bảng sự cố
- 9. Lời khuyên
- 10. Checklist & bài tiếp theo

DINHDANH Creator · Bài K05 · Cấp độ: Kỹ thuật
với appendData
Khách gửi liên hệ/đơn không có phiên đăng nhập quản trị - chỉ append khi policy cho phép; xử lý thông báo gửi quá nhiều lần và cấm thao tác nguy hiểm.
Mục tiêu bài học: Thiết kế form public chỉ dùng appendData indexed; validate client + server; xử lý UI khi bị giới hạn gửi; guest không được writeFile/updateData/delete/executeBackendFunction.
Thời lượng đọc: khoảng 20 phút.
Điều kiện trước: F02 (form cơ bản), T03 (Storage), T07 (Backend), K01 (prompt Coder).
Bài trước: K04 - Inspector + AI.
Bài tiếp theo: K06 - Đồng bộ frontend ↔ CMS (giới hạn gửi chi tiết → X06).
Nhãn UI chính:
1. Sơ đồ luồng form guest
appifio_appendData(file, payload) - mode indexed2. Bảng thuật ngữ
| Thuật ngữ | Nghĩa | Nơi UI |
|---|---|---|
| appendData indexed | Thêm bản ghi mới vào mảng JSON - server gán id/index | Code form + tab Backend |
| Guest | Khách chưa đăng nhập admin - quyền hạn chế | URL public / preview |
| Thông báo gửi quá nhiều lần | UI khi hệ thống tạm chặn vì gửi quá nhanh / chính sách | Form: “Thử lại sau” |
| Backend | Xem file JSON, policy, giới hạn gửi | Tab Backend Creator |
| Liên hệ (CMS) | Panel đọc submissions từ data_file | CMS panel Liên hệ |
| executeBackendFunction | Gọi hàm server tùy ý - guest bị cấm | Chỉ admin/backend có quyền |
3. Các bước tuần tự (how-to kỹ thuật)

- Bước 1 - Xác định data_file: đọc
__cms_manifest__- entity Liên hệ trỏ file nào (ví dụcontacts.json). Không tự đặt tên file song song. - Bước 2 - Prompt Coder: mode Coder, brief: “Form public chỉ
appifio_appendData('contacts.json', payload)indexed; try/catch hiện thông báo thân thiện khi bị giới hạn gửi; không writeFile/updateData/delete/executeBackendFunction; không tự set id.” - Bước 3 - Validate client: required fields, email format, maxlength; honeypot field ẩn (CSS display:none) - bot điền thì abort.
- Bước 4 - Payload an toàn: chỉ gửi field cần (name, email, message, timestamp ISO); không gửi role/admin flag từ client.
- Bước 5 - Diff review: mở So sánh thay đổi: - không có writeFile list, không lộ admin API, không hardcode secret.
- Bước 6 - Test trên Thay đổi: submit 2-3 lần → tab Backend xem JSON · hoặc CMS Liên hệ.
- Bước 7 - Test giới hạn gửi: submit nhanh liên tiếp → bắt lỗi → hiện thông báo thân thiện (“Thử lại sau vài phút”).
- Bước 8 - Publish: Lưu thay đổi → test URL live guest (không login admin).
try { await appifio_appendData('contacts.json', data); showSuccess(); } catch (e) { showFriendlyRateLimitMessage(); /* “Thử lại sau” */ }4. Giải thích tính năng liên quan
appendData indexed vs tự ghi file
Indexed: server thêm phần tử cuối mảng, gán id - guest không ghi đè bản ghi cũ. writeFile thay cả file = quyền admin - guest bị từ chối.
Tab Backend - kiểm policy
Advanced Backend hiển thị file thật, giới hạn gửi, security enforce từ CMS. Nếu append bị chặn dù code đúng → kiểm manifest/security (T05), không sửa bằng cách gọi executeBackendFunction.
CMS panel Liên hệ
Admin đọc cùng data_file manifest - không duplicate DB. Form guest append → CMS Liên hệ thấy ngay sau refresh (cùng nguồn K06).
5. So sánh 3 giải pháp form
| Giải pháp | Lưu data | DINHDANH appendData |
|---|---|---|
| Google Form | Sheet Google | Data trong Aura Storage + CMS Liên hệ cùng site |
| Formspree / Getform | Email/SaaS bên thứ 3 | Không rời DINHDANH - manifest một nguồn |
| WP Contact Form 7 | DB WordPress + plugin | Guest policy sẵn - không cần plugin riêng |
6. Làm được / không làm được
Làm được
- Form liên hệ/đăng ký guest chỉ append.
- Hiện thông báo khi gửi quá nhiều lần.
- Admin đọc qua Backend hoặc CMS Liên hệ.
Không làm được (guest)
- writeFile / updateData / deleteFile.
- executeBackendFunction (email SMTP, payment…).
- Không nhờ AI vô hiệu hóa giới hạn gửi - thông báo “Thử lại sau” là hành vi đúng.
7. Bảo mật form guest
- Không tin validation client - server enforce qua policy + giới hạn gửi.
- Honeypot + UI thông báo khi bị giới hạn gửi giảm spam - không thay CAPTCHA enterprise nhưng đủ landing thường.
- Không embed phiên đăng nhập quản trị trong JS form - mọi guest dùng chung quyền hạn chế.
- Review Diff: AI hay thêm executeBackendFunction “tiện” - từ chối ✗ nếu form public.
8. Bảng sự cố
| Sự cố | Xử lý |
|---|---|
| Thông báo gửi quá nhiều lần sau vài submit | Đúng giới hạn gửi - UI thông báo; chi tiết X06; đợi rồi thử lại. |
| Append bị chặn hoàn toàn | CMS security enforce / sai data_file manifest (T05, K06). |
| Form OK nhưng CMS Liên hệ trống | Append nhầm file - đối chiếu __cms_manifest__ data_file. |
| Guest gọi writeFile trong Diff | ✗ reject; prompt lại chỉ appendData indexed. |
9. Lời khuyên
- Luôn nhắc AI “indexed, không set id” trong mọi prompt form.
- Test UI khi bị giới hạn gửi trên preview trước live - UX lúc bị chặn quan trọng không kém success.
- Bám manifest contacts - tránh contacts.json và contact.json song song.
- Email notification cần executeBackendFunction → làm route admin, không nhét vào form guest.
10. Checklist & bài tiếp theo
- Guest được phép API nào - bị cấm API nào?
- appendData indexed khác writeFile thế nào?
- Khi gửi quá nhiều lần - bạn hiển thị gì cho user?
- Làm sao biết append đúng file CMS Liên hệ?
- 4 bước test trước Lưu thay đổi?
Bài tiếp theo
K06 - Đồng bộ frontend với Aura CMS
Một nguồn sự thật qua __cms_manifest__ - HTML Creator và panel CMS không lệch data.
Điều hướng nội bộ (cùng ngôn ngữ)
DINHDANH Creator · K05 · Form guest appendData