Phân chia môi trường
Phần mềm có hai bản chạy song song:
- Bản thử — để nhà trường xem trước và góp ý
- Bản chính thức — bản cán bộ dùng thật hằng ngày
Mọi thay đổi đều cho chạy ở bản thử trước. Nhà trường xem và duyệt xong mới đưa lên bản chính thức. Nguyên tắc này để người dùng không bao giờ gặp tính năng nửa vời trong lúc đang làm việc.
Ngoài hai bản trên, đội phát triển còn một bản chạy trên máy cá nhân khi lập trình.
Cán bộ nhà trường chỉ cần đọc tới đây. Phần dưới dành cho đội phát triển và người quản trị máy chủ.
Bảng môi trường
| Môi trường | Tên miền | Mục đích | Ai truy cập |
|---|---|---|---|
| dev | localhost | Phát triển trên máy cá nhân | Lập trình viên |
| staging | stg.sotaylop.com | Nghiệm thu nội bộ, UAT trước khi phát hành | Đội dự án, người nghiệm thu |
| production | sotaylop.com | Bản chạy thật cho pilot | Người dùng cuối tại trường |
Đường dẫn
| dev | staging | production | |
|---|---|---|---|
| Ứng dụng | http://localhost:5173 | https://stg.sotaylop.com | https://sotaylop.com |
| Tài liệu | http://localhost:3000 | https://stg.sotaylop.com/docs/ ✅ | https://sotaylop.com/docs/ ✅ |
Tài liệu nằm ở đường dẫn con /docs/ để root domain dành cho bản demo ứng dụng.
Hạ tầng
Bản thử và bản chính thức chạy trên cùng một máy chủ, tách nhau bằng cấu hình máy chủ web và cổng nội bộ riêng. Máy này còn chạy vài dịch vụ khác của đơn vị, nên mỗi dịch vụ mới phải chọn cổng chưa dùng.
Địa chỉ máy chủ, sơ đồ cổng, tài khoản quản trị và các thông tin vận hành khác không đưa lên trang tài liệu công khai. Chúng nằm trong tài liệu vận hành nội bộ, chỉ người quản trị hệ thống được xem.
Công bố những thông tin này giúp người muốn tấn công rút ngắn công đoạn dò tìm.
sotaylop.com trước đây chạy một ứng dụng khác. Ngày 03/08/2026 người phụ trách sản phẩm quyết định gỡ ứng dụng đó, và tên miền đã chuyển hẳn cho dự án ADang. Dữ liệu cũ đã sao lưu trước khi gỡ.
Quy trình phát hành
dev (máy cá nhân)
└─ push nhánh → PR
└─ merge vào main
└─ deploy staging → nghiệm thu tại stg.sotaylop.com
└─ duyệt → deploy production
Deploy tài liệu
npm --prefix docs-site run deploy:staging
npm --prefix docs-site run deploy:production
Xem chi tiết cấu hình máy chủ tại Hướng dẫn cài đặt & vận hành.
Biến môi trường của tài liệu
Docusaurus chọn cấu hình theo biến DOCS_ENV (dev · staging · production), khai báo trong docs-site/docusaurus.config.js. Bản staging hiển thị banner cảnh báo để không nhầm với bản chính thức.