# basava2005/sathyagraha_ai architecture

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

- Interactive diagram: https://gitdiagram.com/basava2005/sathyagraha_ai
- Repository: https://github.com/basava2005/sathyagraha_ai

## Overview

DocuManage is a legal-document hub whose main user workflow is to sign in, choose or fill a template, and manage or export a generated document; separate routes support document analysis, legal chat, and administration. The graph distinguishes the React experience, API/authentication, domain services, and persistence. Several page and route implementations were not sampled, so their documented capabilities are represented without guessing their internal call chains.

Main entry points: [`client/src/App.tsx`](https://github.com/basava2005/sathyagraha_ai/blob/main/client/src/App.tsx) (Application router), [`server/routes.ts`](https://github.com/basava2005/sathyagraha_ai/blob/main/server/routes.ts) (HTTP API routes), [`server/storage.ts`](https://github.com/basava2005/sathyagraha_ai/blob/main/server/storage.ts) (Database storage), [`client/src/lib/queryClient.ts`](https://github.com/basava2005/sathyagraha_ai/blob/main/client/src/lib/queryClient.ts) (API query client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client experience"]
  node_app["Application router<br/>[App.tsx]"]
  node_authui["Sign-in and account<br/>[auth-page.tsx]"]
  node_templateui["Template workflow<br/>[template-form.tsx]"]
  node_documentui["Document management<br/>[documents.tsx]"]
  node_dashboardui["User dashboard<br/>[dashboard.tsx]"]
  node_analysisui["Document analyzer<br/>[fir-analyzer.tsx]"]
  node_consultui["Legal consultation<br/>[consultation.tsx]"]
  node_adminui["Admin console"]
  node_query["API query client<br/>[queryClient.ts]"]
  node_authstate["Client auth state<br/>[use-auth.tsx]"]
end

subgraph group_api["API and access"]
  node_api["HTTP API routes<br/>[routes.ts]"]
  node_auth["Session authentication<br/>[auth.ts]"]
end

subgraph group_domain["Legal services"]
  node_templates["Template and document service<br/>[routes.ts]"]
  node_pdf["PDF generation<br/>[pdf-generator.ts]"]
  node_analysis["Legal text analysis<br/>[routes.ts]"]
  node_chat["LLM legal chat<br/>[routes.ts]"]
  node_admin["Admin operations<br/>[routes.ts]"]
end

subgraph group_data["Persistence"]
  node_storage["Database storage<br/>[storage.ts]"]
  node_schema["Domain schema<br/>[schema.ts]"]
  node_db[("PostgreSQL<br/>[db.ts]")]
end

node_user(("User"))
node_llm["Configured LLM endpoint"]

node_user -->|"uses"| node_app
node_app -->|"provides queries"| node_query
node_app -->|"routes to"| node_authui
node_app -->|"routes to"| node_templateui
node_app -->|"routes to"| node_documentui
node_app -->|"routes to"| node_dashboardui
node_app -->|"routes to"| node_analysisui
node_app -->|"routes to"| node_consultui
node_app -->|"routes to"| node_adminui
node_app -->|"provides auth"| node_authstate
node_authstate -->|"requests API"| node_query
node_query -.->|"sends requests"| node_api
node_api -->|"sets up auth"| node_auth
node_api -->|"reads and writes"| node_storage
node_api -->|"generates PDF"| node_pdf
node_api -->|"sends chat request"| node_llm
node_api -->|"handles analysis"| node_analysis
node_api -->|"handles admin"| node_admin
node_auth -->|"loads users"| node_storage
node_storage -->|"queries"| node_db
node_storage -->|"uses types"| node_schema
node_analysisui -->|"posts analysis"| node_analysis
node_consultui -.->|"uses chat"| node_chat

click node_app "https://github.com/basava2005/sathyagraha_ai/blob/main/client/src/App.tsx"
click node_authui "https://github.com/basava2005/sathyagraha_ai/blob/main/client/src/pages/auth-page.tsx"
click node_templateui "https://github.com/basava2005/sathyagraha_ai/blob/main/client/src/pages/template-form.tsx"
click node_documentui "https://github.com/basava2005/sathyagraha_ai/blob/main/client/src/pages/documents.tsx"
click node_dashboardui "https://github.com/basava2005/sathyagraha_ai/blob/main/client/src/pages/dashboard.tsx"
click node_analysisui "https://github.com/basava2005/sathyagraha_ai/blob/main/client/src/pages/fir-analyzer.tsx"
click node_consultui "https://github.com/basava2005/sathyagraha_ai/blob/main/client/src/pages/consultation.tsx"
click node_adminui "https://github.com/basava2005/sathyagraha_ai/tree/main/client/src/pages/admin"
click node_query "https://github.com/basava2005/sathyagraha_ai/blob/main/client/src/lib/queryClient.ts"
click node_authstate "https://github.com/basava2005/sathyagraha_ai/blob/main/client/src/hooks/use-auth.tsx"
click node_api "https://github.com/basava2005/sathyagraha_ai/blob/main/server/routes.ts"
click node_auth "https://github.com/basava2005/sathyagraha_ai/blob/main/server/auth.ts"
click node_templates "https://github.com/basava2005/sathyagraha_ai/blob/main/server/routes.ts"
click node_pdf "https://github.com/basava2005/sathyagraha_ai/blob/main/server/pdf-generator.ts"
click node_analysis "https://github.com/basava2005/sathyagraha_ai/blob/main/server/routes.ts"
click node_chat "https://github.com/basava2005/sathyagraha_ai/blob/main/server/routes.ts"
click node_admin "https://github.com/basava2005/sathyagraha_ai/blob/main/server/routes.ts"
click node_storage "https://github.com/basava2005/sathyagraha_ai/blob/main/server/storage.ts"
click node_schema "https://github.com/basava2005/sathyagraha_ai/blob/main/shared/schema.ts"
click node_db "https://github.com/basava2005/sathyagraha_ai/blob/main/server/db.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_app,node_authui,node_templateui,node_documentui,node_dashboardui,node_analysisui,node_consultui,node_adminui,node_query,node_authstate,node_user toneBlue
class node_api,node_auth toneAmber
class node_templates,node_pdf,node_analysis,node_chat,node_admin toneMint
class node_storage,node_schema,node_db toneRose
class node_llm toneIndigo
```

## Components

### Client experience

- [Application router](https://github.com/basava2005/sathyagraha_ai/blob/main/client/src/App.tsx): `client/src/App.tsx`
- [Sign-in and account](https://github.com/basava2005/sathyagraha_ai/blob/main/client/src/pages/auth-page.tsx): `client/src/pages/auth-page.tsx`
- [Template workflow](https://github.com/basava2005/sathyagraha_ai/blob/main/client/src/pages/template-form.tsx): `client/src/pages/template-form.tsx`
- [Document management](https://github.com/basava2005/sathyagraha_ai/blob/main/client/src/pages/documents.tsx): `client/src/pages/documents.tsx`
- [User dashboard](https://github.com/basava2005/sathyagraha_ai/blob/main/client/src/pages/dashboard.tsx): `client/src/pages/dashboard.tsx`
- [Document analyzer](https://github.com/basava2005/sathyagraha_ai/blob/main/client/src/pages/fir-analyzer.tsx): `client/src/pages/fir-analyzer.tsx`
- [Legal consultation](https://github.com/basava2005/sathyagraha_ai/blob/main/client/src/pages/consultation.tsx): `client/src/pages/consultation.tsx`
- [Admin console](https://github.com/basava2005/sathyagraha_ai/tree/main/client/src/pages/admin): `client/src/pages/admin`
- [API query client](https://github.com/basava2005/sathyagraha_ai/blob/main/client/src/lib/queryClient.ts): `client/src/lib/queryClient.ts`
- [Client auth state](https://github.com/basava2005/sathyagraha_ai/blob/main/client/src/hooks/use-auth.tsx): `client/src/hooks/use-auth.tsx`

### API and access

- [HTTP API routes](https://github.com/basava2005/sathyagraha_ai/blob/main/server/routes.ts): `server/routes.ts`
- [Session authentication](https://github.com/basava2005/sathyagraha_ai/blob/main/server/auth.ts): `server/auth.ts`

### Legal services

- [Template and document service](https://github.com/basava2005/sathyagraha_ai/blob/main/server/routes.ts): `server/routes.ts`
- [PDF generation](https://github.com/basava2005/sathyagraha_ai/blob/main/server/pdf-generator.ts): `server/pdf-generator.ts`
- [Legal text analysis](https://github.com/basava2005/sathyagraha_ai/blob/main/server/routes.ts): `server/routes.ts`
- [LLM legal chat](https://github.com/basava2005/sathyagraha_ai/blob/main/server/routes.ts): `server/routes.ts`
- [Admin operations](https://github.com/basava2005/sathyagraha_ai/blob/main/server/routes.ts): `server/routes.ts`

### Persistence

- [Database storage](https://github.com/basava2005/sathyagraha_ai/blob/main/server/storage.ts): `server/storage.ts`
- [Domain schema](https://github.com/basava2005/sathyagraha_ai/blob/main/shared/schema.ts): `shared/schema.ts`
- [PostgreSQL](https://github.com/basava2005/sathyagraha_ai/blob/main/server/db.ts): `server/db.ts`

### Other components

- **User**
- **Configured LLM endpoint**

## Connections

- User → Application router: uses (evidence: `client/src/App.tsx`)
- Application router → API query client: provides queries (evidence: `client/src/App.tsx`)
- Application router → Sign-in and account: routes to (evidence: `client/src/App.tsx`)
- Application router → Template workflow: routes to (evidence: `client/src/App.tsx`)
- Application router → Document management: routes to (evidence: `client/src/App.tsx`)
- Application router → User dashboard: routes to (evidence: `client/src/App.tsx`)
- Application router → Document analyzer: routes to (evidence: `client/src/App.tsx`)
- Application router → Legal consultation: routes to (evidence: `client/src/App.tsx`)
- Application router → Admin console: routes to (evidence: `client/src/App.tsx`)
- Application router → Client auth state: provides auth (evidence: `client/src/App.tsx`)
- Client auth state → API query client: requests API (evidence: `client/src/hooks/use-auth.tsx`)
- API query client → HTTP API routes: sends requests
- HTTP API routes → Session authentication: sets up auth (evidence: `server/routes.ts`)
- HTTP API routes → Database storage: reads and writes (evidence: `server/routes.ts`)
- HTTP API routes → PDF generation: generates PDF (evidence: `server/routes.ts`)
- HTTP API routes → Configured LLM endpoint: sends chat request (evidence: `server/routes.ts`)
- HTTP API routes → Legal text analysis: handles analysis (evidence: `server/routes.ts`)
- HTTP API routes → Admin operations: handles admin (evidence: `server/routes.ts`)
- Session authentication → Database storage: loads users (evidence: `server/auth.ts`)
- Database storage → PostgreSQL: queries (evidence: `server/storage.ts`)
- Database storage → Domain schema: uses types (evidence: `server/storage.ts`)
- Document analyzer → Legal text analysis: posts analysis (evidence: `README.md`)
- Legal consultation → LLM legal chat: uses chat
