Khởi tạo System

Role: Project Manager | Solution Architect 🏗️

System trong AIPD đại diện cho một service, ứng dụng, hoặc thành phần kỹ thuật độc lập trong kiến trúc tổng thể của dự án (ví dụ: Order Service, Admin Portal, Payment Gateway, Mobile App). Mỗi System là đơn vị quản lý riêng biệt, chứa Environments, Features, Configurations, API Specs, và Foundation Documents của riêng nó.

Hướng dẫn thao tác

Truy cập System Management từ thanh điều hướng chính của AIPD Client.

Màn hình chia thành hai vùng:

• Cột trái — danh sách các System đã tạo, có ô tìm kiếm phía trên.
• Vùng phải — panel tạo mới hoặc chi tiết System đang chọn.

---

Tạo System mới

1. Ở cuối cột trái, nhấn nút "Connect New System".

2. Panel "Connect New System" mở ra bên phải. Điền thông tin:

   Thông tin cơ bản:

   Trường	Bắt buộc	Ghi chú
   System Name	Có	Tên hiển thị (ví dụ: Order Service, Admin Portal)
   System Code	Có	Mã định danh ngắn, chỉ dùng chữ cái, số, dấu - và _ (ví dụ: SYS-001, ORDER_SVC)
   Description	Có	Mô tả ngắn về vai trò của System này trong dự án

   Deployment Regions:

   Trường	Bắt buộc	Giá trị có thể chọn
   Countries	Không	Global, US, EU, UK, CA, AU, JP, CN, Internal

   Technical Stack:

   Trường	Bắt buộc	Giá trị có thể chọn
   Languages	Không	TypeScript, JavaScript, Python, Java, Go, Rust, C++, C#, Ruby, PHP, Swift, Kotlin

   Organisation:

   Trường	Bắt buộc	Ghi chú
   Labels	Không	Tag tuỳ chỉnh — gõ và nhấn Enter hoặc dấu phẩy để thêm. Không có lựa chọn cố định.

3. Nhấn "Create System". System mới xuất hiện ngay trong danh sách bên trái và được tự động chọn.

---

Xem và điều hướng System vừa tạo

Khi một System được chọn, vùng phải chuyển sang System Details với 5 tab:

Tab	Nội dung
Foundation	Tài liệu kỹ thuật nền tảng (knowledge base cho AI Agent)
Environments	Các môi trường triển khai (Dev, Staging, Prod...)
Features	Danh sách tính năng của System
Configs	Biến môi trường, secrets, kết nối DB, queue
API Specs	Swagger/OpenAPI URL theo từng environment

Góc trên trái của panel details hiển thị tên System, mã code (badge màu cyan), và description. Nhấn icon ⚙️ để chỉnh sửa thông tin System.

---

Chỉnh sửa System

Nhấn icon ⚙️ trên header của System Details (hoặc menu dropdown trên card trong danh sách) để mở panel "Edit System". Cập nhật thông tin rồi nhấn "Save Changes".

Xoá System

Mở menu dropdown trên card/row System → chọn "Delete" → xác nhận trong hộp thoại. Thao tác này không thể hoàn tác — toàn bộ Environments, Features, Configs, API Specs và Foundation Documents của System sẽ bị xoá theo.

---

Thứ tự khuyến nghị sau khi tạo System

Để AI Agent có đủ ngữ cảnh hoạt động, thực hiện theo thứ tự:

1. Environments  →  định nghĩa môi trường triển khai
2. Features      →  liệt kê các tính năng
3. Configs       →  thêm biến môi trường và secrets
4. API Specs     →  nhập Swagger URL để trích xuất endpoints
5. Foundation    →  soạn tài liệu kỹ thuật nền tảng

Đặt tên System

Đặt tên ngắn gọn, phản ánh đúng ranh giới kỹ thuật của service. Ví dụ tốt: User Auth Service, Payment Gateway, Notification Worker. Tránh tên chung chung như Backend hay Service 1.

Bước tiếp theo

Sau khi tạo System, chuyển sang bước 02 — Khởi tạo Environments để định nghĩa môi trường triển khai.