SAHA-Care

graph TD
    subgraph Client ["Client (Browser)"]
        PWA["React PWA<br/>(Vite + TypeScript)"]
        SW["Service Worker<br/>(Vite PWA Plugin)"]
        Cache["Firestore<br/>Offline Cache"]
        UI["MUI + Leaflet + Recharts"]
        Ctx["React Context<br/>(AuthContext)"]
        Hooks["Custom Hooks<br/>(useReports, useAlerts)"]

        PWA --- UI
        PWA --- Ctx
        PWA --- Hooks
        PWA --- SW
        PWA --- Cache
    end

    subgraph Views ["Role-Based Views"]
        V["Volunteer<br/>Submit Reports"]
        S["Supervisor<br/>Verify, Approve, Maps & Charts"]
        O["Official<br/>Dashboard, Maps & Charts"]
    end

    subgraph Firebase ["Firebase"]
        Hosting["Firebase Hosting<br/>(CDN + SSL)"]
        Auth["Firebase Auth<br/>(Email/Password + Custom Claims)"]
        Firestore[("Firestore DB")]

        subgraph Functions ["Cloud Functions"]
            F1["onUserApproval<br/><i>users/uid onUpdate</i>"]
            F2["onReportWrite<br/><i>reports/id onCreate</i>"]
            F3["aggregateCases<br/><i>reports/id onWrite</i>"]
        end
    end

    subgraph Collections ["Firestore Collections"]
        users["users"]
        reports["reports"]
        caseDefs["caseDefinitions"]
        alerts["alerts"]
        aggregates["aggregates"]
    end

    Hosting -->|serves| PWA
    PWA -->|authenticates| Auth
    Cache <-->|"auto-sync<br/>(online)"| Firestore

    PWA --> Views

    Firestore -->|triggers| F1
    Firestore -->|triggers| F2
    Firestore -->|triggers| F3

    F1 -->|validates & writes| users
    F2 -->|creates| alerts
    F3 -->|updates| aggregates

    Firestore --- Collections
        

erDiagram
    users {
        string uid PK
        string email
        string displayName
        string role "volunteer | supervisor | official"
        string status "pending | approved"
        string supervisorId FK "references users.uid"
        string region
        timestamp createdAt
        timestamp updatedAt
    }

    reports {
        string id PK
        string disease FK "references caseDefinitions.disease"
        array symptoms
        float temp
        float lat
        float lng
        string locationName
        string status "pending | verified | rejected"
        string reporterId FK "references users.uid"
        string verifiedBy FK "references users.uid"
        string region
        timestamp createdAt
        timestamp verifiedAt
    }

    caseDefinitions {
        string id PK
        string disease UK
        json symptoms "symptom checklist"
        array dangerSigns
        string guidance
        boolean active
        int threshold "alert threshold per region"
    }

    alerts {
        string id PK
        string disease FK "references caseDefinitions.disease"
        string region
        int caseCount
        int threshold
        string severity "low | medium | high | critical"
        string status "active | resolved"
        timestamp createdAt
        timestamp resolvedAt
    }

    aggregates {
        string id PK "disease_region_period"
        string disease FK "references caseDefinitions.disease"
        string region
        string period "day | week"
        int caseCount
        int verifiedCount
        timestamp lastUpdated
    }

    users ||--o{ reports : "submits (reporterId)"
    users ||--o{ reports : "verifies (verifiedBy)"
    users ||--o{ users : "supervises (supervisorId)"
    caseDefinitions ||--o{ reports : "defines disease"
    caseDefinitions ||--o{ alerts : "triggers for disease"
    caseDefinitions ||--o{ aggregates : "aggregated by disease"