Tài liệu CenterOS

Mục tiêu

CenterOS Docs là tài liệu kỹ thuật Git-backed cho engineer làm việc với CenterOS. Repo này ghi lại các phần đã đóng, các boundary còn hiệu lực, API/FE-BE flow, database ownership và runbook vận hành.

Trạng thái hiện tại

Checkpoint hiện tại: Go API Gateway và Go Identity Service đã đóng cho local compose và frontend auth/select-branch.

Mục tiêu tiếp theo: validate Entitlement Service cho current-context, setup, packages và selection resolve.

Nội dung thuộc repo này:

• Closed checkpoints.
• Architecture/service boundary.
• Service runtime.
• API use cases.
• FE-BE flows.
• Database ownership.
• Runbooks.
• References.
• ADR.

Nội dung không thuộc repo này:

• Business planning.
• Company strategy.
• Prioritization notes.
• Sales notes.
• Secrets.

Luồng chính

Đọc docs
1. Checkpoint
2. Architecture
3. Services
4. Flow
5. Use case
6. Runbook

Quy tắc quan trọng

• Chỉ viết fact đã kiểm chứng hoặc đánh dấu TODO/Chưa đóng.
• Không copy secret, token thật hoặc giá trị private từ .env.
• Giữ nguyên API paths, header names, JSON fields, Docker names, image names, env var names và schema/table names.
• Java Gateway và Java Identity là legacy/đã xóa, không document như runtime hiện tại.

Liên quan

• Checkpoint Go Gateway và Identity đã đóng
• Tổng quan hệ thống
• Boundary giữa service
• Mô hình token và context
• Quy chuẩn viết docs

TODO

• Chưa đóng: Entitlement Service validation.