# razzikk09-zikzik/meiveli-ngem architecture

> Architecture diagram of the GitHub repository razzikk09-zikzik/meiveli-ngem, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/razzikk09-zikzik/meiveli-ngem
- Repository: https://github.com/razzikk09-zikzik/meiveli-ngem

## Overview

Meiveli-NGEM is a citizen scam-checking and community threat-reporting app with an analyst review console. Citizens check messages or URLs, submit reports, and browse local alerts; analysts review and override reports before eligible threats appear on public maps. The intelligence layer parses domains and checks trusted-domain, impersonation, and scam-pattern signals. The graph preserves documented checking, reporting, review, and map-filtering capabilities. Some page behavior and integrations are unsampled, so only documented or indexed relationships are connected.

Main entry points: [`src/App.jsx`](https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/App.jsx) (Responsive router), [`src/pages/AnalystDashboard.jsx`](https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/pages/AnalystDashboard.jsx) (Analyst console), [`src/utils/supabase.js`](https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/utils/supabase.js) (Supabase client), [`src/hooks/useHotspots.js`](https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/hooks/useHotspots.js) (Report filtering)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and guidance"]
  node_app["Responsive router<br/>[App.jsx]"]
  node_home["Safety checker<br/>[HomePage.jsx]"]
  node_result["Check results<br/>[ResultPage.jsx]"]
  node_guide["Safety guidance<br/>[GuidePage.jsx]"]
  node_help["Help resources<br/>[HelpPage.jsx]"]
  node_language["Language state"]
  node_translations["Translations<br/>[translations.js]"]
end

subgraph group_intelligence["Threat intelligence"]
  node_analysis["Check analysis<br/>[analyze.js]"]
  node_domain["Domain intelligence<br/>[domainAnalyzer.js]"]
  node_trusted["Trusted-domain lists<br/>[trustedDomains.js]"]
  node_patterns["Scam patterns<br/>[scamPatterns.js]"]
end

subgraph group_reporting["Reports and review"]
  node_report["Citizen reporting<br/>[ReportPage.jsx]"]
  node_analystui["Analyst console"]
  node_login["Analyst login<br/>[AnalystLogin.jsx]"]
  node_supaclient["Supabase client<br/>[supabase.js]"]
  node_database[("Supabase database")]
end

subgraph group_publicmap["Threat map"]
  node_hotspots["Report filtering<br/>[useHotspots.js]"]
  node_threats["Active threats<br/>[ThreatsPage.jsx]"]
  node_map["Threat map<br/>[ThreatMap.jsx]"]
  node_network["Campaign network<br/>[NetworkGraph.jsx]"]
end

node_citizen(("Citizen"))
node_analyst(("Analyst"))

node_citizen -->|"opens app"| node_app
node_analyst -->|"opens console"| node_app
node_app -->|"routes mobile"| node_home
node_app -->|"routes mobile"| node_result
node_app -->|"routes mobile"| node_report
node_app -->|"routes mobile"| node_threats
node_app -->|"routes mobile"| node_guide
node_app -->|"routes mobile"| node_help
node_app -->|"routes desktop"| node_analystui
node_app -->|"routes desktop"| node_login
node_app -->|"provides language"| node_language
node_language -->|"looks up text"| node_translations
node_result -->|"analyzes input"| node_analysis
node_analysis -->|"checks domains"| node_domain
node_analysis -->|"checks patterns"| node_patterns
node_domain -->|"checks domain lists"| node_trusted
node_report -->|"classifies report"| node_domain
node_report -->|"saves report"| node_supaclient
node_result -->|"logs check"| node_supaclient
node_analystui -->|"updates review"| node_supaclient
node_analystui -->|"loads reports"| node_hotspots
node_analystui -->|"renders hotspots"| node_map
node_analystui -->|"renders campaigns"| node_network
node_home -->|"loads alerts"| node_hotspots
node_home -->|"renders hotspots"| node_map
node_threats -->|"loads threats"| node_hotspots
node_threats -->|"renders hotspots"| node_map
node_hotspots -->|"fetches and subscribes"| node_supaclient
node_supaclient -->|"connects"| node_database

click node_app "https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/App.jsx"
click node_home "https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/pages/HomePage.jsx"
click node_result "https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/pages/ResultPage.jsx"
click node_guide "https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/pages/GuidePage.jsx"
click node_help "https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/pages/HelpPage.jsx"
click node_language "https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/context/LanguageContext.jsx"
click node_translations "https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/utils/translations.js"
click node_report "https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/pages/ReportPage.jsx"
click node_analysis "https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/utils/analyze.js"
click node_domain "https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/utils/domainAnalyzer.js"
click node_trusted "https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/utils/trustedDomains.js"
click node_patterns "https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/utils/scamPatterns.js"
click node_analystui "https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/pages/AnalystDashboard.jsx"
click node_login "https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/pages/AnalystLogin.jsx"
click node_hotspots "https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/hooks/useHotspots.js"
click node_threats "https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/pages/ThreatsPage.jsx"
click node_map "https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/components/ThreatMap.jsx"
click node_network "https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/components/NetworkGraph.jsx"
click node_supaclient "https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/utils/supabase.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_home,node_result,node_guide,node_help,node_language,node_translations toneBlue
class node_analysis,node_domain,node_trusted,node_patterns toneAmber
class node_report,node_analystui,node_login,node_supaclient,node_database toneMint
class node_hotspots,node_threats,node_map,node_network toneRose
class node_citizen,node_analyst toneIndigo
```

## Components

### App and guidance

- [Responsive router](https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/App.jsx): `src/App.jsx`
- [Safety checker](https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/pages/HomePage.jsx): `src/pages/HomePage.jsx`
- [Check results](https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/pages/ResultPage.jsx): `src/pages/ResultPage.jsx`
- [Safety guidance](https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/pages/GuidePage.jsx): `src/pages/GuidePage.jsx`
- [Help resources](https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/pages/HelpPage.jsx): `src/pages/HelpPage.jsx`
- [Language state](https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/context/LanguageContext.jsx): `src/context/LanguageContext.jsx`
- [Translations](https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/utils/translations.js): `src/utils/translations.js`

### Threat intelligence

- [Check analysis](https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/utils/analyze.js): `src/utils/analyze.js`
- [Domain intelligence](https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/utils/domainAnalyzer.js): `src/utils/domainAnalyzer.js`
- [Trusted-domain lists](https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/utils/trustedDomains.js): `src/utils/trustedDomains.js`
- [Scam patterns](https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/utils/scamPatterns.js): `src/utils/scamPatterns.js`

### Reports and review

- [Citizen reporting](https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/pages/ReportPage.jsx): `src/pages/ReportPage.jsx`
- [Analyst console](https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/pages/AnalystDashboard.jsx): `src/pages/AnalystDashboard.jsx`
- [Analyst login](https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/pages/AnalystLogin.jsx): `src/pages/AnalystLogin.jsx`
- [Supabase client](https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/utils/supabase.js): `src/utils/supabase.js`
- **Supabase database**

### Threat map

- [Report filtering](https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/hooks/useHotspots.js): `src/hooks/useHotspots.js`
- [Active threats](https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/pages/ThreatsPage.jsx): `src/pages/ThreatsPage.jsx`
- [Threat map](https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/components/ThreatMap.jsx): `src/components/ThreatMap.jsx`
- [Campaign network](https://github.com/razzikk09-zikzik/meiveli-ngem/blob/main/src/components/NetworkGraph.jsx): `src/components/NetworkGraph.jsx`

### Other components

- **Citizen**
- **Analyst**

## Connections

- Citizen → Responsive router: opens app (evidence: `src/App.jsx`)
- Analyst → Responsive router: opens console (evidence: `src/App.jsx`)
- Responsive router → Safety checker: routes mobile (evidence: `src/App.jsx`)
- Responsive router → Check results: routes mobile (evidence: `src/App.jsx`)
- Responsive router → Citizen reporting: routes mobile (evidence: `src/App.jsx`)
- Responsive router → Active threats: routes mobile (evidence: `src/App.jsx`)
- Responsive router → Safety guidance: routes mobile (evidence: `src/App.jsx`)
- Responsive router → Help resources: routes mobile (evidence: `src/App.jsx`)
- Responsive router → Analyst console: routes desktop (evidence: `src/App.jsx`)
- Responsive router → Analyst login: routes desktop (evidence: `src/App.jsx`)
- Responsive router → Language state: provides language (evidence: `src/App.jsx`)
- Language state → Translations: looks up text (evidence: `src/context/LanguageContext.jsx`)
- Check results → Check analysis: analyzes input (evidence: `src/pages/ResultPage.jsx`)
- Check analysis → Domain intelligence: checks domains (evidence: `src/utils/analyze.js`)
- Check analysis → Scam patterns: checks patterns (evidence: `src/utils/analyze.js`)
- Domain intelligence → Trusted-domain lists: checks domain lists (evidence: `src/utils/domainAnalyzer.js`)
- Citizen reporting → Domain intelligence: classifies report (evidence: `README.md`)
- Citizen reporting → Supabase client: saves report (evidence: `README.md`)
- Check results → Supabase client: logs check (evidence: `src/pages/ResultPage.jsx`)
- Analyst console → Supabase client: updates review (evidence: `src/pages/AnalystDashboard.jsx`)
- Analyst console → Report filtering: loads reports (evidence: `src/pages/AnalystDashboard.jsx`)
- Analyst console → Threat map: renders hotspots (evidence: `src/pages/AnalystDashboard.jsx`)
- Analyst console → Campaign network: renders campaigns (evidence: `src/pages/AnalystDashboard.jsx`)
- Safety checker → Report filtering: loads alerts (evidence: `src/pages/HomePage.jsx`)
- Safety checker → Threat map: renders hotspots (evidence: `src/pages/HomePage.jsx`)
- Active threats → Report filtering: loads threats (evidence: `src/pages/ThreatsPage.jsx`)
- Active threats → Threat map: renders hotspots (evidence: `src/pages/ThreatsPage.jsx`)
- Report filtering → Supabase client: fetches and subscribes (evidence: `src/hooks/useHotspots.js`)
- Supabase client → Supabase database: connects (evidence: `src/utils/supabase.js`)
