🇿🇦 SUMBANDILA

graph TD
    subgraph "🌐 Frontend — Next.js 16 (Turbopack)"
        A[Landing App<br/>apps/landing] --> B[Public Homepage]
        A --> C[Verify Portal]
        A --> D[Apply: NSFAS / SASSA]
        A --> E[Skills Hub]
        A --> F[Opportunities]
        A --> G[Admin Portal]
        A --> H[Sipho AI Page]
        W[Web App<br/>apps/web] --> I[Dashboard]
        W --> J[Registry Search]
    end

    subgraph "⚙️ Backend Services"
        K[FastAPI Core<br/>services/core] --> L[(PostgreSQL DB)]
        K --> M[(Redis Cache)]
        K --> N[AI Trust Engine]
    end

    subgraph "🐍 Python Scripts"
        O[dhet_collector.py<br/>pdfplumber] --> L
        P[live_scraper_service.py<br/>Playwright] --> L
        Q[sentinel_heartbeat.py] --> R[Alert System]
    end

    A -->|REST API| K
    W -->|REST API| K
    N --> S[Fraud Score 0–100%]
    N --> T[SHA-256 Credential Hash]

flowchart LR
    Start([🧑 Citizen visits\nlanding-five-orcin-61.vercel.app]) --> Home[Homepage\nHero + Services]
    Home --> Choice{What do\nyou need?}

    Choice -->|Student| NSFAS[Apply for NSFAS\n/apply/nsfas]
    Choice -->|Grant| SASSA[Apply for SASSA\n/apply/sassa]
    Choice -->|Job| Opp[Browse Opportunities\n/opportunities]
    Choice -->|Learning| Skills[Skills Hub\n/skills]
    Choice -->|Health| Clinic[Find a Clinic\n/services/clinics]
    Choice -->|Check legitimacy| Verify[Verify Institution\n/verify]

    Verify --> Engine[National Verification\nEngine]
    Engine --> Result{Result}
    Result -->|✅ GREEN| Safe[Verified — Safe to Enrol]
    Result -->|🟡 YELLOW| Caution[Caution — Check Accreditation]
    Result -->|🔴 RED| Danger[Danger — Fraudulent Entity]

    NSFAS --> Dashboard[User Dashboard\n/dashboard]
    SASSA --> Dashboard
    Opp --> Dashboard
    Skills --> Dashboard

graph LR
    Search([🔍 Search\nInstitution / Practitioner]) --> Check{Registry\nCheck}
    Check -->|Registered + Accredited| Green["✅ GREEN\nSafe to Enrol / Trust"]
    Check -->|Registered but Unaccredited| Yellow["🟡 YELLOW\nVerify Course Scope"]
    Check -->|Cancelled / Suspended| Red["🔴 RED\nDo NOT Proceed"]
    Check -->|Not Found| Grey["⬜ UNKNOWN\nReport to Sumbandila"]

    style Green fill:#007749,color:#fff
    style Yellow fill:#FFB81C,color:#000
    style Red fill:#E03C31,color:#fff
    style Grey fill:#64748b,color:#fff

graph LR
    subgraph Frontend
        NX[Next.js 16 + Turbopack]
        RC[React 19]
        TW[Tailwind CSS]
        LC[Lucide React Icons]
    end
    subgraph Backend
        FA[FastAPI v4]
        PY[Python 3.11]
        PG[PostgreSQL]
        RD[Redis]
    end
    subgraph Data Pipeline
        PB[pdfplumber — PDF parsing]
        PL[Playwright — Live scraping]
        SC[sentinel_heartbeat.py]
    end
    subgraph Deployment
        VC[Vercel — Frontend]
        DK[Docker — Backend]
        GH[GitHub Actions — CI/CD]
    end
    NX --> FA
    FA --> PG
    FA --> RD
    PB --> PG
    PL --> PG
    NX --> VC
    FA --> DK