How ajaysai157/legal_document_analyzer works
The product is a legal and policy document analyzer. Its primary workflow is upload and parsing, clause and cross-clause analysis, risk scoring, optional human review, and report generation; users can also ask grounded questions about a document. The graph preserves the documented stages and major UI capabilities. Some connections rely on the README or SOURCE INDEX because not all router and service implementations were excerpted.
Main entry points: analysis_graph.py Analysis workflow · main.py FastAPI app · client.ts Typed API client · models.py Relational store
Components 28
User interface
- Upload page
frontend/src/pages/UploadPage.tsx - Document workspace
frontend/src/pages/WorkspacePage.tsx - Review page
frontend/src/pages/ReviewPage.tsx - Report page
frontend/src/pages/ReportPage.tsx - Document viewer
frontend/src/components/DocumentViewer.tsx - Chat panel
frontend/src/components/ChatPanel.tsx - Report summary
frontend/src/components/ReportSummary.tsx - Review card
frontend/src/components/ReviewQueueCard.tsx - Typed API client
frontend/src/api/client.ts
API and workflow
- FastAPI app
app/main.py - Document endpoints
app/routers/documents.py - Clause and finding endpoints
app/routers/clauses.py - Review endpoints
app/routers/review.py - Report endpoints
app/routers/report.py - Chat endpoints
app/routers/chat.py
Analysis services
- Document parser
app/services/parser.py - Analysis workflow
app/services/analysis_graph.py - Clause analysis
app/services/clause_analyzer.py - Cross-clause reasoning
app/services/cross_clause.py - Risk scoring
app/services/risk_scoring.py - Clause retrieval
app/services/retriever.py
Persistence and models
- Relational store
app/db/models.py - Domain schemas
app/models/clause.py - Application settings
app/config.py - Domain exceptions
app/core/exceptions.py
Model providers
- LLM client factory
app/services/llm_client.py - Configured LLM provider
Other components
- Document reviewer
Connections 36
- Document reviewer → Upload page: uploads document
README.md - Upload page → Typed API client: submits file
frontend/src/pages/UploadPage.tsx - Document workspace → Typed API client: loads document data
frontend/src/pages/WorkspacePage.tsx - Review page → Typed API client: submits review
frontend/src/pages/ReviewPage.tsx - Report page → Typed API client: requests report
frontend/src/pages/ReportPage.tsx - Document workspace → Document viewer: renders document
frontend/src/pages/WorkspacePage.tsx - Document workspace → Chat panel: opens chat
frontend/src/pages/WorkspacePage.tsx - Report page → Report summary: renders summary
frontend/src/pages/ReportPage.tsx - Review page → Review card: renders queue item
frontend/src/pages/ReviewPage.tsx - Typed API client → FastAPI app: sends API requests
README.md - FastAPI app → Document endpoints: routes requests
app/main.py - FastAPI app → Clause and finding endpoints: routes requests
app/main.py - FastAPI app → Review endpoints: routes requests
app/main.py - FastAPI app → Report endpoints: routes requests
app/main.py - FastAPI app → Chat endpoints: routes requests
app/main.py - Document endpoints → Document parser: parses upload
app/routers/documents.py - Document endpoints → Analysis workflow: starts analysis
app/routers/documents.py - Analysis workflow → Clause analysis: analyzes clauses
app/services/analysis_graph.py - Analysis workflow → Cross-clause reasoning: checks relationships
app/services/analysis_graph.py - Analysis workflow → Risk scoring: calculates score
app/services/analysis_graph.py - Clause analysis → LLM client factory: requests analysis model
app/services/clause_analyzer.py - Cross-clause reasoning → LLM client factory: requests reasoning model
app/services/cross_clause.py - LLM client factory → Configured LLM provider: creates model client
app/services/llm_client.py - Review endpoints → Analysis workflow: resumes workflow
app/routers/review.py - Chat endpoints → Clause retrieval: retrieves clauses
app/routers/chat.py - Chat endpoints → LLM client factory: requests answer model
app/routers/chat.py - Document endpoints → Relational store: stores document data
app/routers/documents.py - Analysis workflow → Relational store: persists analysis
app/services/analysis_graph.py - Report endpoints → Relational store: reads report inputs
app/routers/report.py - Chat endpoints → Relational store: reads document data
app/routers/chat.py - Review endpoints → Relational store: updates review state
app/routers/review.py - Analysis workflow → Domain schemas: uses clause types
app/services/analysis_graph.py - Relational store → Application settings: configures connection
app/db/database.py - Document endpoints → Domain exceptions: raises upload errors
app/routers/documents.py - Report endpoints → LLM client factory: requests report model
app/routers/report.py - Chat panel → Typed API client: sends question
frontend/src/components/ChatPanel.tsx