Câu Hỏi Thường Gặp (FAQ)¶
Tài Khoản & Đăng Nhập¶
Tôi quên mật khẩu, làm sao để lấy lại?
Hiện tại hệ thống chưa hỗ trợ tính năng quên mật khẩu tự động. Vui lòng liên hệ quản trị viên để được reset mật khẩu.
Làm sao để tạo tài khoản Admin mới?
Chỉ có Super Admin mới có quyền tạo tài khoản Admin. Vào menu Người dùng → Thêm mới → Chọn vai trò Admin.
Tôi có thể đăng nhập từ nhiều thiết bị không?
Có, bạn có thể đăng nhập từ nhiều thiết bị cùng lúc. Token JWT có thời hạn 30 phút (mặc định).
Bản Đồ¶
Bản đồ không hiển thị, chỉ thấy màu xám?
Nguyên nhân có thể là:
- Thiếu API Key: Kiểm tra biến
VITE_MAPTILER_KEYtrong file.env - API Key hết hạn: Đăng nhập MapTiler để kiểm tra
- Lỗi mạng: Kiểm tra kết nối Internet
Dữ liệu AQI không cập nhật?
Kiểm tra các agent có đang chạy không:
Nếu lỗi, kiểm tra API key của OpenAQ trong file.env.
Làm sao để thêm layer mới?
Cần chỉnh sửa source code Frontend. Tham khảo tài liệu Developer Guide để biết cách thêm layer.
Báo Cáo¶
Có giới hạn số lượng báo cáo không?
Không có giới hạn. Tuy nhiên, hệ thống có cơ chế rate limiting để tránh spam (tối đa 10 báo cáo/phút/người dùng).
Hình ảnh báo cáo được lưu ở đâu?
Hình ảnh được lưu trữ trên server trong thư mục /uploads/reports/. Trong production nên dùng cloud storage (S3, GCS).
Tôi có thể xuất danh sách báo cáo không?
Chức năng export đang được phát triển. Tạm thời có thể sử dụng API endpoint để lấy dữ liệu JSON.
Kỹ Thuật¶
Hệ thống hỗ trợ bao nhiêu người dùng đồng thời?
Với cấu hình mặc định (Docker Compose), hệ thống có thể xử lý ~100 concurrent users. Để scale up, cần triển khai với Kubernetes.
Dữ liệu được backup như thế nào?
Cần tự thiết lập backup cho PostgreSQL và MongoDB. Khuyến nghị sử dụng pg_dump và mongodump với cron job hàng ngày.
Làm sao để deploy lên production?
Tham khảo tài liệu Developer Guide > Deployment để biết cách triển khai với Docker Swarm hoặc Kubernetes.
Mobile App¶
App có trên iOS không?
Hiện tại chỉ có phiên bản Android. iOS đang trong kế hoạch phát triển.
Làm sao để test app trên thiết bị thật?
- Build APK:
./gradlew assembleDebug - Cài đặt file
.apklên điện thoại - Đảm bảo điện thoại và server cùng mạng WiFi
Liên Hệ Hỗ Trợ¶
Nếu không tìm thấy câu trả lời, vui lòng:
- 📧 Email: support@greenmap.hanoi
- 💬 GitHub Issues: Tạo issue mới