IoT & Maritime Emergency Rescue Platform (Hệ Thống Giám Sát Hải Trình & Cứu Nạn Hàng Hải LoRaWAN)

flowchart TB
    subgraph IOT_LAYER["1. TẦNG THIẾT BỊ IOT & NỀN TẢNG CLOUD"]
        DEV_BUTTON["Nút Nhấn Khẩn Cấp (SOS: WS101, LW006/013)"]
        DEV_GPS["Thiết Bị Định Vị GPS (Tàu Thuyền / Xe Cứu Hộ)"]
        DEV_GW["Trạm LoRaWAN Gateway Ngoài Trời"]
        CLOUD_IOT["Maritime IoT Platform (ChirpStack v4 / Mosquitto)"]
        DEV_BUTTON -->|LoRaWAN Uplink AS923/EU868| CLOUD_IOT
        DEV_GPS -->|LoRaWAN Uplink Định Kỳ| CLOUD_IOT
        DEV_GW -->|Trạng Thái Gateway & Link Info| CLOUD_IOT
    end

    subgraph SERVER_INGESTION["2. TẦNG TIẾP NHẬN & XỬ LÝ SỰ KIỆN (BACKEND)"]
        WEBHOOK["hctech_webhook.py\n- Xác thực Bearer Token\n- Khử trùng 24h FR-11.23\n- Chống trễ gói tin FR-11.22\n- Chuẩn hóa OutboundRecord FR-11.15"]
        CLIENT["hctech_client.py\n- Downlink Commands F-Port 1~223\n- Confirmed ACK RX1/RX2\n- Vòng đời lệnh queued ➜ sent ➜ delivered"]
        HB_THREAD["apps.py (HeartbeatCheckerThread)\n- Quét chu kỳ heartbeat ngầm\n- Tự chuyển OFFLINE khi mất sóng"]
        SSE_DISPATCH["sse.py (Server-Sent Events Engine)\n- Pub/Sub tin nhắn real-time\n- Đẩy sự kiện 0ms tới Dashboard"]
        
        CLOUD_IOT -->|POST /api/v1/webhook/ JSON| WEBHOOK
        CLIENT -->|HTTP Downlink / Sync| CLOUD_IOT
        HB_THREAD -->|Kiểm tra timeout chu kỳ| WEBHOOK
    end

    subgraph DATABASE_LAYER["3. TẦNG DỮ LIỆU & LƯỢC ĐỒ (POSTGRESQL 16)"]
        DB[(PostgreSQL Database)]
        MODELS["Server_tenant/models.py\n- Device (DevEUI, GPS, Nhóm Parent)\n- AlertLog (Sự cố SOS, Quy trình tiếp nhận)\n- LocationHistory (Chuỗi GPS, Điểm dừng trôi)\n- WebhookLog & User (Phân quyền 3 cấp)"]
        WEBHOOK -->|Ghi log & Cập nhật| DB
        HB_THREAD -->|Đổi trạng thái OFFLINE| DB
        MODELS -.-> DB
    end

    subgraph WEB_LAYER["4. TẦNG ĐIỀU PHỐI & REST API (DJANGO 6.1)"]
        VIEWS["Server_tenant/views.py (119 KB Logic)\n- Dashboard GIS APIs\n- Quản lý cảnh báo SOS & Điều phối\n- GPS Route Replay & Xuất file GPX\n- Telemetry Explorer /telemetry/aggregated"]
        
        VIEWS <-->|Truy vấn & Cập nhật| DB
        WEBHOOK -->|Bắn sự kiện| SSE_DISPATCH
    end

    subgraph CLIENT_LAYER["5. TẦNG GIAO DIỆN NGƯỜI DÙNG & ĐIỀU HÀNH (FRONTEND)"]
        DASHBOARD["dashboard.html + dashboard.js\n- Bản đồ số MapVina / Leaflet GIS\n- Tự động Zoom-to-fit bao quát thiết bị\n- Tua lại hải trình GPS Route Replay\n- Còi hú báo động SOS âm vang"]
        ADMIN["admin_portal.html\n- Quản trị Downlink F-Port\n- Bộ giả lập Webhook Simulator 5 mẫu\n- Quản lý chuỗi thời gian Telemetry"]
        LOGIN["login.html\n- Đăng nhập bảo mật phân quyền đa cấp"]
        
        VIEWS --> DASHBOARD
        VIEWS --> ADMIN
        VIEWS --> LOGIN
        SSE_DISPATCH -.->|Real-time SSE Stream 0ms| DASHBOARD
        SSE_DISPATCH -.->|Real-time Monitor Stream| ADMIN
    end