Đúng từ thiết lập.
Rõ trong vận hành.
Hướng dẫn Orkestr cho developer và operator. Ba lối vào riêng để dựng môi trường, vận hành hệ thống và xử lý tình huống — từ local đến triển khai.
Provisioning Guide
Local, POC, môi trường, Keycloak và lần triển khai đầu.
Dựng môi trường 02 — VẬN HÀNH/runbookRunbook
Database, migration, tích hợp và quyền sử dụng AI.
Vận hành hệ thống 03 — TÌNH HUỐNG/playbookPlaybook
Dấu hiệu lỗi, cách khoanh vùng, khôi phục và kiểm chứng.
Xử lý sự cốChọn theo việc cần làm
Bắt đầu đúng chỗ
Lần đầu dựng Orkestr
Chuẩn bị local, chọn POC hoặc dev, cấu hình từng client Keycloak rồi triển khai.
Mở quickstart local →Hệ thống đã chạy
Kiểm dịch vụ, nâng phiên bản, quản lý integration và cấp quyền model theo project.
Mở checklist vận hành →Đang có sự cố
Khoanh vùng theo triệu chứng, khôi phục có kiểm chứng và giữ nguyên lịch sử cần đối soát.
Mở quy trình xử lý →Phạm vi hệ thống
Một backend, hai ứng dụng
Portal dành cho công việc theo project; Console dành cho quản trị hệ thống. Hai ứng dụng Angular có entrypoint, domain và public client Keycloak riêng, cùng gọi một API NestJS.
| Thành phần | Phạm vi | Local |
|---|---|---|
| Portal | Project, tài liệu, planning, execution, delivery. | localhost:4200 |
| Console | Tài khoản AI dùng chung và quyền model theo project. | localhost:4300 |
| Backend | Một API, cùng worker và runner xử lý queue. | localhost:3300/api/v1 |
Keycloak xác thực user. Role orkestr-admin mở quản trị hệ thống; membership trong database quyết định quyền project. Kết nối Claude/Codex và cấp model hiện chưa nối CLI vào inference của workflow; One Nexus đang chờ thông tin dịch vụ.
Các domain triển khai trong Guide là cấu hình đích, không phải tuyên bố trạng thái live. Chốt Keycloak production trước khi triển khai main; ghi kết quả thực tế bằng checklist kiểm chứng.