Skip to content

Constitution và Governance ​

Version: 1.0
Date: 2026-11-12
Status: Working baseline

Chính sách hai tầng ​

MINAP Platform Constitution là chính sách cha bắt buộc. Mỗi Application Constitution kế thừa và có thể thêm quy tắc chặt hơn hoặc theo công nghệ, nhưng không được làm yếu hoặc mâu thuẫn. Nếu Application cần ngoại lệ, SA ghi lý do và tác động; Project Owner phê duyệt ngoại lệ có thời hạn qua change control governance.

Constitution Spec Kit đang active ​

Với mỗi repository đã khởi tạo Spec Kit, .specify/memory/constitution.md là constitution active mà Spec Kit tiêu thụ. governance/minap-platform-constitution.md là nguồn chính sách MINAP chuẩn. Khi khởi tạo, copy/adapt chính sách đã duyệt vào Spec Kit constitution bằng /speckit-constitution; không duy trì bản lệch nhau. Nguồn governance là thẩm quyền; bản sinh/active phải ghi phiên bản nguồn và được kiểm drift.

Quy trình đổi Constitution ​

Đề xuất → SA phân tích tác động → BA/QA review → Owner phê duyệt → cập nhật file governance chuẩn → đồng bộ .specify/memory/constitution.md của mỗi repository → kiểm tính nhất quán → commit. Đổi Constitution không tự viết lại các feature plan đã phê duyệt; đánh giá từng work item bị ảnh hưởng riêng.

MINAP Platform Constitution (baseline đề xuất) ​

  1. Architecture (kiến trúc): giữ Platform Core độc lập và các Application deploy độc lập; dùng contracts đã tài liệu hóa; tránh coupling tình cờ.
  2. Application integration (tích hợp Application): Applications tích hợp qua Platform SDK/API contracts đã duyệt; không phụ thuộc trực tiếp vào internals chưa tài liệu hóa.
  3. Security (bảo mật): least privilege, secure defaults, input validation, output encoding, secrets/ENV trong Infisical (không trong source hay model context), audit thao tác nhạy cảm.
  4. Identity and access: authentication và authorization phải dùng Platform identity contracts đã duyệt; không tự tạo kho identity song song hay bypass chính sách tập trung.
  5. Data (dữ liệu): ownership, phân loại, retention, backup, migration và xóa tường minh; cô lập tenant/user phải kiểm thử được.
  6. API: contracts có version, lỗi nhất quán, authentication/authorization, idempotency khi phù hợp, chính sách tương thích và deprecation.
  7. Reliability (độ tin cậy): timeouts, retries có giới hạn, idempotency, observability, health checks và cô lập lỗi phù hợp mức quan trọng của service.
  8. Testing: AC map sang tests; unit, integration, contract, security và end-to-end chọn theo rủi ro; regression tests cho defects.
  9. Documentation (tài liệu): tài liệu kỹ thuật tiếng Anh; ADR cho quyết định trọng yếu; runbooks cho dịch vụ vận hành quan trọng; thuật ngữ Application A/B/C.
  10. Delivery: build tái lập được, kiểm CI, bảo vệ nhánh main, rollout theo giai đoạn, phê duyệt production tường minh và chiến lược rollback đã kiểm thử.
  11. Maintainability (khả năng bảo trì): ưu tiên open-source/self-hosted khi phù hợp; tránh framework tùy biến không cần thiết; ghi ngoại lệ và trade-off.
  12. AI governance: agents theo task có biên, không tự phê duyệt, không lộ secrets, và giữ truy vết từ yêu cầu đến test.

Lựa chọn công nghệ chưa được kiến trúc MINAP phê duyệt vẫn chưa quyết định; Constitution này không chọn stack mới.

docs/ = SoT duy nhất · văn xuôi tiếng Việt + thuật ngữ chuyên ngành English