← Về thư mục
📄 / / root / ceo / plans / SYSTEM_ARCHITECTURE.md

CEO AI OS — Kiến Trúc Hệ Thống & Cẩm Nang Vận Hành Toàn Diện (Living Architecture Guide)

Phiên bản: v5.2 — Domain Separation Enforcement: GLV Corporate vs Personal Knowledge Growth Cập nhật lần cuối: 2026-09-10 bởi Reviewer [Domain Charter]


0. DOMAIN SEPARATION CHARTER (Ràng Buộc Tuyệt Đối — Đọc Trước Mọi Hành Động)

Hệ thống phân định 2 nhóm domain hoàn toàn độc lập. Tất cả profiles, watchlists, dossiers, ICs, cron jobs và routing logic phải tuân thủ bảng phân loại này.

Nhóm Nội dung thuộc nhóm Lane phụ trách Phân luồng artifact KHÔNG GÁN
A: GLV Corporate SEO ngành xe, GEO/AEO vận tải, content xe đưa đón công nhân, fleet management, đào tạo lái xe DDT bd-mkt, glv-director, it-ai projects/corporate/GLV/ Chính sách công, du lịch, AI research
B1: Public Policy VN Nghị quyết, Nghị định, cải cách kinh tế tư nhân, Luật Đầu tư, quản trị dữ liệu số r-and-d, subc projects/personal/ GLV, bd-mkt
B2: VN Tourism Policy Chính sách phát triển du lịch nhà nước (visa, kinh tế đêm, wellness), đối sách quốc tế thu hút khách r-and-d, subc projects/personal/ GLV, bd-mkt
B3: Tech & AI Agents Multi-agent orchestration, Hermes platform, research pipeline ARS, LLM routing, memory architecture r-and-d, subc projects/tech/ GLV, bd-mkt

Nếu không rõ nhóm: ưu tiên projects/personal/ hoặc projects/tech/. KHÔNG BAO GIỜ gán bừa vào GLV.


1. Tổng Quan Kiến Trúc Hạ Tầng (Infrastructure Overview)

CEO AI OS được xây dựng theo mô hình Hybrid Centralized Server / Multi-Client: - VPS Server (Debian/Ubuntu - Tailscale IP: 161.97.131.21 / vmi3427693.tail8c1aaf.ts.net): - hermes-gateway.service: Gateway trung tâm điều phối Telegram bot, lắng nghe webhook, định tuyến tin nhắn theo thread đến đúng Profile. WorkingDirectory mặc định: /opt/ai-os/products/ceo. - hermes-dashboard.service (Port 9119): Giao diện Kanban Board & API phục vụ quản lý tác vụ. - 9router Docker (127.0.0.1:20128/v1): Proxy điều phối tải và xoay vòng tài khoản AI. - Git Auto-Sync (/root/scripts/git-sync.sh): Tự động pull rebase, commit [HM], và push 2 chiều với GitHub mỗi 10 phút. - Mac Local (Thin Client & IDE): - Hermes Desktop: Kết nối tới Tailscale HTTPS (vmi3427693.tail8c1aaf.ts.net). - Antigravity IDE: Lập trình, duyệt file trên repo clone ~/Documents/GitHub/ceo-ai-os.


2. Bảng Danh Mục Profile, Agent & Cách Sử Dụng (Cheat Sheet)

Hệ thống có 8 profiles hoạt động theo mô hình phân làn (Lane Architecture), mỗi profile có vai trò, tính cách (SOUL.md), và ranh giới nghiêm ngặt (Hard Boundaries).

Profile Tên đại diện Phân làn (Lane) Telegram Thread Alias gọi nhanh Cronjob Sở Hữu Use Case cụ thể (Khi nào dùng?)
reviewer Chief Reviewer Main / Gatekeeper Nhóm chính / TUI mặc định reviewer reviewer-decision-log (20:00)
seo-dashboard-nightly-sync (00:00)
Cổng duyệt tối cao: Tiếp nhận tóm tắt từ các phòng ban, đóng feedback loop duyệt/hủy Idea Contracts, xử lý tác vụ ad-hoc, điều phối Kanban. Luôn mở đầu tiên.
subc Subconscious Dreamer Lane Thread 18 subc subc-daily-idea-intake (07:00) Bộ não sáng tạo tiềm thức: Phát hiện cơ hội kinh doanh mới, liên kết xu hướng chéo ngành, soạn thảo các bản Idea Contract có trích dẫn bằng chứng.
r-and-d Research & Dev Evidence Collector Thread 12 r-and-d, rd r-and-d-daily-intelligence (06:00) Nghiên cứu chuyên sâu: Vận hành Intelligence Vault, quét chính sách công, nghị định, thu thập báo cáo học thuật (APA 7th), phân tầng bằng chứng.
grill-qa Grill & QA Independent Verifier Thread 20 grill-qa, gq Phản biện & Kiểm định gắt gao: Tìm lỗi logic, truy vết nguồn tin (fact-check), stress-test ý tưởng, viết QA Receipts. Không bao giờ tin báo cáo chưa kiểm chứng.
writers Writers / Content Retention & Output Thread 1591 writers, wr Biên tập & Chắp bút: Viết bài phân tích dài, chuẩn hóa văn phong tiếng Việt trang nhã, trau chuốt bài đăng blog, bản tin, lưu trữ tri thức lâu dài.
bd-mkt BD & Marketing Commercial Execution Thread 14 bd-mkt, sm weekly-glv-seo-report (Thứ 2 10:00) Chiến lược thị trường & SEO: Phân tích từ khóa, kế hoạch thương mại cho GLV, kịch bản video, chiến dịch truyền thông và marketing.
glv-director GLV Director Corporate Executive Thread 1 glv-director Điều hành Green Leaf Vietnam: Theo dõi tiến độ doanh nghiệp, dashboard KPI, chỉ đạo các phòng ban con của GLV (Video, Content, IT).
it-ai IT & AI (Legacy) Infrastructure Support Thread 46 it-ai, it system-cache-cleaner Hạ tầng kỹ thuật GLV-IT: Bảo trì công cụ, server, script kỹ thuật chuyên biệt cho GLV.

Cách Gọi & Tương Tác:

  1. Qua Telegram: Gửi tin nhắn trực tiếp vào Thread ID tương ứng. Gateway tự động định tuyến tới đúng Profile xử lý.
  2. Qua Hermes Desktop / TUI CLI: bash # Mở phiên chat với profile cụ thể: hermes -p subc chat hermes -p r-and-d chat hermes -p reviewer chat
  3. Trong Kanban Board: Gán thẻ tác vụ (Assignee) với tên alias của phòng ban: assignee: r-and-d hoặc assignee: subc.

3. Chuỗi Vận Hành Tự Động Khép Kín (4-Step Autonomous Pipeline)

Toàn bộ quy trình từ Thu thập Dữ liệu (R&D) -> Sáng tạo Đột phá (subc) -> Phê duyệt Quyết định (CEO) -> Đóng Vòng Lặp Phản Hồi (Reviewer) được chuẩn hóa:

[06:00 AM] R&D Cron ────────► Cập nhật Vault (dossiers, findings, claims)
                                        │
                                        ▼ (subc-handoff.md)
[07:00 AM] subc Cron ────────► Đối chiếu pattern_memory + feedback_loop
                                        │
                                        ▼ Tạo Idea Contract (IC-YYYY-MM-DD-XX)
[Ban Ngày] CEO Review ───────► Đọc Telegram Thread 18/20 ──► Ra quyết định DECISION
                                                                   │
                                                                   ▼ (Thread 20)
[08:00 PM] Reviewer Cron ────► Ghi vault/decisions/ & subc/feedback_loop/
                                        │
                                        ▼ (Nếu APPROVED)
                               Điều phối việc cho BD-MKT / Tech

3.1. r-and-d-daily-intelligence (06:00 AM) — Evidence Collector

3.2. subc-daily-idea-intake (07:00 AM) — Subconscious Dreamer

3.3. Ban Ngày — CEO Đánh Giá & Ra Quyết Định (Human-in-the-Loop)

3.4. reviewer-decision-log (08:00 PM) — Feedback Loop Closer


4. Kho Tri Thức Tích Lũy Dài Hạn — Intelligence Vault (Graeme Framework)

Để tránh hiện tượng "Hallucination Laundry" (văn phong tự tin nhưng không có căn cứ) và "Starts from Scratch Tomorrow" (ngày nào cũng bắt đầu lại từ con số không), toàn bộ dữ liệu tình báo được cấu trúc trong shared/intelligence/vault/:

shared/intelligence/vault/
├── context/
│   ├── interest-profile.md     # Hồ sơ mục tiêu chiến lược & ưu tiên của CEO
│   └── source-plan.md          # Danh mục & xếp hạng độ tin cậy các nguồn dữ liệu
├── dossiers/                   # Hồ sơ chuyên đề tích lũy theo thời gian
│   ├── ai_agent_ecosystem.md   # Chuyên đề Hệ sinh thái AI Agent & Bộ nhớ
│   ├── public_policy_vn.md     # Chuyên đề Chính sách công & Nghị định VN
│   ├── glv_corporate_seo.md           # Dữ liệu thương mại & SEO GLV (Nhóm A)
│   ├── vn_tourism_policy_international.md # Đối sách du lịch quốc tế & Chính sách du lịch VN (Nhóm B2)
│   ├── public_policy_vn.md            # Chính sách công Việt Nam (Nhóm B1)
│   └── ai_agent_ecosystem.md          # Tech & AI Agent Workflows (Nhóm B3)
├── knowledge/                  # Sổ cái bằng chứng máy đọc (Machine-readable Ledgers)
│   ├── claims.jsonl            # Các luận điểm cốt lõi kèm Confidence Score
│   ├── findings.jsonl          # Từng tín hiệu quan sát được kèm nguồn gốc
│   └── sources.jsonl           # Danh mục các nguồn dẫn đã kiểm định
├── queue/                      # Làn điều phối liên phòng ban (Handoff Lanes)
│   ├── verification-queue.md   # Tín hiệu nghi vấn chờ Grill-QA kiểm tra chéo
│   └── subc-handoff.md         # Tín hiệu chất lượng cao bàn giao cho subc mỗi sáng
├── decisions/                  # Sổ cái quyết định phê duyệt / từ chối của CEO
│   └── YYYY-MM-DD-decisions.md
├── health/                     # Báo cáo sức khỏe cấu trúc vault
│   └── latest-health-check.md
└── run-receipts/               # Biên lai kiểm toán thực thi của từng phiên cron
    └── YYYY-MM-DD-T06.md

5. Chuỗi Phân Tầng Bằng Chứng (Evidence Stages)

Hệ thống tuân thủ nghiêm ngặt 5 bước phân tách bằng chứng, cấm làm phẳng dữ liệu:

$$\text{Raw Input} \longrightarrow \text{Finding} \longrightarrow \text{Claim} \longrightarrow \text{Verified Knowledge} \longrightarrow \text{Task Candidate}$$

  1. Raw Input (Thu thập thô): Văn bản, bài viết, dữ liệu cào chưa xác thực (raw_evidence/).
  2. Finding (Tín hiệu có địa chỉ): Quan sát cụ thể kèm URL, ngày quan sát và tác giả (findings.jsonl).
  3. Claim (Luận điểm có trọng số): Luận điểm được trích xuất từ finding, gắn nhãn tin cậy Low / Medium / High (claims.jsonl).
  4. Verified Knowledge (Tri thức kiểm chứng): Luận điểm được đối chiếu chéo qua nhiều nguồn độc lập và tổng hợp vào dossiers/.
  5. Task Candidate (Đề xuất hành động): Chỉ được hình thành khi subc tạo Idea Contract và được CEO/Reviewer ký duyệt.

6. Cấu Trúc Thư Mục Dữ Liệu Sau Chuẩn Hóa v5.1

Mọi tệp tin trong hệ thống đều có vị trí xác định duy nhất (Single Home):


7. Quy Trình Theo Dõi & Lưu Trữ Thay Đổi (Change Management)

Để đảm bảo bạn và mọi AI agent luôn nắm bắt được trạng thái hệ thống:

  1. Tài liệu tham chiếu chuẩn (Source of Truth):
  2. Tài liệu này (plans/SYSTEM_ARCHITECTURE.md) được cập nhật mỗi khi có thay đổi về hạ tầng, profile hoặc quy tắc thư mục.
  3. Nhật ký cập nhật chi tiết (plans/CHANGELOG.md):
  4. Mọi lần tái cấu trúc, đổi cron, thêm profile đều được ghi nhận với format: ### [Phiên bản] - YYYY-MM-DD [Tag] kèm tóm tắt các thay đổi.
  5. Truy cập nhanh:
  6. Bạn có thể xem tài liệu này trên GitHub hoặc tại Mac local: ~/Documents/GitHub/ceo-ai-os/plans/SYSTEM_ARCHITECTURE.md.