🔍

🏛 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.

🎤 Thuyết trình
⚖️
8
Quyết định (ADR)
🧱
5
Nợ kỹ thuật
⚠️
3
Rủi ro
💡
3
Kiến nghị

📜 Nguyên tắc kiến trúc (bất biến)

Giải thích được — không hộp đen

Mọi kết luận (AI, suy luận) kèm nguồn, lý do, độ tin cậy.

Một nguồn sự thật

Đối tượng + Liên kết là lõi; mọi góc nhìn đều đọc từ đó.

Người không lập trình vẫn dùng được

Toàn bộ tiếng Việt, luôn có lối ra, không ngõ cụt.

AI không chạm Database

AI đọc qua Intelligence Engine, tách khỏi tầng dữ liệu.

Mặc định TỪ CHỐI

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ận

Lý 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ận

Lý 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ận

Lý 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ận

Lý do: Chịu tải lớn.

Chuyển sang SQLite cho gọn nhẹ

Chấp nhận

Lý do: Triển khai đơn giản.

Đóng băng kiến trúc (Architecture Freeze)

Chấp nhận

Lý 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

Chưa có test tự động / CICao

Trang & engine chưa có kiểm thử tự động. Rủi ro hồi quy khi thêm tính năng.

Session chưa thu hồi đượcTrung bình

Token phía server chưa có danh sách thu hồi. Không đăng xuất từ xa được.

Backup chưa có restore kiểm chứngTrung bình

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.

Config/luật ở file JSON cục bộThấp

Cấu hình, cờ tính năng, luật còn ở file. Khó quản trị nhiều môi trường.

Provider LLM ngoài mới là fallbackThấp

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

Triển khai phụ thuộc dev server + tunnelTrung bình

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.

Chưa có test → hồi quyCao

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.

Dữ liệu Sprint/kiến trúc ở fileThấp

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

✅ Đã hoàn thành (10)
  • 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).
⏳ Đang chờ / chưa làm (2)
  • 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).
🐞 Lỗi còn lại (0)

💡 Ý tưởng mới

Chế độ so sánh 2 sprintMới

Xem khác biệt giữa hai lần nghiệm thu.

Xuất báo cáo nghiệm thu PDFĐang cân nhắc

Chủ dự án tải về để lưu trữ.

File cấu hình cho Sprint & Kiến trúcĐã chọn

Cập nhật nhanh không cần migration DB.

AI Platform BYOK cho Website SaaSĐã chọn

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Ế.

Hội đồng AI (nhiều vai trò, một model)Đã chọn

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ị

Thêm smoke test cho các trang trung tâm

Bảo vệ khỏi hồi quy khi phối hợp ChatGPT ↔ Claude Code.

Chuẩn hóa quy trình: mỗi sprint cập nhật du-lieu/sprint.ts

Để trang Nghiệm thu Sprint luôn phản ánh đúng thực tế.

Gắn nút 🎤 Thuyết trình vào hồ sơ đối tượng

Cho phép thuyết trình từ bất kỳ đâu như yêu cầu.