# razzikk09-zikzik/meiveliaz architecture

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

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

## Overview

MEYVIZHI is a scam-detection and cyber-intelligence application: users submit suspicious content, receive a risk assessment, and can browse or submit community reports and active threats. The backend combines heuristic, AI, URL-reputation, and graph signals; it also exposes analyst authentication and report services. The README describes only a Vite template and does not document product capabilities, so the map relies on the supplied source index and excerpts; frontend-to-backend API calls are not shown and are left unverified.

Main entry points: [`backend/app/routes/analyze.py`](https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/routes/analyze.py) (Analyze endpoint), [`backend/app/main.py`](https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/main.py) (FastAPI application), [`src/pages/HomePage.jsx`](https://github.com/razzikk09-zikzik/meiveliaz/blob/main/src/pages/HomePage.jsx) (Scam-check home), [`src/App.jsx`](https://github.com/razzikk09-zikzik/meiveliaz/blob/main/src/App.jsx) (App router)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["App router<br/>[App.jsx]"]
  node_home["Scam-check home<br/>[HomePage.jsx]"]
  node_result["Analysis result<br/>[ResultPage.jsx]"]
  node_analyze_client["Analysis client<br/>[analyze.js]"]
  node_report_page["Report submission<br/>[ReportPage.jsx]"]
  node_threats_page["Threat explorer<br/>[ThreatsPage.jsx]"]
  node_scam_map["Scam map<br/>[ScamMap.jsx]"]
  node_mock_data["Example and map data<br/>[mock.js]"]
end

subgraph group_api["API routes"]
  node_api["FastAPI application<br/>[main.py]"]
  node_analyze_route["Analyze endpoint<br/>[analyze.py]"]
  node_reports_route["Reports endpoint<br/>[reports.py]"]
  node_threats_route["Threats endpoint<br/>[threats.py]"]
  node_auth_route["Analyst login<br/>[auth.py]"]
  node_analyze_schema["Analysis schema<br/>[analyze.py]"]
  node_report_schema["Report schema<br/>[report.py]"]
end

subgraph group_analysis["Scam analysis"]
  node_heuristics["Heuristic signals"]
  node_risk["Risk fusion<br/>[risk_engine.py]"]
  node_gemini["AI analysis<br/>[gemini_service.py]"]
  node_ocr["Image text extraction<br/>[ocr_service.py]"]
  node_virustotal["URL reputation"]
end

subgraph group_community["Community intelligence"]
  node_graph_service["Graph intelligence<br/>[neo4j_service.py]"]
  node_supabase_service["Report and auth service"]
end

subgraph group_support["Shared services"]
  node_text_utils["Text utilities<br/>[text_utils.py]"]
  node_url_utils["URL utilities<br/>[url_utils.py]"]
end

node_user(("App user"))
node_neo4j[("Neo4j")]
node_supabase[("Supabase")]
node_gemini_api["Gemini API"]
node_vt_api["VirusTotal API"]

node_user -->|"submits content"| node_home
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_result
node_app -->|"routes to"| node_report_page
node_app -->|"routes to"| node_threats_page
node_home -->|"navigates to"| node_result
node_result -->|"uses"| node_analyze_client
node_home -->|"renders"| node_scam_map
node_home -->|"reads"| node_mock_data
node_scam_map -.->|"uses map data"| node_mock_data
node_analyze_client -.->|"calls API"| node_api
node_report_page -.->|"submits report"| node_api
node_threats_page -.->|"loads threats"| node_api
node_api -->|"registers"| node_analyze_route
node_api -->|"registers"| node_reports_route
node_api -->|"registers"| node_threats_route
node_api -->|"registers"| node_auth_route
node_analyze_route -->|"uses"| node_analyze_schema
node_analyze_route -->|"evaluates"| node_heuristics
node_analyze_route -->|"combines signals"| node_risk
node_analyze_route -->|"requests analysis"| node_gemini
node_analyze_route -->|"checks URLs"| node_virustotal
node_analyze_route -->|"checks relationships"| node_graph_service
node_analyze_route -->|"extracts image text"| node_ocr
node_heuristics -->|"uses"| node_text_utils
node_heuristics -->|"uses"| node_url_utils
node_risk -->|"uses weights"| node_heuristics
node_gemini -.->|"queries"| node_gemini_api
node_virustotal -.->|"checks reputation"| node_vt_api
node_reports_route -->|"uses"| node_report_schema
node_reports_route -->|"persists and lists"| node_supabase_service
node_reports_route -->|"uses graph"| node_graph_service
node_threats_route -->|"loads reports"| node_supabase_service
node_auth_route -->|"authenticates"| node_supabase_service
node_graph_service -->|"queries graph"| node_neo4j
node_supabase_service -->|"uses REST and Auth"| node_supabase

click node_app "https://github.com/razzikk09-zikzik/meiveliaz/blob/main/src/App.jsx"
click node_home "https://github.com/razzikk09-zikzik/meiveliaz/blob/main/src/pages/HomePage.jsx"
click node_result "https://github.com/razzikk09-zikzik/meiveliaz/blob/main/src/pages/ResultPage.jsx"
click node_analyze_client "https://github.com/razzikk09-zikzik/meiveliaz/blob/main/src/utils/analyze.js"
click node_report_page "https://github.com/razzikk09-zikzik/meiveliaz/blob/main/src/pages/ReportPage.jsx"
click node_threats_page "https://github.com/razzikk09-zikzik/meiveliaz/blob/main/src/pages/ThreatsPage.jsx"
click node_scam_map "https://github.com/razzikk09-zikzik/meiveliaz/blob/main/src/components/ScamMap.jsx"
click node_mock_data "https://github.com/razzikk09-zikzik/meiveliaz/blob/main/src/data/mock.js"
click node_api "https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/main.py"
click node_analyze_route "https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/routes/analyze.py"
click node_reports_route "https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/routes/reports.py"
click node_threats_route "https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/routes/threats.py"
click node_auth_route "https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/routes/auth.py"
click node_analyze_schema "https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/schemas/analyze.py"
click node_report_schema "https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/schemas/report.py"
click node_heuristics "https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/services/heuristic_engine.py"
click node_risk "https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/services/risk_engine.py"
click node_gemini "https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/services/gemini_service.py"
click node_ocr "https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/services/ocr_service.py"
click node_virustotal "https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/services/virustotal_service.py"
click node_text_utils "https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/utils/text_utils.py"
click node_url_utils "https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/utils/url_utils.py"
click node_graph_service "https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/services/neo4j_service.py"
click node_supabase_service "https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/services/supabase_service.py"

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_analyze_client,node_report_page,node_threats_page,node_scam_map,node_mock_data,node_user toneBlue
class node_api,node_analyze_route,node_reports_route,node_threats_route,node_auth_route,node_analyze_schema,node_report_schema,node_neo4j,node_supabase toneAmber
class node_heuristics,node_risk,node_gemini,node_ocr,node_virustotal,node_gemini_api,node_vt_api toneMint
class node_graph_service,node_supabase_service toneRose
class node_text_utils,node_url_utils toneIndigo
```

## Components

### Web application

- [App router](https://github.com/razzikk09-zikzik/meiveliaz/blob/main/src/App.jsx): `src/App.jsx`
- [Scam-check home](https://github.com/razzikk09-zikzik/meiveliaz/blob/main/src/pages/HomePage.jsx): `src/pages/HomePage.jsx`
- [Analysis result](https://github.com/razzikk09-zikzik/meiveliaz/blob/main/src/pages/ResultPage.jsx): `src/pages/ResultPage.jsx`
- [Analysis client](https://github.com/razzikk09-zikzik/meiveliaz/blob/main/src/utils/analyze.js): `src/utils/analyze.js`
- [Report submission](https://github.com/razzikk09-zikzik/meiveliaz/blob/main/src/pages/ReportPage.jsx): `src/pages/ReportPage.jsx`
- [Threat explorer](https://github.com/razzikk09-zikzik/meiveliaz/blob/main/src/pages/ThreatsPage.jsx): `src/pages/ThreatsPage.jsx`
- [Scam map](https://github.com/razzikk09-zikzik/meiveliaz/blob/main/src/components/ScamMap.jsx): `src/components/ScamMap.jsx`
- [Example and map data](https://github.com/razzikk09-zikzik/meiveliaz/blob/main/src/data/mock.js): `src/data/mock.js`

### API routes

- [FastAPI application](https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/main.py): `backend/app/main.py`
- [Analyze endpoint](https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/routes/analyze.py): `backend/app/routes/analyze.py`
- [Reports endpoint](https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/routes/reports.py): `backend/app/routes/reports.py`
- [Threats endpoint](https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/routes/threats.py): `backend/app/routes/threats.py`
- [Analyst login](https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/routes/auth.py): `backend/app/routes/auth.py`
- [Analysis schema](https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/schemas/analyze.py): `backend/app/schemas/analyze.py`
- [Report schema](https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/schemas/report.py): `backend/app/schemas/report.py`

### Scam analysis

- [Heuristic signals](https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/services/heuristic_engine.py): `backend/app/services/heuristic_engine.py`
- [Risk fusion](https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/services/risk_engine.py): `backend/app/services/risk_engine.py`
- [AI analysis](https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/services/gemini_service.py): `backend/app/services/gemini_service.py`
- [Image text extraction](https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/services/ocr_service.py): `backend/app/services/ocr_service.py`
- [URL reputation](https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/services/virustotal_service.py): `backend/app/services/virustotal_service.py`

### Community intelligence

- [Graph intelligence](https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/services/neo4j_service.py): `backend/app/services/neo4j_service.py`
- [Report and auth service](https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/services/supabase_service.py): `backend/app/services/supabase_service.py`

### Shared services

- [Text utilities](https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/utils/text_utils.py): `backend/app/utils/text_utils.py`
- [URL utilities](https://github.com/razzikk09-zikzik/meiveliaz/blob/main/backend/app/utils/url_utils.py): `backend/app/utils/url_utils.py`

### Other components

- **App user**
- **Neo4j**
- **Supabase**
- **Gemini API**
- **VirusTotal API**

## Connections

- App user → Scam-check home: submits content (evidence: `src/pages/HomePage.jsx`)
- App router → Scam-check home: routes to (evidence: `src/App.jsx`)
- App router → Analysis result: routes to (evidence: `src/App.jsx`)
- App router → Report submission: routes to (evidence: `src/App.jsx`)
- App router → Threat explorer: routes to (evidence: `src/App.jsx`)
- Scam-check home → Analysis result: navigates to (evidence: `src/pages/HomePage.jsx`)
- Analysis result → Analysis client: uses (evidence: `src/pages/ResultPage.jsx`)
- Scam-check home → Scam map: renders (evidence: `src/pages/HomePage.jsx`)
- Scam-check home → Example and map data: reads (evidence: `src/pages/HomePage.jsx`)
- Scam map → Example and map data: uses map data
- Analysis client → FastAPI application: calls API
- Report submission → FastAPI application: submits report
- Threat explorer → FastAPI application: loads threats
- FastAPI application → Analyze endpoint: registers (evidence: `backend/app/main.py`)
- FastAPI application → Reports endpoint: registers (evidence: `backend/app/main.py`)
- FastAPI application → Threats endpoint: registers (evidence: `backend/app/main.py`)
- FastAPI application → Analyst login: registers (evidence: `backend/app/main.py`)
- Analyze endpoint → Analysis schema: uses (evidence: `backend/app/routes/analyze.py`)
- Analyze endpoint → Heuristic signals: evaluates (evidence: `backend/app/routes/analyze.py`)
- Analyze endpoint → Risk fusion: combines signals (evidence: `backend/app/routes/analyze.py`)
- Analyze endpoint → AI analysis: requests analysis (evidence: `backend/app/routes/analyze.py`)
- Analyze endpoint → URL reputation: checks URLs (evidence: `backend/app/routes/analyze.py`)
- Analyze endpoint → Graph intelligence: checks relationships (evidence: `backend/app/routes/analyze.py`)
- Analyze endpoint → Image text extraction: extracts image text (evidence: `backend/app/routes/analyze.py`)
- Heuristic signals → Text utilities: uses (evidence: `backend/app/services/heuristic_engine.py`)
- Heuristic signals → URL utilities: uses (evidence: `backend/app/services/heuristic_engine.py`)
- Risk fusion → Heuristic signals: uses weights (evidence: `backend/app/services/risk_engine.py`)
- AI analysis → Gemini API: queries
- URL reputation → VirusTotal API: checks reputation
- Reports endpoint → Report schema: uses (evidence: `backend/app/routes/reports.py`)
- Reports endpoint → Report and auth service: persists and lists (evidence: `backend/app/routes/reports.py`)
- Reports endpoint → Graph intelligence: uses graph (evidence: `backend/app/routes/reports.py`)
- Threats endpoint → Report and auth service: loads reports (evidence: `backend/app/routes/threats.py`)
- Analyst login → Report and auth service: authenticates (evidence: `backend/app/routes/auth.py`)
- Graph intelligence → Neo4j: queries graph (evidence: `backend/app/services/neo4j_service.py`)
- Report and auth service → Supabase: uses REST and Auth (evidence: `backend/app/services/supabase_service.py`)
