# naveen-929/sahya architecture

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

- Interactive diagram: https://gitdiagram.com/naveen-929/sahya
- Repository: https://github.com/naveen-929/sahya

## Overview

Sahay is a support platform for men in India facing abuse, legal distress, and related mental-health challenges. Its main user flow is anonymous access to the AI Companion, with safety checks and verified crisis resources, alongside journaling, educational content, and resource-directory features. A separate admin experience supports content review, directory vetting, crisis monitoring, and data-subject requests. The graph reflects documented capabilities and sampled backend wiring; several frontend-to-API and unsampled route relationships are shown only as unverified or omitted.

Main entry points: [`backend/src/routes/mod.rs`](https://github.com/naveen-929/sahya/blob/main/backend/src/routes/mod.rs) (API router), [`backend/src/routes/agent.rs`](https://github.com/naveen-929/sahya/blob/main/backend/src/routes/agent.rs) (AI Companion), [`frontend/src/app`](https://github.com/naveen-929/sahya/tree/main/frontend/src/app) (Support pages), [`backend/src/routes/auth.rs`](https://github.com/naveen-929/sahya/blob/main/backend/src/routes/auth.rs) (Anonymous sessions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_user["User support"]
  node_user_pages["Support pages"]
  node_api_client["API client"]
end

subgraph group_admin["Admin operations"]
  node_admin_pages["Admin panel"]
  node_admin_client["Admin API client<br/>[admin-api.ts]"]
end

subgraph group_backend["Backend services"]
  node_router["API router<br/>[mod.rs]"]
  node_user_auth["Anonymous sessions<br/>[auth.rs]"]
  node_agent["AI Companion<br/>[agent.rs]"]
  node_crisis["Crisis resources"]
  node_journal["Journal<br/>[journal.rs]"]
  node_knowledge["Knowledge content<br/>[knowledge.rs]"]
  node_directory["Resource directory<br/>[directory.rs]"]
  node_account["Privacy and account<br/>[account.rs]"]
  node_admin_routes["Admin operations"]
  node_admin_auth["Admin authentication<br/>[auth.rs]"]
  node_safety["Crisis detection<br/>[crisis.rs]"]
  node_llm["LLM provider<br/>[ollama.rs]"]
end

subgraph group_platform["Shared UI and state"]
  node_crypto["Content encryption<br/>[crypto.rs]"]
  node_config["Application state<br/>[config.rs]"]
  node_database[("Postgres")]
  node_design["Design components"]
end

node_person(("Platform user"))
node_admin_actor(("Admin"))

node_person -->|"uses"| node_user_pages
node_user_pages -.->|"requests"| node_api_client
node_api_client -.->|"calls API"| node_router
node_user_pages -.->|"uses components"| node_design
node_admin_actor -->|"uses"| node_admin_pages
node_admin_pages -.->|"requests"| node_admin_client
node_admin_client -.->|"calls API"| node_router
node_router -->|"routes"| node_user_auth
node_router -->|"routes"| node_agent
node_router -->|"routes"| node_crisis
node_router -->|"routes"| node_journal
node_router -->|"routes"| node_knowledge
node_router -->|"routes"| node_directory
node_router -->|"routes"| node_account
node_router -->|"routes"| node_admin_routes
node_router -->|"routes"| node_admin_auth
node_admin_routes -.->|"includes login routes"| node_admin_auth
node_agent -->|"checks crisis signals"| node_safety
node_agent -->|"generates replies"| node_llm
node_user_auth -->|"wraps user key"| node_crypto
node_config -->|"creates key service"| node_crypto
node_config -->|"configures provider"| node_llm
node_user_auth -->|"reads sessions"| node_database
node_admin_auth -->|"reads admin sessions"| node_database
node_agent -->|"stores conversations"| node_database
node_crisis -.->|"provides verified resources"| node_person

click node_user_pages "https://github.com/naveen-929/sahya/tree/main/frontend/src/app"
click node_api_client "https://github.com/naveen-929/sahya/tree/main/frontend/src/lib"
click node_admin_pages "https://github.com/naveen-929/sahya/tree/main/frontend/src/app/admin"
click node_admin_client "https://github.com/naveen-929/sahya/blob/main/frontend/src/lib/admin-api.ts"
click node_router "https://github.com/naveen-929/sahya/blob/main/backend/src/routes/mod.rs"
click node_user_auth "https://github.com/naveen-929/sahya/blob/main/backend/src/routes/auth.rs"
click node_agent "https://github.com/naveen-929/sahya/blob/main/backend/src/routes/agent.rs"
click node_crisis "https://github.com/naveen-929/sahya/blob/main/backend/src/routes/crisis_resources.rs"
click node_journal "https://github.com/naveen-929/sahya/blob/main/backend/src/routes/journal.rs"
click node_knowledge "https://github.com/naveen-929/sahya/blob/main/backend/src/routes/knowledge.rs"
click node_directory "https://github.com/naveen-929/sahya/blob/main/backend/src/routes/directory.rs"
click node_account "https://github.com/naveen-929/sahya/blob/main/backend/src/routes/account.rs"
click node_admin_routes "https://github.com/naveen-929/sahya/tree/main/backend/src/routes/admin"
click node_admin_auth "https://github.com/naveen-929/sahya/blob/main/backend/src/routes/admin/auth.rs"
click node_safety "https://github.com/naveen-929/sahya/blob/main/backend/src/crisis.rs"
click node_llm "https://github.com/naveen-929/sahya/blob/main/backend/src/llm/ollama.rs"
click node_crypto "https://github.com/naveen-929/sahya/blob/main/backend/src/crypto.rs"
click node_config "https://github.com/naveen-929/sahya/blob/main/backend/src/config.rs"
click node_design "https://github.com/naveen-929/sahya/tree/main/design-system/components"

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_user_pages,node_api_client,node_person toneBlue
class node_admin_pages,node_admin_client toneAmber
class node_router,node_user_auth,node_agent,node_crisis,node_journal,node_knowledge,node_directory,node_account,node_admin_routes,node_admin_auth,node_safety,node_llm toneMint
class node_crypto,node_config,node_database,node_design toneRose
class node_admin_actor toneIndigo
```

## Components

### User support

- [Support pages](https://github.com/naveen-929/sahya/tree/main/frontend/src/app): `frontend/src/app`
- [API client](https://github.com/naveen-929/sahya/tree/main/frontend/src/lib): `frontend/src/lib`

### Admin operations

- [Admin panel](https://github.com/naveen-929/sahya/tree/main/frontend/src/app/admin): `frontend/src/app/admin`
- [Admin API client](https://github.com/naveen-929/sahya/blob/main/frontend/src/lib/admin-api.ts): `frontend/src/lib/admin-api.ts`

### Backend services

- [API router](https://github.com/naveen-929/sahya/blob/main/backend/src/routes/mod.rs): `backend/src/routes/mod.rs`
- [Anonymous sessions](https://github.com/naveen-929/sahya/blob/main/backend/src/routes/auth.rs): `backend/src/routes/auth.rs`
- [AI Companion](https://github.com/naveen-929/sahya/blob/main/backend/src/routes/agent.rs): `backend/src/routes/agent.rs`
- [Crisis resources](https://github.com/naveen-929/sahya/blob/main/backend/src/routes/crisis_resources.rs): `backend/src/routes/crisis_resources.rs`
- [Journal](https://github.com/naveen-929/sahya/blob/main/backend/src/routes/journal.rs): `backend/src/routes/journal.rs`
- [Knowledge content](https://github.com/naveen-929/sahya/blob/main/backend/src/routes/knowledge.rs): `backend/src/routes/knowledge.rs`
- [Resource directory](https://github.com/naveen-929/sahya/blob/main/backend/src/routes/directory.rs): `backend/src/routes/directory.rs`
- [Privacy and account](https://github.com/naveen-929/sahya/blob/main/backend/src/routes/account.rs): `backend/src/routes/account.rs`
- [Admin operations](https://github.com/naveen-929/sahya/tree/main/backend/src/routes/admin): `backend/src/routes/admin`
- [Admin authentication](https://github.com/naveen-929/sahya/blob/main/backend/src/routes/admin/auth.rs): `backend/src/routes/admin/auth.rs`
- [Crisis detection](https://github.com/naveen-929/sahya/blob/main/backend/src/crisis.rs): `backend/src/crisis.rs`
- [LLM provider](https://github.com/naveen-929/sahya/blob/main/backend/src/llm/ollama.rs): `backend/src/llm/ollama.rs`

### Shared UI and state

- [Content encryption](https://github.com/naveen-929/sahya/blob/main/backend/src/crypto.rs): `backend/src/crypto.rs`
- [Application state](https://github.com/naveen-929/sahya/blob/main/backend/src/config.rs): `backend/src/config.rs`
- **Postgres**
- [Design components](https://github.com/naveen-929/sahya/tree/main/design-system/components): `design-system/components`

### Other components

- **Platform user**
- **Admin**

## Connections

- Platform user → Support pages: uses (evidence: `README.md`)
- Support pages → API client: requests
- API client → API router: calls API
- Support pages → Design components: uses components
- Admin → Admin panel: uses (evidence: `README.md`)
- Admin panel → Admin API client: requests
- Admin API client → API router: calls API
- API router → Anonymous sessions: routes (evidence: `backend/src/routes/mod.rs`)
- API router → AI Companion: routes (evidence: `backend/src/routes/mod.rs`)
- API router → Crisis resources: routes (evidence: `backend/src/routes/mod.rs`)
- API router → Journal: routes (evidence: `backend/src/routes/mod.rs`)
- API router → Knowledge content: routes (evidence: `backend/src/routes/mod.rs`)
- API router → Resource directory: routes (evidence: `backend/src/routes/mod.rs`)
- API router → Privacy and account: routes (evidence: `backend/src/routes/mod.rs`)
- API router → Admin operations: routes (evidence: `backend/src/routes/mod.rs`)
- API router → Admin authentication: routes (evidence: `backend/src/routes/mod.rs`)
- Admin operations → Admin authentication: includes login routes
- AI Companion → Crisis detection: checks crisis signals (evidence: `backend/src/routes/agent.rs`)
- AI Companion → LLM provider: generates replies (evidence: `backend/src/routes/agent.rs`)
- Anonymous sessions → Content encryption: wraps user key (evidence: `backend/src/routes/auth.rs`)
- Application state → Content encryption: creates key service (evidence: `backend/src/config.rs`)
- Application state → LLM provider: configures provider (evidence: `backend/src/config.rs`)
- Anonymous sessions → Postgres: reads sessions
- Admin authentication → Postgres: reads admin sessions
- AI Companion → Postgres: stores conversations (evidence: `backend/src/routes/agent.rs`)
- Crisis resources → Platform user: provides verified resources
