🔍
📍 Bạn đang ở:Project OSTổng quanTầng Nền tảngNền tảng Kiến trúc (Foundation)

🧬 Project DNA (Bộ gen dự án)

Tài liệu bất biến: tầm nhìn, sứ mệnh, nguyên tắc và quy tắc định hình mọi quyết định của Project OS.

🎤 Thuyết trình
Tầm nhìn (Vision)

Trở thành “Google Maps của tri thức doanh nghiệp” — nơi mọi dự án, con người, quyết định và ý tưởng đều là Đối tượng + Liên kết, không ngõ cụt, ai cũng khám phá được.

Sứ mệnh (Mission)

Cho phép người không lập trình quản lý, học, khám phá, suy luận và trình bày toàn bộ tri thức của doanh nghiệp từ MỘT nguồn sự thật duy nhất, hoàn toàn bằng tiếng Việt.

Nguyên tắc cốt lõi (Core Principles)

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ắc kiến trúc (Architecture Rules)

9 tầng cố định

Data → Semantic → Meta → Presentation → Governance → Human → Reasoning → (Enterprise/Platform/Intelligence) → AI.

Không thêm bảng nền cho 1 chức năng lẻ

Tính năng mới xây trên Meta (DinhNghiaTruong + Nut.meta) hoặc file cấu hình.

Đổi kiến trúc phải qua ADR + phân tích tác động

Không sửa schema nền nếu không thật cần.

AI đọc Intelligence, không import prisma

loi/ai/* không được chạm tầng dữ liệu (chứng minh bằng grep).

🔤 Quy tắc đặt tên (Naming Rules)

Chuỗi hiển thị: “Tiếng Việt (English)”

Nhãn UI + tài liệu theo chuẩn song ngữ; từ giữ tiếng Anh có lý do ghi ở từ điển.

Không dịch định danh code

Tên model/route/biến giữ nguyên để không phá tương thích.

Route tiếng Việt không dấu

vd /so-do-tu-duy, /trung-tam-tri-thuc.

🏛 Quy tắc nghiệm thu (Review Rules)

Nghiệm thu qua /review + /api/review + /api/review-manifest

Ba nguồn dùng chung loi/review.ts nên không lệch.

Trước mỗi Sprint đọc Review, khắc phục hết thiếu sót rồi mới phát triển

Không chuyển giai đoạn khi Review còn báo thiếu.

Sau mỗi Sprint: chạy tao-manifest.mjs + cập nhật sprint.ts

Giữ manifest và nghiệm thu phản ánh đúng thực tế.

🧊 Quy tắc đóng băng (Freeze Rules)

Đóng băng kiến trúc từ GĐ3

Không thêm bảng nền nếu không thật cần.

Vá dữ liệu chỉ dùng bảng có sẵn

vd DoiTuongMien/LienKet — không migration.

Foundation khóa ở Architecture Foundation v1.0

Từ đây chỉ mở rộng lớp Review/Documentation/Dashboard trên dữ liệu hiện có.

🎨 Ngôn ngữ thiết kế (Design Language)

Đối tượng + Liên kết

Mọi thứ là Nút và Mối liên hệ; màu theo loại, badge trạng thái/tiến độ.

3 engine trực quan dùng chung

Engine Cây · Engine Đồ thị lực · Engine Trình chiếu.

Không ngõ cụt

Mọi trang có ‘Đi tiếp’ + luôn quay về Trung tâm điều hành.

Sáng/tối + responsive Tailwind

Tông màu ‘muc’, thẻ bo góc, tương phản hai chế độ.