File master va shard indexed JSON trong Backend
Sharding

DINHDANH Creator · Bài T04 · Thuật ngữ

Sharding & system files
- vùng cấm của AI và bạn

Aura tự chia dữ liệu lớn thành mảnh (shard). Một số file hệ thống bị deny - đụng vào sẽ lỗi hoặc phá auth.

Mục tiêu: Biết sharding là gì; liệt kê file không được đọc/ghi tay; biết policy khác “hướng dẫn AI” vs enforce backend.

Thời lượng: 11-13 phút · Trước: T03 · Sau: T05

UI: Backend · Clear all data · CMS Settings · tab Đường dẫn · So sánh thay đổi

1. Sơ đồ sharding

Bạn gọi appendData('blog-posts.json', item)
→ Aura cập nhật master index (metadata list)
→ khi dataset đủ lớn → tách payload vào .shards/blog-posts/…
→ bạn vẫn đọc qua readList('blog-posts.json')
KHÔNG readFile('.shards/...') · KHÔNG writeFile shard tay
System deny (enforce): login.json · __super_master_index__ · .shards/*

2. Thuật ngữ & file hệ thống

Thuật ngữ / fileNghĩaCách đúng
ShardingTự tách dataset lớn thành mảnh ổn địnhappendData / readList / updateData
login.jsonKho admin (mật khẩu đã mã hóa)login · registerAdmin · changePassword
routes.jsonMap URL → HTMLTab Đường dẫn · addRoute (T08)
__cms_manifest__.jsonSchema CMS - AI đọc, Panel ghiCMS UI · không rename tay lệch entity
manifest.storage.system_filesGhi chú cho AI trong manifestKhông đồng nghĩa mọi file bị chặn backend

3. Các bước “không đụng vùng cấm”

  1. Quản trị user: yêu cầu AI dùng appifio_login / registerAdmin - cấm “đọc login.json” (X11).
  2. Routes: tab "Đường dẫn" → "Thêm Route" → "Lưu" - hoặc addRoute/removeRoute API.
  3. Trong Diff: path .shards/ hoặc ghi __super_master_index__ → ✗ ngay.
  4. Backend: "Clear all data" chỉ khi hiểu rủi ro - UI yêu cầu gõ chuỗi xác nhận.
  5. Prompt cố định: “Không truy cập .shards, login.json, __super_master_index__. Auth chỉ qua API.”

4. So sánh · Làm được/Không

  • MongoDB sharding / DynamoDB partitions: cùng ý tách tải; Aura giấu chi tiết.
  • WordPress wp-config + wp_users: tương tự “đừng sửa tay lung tung” như login.json.

Làm được: CRUD qua API công khai đúng role. Không: sửa shard tay; không xem được mật khẩu gốc; hard delete lung tung nếu chỉ role user.

Bảo mật: Mật khẩu được mã hóa phía hệ thống; sau khi đăng nhập CMS, phiên quản trị được giữ trong trình duyệt theo đường dẫn dự án của bạn - không commit vào Git/HTML.

5. Sự cố · Lời khuyên

Sự cốXử lý
API deny khi đụng system fileĐúng - đổi sang API auth/route chính thức
AI “sửa routes.json bằng writeFile”Reject; tab Đường dẫn hoặc addRoute
Thấy thư mục .shards trong Thư mụcChỉ quan sát - không edit; dùng readList
Clear all data xóa nhầmClone/Export trước; không dùng trên production live

Prompt cố định trong mọi dự án Advanced: “Không truy cập .shards, login.json, __super_master_index__. Auth chỉ qua API.”

6. Ví dụ từ chối trong Diff

  • writeFile('login.json', { users: [...] }) → ✗ - dùng registerAdmin.
  • readFile('.shards/blog-posts/shard_001.json') → ✗ - dùng readList('blog-posts.json').
  • writeFile('routes.json', entireObject) → ✗ - tab Đường dẫn + Lưu hoặc addRoute.
  • Response API deny: system file → đúng enforce; đổi sang API công khai.

7. Checklist

  1. Bạn hiểu readList che giấu .shards?
  2. Bạn không cho AI đọc login.json?
  3. Bạn sửa route qua tab Đường dẫn + Lưu?

Tiếp: T05 - CMS manifest & UI contract