Smart Forecast

Dashboard — Nền tảng giám sát và cảnh báo môi trường đô thị thông minh

Smart Forecast là gì?

Smart Forecast là nền tảng giám sát và cảnh báo môi trường đô thị thông minh, được phát triển hướng tới hỗ trợ chuyển đổi số cho các thành phố hiện đại.

Dự án tham gia cuộc thi OLP'2025 – Ứng dụng dữ liệu mở liên kết phục vụ chuyển đổi số, tuân thủ chuẩn NGSI-LD và sử dụng Smart Data Models của FIWARE.

Ý tưởng cốt lõi

Smart Forecast thu thập dữ liệu chất lượng không khí (Air Quality) và thời tiết (Weather) từ các nguồn mở như OpenWeatherMap, sau đó:

Phân tích & Cảnh báo tự động khi các chỉ số vượt ngưỡng an toàn
Cho phép quản lý gửi cảnh báo thiên tai, xem báo cáo và thống kê
Cho phép người dân nhận thông báo và gửi báo cáo sự cố (ngập lụt, cây đổ, sạt lở...) kèm vị trí GPS và ảnh

Kiến trúc & Luồng người dùng

Architecture Overview — Sơ đồ kiến trúc tổng quan hệ thống Smart-Forecast

User Flow — Sơ đồ luồng tương tác giữa Người dùng (Mobile) và Quản lý (Web Portal)

Luồng hoạt động chính:

Thu thập dữ liệu: Từ trạm quan trắc và OpenWeatherMap API
Phân tích & Giám sát: Quản lý theo dõi trên Web Dashboard
Phát hiện sự cố: Người dân gửi báo cáo từ Mobile App
Xử lý & Cảnh báo: Quản lý tạo cảnh báo cho vùng ảnh hưởng
Thông báo: Người dân nhận Push Notification và xem trên bản đồ

Tính năng chính

Ứng dụng di động (Citizen App)

Tính năng	Mô tả
Đăng nhập Google OAuth2	Xác thực an toàn với JWT
Xem dữ liệu môi trường	AQI, PM2.5, nhiệt độ, độ ẩm theo vị trí GPS
Bản đồ Live Map	Bản đồ theo dõi sự cố
Nhận cảnh báo Push	Thông báo qua Firebase Cloud Messaging
Gửi báo cáo sự cố	Chụp ảnh, mô tả, gửi vị trí
Lịch sử cảnh báo	Theo dõi các cảnh báo và báo cáo đã gửi

Onboarding 1 — Giới thiệu theo dõi thời tiết

Hồ sơ cá nhân

Dashboard quản trị (Admin Web)

Tính năng	Mô tả
Đăng nhập quản trị	Phân quyền Admin/Manager
Theo dõi thời gian thực	Bản đồ, biểu đồ AQI, nhiệt độ
Quản lý báo cáo sự cố	Xem, xác nhận, gán trạng thái xử lý
Gửi cảnh báo đô thị	Soạn và gửi cảnh báo tự động
Xuất báo cáo	Export PDF/CSV theo tháng, quý, năm

Tech Stack

Thành phần	Công nghệ
Backend	NestJS (Node.js), TypeScript
Web Frontend	Next.js 15, Tailwind CSS, Radix UI
Mobile App	Expo (React Native)
Context Broker	FIWARE Orion-LD (NGSI-LD)
Databases	PostgreSQL, MongoDB
Object Storage	MinIO (S3-compatible)
Notifications	Firebase Cloud Messaging
Data Source	OpenWeatherMap API
Containerization	Docker Compose
Package Manager	pnpm Monorepo Workspace

Tài liệu

Sử dụng thanh điều hướng bên trái để khám phá:

Bắt đầu nhanh - Cài đặt và chạy dự án
Kiến trúc hệ thống - Sơ đồ và luồng dữ liệu
Triển khai - Docker Compose và scripts
API Documentation - REST API endpoints
Hướng dẫn phát triển - Cho developers
Hướng dẫn sử dụng - Cho người dùng

Team NEU-DataVerse

Thành viên	Vai trò	Nhiệm vụ
Khải (Mkhai205)	PM, Backend, DevOps	Quản lý dự án, phát triển backend, Docker & CI/CD
Đạt (NGUYENTHANHDATHH)	Frontend	Dashboard, bản đồ, charts
Bích (BichCan)	Design UI, Docs	UI/UX, tài liệu

License

Dự án được phân phối dưới giấy phép MIT License.

Nhóm NEU-DataVerse – OLP'2025

Smart Forecast là gì?​

Ý tưởng cốt lõi​

Kiến trúc & Luồng người dùng​

Tính năng chính​

Ứng dụng di động (Citizen App)​

Dashboard quản trị (Admin Web)​

Tech Stack​

Tài liệu​

Team NEU-DataVerse​

License​