Khởi tạo Configuration

Role: Project Manager | Solution Architect 🏗️

Configuration là nơi lưu trữ tập trung tất cả biến môi trường, secrets, và thông tin kết nối mà System cần để vận hành. AI Agent tham chiếu đến đây khi sinh Implementation Plan và tài liệu kỹ thuật — đảm bảo đúng tên biến và đúng môi trường.

Hướng dẫn thao tác

1. Trong System Management, chọn System từ danh sách bên trái.
2. Chuyển sang tab "Configs".

---

Tạo Configuration mới

1. Nhấn nút "New" (icon +) ở góc trên phải của tab.

2. Modal "New Configuration" mở ra. Chọn nguồn nhập:

   Nguồn 1 — Manual Input (nhập thủ công):

   Trường	Bắt buộc	Ghi chú
   Name	Có	Tên gợi nhớ (ví dụ: Stripe API Key (Prod), Database URL)
   Key Name	Có	Tên biến thực tế trong code (ví dụ: STRIPE_API_KEY, DATABASE_URL) — dạng monospace
   Type	Không	Phân loại: Env Variable, Secret, Database, Queue
   Value	Có	Giá trị của biến
   Treat as Secret	Không	Bật để mask giá trị (••••••) trong danh sách — dùng cho mật khẩu, API key
   Environments	Không	Gán cho một hoặc nhiều environment
   Countries	Không	Giới hạn theo khu vực triển khai (Global, US, EU...)

   Nguồn 2 — From Credential (từ kho Credentials đã cấu hình):

   Chọn credential từ dropdown — các trường Name, Key, Type sẽ tự điền và không chỉnh sửa được. Chỉ cần chọn Environments và Countries. Dùng khi muốn tái sử dụng credential đã lưu tập trung ở admin.

3. Nhấn "Save Configuration". Config xuất hiện trong bảng.

---

Bảng danh sách Configurations

Bảng hiển thị các cột:

Cột	Nội dung
NAME	Tên gợi nhớ của configuration
KEY REFERENCE	Tên biến (DATABASE_URL, JWT_SECRET...) — dạng monospace
CONFIG VALUE	Giá trị — nếu là Secret thì hiển thị ••••••; nhấn icon 👁 để xem tạm thời, nhấn icon copy để sao chép
TYPE	Badge màu: env (xanh), secret (tím), db (cyan), queue (cam)
COUNTRIES	Các khu vực áp dụng
ENVIRONMENTS	Các môi trường áp dụng
ACTIONS	Nút Edit

---

Lọc theo Environment và Country

Nhấn icon filter trên cột COUNTRIES hoặc ENVIRONMENTS để mở dropdown lọc. Badge số xuất hiện trên icon khi đang có filter hoạt động. Nhấn "Reset" để xoá bộ lọc.

---

Chỉnh sửa Configuration

Nhấn icon Edit (⚙️) trong cột Actions → modal "Edit Configuration" mở ra → cập nhật → nhấn "Save Configuration".

---

Phân loại Configuration

Type	Dùng cho	Ví dụ
Env Variable	Biến môi trường thông thường	APP_PORT=3000, LOG_LEVEL=info
Secret	Thông tin nhạy cảm	JWT_SECRET, STRIPE_API_KEY, DB_PASSWORD
Database	Chuỗi kết nối database	DATABASE_URL=postgresql://...
Queue	Cấu hình message queue	RABBITMQ_URL, SQS_QUEUE_NAME

Secret và Production

Không dùng chung giá trị Secret giữa môi trường Staging và Production. Khi tạo config cho Dev/Staging, dùng giá trị test/sandbox. Bật "Treat as Secret" cho bất kỳ trường nào chứa mật khẩu, token hoặc API key để tránh lộ giá trị khi chia sẻ màn hình.

Bước tiếp theo

Sau khi thêm xong Configurations, chuyển sang bước 05 — Thiết lập API Specs để import Swagger URL và trích xuất endpoints.