🏛 Trung tâm Kiến trúc
Nơi Kiến trúc sư trưởng ghi lại quyết định, lý do, tác động, giải pháp thay thế, ý tưởng, nợ kỹ thuật, rủi ro và kiến nghị — một nguồn thống nhất cho ChatGPT · Claude Code · Chủ dự án.
📜 Nguyên tắc kiến trúc (bất biến)
Mọi kết luận (AI, suy luận) kèm nguồn, lý do, độ tin cậy.
Đối tượng + Liên kết là lõi; mọi góc nhìn đều đọc từ đó.
Toàn bộ tiếng Việt, luôn có lối ra, không ngõ cụt.
AI đọc qua Intelligence Engine, tách khỏi tầng dữ liệu.
Phân quyền an toàn theo mặc định; mọi ghi qua capQuyen().
⚖️ Quyết định kiến trúc (ADR)
Xem đầy đủ →Thiết kế AI Platform theo mô hình BYOK + Hội đồng AI + AI Gateway
Chấp nhậnLý do: KHÔNG dùng tài khoản AI chung của chủ hệ thống vì với 1 triệu website, chi phí và hạn mức sẽ dồn về chủ hệ thống, dễ bị khóa tài khoản và không cô lập được dữ liệu từng khách. CHỌN BYOK vì chi phí phân tán về từng khách (họ dùng tài khoản miễn phí/trả phí của họ), thêm website chỉ là thêm cấu hình. Hội đồng AI là nhiều VAI TRÒ dùng chung một model để không bùng nổ số model/tài khoản mà vẫn có 'đội ngũ AI' cho doanh nghiệp. AI Platform hiện CHỈ LÀ THIẾT KẾ (chưa triển khai) để khóa kiến trúc trước, tránh làm lại; do đó CHƯA gọi API AI, CHƯA lưu API key thật, CHƯA tích hợp Website SaaS thật — giảm rủi ro bảo mật/chi phí khi chưa chốt.
Tác động: Mở rộng tới 1.000.000 website nhờ: BYOK phân tán chi phí, Năng lực tách khỏi Provider, Gateway đứng giữa (đổi provider không ảnh hưởng website), nhiều vai trò dùng chung một model, Workspace cô lập nhân bản ngang, Gói & Chợ AI cài nhanh theo ngành. TRẠNG THÁI: Đã duyệt thiết kế · Chưa triển khai kỹ thuật · Chưa tích hợp Website SaaS · Chưa gọi API AI thật. Liên kết: /ai-platform · /ai-platform/hoi-dong · /ai-platform/lo-trinh · /trung-tam-kien-truc · /goc-nhin-kien-truc · /nghiem-thu-sprint. Tài liệu: tai-lieu-thiet-ke/22-ai-platform.md.
Giải pháp thay thế: PA1: Tài khoản AI chung của chủ hệ thống cho mọi website (bị loại — chi phí bùng nổ, rủi ro hạn mức/khóa tài khoản, khó cô lập dữ liệu). PA2 (CHỌN): BYOK — mỗi website dùng tài khoản AI của chính khách, qua AI Gateway trung gian, tổ chức theo Hội đồng AI (nhiều vai trò dùng chung một model). PA3: Chỉ 1 nhà cung cấp AI cố định (bị loại — phụ thuộc một provider, không tối ưu chi phí/năng lực).
ADR: Mô hình hóa doanh nghiệp bằng Enum + Meta + LienKet
Chấp nhậnLý do: Không thêm bảng nền; tái dùng Reasoning/Execution/Timeline/Impact ngay.
Tác động: Truy vấn theo loai; metadata trong meta JSON.
Giải pháp thay thế: Tạo bảng riêng / Dùng Enum+Meta+LienKet
ADR: Feature Flag & Capability lưu ở file cấu hình/catalog
Chấp nhậnLý do: Không thêm bảng nền; đổi cấu hình không sửa engine.
Tác động: Khi chạy đa tiến trình nên chuyển sang lưu DB.
Chọn PostgreSQL làm cơ sở dữ liệu
Chấp nhậnLý do: Chịu tải lớn.
Chuyển sang SQLite cho gọn nhẹ
Chấp nhậnLý do: Triển khai đơn giản.
Đóng băng kiến trúc (Architecture Freeze)
Chấp nhậnLý do: Ổn định nền tảng để tập trung chức năng & trải nghiệm, nhưng vẫn cho phép thay đổi nếu là thiếu sót ảnh hưởng toàn hệ thống.
Tác động: Mọi đề xuất đổi kiến trúc phải ghi ADR + phân tích tác động trước khi triển khai. Không thêm bảng nền cho 1 chức năng riêng lẻ.
Giải pháp thay thế: Tiếp tục mở rộng kiến trúc tự do / Đóng băng có điều kiện / Đóng băng cứng
🧱 Nợ kỹ thuật
Trang & engine chưa có kiểm thử tự động. → Rủi ro hồi quy khi thêm tính năng.
Token phía server chưa có danh sách thu hồi. → Không đăng xuất từ xa được.
Xuất backup có, nhập lại chưa kiểm thử end-to-end. → Chưa chắc khôi phục toàn vẹn.
Cấu hình, cờ tính năng, luật còn ở file. → Khó quản trị nhiều môi trường.
Ollama/Claude/OpenAI mới cắm dạng dự phòng. → Chưa dùng LLM mạnh mặc định.
⚠️ Rủi ro
duanweb.click = dev server cổng 5000 qua Cloudflare Tunnel.
🛡️ Giảm thiểu: Autostart khi đăng nhập Windows; kế hoạch build production về sau.
Thêm tính năng có thể vỡ trang khác mà không phát hiện.
🛡️ Giảm thiểu: Ưu tiên thêm smoke test cho các trang trung tâm ở sprint sau.
Cập nhật thủ công qua file cấu hình.
🛡️ Giảm thiểu: Chuyển vào DB khi cần nhiều người biên tập đồng thời.
✅ Việc cần làm · đang chờ · đã hoàn thành
- •Bản kê Nền tảng (Foundation Manifest) /nen-tang — tự tổng hợp Foundation/Architecture/Freeze Version, Sprint hoàn thành, Review Score, Build Status, ADR/Object/Relation/Domain/Module/Capability Count, Health Score từ dữ liệu hiện có.
- •Dòng thời gian kiến trúc /nen-tang/dong-thoi-gian — Sprint → ADR → Tính năng → Review → Foundation, sinh từ SPRINTS + TIEN_HOA, gom theo năm.
- •Cổng chất lượng /nen-tang/cong-chat-luong — PASS/WARNING/FAIL cho Architecture/Knowledge/Route/UI/UX/Health/Documentation/Build từ điểm review.
- •Project DNA /nen-tang/dna — Vision/Mission/Core Principles/Architecture/Naming/Review/Freeze Rules/Design Language (documentation).
- •Tăng trưởng tri thức /nen-tang/tang-truong — Sprint & ADR tích lũy (thật) + đánh dấu rõ Objects/Domains/Relations 'sẽ đầy đủ khi có thêm sprint' (không dữ liệu giả).
- •Độ phủ kiến trúc /nen-tang/do-phu — % 7 vùng (Foundation/Knowledge/Enterprise/Platform/Intelligence/AI/Execution) từ Capability Registry.
- •Bảng sẵn sàng /nen-tang/san-sang — Developer/Designer/Product/PM/Investor/Customer/AI tính từ điểm sức khỏe review.
- •Tự mô tả cho AI /nen-tang/tu-mo-ta — là gì/kiến trúc/engine/capability/review/limitation/freeze/roadmap để AI đọc nhanh.
- •Chứng nhận Nền tảng /nen-tang/chung-nhan — 'PROJECT OS FOUNDATION COMPLETE' (Version/Lock Date/Architecture/Review Score/Freeze/Sprint).
- •Đồng bộ Review: thêm khối Foundation vào loi/review.ts, /review, /api/review-manifest (dùng chung nguồn, không trùng dữ liệu).
- •Lịch sử snapshot Objects/Domains/Relations theo thời gian (đợi thêm sprint để có chuỗi dữ liệu thật).
- •Test tự động/CI (thuộc GĐ sau).
—
💡 Ý tưởng mới
Xem khác biệt giữa hai lần nghiệm thu.
Chủ dự án tải về để lưu trữ.
Cập nhật nhanh không cần migration DB.
Khách dùng tài khoản AI của họ; chủ hệ thống không trả phí AI cho 1 triệu web. Mới THIẾT KẾ.
Nhiều vai trò AI dùng chung một provider để tiết kiệm chi phí.
🗑️ Ý tưởng bị loại
Chưa có.
📌 Kiến nghị
Bảo vệ khỏi hồi quy khi phối hợp ChatGPT ↔ Claude Code.
Để trang Nghiệm thu Sprint luôn phản ánh đúng thực tế.
Cho phép thuyết trình từ bất kỳ đâu như yêu cầu.