# jahanvi11-1/vistara-ai architecture

> Architecture diagram of the GitHub repository jahanvi11-1/vistara-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/jahanvi11-1/vistara-ai
- Repository: https://github.com/jahanvi11-1/vistara-ai

## Overview

Vistara is a cross-platform contract-risk analysis app. The main workflow is document or text submission in the Flutter app, API analysis by the FastAPI backend with Gemini, and presentation of a structured report with severity, plain-language explanations, and worst-case scenarios. The app also supports local recent-document/report access and viewing saved or original PDFs. The README documents these capabilities; frontend implementation excerpts were not provided, so the detailed UI-to-service relationships below reflect documented behavior rather than inspected call sites.

Main entry points: [`vistara/lib/services/api_service.dart`](https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/services/api_service.dart) (API client), [`vistara-backend/main.py`](https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara-backend/main.py) (Analysis API), [`vistara/lib/screens/analyze_screen.dart`](https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/screens/analyze_screen.dart) (Upload contract), [`vistara/lib/models/contract_report.dart`](https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/models/contract_report.dart) (Contract report model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Flutter experience"]
  node_onboarding["Onboarding"]
  node_navigation["App navigation"]
  node_analyze["Upload contract"]
  node_progress["Analysis progress"]
end

subgraph group_analysis["Contract analysis"]
  node_api_client["API client<br/>[api_service.dart]"]
  node_backend_api["Analysis API<br/>[main.py]"]
end

subgraph group_results["Reports and documents"]
  node_report_model["Contract report model"]
  node_report_view["Report display<br/>[report_screen.dart]"]
  node_risk_detail["Risk detail"]
  node_recent_docs["Recent documents"]
  node_document_viewer["Original PDF viewer"]
  node_saved_pdf["Saved PDF viewer"]
  node_saved_reports["Saved reports"]
end

subgraph group_persistence["Local persistence"]
  node_report_storage["Report storage"]
  node_local_storage[("Local storage")]
end

node_user(("User"))
node_gemini{{"Google Gemini"}}

node_user -->|"starts"| node_onboarding
node_user -->|"submits contract"| node_analyze
node_analyze -->|"sends upload"| node_api_client
node_api_client -->|"calls analysis API"| node_backend_api
node_backend_api -->|"requests assessment"| node_gemini
node_backend_api -->|"returns risk report"| node_api_client
node_api_client -.->|"provides report data"| node_report_model
node_report_model -.->|"renders results"| node_report_view
node_report_view -.->|"opens risk detail"| node_risk_detail
node_user -.->|"uses app"| node_navigation
node_recent_docs -->|"reads history"| node_local_storage
node_report_storage -.->|"persists reports"| node_local_storage
node_saved_reports -.->|"loads reports"| node_report_storage
node_user -->|"browses documents"| node_recent_docs
node_user -->|"views original"| node_document_viewer
node_user -.->|"views saved PDF"| node_saved_pdf

click node_onboarding "https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/screens/onboarding_screen.dart"
click node_navigation "https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/screens/main_navigation.dart"
click node_analyze "https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/screens/analyze_screen.dart"
click node_progress "https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/screens/analyzing_screen.dart"
click node_api_client "https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/services/api_service.dart"
click node_backend_api "https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara-backend/main.py"
click node_report_model "https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/models/contract_report.dart"
click node_report_view "https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/screens/report_screen.dart"
click node_risk_detail "https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/screens/risk_detail_screen.dart"
click node_recent_docs "https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/screens/recent_documents_screen.dart"
click node_document_viewer "https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/screens/document_viewer_screen.dart"
click node_saved_pdf "https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/screens/saved_pdf_viewer_screen.dart"
click node_saved_reports "https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/screens/saved_reports_screen.dart"
click node_report_storage "https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/services/report_storage_service.dart"
click node_local_storage "https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/services/storage_service.dart"

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_onboarding,node_navigation,node_analyze,node_progress,node_user toneBlue
class node_api_client,node_backend_api toneAmber
class node_report_model,node_report_view,node_risk_detail,node_recent_docs,node_document_viewer,node_saved_pdf,node_saved_reports toneMint
class node_report_storage,node_local_storage toneRose
class node_gemini toneIndigo
```

## Components

### Flutter experience

- [Onboarding](https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/screens/onboarding_screen.dart): `vistara/lib/screens/onboarding_screen.dart`
- [App navigation](https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/screens/main_navigation.dart): `vistara/lib/screens/main_navigation.dart`
- [Upload contract](https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/screens/analyze_screen.dart): `vistara/lib/screens/analyze_screen.dart`
- [Analysis progress](https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/screens/analyzing_screen.dart): `vistara/lib/screens/analyzing_screen.dart`

### Contract analysis

- [API client](https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/services/api_service.dart): `vistara/lib/services/api_service.dart`
- [Analysis API](https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara-backend/main.py): `vistara-backend/main.py`

### Reports and documents

- [Contract report model](https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/models/contract_report.dart): `vistara/lib/models/contract_report.dart`
- [Report display](https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/screens/report_screen.dart): `vistara/lib/screens/report_screen.dart`
- [Risk detail](https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/screens/risk_detail_screen.dart): `vistara/lib/screens/risk_detail_screen.dart`
- [Recent documents](https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/screens/recent_documents_screen.dart): `vistara/lib/screens/recent_documents_screen.dart`
- [Original PDF viewer](https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/screens/document_viewer_screen.dart): `vistara/lib/screens/document_viewer_screen.dart`
- [Saved PDF viewer](https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/screens/saved_pdf_viewer_screen.dart): `vistara/lib/screens/saved_pdf_viewer_screen.dart`
- [Saved reports](https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/screens/saved_reports_screen.dart): `vistara/lib/screens/saved_reports_screen.dart`

### Local persistence

- [Report storage](https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/services/report_storage_service.dart): `vistara/lib/services/report_storage_service.dart`
- [Local storage](https://github.com/jahanvi11-1/vistara-ai/blob/main/vistara/lib/services/storage_service.dart): `vistara/lib/services/storage_service.dart`

### Other components

- **User**
- **Google Gemini**

## Connections

- User → Onboarding: starts (evidence: `README.md`)
- User → Upload contract: submits contract (evidence: `README.md`)
- Upload contract → API client: sends upload (evidence: `README.md`)
- API client → Analysis API: calls analysis API (evidence: `README.md`)
- Analysis API → Google Gemini: requests assessment (evidence: `README.md`)
- Analysis API → API client: returns risk report (evidence: `README.md`)
- API client → Contract report model: provides report data
- Contract report model → Report display: renders results
- Report display → Risk detail: opens risk detail
- User → App navigation: uses app
- Recent documents → Local storage: reads history (evidence: `README.md`)
- Report storage → Local storage: persists reports
- Saved reports → Report storage: loads reports
- User → Recent documents: browses documents (evidence: `README.md`)
- User → Original PDF viewer: views original (evidence: `README.md`)
- User → Saved PDF viewer: views saved PDF
