# jeyaprakash06/sattam_ai architecture

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

- Interactive diagram: https://gitdiagram.com/jeyaprakash06/sattam_ai
- Repository: https://github.com/jeyaprakash06/sattam_ai

## Overview

SATTAM AI is a mobile-facing legal assistance platform spanning legal Q&A, drafting and document tools, legal feeds, and gamification. The README describes users interacting through the app and receiving results from the relevant backend. App-to-service connections below reflect that documented architecture, not inspected HTTP wiring. Sampled entrypoints and source references show some internal dispatches and service calls; unsampled feed ingestion details are kept as capabilities without guessed connections.

Main entry points: [`legal_drafting_backend/app/main.py`](https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_drafting_backend/app/main.py) (Drafting API), [`legal_drafting_backend/app/db/database.py`](https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_drafting_backend/app/db/database.py) (Draft Data Store), [`frontend/sattam_ai`](https://github.com/jeyaprakash06/sattam_ai/tree/main/frontend/sattam_ai) (Mobile App), [`legal_ai_backend/app/api/chat.py`](https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_ai_backend/app/api/chat.py) (Chat Routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Mobile Client"]
  node_mobile_app["Mobile App"]
end

subgraph group_legal_ai["Legal AI"]
  node_ai_api["AI API<br/>[main.py]"]
  node_chat_api["Chat Routes<br/>[chat.py]"]
  node_document_api["Document Routes<br/>[documents.py]"]
  node_rag["Legal Q&amp;A<br/>[rag_service.py]"]
  node_recommendation["Recommendations<br/>[recommendation.py]"]
  node_ai_documents["Document Analysis"]
  node_ai_store[("AI Data Store<br/>[database.py]")]
end

subgraph group_drafting["Legal Drafting"]
  node_draft_api["Drafting API<br/>[main.py]"]
  node_draft_routes["Draft Routes<br/>[drafting.py]"]
  node_document_routes["Document Routes<br/>[documents.py]"]
  node_template_routes["Template Library<br/>[templates.py]"]
  node_simplification["Simplification<br/>[simplification.py]"]
  node_clause_routes["Clause Library<br/>[clauses.py]"]
  node_auth_routes["Authentication<br/>[auth.py]"]
  node_draft_ai["Drafting AI<br/>[ai_service.py]"]
  node_export["Document Export<br/>[export_service.py]"]
  node_draft_store[("Draft Data Store<br/>[database.py]")]
end

subgraph group_feed["Legal Feed"]
  node_feed_api["Feed API<br/>[main.py]"]
  node_feed_routes["Feed Routes<br/>[feed.py]"]
  node_user_feed["User Feed<br/>[user.py]"]
  node_admin_feed["Feed Admin<br/>[admin_router.py]"]
  node_scraper["LiveLaw Scraper<br/>[livelaw_scraper.py]"]
  node_ingestion["Feed Ingestion<br/>[ingestion.py]"]
  node_feed_store[("Feed Store<br/>[database.py]")]
end

subgraph group_gamification["Gamification"]
  node_game_api["Gamification API<br/>[main.py]"]
  node_game_routes["Engagement Routes<br/>[routes.py]"]
  node_game_logic["Rewards Logic<br/>[services.py]"]
  node_game_store[("Engagement Store<br/>[db.py]")]
end

node_user(("User"))

node_user -->|"uses"| node_mobile_app
node_mobile_app -.->|"requests legal AI"| node_ai_api
node_mobile_app -.->|"requests drafting"| node_draft_api
node_mobile_app -.->|"requests feed"| node_feed_api
node_mobile_app -.->|"requests engagement"| node_game_api
node_ai_api -->|"registers routes"| node_chat_api
node_ai_api -->|"registers routes"| node_document_api
node_chat_api -->|"calls Q&amp;A"| node_rag
node_chat_api -->|"calls"| node_recommendation
node_chat_api -->|"reads and writes"| node_ai_store
node_rag -->|"reads sessions"| node_ai_store
node_document_api -->|"calls analysis"| node_ai_documents
node_draft_api -->|"registers routes"| node_auth_routes
node_draft_api -->|"registers routes"| node_template_routes
node_draft_api -->|"registers routes"| node_document_routes
node_draft_api -->|"registers routes"| node_draft_routes
node_draft_api -->|"registers routes"| node_simplification
node_draft_api -->|"registers routes"| node_clause_routes
node_draft_routes -->|"calls drafting AI"| node_draft_ai
node_draft_routes -->|"uses database"| node_draft_store
node_document_routes -->|"calls drafting AI"| node_draft_ai
node_document_routes -->|"calls export"| node_export
node_document_routes -->|"uses database"| node_draft_store
node_template_routes -->|"uses database"| node_draft_store
node_simplification -->|"calls simplifier"| node_draft_ai
node_simplification -->|"uses database"| node_draft_store
node_clause_routes -->|"uses database"| node_draft_store
node_auth_routes -->|"uses database"| node_draft_store
node_feed_api -->|"registers routes"| node_feed_routes
node_feed_api -->|"registers routes"| node_user_feed
node_feed_api -->|"registers routes"| node_admin_feed
node_feed_routes -->|"uses database"| node_feed_store
node_user_feed -->|"uses database"| node_feed_store
node_admin_feed -->|"calls scraper"| node_scraper
node_ingestion -->|"uses database"| node_feed_store
node_game_api -->|"registers routes"| node_game_routes
node_game_api -->|"imports database"| node_game_store
node_game_routes -->|"calls rewards logic"| node_game_logic
node_game_routes -->|"reads and writes"| node_game_store

click node_mobile_app "https://github.com/jeyaprakash06/sattam_ai/tree/main/frontend/sattam_ai"
click node_ai_api "https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_ai_backend/app/main.py"
click node_chat_api "https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_ai_backend/app/api/chat.py"
click node_document_api "https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_ai_backend/app/api/documents.py"
click node_rag "https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_ai_backend/app/services/rag_service.py"
click node_recommendation "https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_ai_backend/app/services/recommendation.py"
click node_ai_documents "https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_ai_backend/app/services/document_service.py"
click node_ai_store "https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_ai_backend/app/core/database.py"
click node_draft_api "https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_drafting_backend/app/main.py"
click node_draft_routes "https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_drafting_backend/app/api/routes/drafting.py"
click node_document_routes "https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_drafting_backend/app/api/routes/documents.py"
click node_template_routes "https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_drafting_backend/app/api/routes/templates.py"
click node_simplification "https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_drafting_backend/app/api/routes/simplification.py"
click node_clause_routes "https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_drafting_backend/app/api/routes/clauses.py"
click node_auth_routes "https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_drafting_backend/app/api/routes/auth.py"
click node_draft_ai "https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_drafting_backend/app/services/ai_service.py"
click node_export "https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_drafting_backend/app/services/export_service.py"
click node_draft_store "https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_drafting_backend/app/db/database.py"
click node_feed_api "https://github.com/jeyaprakash06/sattam_ai/blob/main/sattam_feed_backend/app/main.py"
click node_feed_routes "https://github.com/jeyaprakash06/sattam_ai/blob/main/sattam_feed_backend/app/routes/feed.py"
click node_user_feed "https://github.com/jeyaprakash06/sattam_ai/blob/main/sattam_feed_backend/app/routes/user.py"
click node_admin_feed "https://github.com/jeyaprakash06/sattam_ai/blob/main/sattam_feed_backend/app/routes/admin_router.py"
click node_scraper "https://github.com/jeyaprakash06/sattam_ai/blob/main/sattam_feed_backend/app/services/livelaw_scraper.py"
click node_ingestion "https://github.com/jeyaprakash06/sattam_ai/blob/main/sattam_feed_backend/app/services/ingestion.py"
click node_feed_store "https://github.com/jeyaprakash06/sattam_ai/blob/main/sattam_feed_backend/app/database.py"
click node_game_api "https://github.com/jeyaprakash06/sattam_ai/blob/main/sattam_gamification_backend/main.py"
click node_game_routes "https://github.com/jeyaprakash06/sattam_ai/blob/main/sattam_gamification_backend/app/routes.py"
click node_game_logic "https://github.com/jeyaprakash06/sattam_ai/blob/main/sattam_gamification_backend/app/services.py"
click node_game_store "https://github.com/jeyaprakash06/sattam_ai/blob/main/sattam_gamification_backend/app/db.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_mobile_app,node_user toneBlue
class node_ai_api,node_chat_api,node_document_api,node_rag,node_recommendation,node_ai_documents,node_ai_store toneAmber
class node_draft_api,node_draft_routes,node_document_routes,node_template_routes,node_simplification,node_clause_routes,node_auth_routes,node_draft_ai,node_export,node_draft_store toneMint
class node_feed_api,node_feed_routes,node_user_feed,node_admin_feed,node_scraper,node_ingestion,node_feed_store toneRose
class node_game_api,node_game_routes,node_game_logic,node_game_store toneIndigo
```

## Components

### Mobile Client

- [Mobile App](https://github.com/jeyaprakash06/sattam_ai/tree/main/frontend/sattam_ai): `frontend/sattam_ai`

### Legal AI

- [AI API](https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_ai_backend/app/main.py): `legal_ai_backend/app/main.py`
- [Chat Routes](https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_ai_backend/app/api/chat.py): `legal_ai_backend/app/api/chat.py`
- [Document Routes](https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_ai_backend/app/api/documents.py): `legal_ai_backend/app/api/documents.py`
- [Legal Q&A](https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_ai_backend/app/services/rag_service.py): `legal_ai_backend/app/services/rag_service.py`
- [Recommendations](https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_ai_backend/app/services/recommendation.py): `legal_ai_backend/app/services/recommendation.py`
- [Document Analysis](https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_ai_backend/app/services/document_service.py): `legal_ai_backend/app/services/document_service.py`
- [AI Data Store](https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_ai_backend/app/core/database.py): `legal_ai_backend/app/core/database.py`

### Legal Drafting

- [Drafting API](https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_drafting_backend/app/main.py): `legal_drafting_backend/app/main.py`
- [Draft Routes](https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_drafting_backend/app/api/routes/drafting.py): `legal_drafting_backend/app/api/routes/drafting.py`
- [Document Routes](https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_drafting_backend/app/api/routes/documents.py): `legal_drafting_backend/app/api/routes/documents.py`
- [Template Library](https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_drafting_backend/app/api/routes/templates.py): `legal_drafting_backend/app/api/routes/templates.py`
- [Simplification](https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_drafting_backend/app/api/routes/simplification.py): `legal_drafting_backend/app/api/routes/simplification.py`
- [Clause Library](https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_drafting_backend/app/api/routes/clauses.py): `legal_drafting_backend/app/api/routes/clauses.py`
- [Authentication](https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_drafting_backend/app/api/routes/auth.py): `legal_drafting_backend/app/api/routes/auth.py`
- [Drafting AI](https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_drafting_backend/app/services/ai_service.py): `legal_drafting_backend/app/services/ai_service.py`
- [Document Export](https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_drafting_backend/app/services/export_service.py): `legal_drafting_backend/app/services/export_service.py`
- [Draft Data Store](https://github.com/jeyaprakash06/sattam_ai/blob/main/legal_drafting_backend/app/db/database.py): `legal_drafting_backend/app/db/database.py`

### Legal Feed

- [Feed API](https://github.com/jeyaprakash06/sattam_ai/blob/main/sattam_feed_backend/app/main.py): `sattam_feed_backend/app/main.py`
- [Feed Routes](https://github.com/jeyaprakash06/sattam_ai/blob/main/sattam_feed_backend/app/routes/feed.py): `sattam_feed_backend/app/routes/feed.py`
- [User Feed](https://github.com/jeyaprakash06/sattam_ai/blob/main/sattam_feed_backend/app/routes/user.py): `sattam_feed_backend/app/routes/user.py`
- [Feed Admin](https://github.com/jeyaprakash06/sattam_ai/blob/main/sattam_feed_backend/app/routes/admin_router.py): `sattam_feed_backend/app/routes/admin_router.py`
- [LiveLaw Scraper](https://github.com/jeyaprakash06/sattam_ai/blob/main/sattam_feed_backend/app/services/livelaw_scraper.py): `sattam_feed_backend/app/services/livelaw_scraper.py`
- [Feed Ingestion](https://github.com/jeyaprakash06/sattam_ai/blob/main/sattam_feed_backend/app/services/ingestion.py): `sattam_feed_backend/app/services/ingestion.py`
- [Feed Store](https://github.com/jeyaprakash06/sattam_ai/blob/main/sattam_feed_backend/app/database.py): `sattam_feed_backend/app/database.py`

### Gamification

- [Gamification API](https://github.com/jeyaprakash06/sattam_ai/blob/main/sattam_gamification_backend/main.py): `sattam_gamification_backend/main.py`
- [Engagement Routes](https://github.com/jeyaprakash06/sattam_ai/blob/main/sattam_gamification_backend/app/routes.py): `sattam_gamification_backend/app/routes.py`
- [Rewards Logic](https://github.com/jeyaprakash06/sattam_ai/blob/main/sattam_gamification_backend/app/services.py): `sattam_gamification_backend/app/services.py`
- [Engagement Store](https://github.com/jeyaprakash06/sattam_ai/blob/main/sattam_gamification_backend/app/db.py): `sattam_gamification_backend/app/db.py`

### Other components

- **User**

## Connections

- User → Mobile App: uses (evidence: `README.md`)
- Mobile App → AI API: requests legal AI (evidence: `README.md`)
- Mobile App → Drafting API: requests drafting (evidence: `README.md`)
- Mobile App → Feed API: requests feed (evidence: `README.md`)
- Mobile App → Gamification API: requests engagement (evidence: `README.md`)
- AI API → Chat Routes: registers routes (evidence: `legal_ai_backend/app/main.py`)
- AI API → Document Routes: registers routes (evidence: `legal_ai_backend/app/main.py`)
- Chat Routes → Legal Q&A: calls Q&A (evidence: `legal_ai_backend/app/api/chat.py`)
- Chat Routes → Recommendations: calls (evidence: `legal_ai_backend/app/api/chat.py`)
- Chat Routes → AI Data Store: reads and writes (evidence: `legal_ai_backend/app/api/chat.py`)
- Legal Q&A → AI Data Store: reads sessions (evidence: `legal_ai_backend/app/services/rag_service.py`)
- Document Routes → Document Analysis: calls analysis (evidence: `legal_ai_backend/app/api/documents.py`)
- Drafting API → Authentication: registers routes (evidence: `legal_drafting_backend/app/main.py`)
- Drafting API → Template Library: registers routes (evidence: `legal_drafting_backend/app/main.py`)
- Drafting API → Document Routes: registers routes (evidence: `legal_drafting_backend/app/main.py`)
- Drafting API → Draft Routes: registers routes (evidence: `legal_drafting_backend/app/main.py`)
- Drafting API → Simplification: registers routes (evidence: `legal_drafting_backend/app/main.py`)
- Drafting API → Clause Library: registers routes (evidence: `legal_drafting_backend/app/main.py`)
- Draft Routes → Drafting AI: calls drafting AI (evidence: `legal_drafting_backend/app/api/routes/drafting.py`)
- Draft Routes → Draft Data Store: uses database (evidence: `legal_drafting_backend/app/api/routes/drafting.py`)
- Document Routes → Drafting AI: calls drafting AI (evidence: `legal_drafting_backend/app/api/routes/documents.py`)
- Document Routes → Document Export: calls export (evidence: `legal_drafting_backend/app/api/routes/documents.py`)
- Document Routes → Draft Data Store: uses database (evidence: `legal_drafting_backend/app/api/routes/documents.py`)
- Template Library → Draft Data Store: uses database (evidence: `legal_drafting_backend/app/api/routes/templates.py`)
- Simplification → Drafting AI: calls simplifier (evidence: `legal_drafting_backend/app/api/routes/simplification.py`)
- Simplification → Draft Data Store: uses database (evidence: `legal_drafting_backend/app/api/routes/simplification.py`)
- Clause Library → Draft Data Store: uses database (evidence: `legal_drafting_backend/app/api/routes/clauses.py`)
- Authentication → Draft Data Store: uses database (evidence: `legal_drafting_backend/app/api/routes/auth.py`)
- Feed API → Feed Routes: registers routes (evidence: `sattam_feed_backend/app/main.py`)
- Feed API → User Feed: registers routes (evidence: `sattam_feed_backend/app/main.py`)
- Feed API → Feed Admin: registers routes (evidence: `sattam_feed_backend/app/main.py`)
- Feed Routes → Feed Store: uses database (evidence: `sattam_feed_backend/app/routes/feed.py`)
- User Feed → Feed Store: uses database (evidence: `sattam_feed_backend/app/routes/user.py`)
- Feed Admin → LiveLaw Scraper: calls scraper (evidence: `sattam_feed_backend/app/routes/admin_router.py`)
- Feed Ingestion → Feed Store: uses database (evidence: `sattam_feed_backend/app/services/ingestion.py`)
- Gamification API → Engagement Routes: registers routes (evidence: `sattam_gamification_backend/main.py`)
- Gamification API → Engagement Store: imports database (evidence: `sattam_gamification_backend/main.py`)
- Engagement Routes → Rewards Logic: calls rewards logic (evidence: `sattam_gamification_backend/app/routes.py`)
- Engagement Routes → Engagement Store: reads and writes (evidence: `sattam_gamification_backend/app/routes.py`)
