# dmainak673-droid/edufind architecture

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

- Interactive diagram: https://gitdiagram.com/dmainak673-droid/edufind
- Repository: https://github.com/dmainak673-droid/edufind

## Overview

This is a research-document verification workspace: users upload papers, the backend extracts claims and citations, retrieves source evidence, and assesses claim support; the UI then exposes analysis, claim, citation, dashboard, and report views. The frontend also supports demo data and backend-health awareness. Backend relationships below follow the source index; frontend/backend route mapping is not fully established by the excerpts, so that boundary is shown as unverified rather than as a specific route call.

Main entry points: [`src/App.tsx`](https://github.com/dmainak673-droid/edufind/blob/main/src/App.tsx) (App routing), [`backend/app/services/analysis_pipeline.py`](https://github.com/dmainak673-droid/edufind/blob/main/backend/app/services/analysis_pipeline.py) (Analysis orchestration), [`backend/app/api/routes/documents.py`](https://github.com/dmainak673-droid/edufind/blob/main/backend/app/api/routes/documents.py) (Document routes), [`backend/app/api/routes/extraction.py`](https://github.com/dmainak673-droid/edufind/blob/main/backend/app/api/routes/extraction.py) (Extraction routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Research workspace UI"]
  node_app["App routing<br/>[App.tsx]"]
  node_workspace["Workspace state"]
  node_api_client["API client<br/>[client.ts]"]
  node_verification_api["Verification API<br/>[verification.ts]"]
  node_upload_page["Document upload<br/>[UploadPage.tsx]"]
  node_analysis_page["Analysis view<br/>[AnalysisPage.tsx]"]
  node_dashboard_page["Dashboard<br/>[DashboardPage.tsx]"]
  node_claim_page["Claim details"]
  node_citation_page["Citation explorer"]
  node_reports_page["Reports<br/>[ReportsPage.tsx]"]
  node_demo_data["Demo records<br/>[demoData.ts]"]
end

subgraph group_api["Backend API"]
  node_api_app["FastAPI app<br/>[main.py]"]
  node_documents_route["Document routes<br/>[documents.py]"]
  node_extraction_route["Extraction routes<br/>[extraction.py]"]
  node_analysis_route["Analysis routes<br/>[analysis.py]"]
  node_evidence_route["Evidence routes<br/>[evidence.py]"]
  node_verification_route["Verification routes<br/>[verification.py]"]
end

subgraph group_processing["Document analysis"]
  node_pipeline["Analysis orchestration"]
  node_pdf["PDF processing<br/>[pdf_service.py]"]
  node_extraction["Claims and citations"]
  node_evidence["Evidence retrieval"]
  node_verification["Claim verification"]
  node_research_providers["Research providers"]
  node_gemini["Gemini provider<br/>[gemini_provider.py]"]
end

subgraph group_persistence["State and evidence"]
  node_db_session["Database session<br/>[session.py]"]
  node_documents_store[("Documents<br/>[document.py]")]
  node_extractions_store[("Claims and citations<br/>[extraction.py]")]
  node_research_store[("Research evidence<br/>[research.py]")]
  node_verification_store[("Verification results<br/>[verification.py]")]
  node_file_storage["Uploaded files<br/>[storage.py]"]
  node_operation_lock["Operation locks<br/>[operation_lock.py]"]
end

node_researcher(("Researcher"))

node_researcher -->|"uses workspace"| node_app
node_app -->|"provides state"| node_workspace
node_app -->|"routes to"| node_upload_page
node_app -->|"routes to"| node_analysis_page
node_app -->|"routes to"| node_dashboard_page
node_app -->|"routes to"| node_claim_page
node_app -->|"routes to"| node_citation_page
node_app -->|"routes to"| node_reports_page
node_workspace -->|"checks health"| node_verification_api
node_workspace -->|"selects demo"| node_demo_data
node_upload_page -->|"uploads document"| node_verification_api
node_verification_api -->|"sends requests"| node_api_client
node_verification_api -.->|"targets upload API"| node_documents_route
node_analysis_route -->|"registered by"| node_api_app
node_documents_route -->|"registered by"| node_api_app
node_extraction_route -->|"registered by"| node_api_app
node_evidence_route -->|"registered by"| node_api_app
node_verification_route -->|"registered by"| node_api_app
node_documents_route -->|"extracts PDF text"| node_pdf
node_documents_route -->|"stores uploads"| node_file_storage
node_extraction_route -->|"runs extraction"| node_extraction
node_extraction_route -->|"starts analysis"| node_pipeline
node_verification_route -->|"runs verification"| node_verification
node_verification_route -->|"starts analysis"| node_pipeline
node_pipeline -->|"runs extraction"| node_extraction
node_pipeline -->|"retrieves evidence"| node_evidence
node_pipeline -->|"verifies claims"| node_verification
node_evidence -->|"queries providers"| node_research_providers
node_verification -->|"requests assessment"| node_gemini
node_documents_route -->|"uses database"| node_db_session
node_extraction_route -->|"uses database"| node_db_session
node_verification_route -->|"uses database"| node_db_session
node_pipeline -->|"records stages"| node_extractions_store
node_pipeline -->|"records stages"| node_research_store
node_pipeline -->|"records stages"| node_verification_store
node_documents_route -->|"guards operations"| node_operation_lock
node_extraction_route -->|"guards operations"| node_operation_lock
node_verification_route -->|"guards operations"| node_operation_lock

click node_app "https://github.com/dmainak673-droid/edufind/blob/main/src/App.tsx"
click node_workspace "https://github.com/dmainak673-droid/edufind/blob/main/src/context/WorkspaceContext.tsx"
click node_api_client "https://github.com/dmainak673-droid/edufind/blob/main/src/api/client.ts"
click node_verification_api "https://github.com/dmainak673-droid/edufind/blob/main/src/api/verification.ts"
click node_upload_page "https://github.com/dmainak673-droid/edufind/blob/main/src/pages/UploadPage.tsx"
click node_analysis_page "https://github.com/dmainak673-droid/edufind/blob/main/src/pages/AnalysisPage.tsx"
click node_dashboard_page "https://github.com/dmainak673-droid/edufind/blob/main/src/pages/DashboardPage.tsx"
click node_claim_page "https://github.com/dmainak673-droid/edufind/blob/main/src/pages/ClaimDetailsPage.tsx"
click node_citation_page "https://github.com/dmainak673-droid/edufind/blob/main/src/pages/CitationExplorerPage.tsx"
click node_reports_page "https://github.com/dmainak673-droid/edufind/blob/main/src/pages/ReportsPage.tsx"
click node_demo_data "https://github.com/dmainak673-droid/edufind/blob/main/src/data/demoData.ts"
click node_api_app "https://github.com/dmainak673-droid/edufind/blob/main/backend/app/main.py"
click node_documents_route "https://github.com/dmainak673-droid/edufind/blob/main/backend/app/api/routes/documents.py"
click node_extraction_route "https://github.com/dmainak673-droid/edufind/blob/main/backend/app/api/routes/extraction.py"
click node_analysis_route "https://github.com/dmainak673-droid/edufind/blob/main/backend/app/api/routes/analysis.py"
click node_evidence_route "https://github.com/dmainak673-droid/edufind/blob/main/backend/app/api/routes/evidence.py"
click node_verification_route "https://github.com/dmainak673-droid/edufind/blob/main/backend/app/api/routes/verification.py"
click node_pipeline "https://github.com/dmainak673-droid/edufind/blob/main/backend/app/services/analysis_pipeline.py"
click node_pdf "https://github.com/dmainak673-droid/edufind/blob/main/backend/app/services/pdf_service.py"
click node_extraction "https://github.com/dmainak673-droid/edufind/blob/main/backend/app/services/extraction_service.py"
click node_evidence "https://github.com/dmainak673-droid/edufind/blob/main/backend/app/services/evidence_retrieval.py"
click node_verification "https://github.com/dmainak673-droid/edufind/blob/main/backend/app/services/verification_service.py"
click node_research_providers "https://github.com/dmainak673-droid/edufind/blob/main/backend/app/services/research_providers.py"
click node_gemini "https://github.com/dmainak673-droid/edufind/blob/main/backend/app/services/gemini_provider.py"
click node_db_session "https://github.com/dmainak673-droid/edufind/blob/main/backend/app/db/session.py"
click node_documents_store "https://github.com/dmainak673-droid/edufind/blob/main/backend/app/db/models/document.py"
click node_extractions_store "https://github.com/dmainak673-droid/edufind/blob/main/backend/app/db/models/extraction.py"
click node_research_store "https://github.com/dmainak673-droid/edufind/blob/main/backend/app/db/models/research.py"
click node_verification_store "https://github.com/dmainak673-droid/edufind/blob/main/backend/app/db/models/verification.py"
click node_file_storage "https://github.com/dmainak673-droid/edufind/blob/main/backend/app/services/storage.py"
click node_operation_lock "https://github.com/dmainak673-droid/edufind/blob/main/backend/app/services/operation_lock.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_workspace,node_api_client,node_verification_api,node_upload_page,node_analysis_page,node_dashboard_page,node_claim_page,node_citation_page,node_reports_page,node_demo_data toneBlue
class node_api_app,node_documents_route,node_extraction_route,node_analysis_route,node_evidence_route,node_verification_route toneAmber
class node_pipeline,node_pdf,node_extraction,node_evidence,node_verification,node_research_providers,node_gemini toneMint
class node_db_session,node_documents_store,node_extractions_store,node_research_store,node_verification_store,node_file_storage,node_operation_lock toneRose
class node_researcher toneIndigo
```

## Components

### Research workspace UI

- [App routing](https://github.com/dmainak673-droid/edufind/blob/main/src/App.tsx): `src/App.tsx`
- [Workspace state](https://github.com/dmainak673-droid/edufind/blob/main/src/context/WorkspaceContext.tsx): `src/context/WorkspaceContext.tsx`
- [API client](https://github.com/dmainak673-droid/edufind/blob/main/src/api/client.ts): `src/api/client.ts`
- [Verification API](https://github.com/dmainak673-droid/edufind/blob/main/src/api/verification.ts): `src/api/verification.ts`
- [Document upload](https://github.com/dmainak673-droid/edufind/blob/main/src/pages/UploadPage.tsx): `src/pages/UploadPage.tsx`
- [Analysis view](https://github.com/dmainak673-droid/edufind/blob/main/src/pages/AnalysisPage.tsx): `src/pages/AnalysisPage.tsx`
- [Dashboard](https://github.com/dmainak673-droid/edufind/blob/main/src/pages/DashboardPage.tsx): `src/pages/DashboardPage.tsx`
- [Claim details](https://github.com/dmainak673-droid/edufind/blob/main/src/pages/ClaimDetailsPage.tsx): `src/pages/ClaimDetailsPage.tsx`
- [Citation explorer](https://github.com/dmainak673-droid/edufind/blob/main/src/pages/CitationExplorerPage.tsx): `src/pages/CitationExplorerPage.tsx`
- [Reports](https://github.com/dmainak673-droid/edufind/blob/main/src/pages/ReportsPage.tsx): `src/pages/ReportsPage.tsx`
- [Demo records](https://github.com/dmainak673-droid/edufind/blob/main/src/data/demoData.ts): `src/data/demoData.ts`

### Backend API

- [FastAPI app](https://github.com/dmainak673-droid/edufind/blob/main/backend/app/main.py): `backend/app/main.py`
- [Document routes](https://github.com/dmainak673-droid/edufind/blob/main/backend/app/api/routes/documents.py): `backend/app/api/routes/documents.py`
- [Extraction routes](https://github.com/dmainak673-droid/edufind/blob/main/backend/app/api/routes/extraction.py): `backend/app/api/routes/extraction.py`
- [Analysis routes](https://github.com/dmainak673-droid/edufind/blob/main/backend/app/api/routes/analysis.py): `backend/app/api/routes/analysis.py`
- [Evidence routes](https://github.com/dmainak673-droid/edufind/blob/main/backend/app/api/routes/evidence.py): `backend/app/api/routes/evidence.py`
- [Verification routes](https://github.com/dmainak673-droid/edufind/blob/main/backend/app/api/routes/verification.py): `backend/app/api/routes/verification.py`

### Document analysis

- [Analysis orchestration](https://github.com/dmainak673-droid/edufind/blob/main/backend/app/services/analysis_pipeline.py): `backend/app/services/analysis_pipeline.py`
- [PDF processing](https://github.com/dmainak673-droid/edufind/blob/main/backend/app/services/pdf_service.py): `backend/app/services/pdf_service.py`
- [Claims and citations](https://github.com/dmainak673-droid/edufind/blob/main/backend/app/services/extraction_service.py): `backend/app/services/extraction_service.py`
- [Evidence retrieval](https://github.com/dmainak673-droid/edufind/blob/main/backend/app/services/evidence_retrieval.py): `backend/app/services/evidence_retrieval.py`
- [Claim verification](https://github.com/dmainak673-droid/edufind/blob/main/backend/app/services/verification_service.py): `backend/app/services/verification_service.py`
- [Research providers](https://github.com/dmainak673-droid/edufind/blob/main/backend/app/services/research_providers.py): `backend/app/services/research_providers.py`
- [Gemini provider](https://github.com/dmainak673-droid/edufind/blob/main/backend/app/services/gemini_provider.py): `backend/app/services/gemini_provider.py`

### State and evidence

- [Database session](https://github.com/dmainak673-droid/edufind/blob/main/backend/app/db/session.py): `backend/app/db/session.py`
- [Documents](https://github.com/dmainak673-droid/edufind/blob/main/backend/app/db/models/document.py): `backend/app/db/models/document.py`
- [Claims and citations](https://github.com/dmainak673-droid/edufind/blob/main/backend/app/db/models/extraction.py): `backend/app/db/models/extraction.py`
- [Research evidence](https://github.com/dmainak673-droid/edufind/blob/main/backend/app/db/models/research.py): `backend/app/db/models/research.py`
- [Verification results](https://github.com/dmainak673-droid/edufind/blob/main/backend/app/db/models/verification.py): `backend/app/db/models/verification.py`
- [Uploaded files](https://github.com/dmainak673-droid/edufind/blob/main/backend/app/services/storage.py): `backend/app/services/storage.py`
- [Operation locks](https://github.com/dmainak673-droid/edufind/blob/main/backend/app/services/operation_lock.py): `backend/app/services/operation_lock.py`

### Other components

- **Researcher**

## Connections

- Researcher → App routing: uses workspace (evidence: `src/App.tsx`)
- App routing → Workspace state: provides state (evidence: `src/App.tsx`)
- App routing → Document upload: routes to (evidence: `src/App.tsx`)
- App routing → Analysis view: routes to (evidence: `src/App.tsx`)
- App routing → Dashboard: routes to (evidence: `src/App.tsx`)
- App routing → Claim details: routes to (evidence: `src/App.tsx`)
- App routing → Citation explorer: routes to (evidence: `src/App.tsx`)
- App routing → Reports: routes to (evidence: `src/App.tsx`)
- Workspace state → Verification API: checks health (evidence: `src/context/WorkspaceContext.tsx`)
- Workspace state → Demo records: selects demo (evidence: `src/context/WorkspaceContext.tsx`)
- Document upload → Verification API: uploads document (evidence: `src/pages/UploadPage.tsx`)
- Verification API → API client: sends requests (evidence: `src/api/verification.ts`)
- Verification API → Document routes: targets upload API
- Analysis routes → FastAPI app: registered by (evidence: `backend/app/main.py`)
- Document routes → FastAPI app: registered by (evidence: `backend/app/main.py`)
- Extraction routes → FastAPI app: registered by (evidence: `backend/app/main.py`)
- Evidence routes → FastAPI app: registered by (evidence: `backend/app/main.py`)
- Verification routes → FastAPI app: registered by (evidence: `backend/app/main.py`)
- Document routes → PDF processing: extracts PDF text (evidence: `backend/app/api/routes/documents.py`)
- Document routes → Uploaded files: stores uploads (evidence: `backend/app/api/routes/documents.py`)
- Extraction routes → Claims and citations: runs extraction (evidence: `backend/app/api/routes/extraction.py`)
- Extraction routes → Analysis orchestration: starts analysis (evidence: `backend/app/api/routes/extraction.py`)
- Verification routes → Claim verification: runs verification (evidence: `backend/app/api/routes/verification.py`)
- Verification routes → Analysis orchestration: starts analysis (evidence: `backend/app/api/routes/verification.py`)
- Analysis orchestration → Claims and citations: runs extraction (evidence: `backend/app/services/analysis_pipeline.py`)
- Analysis orchestration → Evidence retrieval: retrieves evidence (evidence: `backend/app/services/analysis_pipeline.py`)
- Analysis orchestration → Claim verification: verifies claims (evidence: `backend/app/services/analysis_pipeline.py`)
- Evidence retrieval → Research providers: queries providers (evidence: `backend/app/services/evidence_retrieval.py`)
- Claim verification → Gemini provider: requests assessment (evidence: `backend/app/services/verification_service.py`)
- Document routes → Database session: uses database (evidence: `backend/app/api/routes/documents.py`)
- Extraction routes → Database session: uses database (evidence: `backend/app/api/routes/extraction.py`)
- Verification routes → Database session: uses database (evidence: `backend/app/api/routes/verification.py`)
- Analysis orchestration → Claims and citations: records stages (evidence: `backend/app/services/analysis_pipeline.py`)
- Analysis orchestration → Research evidence: records stages (evidence: `backend/app/services/analysis_pipeline.py`)
- Analysis orchestration → Verification results: records stages (evidence: `backend/app/services/analysis_pipeline.py`)
- Document routes → Operation locks: guards operations (evidence: `backend/app/api/routes/documents.py`)
- Extraction routes → Operation locks: guards operations (evidence: `backend/app/api/routes/extraction.py`)
- Verification routes → Operation locks: guards operations (evidence: `backend/app/api/routes/verification.py`)
