# yashraj-sonawane02/contractlens architecture

> Architecture diagram of the GitHub repository yashraj-sonawane02/contractlens, 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/yashraj-sonawane02/contractlens
- Repository: https://github.com/yashraj-sonawane02/contractlens

## Overview

ContractLens is a web platform for auditing Maharashtra leave-and-license agreements. A user uploads a contract; the frontend submits it for analysis, which extracts text, masks personal information, classifies clauses, and evaluates statutory risk. Results feed a dashboard for reviewing risks, comparison, and negotiation. Separate capabilities include grounded legal chat and exploration, authentication, history, and document exports. The graph follows documented calls and SOURCE INDEX references; some unsampled implementation details are represented only at their existing service-directory path.

Main entry points: [`backend/app/api/analysis.py`](https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/api/analysis.py) (Analysis endpoint), [`frontend/src/components/RiskDashboard.jsx`](https://github.com/yashraj-sonawane02/contractlens/blob/main/frontend/src/components/RiskDashboard.jsx) (Risk dashboard), [`backend/app/main.py`](https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/main.py) (FastAPI application), [`frontend/src/App.jsx`](https://github.com/yashraj-sonawane02/contractlens/blob/main/frontend/src/App.jsx) (Application shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web experience"]
  node_app["Application shell<br/>[App.jsx]"]
  node_api_client["API client<br/>[api.js]"]
  node_dashboard["Risk dashboard<br/>[RiskDashboard.jsx]"]
  node_clause_card["Clause cards<br/>[ClauseCard.jsx]"]
  node_risk_heatmap["Risk heatmap<br/>[RiskHeatmap.jsx]"]
  node_chat_ui["Contract chat<br/>[ContractChat.jsx]"]
  node_comparison["Contract comparison"]
  node_negotiation_ui["Negotiation generator"]
  node_benchmark_ui["Benchmark view"]
  node_legal_ui["Legal explorer"]
  node_history_ui["Analysis history<br/>[HistoryPage.jsx]"]
end

subgraph group_api["API and identity"]
  node_app_server["FastAPI application<br/>[main.py]"]
  node_auth["Authentication<br/>[auth.py]"]
  node_analysis_api["Analysis endpoint<br/>[analysis.py]"]
  node_document_api["Document endpoints<br/>[document.py]"]
  node_chat_api["Legal chat endpoint<br/>[chat.py]"]
  node_legal_api["Legal knowledge endpoint<br/>[legal.py]"]
  node_negotiation_api["Negotiation endpoint<br/>[negotiation.py]"]
end

subgraph group_analysis["Contract analysis"]
  node_parser["Document parser<br/>[document_parser.py]"]
  node_classifier["Document classifier"]
  node_pii["PII masker<br/>[pii_masker.py]"]
  node_clause_engine["Clause segmentation<br/>[clause_engine.py]"]
  node_parallel["Parallel analyzer"]
  node_rag["Statutory risk engine<br/>[rag_engine.py]"]
  node_evaluation["Evaluation and benchmarks"]
  node_empirical["Empirical benchmark"]
end

subgraph group_legal["Legal assistance"]
  node_legal_kb["Legal knowledge base"]
  node_translator["Legal translation<br/>[translator.py]"]
  node_negotiation["Negotiation engine"]
  node_gemini_rag["Gemini retrieval<br/>[gemini_rag.py]"]
end

subgraph group_persistence["Data and storage"]
  node_db[("Relational database<br/>[database.py]")]
  node_models["User and history models<br/>[models.py]"]
  node_storage[("Encrypted object storage<br/>[storage_service.py]")]
end

node_user(("Contract user"))

node_user -->|"uses"| node_app
node_app -->|"submits analysis"| node_api_client
node_app -->|"renders results"| node_dashboard
node_dashboard -->|"renders clauses"| node_clause_card
node_dashboard -->|"renders risks"| node_risk_heatmap
node_dashboard -->|"renders chat"| node_chat_ui
node_dashboard -->|"renders comparison"| node_comparison
node_dashboard -->|"renders negotiation"| node_negotiation_ui
node_dashboard -->|"renders benchmark"| node_benchmark_ui
node_app -->|"renders explorer"| node_legal_ui
node_app -->|"renders history"| node_history_ui
node_app_server -->|"registers router"| node_auth
node_app_server -->|"registers router"| node_analysis_api
node_app_server -->|"registers router"| node_document_api
node_app_server -->|"registers router"| node_chat_api
node_app_server -->|"registers router"| node_legal_api
node_app_server -->|"registers router"| node_negotiation_api
node_api_client -->|"posts analysis"| node_analysis_api
node_auth -->|"gets session"| node_db
node_auth -->|"queries users"| node_models
node_auth -->|"stores user"| node_db
node_analysis_api -->|"parses upload"| node_parser
node_analysis_api -->|"masks data"| node_pii
node_analysis_api -->|"segments clauses"| node_clause_engine
node_analysis_api -->|"dispatches analysis"| node_parallel
node_analysis_api -->|"evaluates results"| node_evaluation
node_analysis_api -->|"runs benchmark"| node_empirical
node_analysis_api -->|"checks document"| node_classifier
node_analysis_api -->|"stores upload"| node_storage
node_parser -->|"detects type"| node_classifier
node_parallel -->|"dispatches clauses"| node_rag
node_rag -->|"retrieves statutes"| node_legal_kb
node_chat_api -->|"uses knowledge base"| node_legal_kb
node_legal_api -->|"uses knowledge base"| node_legal_kb
node_negotiation_api -->|"generates proposal"| node_negotiation
node_document_api -->|"parses document"| node_parser
node_document_api -.->|"uses storage"| node_storage
node_document_api -.->|"exports documents"| node_app_server
node_db -->|"maps entities"| node_models
node_analysis_api -->|"uses history"| node_db

click node_app "https://github.com/yashraj-sonawane02/contractlens/blob/main/frontend/src/App.jsx"
click node_api_client "https://github.com/yashraj-sonawane02/contractlens/blob/main/frontend/src/services/api.js"
click node_dashboard "https://github.com/yashraj-sonawane02/contractlens/blob/main/frontend/src/components/RiskDashboard.jsx"
click node_clause_card "https://github.com/yashraj-sonawane02/contractlens/blob/main/frontend/src/components/ClauseCard.jsx"
click node_risk_heatmap "https://github.com/yashraj-sonawane02/contractlens/blob/main/frontend/src/components/RiskHeatmap.jsx"
click node_chat_ui "https://github.com/yashraj-sonawane02/contractlens/blob/main/frontend/src/components/ContractChat.jsx"
click node_comparison "https://github.com/yashraj-sonawane02/contractlens/blob/main/frontend/src/components/ContractComparison.jsx"
click node_negotiation_ui "https://github.com/yashraj-sonawane02/contractlens/blob/main/frontend/src/components/NegotiationGenerator.jsx"
click node_benchmark_ui "https://github.com/yashraj-sonawane02/contractlens/blob/main/frontend/src/components/EmpiricalBenchmarkModal.jsx"
click node_legal_ui "https://github.com/yashraj-sonawane02/contractlens/blob/main/frontend/src/components/LegalExplorerModal.jsx"
click node_history_ui "https://github.com/yashraj-sonawane02/contractlens/blob/main/frontend/src/pages/HistoryPage.jsx"
click node_app_server "https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/main.py"
click node_auth "https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/api/auth.py"
click node_analysis_api "https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/api/analysis.py"
click node_document_api "https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/api/document.py"
click node_chat_api "https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/api/chat.py"
click node_legal_api "https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/api/legal.py"
click node_negotiation_api "https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/api/negotiation.py"
click node_parser "https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/services/document_parser.py"
click node_classifier "https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/services/document_classifier.py"
click node_pii "https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/services/pii_masker.py"
click node_clause_engine "https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/services/clause_engine.py"
click node_parallel "https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/services/parallel_analyzer.py"
click node_rag "https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/services/rag_engine.py"
click node_evaluation "https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/services/evaluation_suite.py"
click node_empirical "https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/services/empirical_benchmark.py"
click node_legal_kb "https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/services/legal_knowledge_base.py"
click node_translator "https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/services/translator.py"
click node_negotiation "https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/services/negotiation_engine.py"
click node_gemini_rag "https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/services/gemini_rag.py"
click node_db "https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/db/database.py"
click node_models "https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/models/models.py"
click node_storage "https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/services/storage_service.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_app,node_api_client,node_dashboard,node_clause_card,node_risk_heatmap,node_chat_ui,node_comparison,node_negotiation_ui,node_benchmark_ui,node_legal_ui,node_history_ui,node_user toneBlue
class node_app_server,node_auth,node_analysis_api,node_document_api,node_chat_api,node_legal_api,node_negotiation_api toneAmber
class node_parser,node_classifier,node_pii,node_clause_engine,node_parallel,node_rag,node_evaluation,node_empirical toneMint
class node_legal_kb,node_translator,node_negotiation,node_gemini_rag toneRose
class node_db,node_models,node_storage toneIndigo
```

## Components

### Web experience

- [Application shell](https://github.com/yashraj-sonawane02/contractlens/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [API client](https://github.com/yashraj-sonawane02/contractlens/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Risk dashboard](https://github.com/yashraj-sonawane02/contractlens/blob/main/frontend/src/components/RiskDashboard.jsx): `frontend/src/components/RiskDashboard.jsx`
- [Clause cards](https://github.com/yashraj-sonawane02/contractlens/blob/main/frontend/src/components/ClauseCard.jsx): `frontend/src/components/ClauseCard.jsx`
- [Risk heatmap](https://github.com/yashraj-sonawane02/contractlens/blob/main/frontend/src/components/RiskHeatmap.jsx): `frontend/src/components/RiskHeatmap.jsx`
- [Contract chat](https://github.com/yashraj-sonawane02/contractlens/blob/main/frontend/src/components/ContractChat.jsx): `frontend/src/components/ContractChat.jsx`
- [Contract comparison](https://github.com/yashraj-sonawane02/contractlens/blob/main/frontend/src/components/ContractComparison.jsx): `frontend/src/components/ContractComparison.jsx`
- [Negotiation generator](https://github.com/yashraj-sonawane02/contractlens/blob/main/frontend/src/components/NegotiationGenerator.jsx): `frontend/src/components/NegotiationGenerator.jsx`
- [Benchmark view](https://github.com/yashraj-sonawane02/contractlens/blob/main/frontend/src/components/EmpiricalBenchmarkModal.jsx): `frontend/src/components/EmpiricalBenchmarkModal.jsx`
- [Legal explorer](https://github.com/yashraj-sonawane02/contractlens/blob/main/frontend/src/components/LegalExplorerModal.jsx): `frontend/src/components/LegalExplorerModal.jsx`
- [Analysis history](https://github.com/yashraj-sonawane02/contractlens/blob/main/frontend/src/pages/HistoryPage.jsx): `frontend/src/pages/HistoryPage.jsx`

### API and identity

- [FastAPI application](https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/main.py): `backend/app/main.py`
- [Authentication](https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/api/auth.py): `backend/app/api/auth.py`
- [Analysis endpoint](https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/api/analysis.py): `backend/app/api/analysis.py`
- [Document endpoints](https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/api/document.py): `backend/app/api/document.py`
- [Legal chat endpoint](https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/api/chat.py): `backend/app/api/chat.py`
- [Legal knowledge endpoint](https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/api/legal.py): `backend/app/api/legal.py`
- [Negotiation endpoint](https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/api/negotiation.py): `backend/app/api/negotiation.py`

### Contract analysis

- [Document parser](https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/services/document_parser.py): `backend/app/services/document_parser.py`
- [Document classifier](https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/services/document_classifier.py): `backend/app/services/document_classifier.py`
- [PII masker](https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/services/pii_masker.py): `backend/app/services/pii_masker.py`
- [Clause segmentation](https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/services/clause_engine.py): `backend/app/services/clause_engine.py`
- [Parallel analyzer](https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/services/parallel_analyzer.py): `backend/app/services/parallel_analyzer.py`
- [Statutory risk engine](https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/services/rag_engine.py): `backend/app/services/rag_engine.py`
- [Evaluation and benchmarks](https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/services/evaluation_suite.py): `backend/app/services/evaluation_suite.py`
- [Empirical benchmark](https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/services/empirical_benchmark.py): `backend/app/services/empirical_benchmark.py`

### Legal assistance

- [Legal knowledge base](https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/services/legal_knowledge_base.py): `backend/app/services/legal_knowledge_base.py`
- [Legal translation](https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/services/translator.py): `backend/app/services/translator.py`
- [Negotiation engine](https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/services/negotiation_engine.py): `backend/app/services/negotiation_engine.py`
- [Gemini retrieval](https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/services/gemini_rag.py): `backend/app/services/gemini_rag.py`

### Data and storage

- [Relational database](https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/db/database.py): `backend/app/db/database.py`
- [User and history models](https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/models/models.py): `backend/app/models/models.py`
- [Encrypted object storage](https://github.com/yashraj-sonawane02/contractlens/blob/main/backend/app/services/storage_service.py): `backend/app/services/storage_service.py`

### Other components

- **Contract user**

## Connections

- Contract user → Application shell: uses (evidence: `README.md`)
- Application shell → API client: submits analysis (evidence: `frontend/src/App.jsx`)
- Application shell → Risk dashboard: renders results (evidence: `frontend/src/App.jsx`)
- Risk dashboard → Clause cards: renders clauses (evidence: `frontend/src/components/RiskDashboard.jsx`)
- Risk dashboard → Risk heatmap: renders risks (evidence: `frontend/src/components/RiskDashboard.jsx`)
- Risk dashboard → Contract chat: renders chat (evidence: `frontend/src/components/RiskDashboard.jsx`)
- Risk dashboard → Contract comparison: renders comparison (evidence: `frontend/src/components/RiskDashboard.jsx`)
- Risk dashboard → Negotiation generator: renders negotiation (evidence: `frontend/src/components/RiskDashboard.jsx`)
- Risk dashboard → Benchmark view: renders benchmark (evidence: `frontend/src/components/RiskDashboard.jsx`)
- Application shell → Legal explorer: renders explorer (evidence: `frontend/src/App.jsx`)
- Application shell → Analysis history: renders history (evidence: `frontend/src/App.jsx`)
- FastAPI application → Authentication: registers router (evidence: `backend/app/main.py`)
- FastAPI application → Analysis endpoint: registers router (evidence: `backend/app/main.py`)
- FastAPI application → Document endpoints: registers router (evidence: `backend/app/main.py`)
- FastAPI application → Legal chat endpoint: registers router (evidence: `backend/app/main.py`)
- FastAPI application → Legal knowledge endpoint: registers router (evidence: `backend/app/main.py`)
- FastAPI application → Negotiation endpoint: registers router (evidence: `backend/app/main.py`)
- API client → Analysis endpoint: posts analysis
- Authentication → Relational database: gets session (evidence: `backend/app/api/auth.py`)
- Authentication → User and history models: queries users (evidence: `backend/app/api/auth.py`)
- Authentication → Relational database: stores user (evidence: `backend/app/api/auth.py`)
- Analysis endpoint → Document parser: parses upload (evidence: `backend/app/api/analysis.py`)
- Analysis endpoint → PII masker: masks data (evidence: `backend/app/api/analysis.py`)
- Analysis endpoint → Clause segmentation: segments clauses (evidence: `backend/app/api/analysis.py`)
- Analysis endpoint → Parallel analyzer: dispatches analysis (evidence: `backend/app/api/analysis.py`)
- Analysis endpoint → Evaluation and benchmarks: evaluates results (evidence: `backend/app/api/analysis.py`)
- Analysis endpoint → Empirical benchmark: runs benchmark (evidence: `backend/app/api/analysis.py`)
- Analysis endpoint → Document classifier: checks document (evidence: `backend/app/api/analysis.py`)
- Analysis endpoint → Encrypted object storage: stores upload (evidence: `backend/app/api/analysis.py`)
- Document parser → Document classifier: detects type (evidence: `backend/app/services/document_parser.py`)
- Parallel analyzer → Statutory risk engine: dispatches clauses (evidence: `backend/app/services/parallel_analyzer.py`)
- Statutory risk engine → Legal knowledge base: retrieves statutes (evidence: `backend/app/services/rag_engine.py`)
- Legal chat endpoint → Legal knowledge base: uses knowledge base (evidence: `backend/app/api/chat.py`)
- Legal knowledge endpoint → Legal knowledge base: uses knowledge base (evidence: `backend/app/api/legal.py`)
- Negotiation endpoint → Negotiation engine: generates proposal (evidence: `backend/app/api/negotiation.py`)
- Document endpoints → Document parser: parses document (evidence: `backend/app/api/document.py`)
- Document endpoints → Encrypted object storage: uses storage
- Document endpoints → FastAPI application: exports documents (evidence: `backend/app/main.py`)
- Relational database → User and history models: maps entities (evidence: `backend/app/models/models.py`)
- Analysis endpoint → Relational database: uses history (evidence: `backend/app/api/analysis.py`)
