Cài đặt hệ thống
Module Cài đặt hệ thống cho phép quản trị viên quản lý các tham số cấu hình toàn hệ thống. Danh sách cài đặt hỗ trợ kéo-thả (draggable) để sắp xếp thứ tự hiển thị.
Danh sách cài đặt
Truy cập Admin → Cài đặt để xem toàn bộ tham số cấu hình.
| Cột | Mô tả |
|---|---|
| Khóa (Key) | Định danh duy nhất của cài đặt (VD: app.name) |
| Giá trị (Value) | Giá trị hiện tại |
| Mô tả | Ghi chú giải thích mục đích cài đặt |
| Nhóm (Group) | Nhóm phân loại (VD: general, task_types) |
Nhấn giữ biểu tượng ⠿ bên trái mỗi dòng và kéo lên/xuống để thay đổi thứ tự hiển thị. Thứ tự được lưu tự động.
Thêm cài đặt mới
- Nhấn nút Thêm cài đặt trên thanh công cụ.
- Điền thông tin trong hộp thoại:
| Trường | Bắt buộc | Mô tả |
|---|---|---|
| Khóa (Key) | ✅ | Định danh duy nhất, sử dụng ký pháp dot-notation (VD: email.smtp_host) |
| Giá trị (Value) | ✅ | Giá trị cài đặt (chuỗi, số, hoặc JSON) |
| Mô tả | ❌ | Ghi chú về mục đích cài đặt |
| Nhóm (Group) | ✅ | Nhóm phân loại để quản lý |
- Nhấn Lưu để tạo cài đặt.
Khóa cài đặt phải là duy nhất trong toàn hệ thống. Sử dụng ký pháp dot-notation để phân nhóm logic: nhóm.tên_cài_đặt (VD: mail.sender_name, app.timezone).
Sửa / xóa cài đặt
Sửa cài đặt
- Nhấn vào dòng cài đặt cần sửa hoặc nhấn biểu tượng ✏️ Sửa.
- Cập nhật giá trị trong hộp thoại chỉnh sửa.
- Nhấn Lưu để áp dụng.
Xóa cài đặt
- Nhấn biểu tượng 🗑️ Xóa trên dòng cài đặt.
- Xác nhận trong hộp thoại.
Xóa cài đặt hệ thống có thể gây lỗi nếu mã nguồn đang tham chiếu đến khóa đó. Chỉ xóa các cài đặt không còn được sử dụng.
Các nhóm cài đặt
Cài đặt được phân loại theo nhóm để dễ quản lý:
| Nhóm | Mô tả | Ví dụ khóa |
|---|---|---|
general | Cài đặt chung của ứng dụng | app.name, app.timezone |
task_types | Loại công việc | Quản lý qua giao diện riêng |
mail | Cấu hình email | mail.smtp_host, mail.sender_name |
security | Bảo mật | security.session_timeout |
Sử dụng bộ lọc Nhóm trên thanh công cụ để hiển thị chỉ các cài đặt thuộc nhóm cụ thể.
Quản lý loại công việc (Task Types)
Loại công việc là một nhóm cài đặt đặc biệt được quản lý thông qua giao diện riêng với hộp thoại CRUD.
Danh sách loại công việc
Truy cập Admin → Cài đặt → Loại công việc để xem danh sách.
Thêm loại công việc mới
- Nhấn Thêm loại công việc.
- Điền thông tin trong hộp thoại:
| Trường | Bắt buộc | Mô tả |
|---|---|---|
| Tên loại | ✅ | Tên hiển thị (VD: "Kiểm tra chất lượng") |
| Mã loại | ✅ | Mã định danh duy nhất (VD: QC_INSPECTION) |
| Mô tả | ❌ | Ghi chú về loại công việc |
| Màu sắc | ❌ | Màu hiển thị trên giao diện |
| Trạng thái | ✅ | Hoạt động hoặc Ngừng sử dụng |
- Nhấn Lưu.
Sửa / xóa loại công việc
- Sửa: nhấn biểu tượng ✏️ trên dòng loại công việc, cập nhật thông tin và nhấn Lưu.
- Xóa: nhấn biểu tượng 🗑️, xác nhận trong hộp thoại.
Loại công việc đang được sử dụng trong các task hiện có sẽ không thể xóa. Hãy chuyển trạng thái sang Ngừng sử dụng thay vì xóa.
Áp dụng thay đổi cài đặt
Hầu hết các thay đổi cài đặt có hiệu lực ngay lập tức mà không cần khởi động lại hệ thống. Một số cài đặt liên quan đến kết nối bên ngoài (SMTP, tích hợp bên thứ ba) có thể cần thời gian đồng bộ từ 1-2 phút.
Cài đặt hệ thống được cache trên Redis. Khi thay đổi giá trị, cache tự động được cập nhật cho toàn bộ instance của ứng dụng.