# debopom26/praxis_ architecture

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

- Interactive diagram: https://gitdiagram.com/debopom26/praxis_
- Repository: https://github.com/debopom26/praxis_

## Overview

PRAXIS is a real-time voice-scam detection and protection platform, with an Android caller, backend analysis service, and operator dashboard. In the documented workflow, live-call audio is captured, analyzed across speech, voice, context, authenticity, and scam-pattern signals, fused into evidence and scored for risk; clients can then present a warning or analysis result. The graph preserves the documented analysis stages and the sampled backend, mobile, and dashboard components. Several subsystem connections are documented in the README but their implementation was not sampled.

Main entry points: [`backend/src/praxis/main.py`](https://github.com/debopom26/praxis_/blob/main/backend/src/praxis/main.py) (HTTP and socket API), [`backend/src/praxis/db/repository.py`](https://github.com/debopom26/praxis_/blob/main/backend/src/praxis/db/repository.py) (Session repository), [`backend/src/praxis/supplied/engine.py`](https://github.com/debopom26/praxis_/blob/main/backend/src/praxis/supplied/engine.py) (Model inference), [`integrations/android/Praxis_Caller/app/src/main/kotlin/com/praxis/caller/audio/CaptureService.kt`](https://github.com/debopom26/praxis_/blob/main/integrations/android/Praxis_Caller/app/src/main/kotlin/com/praxis/caller/audio/CaptureService.kt) (Audio capture)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mobile["Caller app"]
  node_caller["Caller UI<br/>[MainActivity.kt]"]
  node_telecom["Call handling<br/>[CallManager.kt]"]
  node_capture["Audio capture<br/>[CaptureService.kt]"]
  node_praxis_manager["Praxis connection<br/>[PraxisManager.kt]"]
  node_sdk["Praxis SDK<br/>[PraxisClient.kt]"]
end

subgraph group_service["Analysis service"]
  node_api["HTTP and socket API<br/>[main.py]"]
  node_orchestration["Session orchestration<br/>[orchestration.py]"]
end

subgraph group_analysis["Detection pipeline"]
  node_audio_pipeline["Audio processing<br/>[pipeline.py]"]
  node_supplied_engine["Model inference<br/>[engine.py]"]
  node_evidence_fusion["Evidence fusion<br/>[evidence.py]"]
  node_risk["Risk assessment<br/>[risk.py]"]
  node_policy["Policy decisions<br/>[policy.py]"]
end

subgraph group_state["Data and security"]
  node_contracts["Domain contracts"]
  node_repository["Session repository<br/>[repository.py]"]
  node_database[("Application database<br/>[models.py]")]
  node_privacy["Privacy controls<br/>[privacy.py]"]
  node_security["Authentication<br/>[security.py]"]
end

subgraph group_dashboard["Operations dashboard"]
  node_dashboard_app["Dashboard routing<br/>[App.tsx]"]
  node_dashboard_api["Dashboard API<br/>[praxis.ts]"]
  node_session_directory["Session directory"]
end

node_operator(("Operator"))
node_caller_actor(("Caller"))
node_live_call(("Live conversation"))
node_warning["Risk warning"]

node_caller_actor -->|"uses"| node_caller
node_caller -->|"handles calls"| node_telecom
node_telecom -.->|"enables capture"| node_capture
node_live_call -.->|"provides audio"| node_capture
node_capture -.->|"streams audio"| node_praxis_manager
node_praxis_manager -->|"uses"| node_sdk
node_sdk -.->|"calls service"| node_api
node_api -->|"routes sessions"| node_orchestration
node_live_call -.->|"audio input"| node_audio_pipeline
node_audio_pipeline -.->|"analyzes audio"| node_supplied_engine
node_supplied_engine -->|"fuses signals"| node_evidence_fusion
node_supplied_engine -->|"scores fusion"| node_risk
node_evidence_fusion -.->|"informs policy"| node_policy
node_risk -.->|"produces assessment"| node_warning
node_api -->|"reads sessions"| node_repository
node_repository -->|"reads and writes"| node_database
node_repository -->|"applies controls"| node_privacy
node_repository -->|"checks access"| node_security
node_api -->|"authenticates"| node_security
node_api -->|"uses contracts"| node_contracts
node_operator -->|"uses"| node_dashboard_app
node_dashboard_app -.->|"loads data"| node_dashboard_api
node_session_directory -->|"requests sessions"| node_dashboard_api
node_dashboard_api -.->|"requests data"| node_api

click node_caller "https://github.com/debopom26/praxis_/blob/main/integrations/android/Praxis_Caller/app/src/main/kotlin/com/praxis/caller/MainActivity.kt"
click node_telecom "https://github.com/debopom26/praxis_/blob/main/integrations/android/Praxis_Caller/app/src/main/kotlin/com/praxis/caller/telecom/CallManager.kt"
click node_capture "https://github.com/debopom26/praxis_/blob/main/integrations/android/Praxis_Caller/app/src/main/kotlin/com/praxis/caller/audio/CaptureService.kt"
click node_praxis_manager "https://github.com/debopom26/praxis_/blob/main/integrations/android/Praxis_Caller/app/src/main/kotlin/com/praxis/caller/praxis/PraxisManager.kt"
click node_sdk "https://github.com/debopom26/praxis_/blob/main/android-sdk/praxis/src/main/kotlin/io/praxis/sdk/PraxisClient.kt"
click node_api "https://github.com/debopom26/praxis_/blob/main/backend/src/praxis/main.py"
click node_orchestration "https://github.com/debopom26/praxis_/blob/main/backend/src/praxis/orchestration.py"
click node_audio_pipeline "https://github.com/debopom26/praxis_/blob/main/backend/src/praxis/audio/pipeline.py"
click node_supplied_engine "https://github.com/debopom26/praxis_/blob/main/backend/src/praxis/supplied/engine.py"
click node_evidence_fusion "https://github.com/debopom26/praxis_/blob/main/backend/src/praxis/evidence.py"
click node_risk "https://github.com/debopom26/praxis_/blob/main/backend/src/praxis/risk.py"
click node_policy "https://github.com/debopom26/praxis_/blob/main/backend/src/praxis/policy.py"
click node_contracts "https://github.com/debopom26/praxis_/tree/main/backend/src/praxis/contracts"
click node_repository "https://github.com/debopom26/praxis_/blob/main/backend/src/praxis/db/repository.py"
click node_database "https://github.com/debopom26/praxis_/blob/main/backend/src/praxis/db/models.py"
click node_privacy "https://github.com/debopom26/praxis_/blob/main/backend/src/praxis/privacy.py"
click node_security "https://github.com/debopom26/praxis_/blob/main/backend/src/praxis/security.py"
click node_dashboard_app "https://github.com/debopom26/praxis_/blob/main/praxis-dashboard/src/App.tsx"
click node_dashboard_api "https://github.com/debopom26/praxis_/blob/main/praxis-dashboard/src/api/praxis.ts"
click node_session_directory "https://github.com/debopom26/praxis_/blob/main/praxis-dashboard/src/hooks/useSessionDirectory.ts"

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_caller,node_telecom,node_capture,node_praxis_manager,node_sdk toneBlue
class node_api,node_orchestration toneAmber
class node_audio_pipeline,node_supplied_engine,node_evidence_fusion,node_risk,node_policy toneMint
class node_contracts,node_repository,node_database,node_privacy,node_security toneRose
class node_dashboard_app,node_dashboard_api,node_session_directory,node_operator,node_caller_actor,node_live_call,node_warning toneIndigo
```

## Components

### Caller app

- [Caller UI](https://github.com/debopom26/praxis_/blob/main/integrations/android/Praxis_Caller/app/src/main/kotlin/com/praxis/caller/MainActivity.kt): `integrations/android/Praxis_Caller/app/src/main/kotlin/com/praxis/caller/MainActivity.kt`
- [Call handling](https://github.com/debopom26/praxis_/blob/main/integrations/android/Praxis_Caller/app/src/main/kotlin/com/praxis/caller/telecom/CallManager.kt): `integrations/android/Praxis_Caller/app/src/main/kotlin/com/praxis/caller/telecom/CallManager.kt`
- [Audio capture](https://github.com/debopom26/praxis_/blob/main/integrations/android/Praxis_Caller/app/src/main/kotlin/com/praxis/caller/audio/CaptureService.kt): `integrations/android/Praxis_Caller/app/src/main/kotlin/com/praxis/caller/audio/CaptureService.kt`
- [Praxis connection](https://github.com/debopom26/praxis_/blob/main/integrations/android/Praxis_Caller/app/src/main/kotlin/com/praxis/caller/praxis/PraxisManager.kt): `integrations/android/Praxis_Caller/app/src/main/kotlin/com/praxis/caller/praxis/PraxisManager.kt`
- [Praxis SDK](https://github.com/debopom26/praxis_/blob/main/android-sdk/praxis/src/main/kotlin/io/praxis/sdk/PraxisClient.kt): `android-sdk/praxis/src/main/kotlin/io/praxis/sdk/PraxisClient.kt`

### Analysis service

- [HTTP and socket API](https://github.com/debopom26/praxis_/blob/main/backend/src/praxis/main.py): `backend/src/praxis/main.py`
- [Session orchestration](https://github.com/debopom26/praxis_/blob/main/backend/src/praxis/orchestration.py): `backend/src/praxis/orchestration.py`

### Detection pipeline

- [Audio processing](https://github.com/debopom26/praxis_/blob/main/backend/src/praxis/audio/pipeline.py): `backend/src/praxis/audio/pipeline.py`
- [Model inference](https://github.com/debopom26/praxis_/blob/main/backend/src/praxis/supplied/engine.py): `backend/src/praxis/supplied/engine.py`
- [Evidence fusion](https://github.com/debopom26/praxis_/blob/main/backend/src/praxis/evidence.py): `backend/src/praxis/evidence.py`
- [Risk assessment](https://github.com/debopom26/praxis_/blob/main/backend/src/praxis/risk.py): `backend/src/praxis/risk.py`
- [Policy decisions](https://github.com/debopom26/praxis_/blob/main/backend/src/praxis/policy.py): `backend/src/praxis/policy.py`

### Data and security

- [Domain contracts](https://github.com/debopom26/praxis_/tree/main/backend/src/praxis/contracts): `backend/src/praxis/contracts`
- [Session repository](https://github.com/debopom26/praxis_/blob/main/backend/src/praxis/db/repository.py): `backend/src/praxis/db/repository.py`
- [Application database](https://github.com/debopom26/praxis_/blob/main/backend/src/praxis/db/models.py): `backend/src/praxis/db/models.py`
- [Privacy controls](https://github.com/debopom26/praxis_/blob/main/backend/src/praxis/privacy.py): `backend/src/praxis/privacy.py`
- [Authentication](https://github.com/debopom26/praxis_/blob/main/backend/src/praxis/security.py): `backend/src/praxis/security.py`

### Operations dashboard

- [Dashboard routing](https://github.com/debopom26/praxis_/blob/main/praxis-dashboard/src/App.tsx): `praxis-dashboard/src/App.tsx`
- [Dashboard API](https://github.com/debopom26/praxis_/blob/main/praxis-dashboard/src/api/praxis.ts): `praxis-dashboard/src/api/praxis.ts`
- [Session directory](https://github.com/debopom26/praxis_/blob/main/praxis-dashboard/src/hooks/useSessionDirectory.ts): `praxis-dashboard/src/hooks/useSessionDirectory.ts`

### Other components

- **Operator**
- **Caller**
- **Live conversation**
- **Risk warning**

## Connections

- Caller → Caller UI: uses (evidence: `integrations/android/Praxis_Caller/app/src/main/kotlin/com/praxis/caller/MainActivity.kt`)
- Caller UI → Call handling: handles calls (evidence: `integrations/android/Praxis_Caller/app/src/main/kotlin/com/praxis/caller/MainActivity.kt`)
- Call handling → Audio capture: enables capture
- Live conversation → Audio capture: provides audio
- Audio capture → Praxis connection: streams audio
- Praxis connection → Praxis SDK: uses (evidence: `integrations/android/Praxis_Caller/app/src/main/kotlin/com/praxis/caller/praxis/PraxisManager.kt`)
- Praxis SDK → HTTP and socket API: calls service
- HTTP and socket API → Session orchestration: routes sessions (evidence: `backend/src/praxis/main.py`)
- Live conversation → Audio processing: audio input
- Audio processing → Model inference: analyzes audio
- Model inference → Evidence fusion: fuses signals (evidence: `backend/src/praxis/supplied/engine.py`)
- Model inference → Risk assessment: scores fusion (evidence: `backend/src/praxis/supplied/engine.py`)
- Evidence fusion → Policy decisions: informs policy
- Risk assessment → Risk warning: produces assessment
- HTTP and socket API → Session repository: reads sessions (evidence: `backend/src/praxis/main.py`)
- Session repository → Application database: reads and writes (evidence: `backend/src/praxis/db/repository.py`)
- Session repository → Privacy controls: applies controls (evidence: `backend/src/praxis/db/repository.py`)
- Session repository → Authentication: checks access (evidence: `backend/src/praxis/db/repository.py`)
- HTTP and socket API → Authentication: authenticates (evidence: `backend/src/praxis/main.py`)
- HTTP and socket API → Domain contracts: uses contracts (evidence: `backend/src/praxis/main.py`)
- Operator → Dashboard routing: uses (evidence: `praxis-dashboard/src/App.tsx`)
- Dashboard routing → Dashboard API: loads data
- Session directory → Dashboard API: requests sessions (evidence: `praxis-dashboard/src/hooks/useSessionDirectory.ts`)
- Dashboard API → HTTP and socket API: requests data
