Form lien he cong khai tren site cho khach gui
Form khach

DINHDANH Creator · Bài K05 · Cấp độ: Kỹ thuật

Form guest an toàn
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:

Backend · Coder · Gửi · So sánh thay đổi Thay đổi · Lưu thay đổi · Liên hệ (CMS panel) appendData indexed · Thử lại sau

1. Sơ đồ luồng form guest

Guest submit HTML form (preview Thay đổi / live)
→ JS validate (required, email, honeypot ẩn)
→ appifio_appendData(file, payload) - mode indexed
→ Backend: giới hạn gửi + security enforce (CMS manifest)
→ OK: bản ghi mới trong contacts.json (hoặc data_file manifest)
→ Admin: readList sau login · panel CMS Liên hệ
Guest ❌ writeFile · updateData · deleteFile · executeBackendFunction
Gửi quá nhanh → hệ thống tạm chặn → thông báo user (chi tiết X06)

2. Bảng thuật ngữ

Thuật ngữNghĩaNơi UI
appendData indexedThêm bản ghi mới vào mảng JSON - server gán id/indexCode form + tab Backend
GuestKhá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ầnUI khi hệ thống tạm chặn vì gửi quá nhanh / chính sáchForm: “Thử lại sau”
BackendXem file JSON, policy, giới hạn gửiTab Backend Creator
Liên hệ (CMS)Panel đọc submissions từ data_fileCMS panel Liên hệ
executeBackendFunctionGọi hàm server tùy ý - guest bị cấmChỉ admin/backend có quyền

3. Các bước tuần tự (how-to kỹ thuật)

Xem contacts da luu trong CMS hoac Backend
Kho lien he
  1. 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.
  2. 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.”
  3. Bước 3 - Validate client: required fields, email format, maxlength; honeypot field ẩn (CSS display:none) - bot điền thì abort.
  4. 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.
  5. 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.
  6. Bước 6 - Test trên Thay đổi: submit 2-3 lần → tab Backend xem JSON · hoặc CMS Liên hệ.
  7. 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”).
  8. Bước 8 - Publish: Lưu thay đổi → test URL live guest (không login admin).
Mẫu xử lý khi bị giới hạn gửi (pseudo):
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ápLưu dataDINHDANH appendData
Google FormSheet GoogleData trong Aura Storage + CMS Liên hệ cùng site
Formspree / GetformEmail/SaaS bên thứ 3Không rời DINHDANH - manifest một nguồn
WP Contact Form 7DB WordPress + pluginGuest 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ànCMS security enforce / sai data_file manifest (T05, K06).
Form OK nhưng CMS Liên hệ trốngAppend 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

  1. Guest được phép API nào - bị cấm API nào?
  2. appendData indexed khác writeFile thế nào?
  3. Khi gửi quá nhiều lần - bạn hiển thị gì cho user?
  4. Làm sao biết append đúng file CMS Liên hệ?
  5. 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.

DINHDANH Creator · K05 · Form guest appendData