Home

🌍 AirSafeNet Wiki

Welcome to the AirSafeNet project wiki — your comprehensive guide to understanding, running, and contributing to the system.

---

📖 Table of Contents

🚀 Getting Started

• Home ← You are here
• Quick Start
• Installation Guide
• Configuration

🏗️ Architecture

• System Architecture
• Cache System
• Database Schema

🤖 AI & Model

• AI Model Overview
• Ensemble Model
• Feature Engineering
• Anomaly Detection
• Model Versioning
• Training Guide

✨ Features

• Dashboard
• Activity Planner
• District Heatmap
• WHO Dose Budget
• AI Assistant
• Notifications
• PM2.5 Guide

📡 API Reference

• AI Server API
• Backend API

🐳 DevOps

• Docker Guide
• CI/CD Pipeline
• GitHub Pages (Docs)

🤝 Contributing

• Contributing Guide
• Branching Strategy
• Commit Convention

---

🎯 What is AirSafeNet?

AirSafeNet is a full-stack AI platform that turns raw PM2.5 data into actionable, personalized health decisions for residents of Ho Chi Minh City.

Open-Meteo + OpenAQ
        ↓
  AI Server (FastAPI)          ← Ensemble AI · Cache · Anomaly · Heatmap
        ↓
  Backend (ASP.NET Core 8)     ← Auth · Activity · Notifications · Chat AI
        ↓
  Frontend (React 18)          ← Dashboard · Planner · Heatmap · Assistant

Built by Team KTT.HUTECH for Website & AI Innovation Contest 2026.

---

⚡ Quick Links

Action	Command
Start full stack	docker compose up -d --build
Open dashboard	http://localhost:5173
API docs	http://localhost:7276/swagger
AI docs	http://localhost:8000/docs
Trigger recompute	POST /api/admin/compute