# ahmedmkofficial/adera architecture

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

- Interactive diagram: https://gitdiagram.com/ahmedmkofficial/adera
- Repository: https://github.com/ahmedmkofficial/adera

## Overview

Adera is a synthetic-data fraud-intelligence platform. Customers authenticate and submit suspicious-payment reports; the backend gathers recipient intelligence, produces explainable risk assessments and alerts, and analysts review alerts, investigate entities and relationships, and manage cases. The frontend exposes customer and analyst routes, while backend API modules provide the domain operations and SQLAlchemy models represent persistent records. The README establishes the product workflow and capabilities; unsampled route implementations and frontend-to-backend wiring limit which detailed calls can be shown, so uncertain integration is dashed.

Main entry points: [`backend/main.py`](https://github.com/ahmedmkofficial/adera/blob/main/backend/main.py) (API application), [`adera-frontend/src/services/api.js`](https://github.com/ahmedmkofficial/adera/blob/main/adera-frontend/src/services/api.js) (Web API client), [`adera-frontend/src/App.jsx`](https://github.com/ahmedmkofficial/adera/blob/main/adera-frontend/src/App.jsx) (Application routes), [`backend/api/risk.py`](https://github.com/ahmedmkofficial/adera/blob/main/backend/api/risk.py) (Risk API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_routes["Application routes<br/>[App.jsx]"]
  node_customer_views["Reporting views<br/>[ReportPage.jsx]"]
  node_analyst_views["Analyst views"]
  node_case_view["Case details<br/>[CasePage.jsx]"]
  node_web_api["Web API client<br/>[api.js]"]
end

subgraph group_access["Identity and API"]
  node_auth_ui["Session context<br/>[AuthProvider.jsx]"]
  node_auth_api["Authentication API<br/>[auth.py]"]
  node_security["Token security<br/>[security.py]"]
  node_api_app["API application<br/>[main.py]"]
end

subgraph group_intelligence["Fraud intelligence"]
  node_report_api["Report API<br/>[reports.py]"]
  node_risk_api["Risk API<br/>[risk.py]"]
  node_risk_engine["Explainable risk engine<br/>[risk_engine.py]"]
  node_recipient_api["Recipient API<br/>[recipients.py]"]
  node_fraud_intel["Recipient intelligence"]
  node_graph_service["Relationship graph<br/>[recipient_graph.py]"]
end

subgraph group_investigation["Analyst investigation"]
  node_alerts_api["Alerts API<br/>[alerts.py]"]
  node_cases_api["Case management API<br/>[cases.py]"]
  node_case_service["Case operations<br/>[case_service.py]"]
  node_alert_service["Alert operations<br/>[alert_service.py]"]
end

subgraph group_persistence["Persistent data"]
  node_models[("Domain records")]
  node_database[("Database session<br/>[session.py]")]
end

node_customer(("Customer"))
node_analyst(("Fraud analyst"))

node_customer -->|"uses"| node_routes
node_analyst -->|"uses"| node_routes
node_routes -->|"routes to"| node_customer_views
node_routes -->|"routes to"| node_analyst_views
node_routes -->|"routes to"| node_case_view
node_case_view -->|"calls"| node_web_api
node_auth_ui -->|"calls"| node_web_api
node_web_api -.->|"requests"| node_auth_api
node_web_api -.->|"requests"| node_report_api
node_web_api -.->|"requests"| node_risk_api
node_web_api -.->|"requests"| node_recipient_api
node_api_app -->|"registers"| node_auth_api
node_api_app -->|"registers"| node_risk_api
node_api_app -->|"registers"| node_report_api
node_api_app -->|"registers"| node_recipient_api
node_api_app -->|"registers"| node_alerts_api
node_api_app -->|"registers"| node_cases_api
node_auth_api -->|"uses"| node_security
node_auth_api -->|"depends on"| node_database
node_risk_api -->|"uses"| node_risk_engine
node_risk_api -->|"uses"| node_fraud_intel
node_risk_api -->|"creates alerts"| node_alert_service
node_recipient_api -->|"uses"| node_fraud_intel
node_recipient_api -->|"uses"| node_graph_service
node_recipient_api -->|"uses"| node_risk_engine
node_alerts_api -->|"uses"| node_alert_service
node_cases_api -->|"uses"| node_case_service
node_cases_api -->|"uses"| node_alert_service
node_fraud_intel -->|"queries"| node_models
node_alert_service -->|"reads and writes"| node_models
node_case_service -->|"uses"| node_models
node_database -.->|"persists"| node_models

click node_routes "https://github.com/ahmedmkofficial/adera/blob/main/adera-frontend/src/App.jsx"
click node_customer_views "https://github.com/ahmedmkofficial/adera/blob/main/adera-frontend/src/pages/ReportPage.jsx"
click node_analyst_views "https://github.com/ahmedmkofficial/adera/blob/main/adera-frontend/src/pages/InvestigationPage.jsx"
click node_case_view "https://github.com/ahmedmkofficial/adera/blob/main/adera-frontend/src/pages/CasePage.jsx"
click node_web_api "https://github.com/ahmedmkofficial/adera/blob/main/adera-frontend/src/services/api.js"
click node_auth_ui "https://github.com/ahmedmkofficial/adera/blob/main/adera-frontend/src/auth/AuthProvider.jsx"
click node_auth_api "https://github.com/ahmedmkofficial/adera/blob/main/backend/api/auth.py"
click node_security "https://github.com/ahmedmkofficial/adera/blob/main/backend/auth/security.py"
click node_report_api "https://github.com/ahmedmkofficial/adera/blob/main/backend/api/reports.py"
click node_risk_api "https://github.com/ahmedmkofficial/adera/blob/main/backend/api/risk.py"
click node_risk_engine "https://github.com/ahmedmkofficial/adera/blob/main/backend/services/risk_engine.py"
click node_recipient_api "https://github.com/ahmedmkofficial/adera/blob/main/backend/api/recipients.py"
click node_fraud_intel "https://github.com/ahmedmkofficial/adera/blob/main/backend/services/fraud_intelligence.py"
click node_graph_service "https://github.com/ahmedmkofficial/adera/blob/main/backend/services/recipient_graph.py"
click node_alerts_api "https://github.com/ahmedmkofficial/adera/blob/main/backend/api/alerts.py"
click node_cases_api "https://github.com/ahmedmkofficial/adera/blob/main/backend/api/cases.py"
click node_case_service "https://github.com/ahmedmkofficial/adera/blob/main/backend/services/case_service.py"
click node_alert_service "https://github.com/ahmedmkofficial/adera/blob/main/backend/services/alert_service.py"
click node_models "https://github.com/ahmedmkofficial/adera/tree/main/backend/models"
click node_database "https://github.com/ahmedmkofficial/adera/blob/main/backend/database/session.py"
click node_api_app "https://github.com/ahmedmkofficial/adera/blob/main/backend/main.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_routes,node_customer_views,node_analyst_views,node_case_view,node_web_api toneBlue
class node_auth_ui,node_auth_api,node_security,node_api_app toneAmber
class node_report_api,node_risk_api,node_risk_engine,node_recipient_api,node_fraud_intel,node_graph_service toneMint
class node_alerts_api,node_cases_api,node_case_service,node_alert_service toneRose
class node_models,node_database,node_customer,node_analyst toneIndigo
```

## Components

### Web application

- [Application routes](https://github.com/ahmedmkofficial/adera/blob/main/adera-frontend/src/App.jsx): `adera-frontend/src/App.jsx`
- [Reporting views](https://github.com/ahmedmkofficial/adera/blob/main/adera-frontend/src/pages/ReportPage.jsx): `adera-frontend/src/pages/ReportPage.jsx`
- [Analyst views](https://github.com/ahmedmkofficial/adera/blob/main/adera-frontend/src/pages/InvestigationPage.jsx): `adera-frontend/src/pages/InvestigationPage.jsx`
- [Case details](https://github.com/ahmedmkofficial/adera/blob/main/adera-frontend/src/pages/CasePage.jsx): `adera-frontend/src/pages/CasePage.jsx`
- [Web API client](https://github.com/ahmedmkofficial/adera/blob/main/adera-frontend/src/services/api.js): `adera-frontend/src/services/api.js`

### Identity and API

- [Session context](https://github.com/ahmedmkofficial/adera/blob/main/adera-frontend/src/auth/AuthProvider.jsx): `adera-frontend/src/auth/AuthProvider.jsx`
- [Authentication API](https://github.com/ahmedmkofficial/adera/blob/main/backend/api/auth.py): `backend/api/auth.py`
- [Token security](https://github.com/ahmedmkofficial/adera/blob/main/backend/auth/security.py): `backend/auth/security.py`
- [API application](https://github.com/ahmedmkofficial/adera/blob/main/backend/main.py): `backend/main.py`

### Fraud intelligence

- [Report API](https://github.com/ahmedmkofficial/adera/blob/main/backend/api/reports.py): `backend/api/reports.py`
- [Risk API](https://github.com/ahmedmkofficial/adera/blob/main/backend/api/risk.py): `backend/api/risk.py`
- [Explainable risk engine](https://github.com/ahmedmkofficial/adera/blob/main/backend/services/risk_engine.py): `backend/services/risk_engine.py`
- [Recipient API](https://github.com/ahmedmkofficial/adera/blob/main/backend/api/recipients.py): `backend/api/recipients.py`
- [Recipient intelligence](https://github.com/ahmedmkofficial/adera/blob/main/backend/services/fraud_intelligence.py): `backend/services/fraud_intelligence.py`
- [Relationship graph](https://github.com/ahmedmkofficial/adera/blob/main/backend/services/recipient_graph.py): `backend/services/recipient_graph.py`

### Analyst investigation

- [Alerts API](https://github.com/ahmedmkofficial/adera/blob/main/backend/api/alerts.py): `backend/api/alerts.py`
- [Case management API](https://github.com/ahmedmkofficial/adera/blob/main/backend/api/cases.py): `backend/api/cases.py`
- [Case operations](https://github.com/ahmedmkofficial/adera/blob/main/backend/services/case_service.py): `backend/services/case_service.py`
- [Alert operations](https://github.com/ahmedmkofficial/adera/blob/main/backend/services/alert_service.py): `backend/services/alert_service.py`

### Persistent data

- [Domain records](https://github.com/ahmedmkofficial/adera/tree/main/backend/models): `backend/models`
- [Database session](https://github.com/ahmedmkofficial/adera/blob/main/backend/database/session.py): `backend/database/session.py`

### Other components

- **Customer**
- **Fraud analyst**

## Connections

- Customer → Application routes: uses (evidence: `adera-frontend/src/App.jsx`)
- Fraud analyst → Application routes: uses (evidence: `adera-frontend/src/App.jsx`)
- Application routes → Reporting views: routes to (evidence: `adera-frontend/src/App.jsx`)
- Application routes → Analyst views: routes to (evidence: `adera-frontend/src/App.jsx`)
- Application routes → Case details: routes to (evidence: `adera-frontend/src/App.jsx`)
- Case details → Web API client: calls (evidence: `adera-frontend/src/pages/CasePage.jsx`)
- Session context → Web API client: calls (evidence: `adera-frontend/src/auth/AuthProvider.jsx`)
- Web API client → Authentication API: requests
- Web API client → Report API: requests
- Web API client → Risk API: requests
- Web API client → Recipient API: requests
- API application → Authentication API: registers (evidence: `backend/main.py`)
- API application → Risk API: registers (evidence: `backend/main.py`)
- API application → Report API: registers (evidence: `backend/main.py`)
- API application → Recipient API: registers (evidence: `backend/main.py`)
- API application → Alerts API: registers (evidence: `backend/main.py`)
- API application → Case management API: registers (evidence: `backend/main.py`)
- Authentication API → Token security: uses (evidence: `backend/api/auth.py`)
- Authentication API → Database session: depends on (evidence: `backend/api/auth.py`)
- Risk API → Explainable risk engine: uses (evidence: `backend/api/risk.py`)
- Risk API → Recipient intelligence: uses (evidence: `backend/api/risk.py`)
- Risk API → Alert operations: creates alerts (evidence: `backend/api/risk.py`)
- Recipient API → Recipient intelligence: uses (evidence: `backend/api/recipients.py`)
- Recipient API → Relationship graph: uses (evidence: `backend/api/recipients.py`)
- Recipient API → Explainable risk engine: uses (evidence: `backend/api/recipients.py`)
- Alerts API → Alert operations: uses (evidence: `backend/api/alerts.py`)
- Case management API → Case operations: uses (evidence: `backend/api/cases.py`)
- Case management API → Alert operations: uses (evidence: `backend/api/cases.py`)
- Recipient intelligence → Domain records: queries (evidence: `backend/services/fraud_intelligence.py`)
- Alert operations → Domain records: reads and writes (evidence: `backend/services/alert_service.py`)
- Case operations → Domain records: uses (evidence: `backend/services/case_service.py`)
- Database session → Domain records: persists
