# shagunagg12/carbonverify architecture

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

- Interactive diagram: https://gitdiagram.com/shagunagg12/carbonverify
- Repository: https://github.com/shagunagg12/carbonverify

## Overview

CarbonVerify turns field-document photos into auditable, reviewable evidence. Operators capture and submit images; disconnected uploads are queued locally and retried by the app, while the backend checks duplicates, persists uploads, runs OCR, and stores extracted fields and audit events. Reviewers search the resulting documents, inspect confidence and image bounding boxes, then edit, approve, or reject them. The graph retains documented dashboard, traceability, and offline capabilities; some backend persistence and endpoint details are visible only through excerpts and README statements.

Main entry points: [`backend/src/routes/documentRoutes.ts`](https://github.com/shagunagg12/carbonverify/blob/main/backend/src/routes/documentRoutes.ts) (Document endpoints), [`frontend/src/App.tsx`](https://github.com/shagunagg12/carbonverify/blob/main/frontend/src/App.tsx) (App routing), [`frontend/src/pages/ReviewBoard.tsx`](https://github.com/shagunagg12/carbonverify/blob/main/frontend/src/pages/ReviewBoard.tsx) (Review dashboard), [`frontend/src/pages/Capture.tsx`](https://github.com/shagunagg12/carbonverify/blob/main/frontend/src/pages/Capture.tsx) (Evidence capture)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Capture &amp; Sync"]
  node_app["App routing<br/>[App.tsx]"]
  node_identity["User context<br/>[UserContext.tsx]"]
  node_header["Navigation &amp; status<br/>[Header.tsx]"]
  node_capture_view["Evidence capture<br/>[Capture.tsx]"]
  node_sync_queue[("Offline queue<br/>[syncQueue.ts]")]
end

subgraph group_review["Review Experience"]
  node_review_board["Review dashboard<br/>[ReviewBoard.tsx]"]
  node_document_detail["Document verification<br/>[DocumentDetail.tsx]"]
end

subgraph group_api["Evidence API"]
  node_api_server["Express API<br/>[index.ts]"]
  node_document_routes["Document endpoints<br/>[documentRoutes.ts]"]
  node_user_routes["User endpoints<br/>[userRoutes.ts]"]
end

subgraph group_processing["Extraction"]
  node_hashing["Duplicate hashing<br/>[hash.ts]"]
  node_ocr["OCR extraction<br/>[ocrService.ts]"]
end

subgraph group_storage["Persistence"]
  node_db_client["Prisma client<br/>[db.ts]"]
  node_database[("Evidence database<br/>[schema.prisma]")]
end

node_operator(("Field operator"))
node_reviewer(("Reviewer"))
node_tesseract["Tesseract engine"]

node_operator -->|"captures evidence"| node_capture_view
node_app -->|"routes to"| node_capture_view
node_app -->|"routes to"| node_review_board
node_app -->|"routes to"| node_document_detail
node_app -->|"syncs queue"| node_sync_queue
node_app -->|"renders"| node_header
node_app -->|"provides users"| node_identity
node_identity -->|"fetches users"| node_user_routes
node_header -->|"selects user"| node_identity
node_header -->|"reads queue"| node_sync_queue
node_capture_view -->|"queues offline"| node_sync_queue
node_capture_view -->|"uploads image"| node_document_routes
node_reviewer -->|"searches evidence"| node_review_board
node_review_board -->|"reads queue"| node_sync_queue
node_review_board -->|"requests metrics"| node_document_routes
node_review_board -->|"opens document"| node_document_detail
node_document_detail -->|"loads and reviews"| node_document_routes
node_api_server -->|"registers routes"| node_document_routes
node_api_server -->|"registers routes"| node_user_routes
node_document_routes -->|"checks duplicate"| node_hashing
node_document_routes -->|"runs extraction"| node_ocr
node_ocr -->|"recognizes image"| node_tesseract
node_document_routes -->|"persists evidence"| node_db_client
node_user_routes -->|"reads and seeds users"| node_db_client
node_db_client -.->|"queries records"| node_database

click node_app "https://github.com/shagunagg12/carbonverify/blob/main/frontend/src/App.tsx"
click node_identity "https://github.com/shagunagg12/carbonverify/blob/main/frontend/src/context/UserContext.tsx"
click node_header "https://github.com/shagunagg12/carbonverify/blob/main/frontend/src/components/Header.tsx"
click node_capture_view "https://github.com/shagunagg12/carbonverify/blob/main/frontend/src/pages/Capture.tsx"
click node_sync_queue "https://github.com/shagunagg12/carbonverify/blob/main/frontend/src/lib/syncQueue.ts"
click node_review_board "https://github.com/shagunagg12/carbonverify/blob/main/frontend/src/pages/ReviewBoard.tsx"
click node_document_detail "https://github.com/shagunagg12/carbonverify/blob/main/frontend/src/pages/DocumentDetail.tsx"
click node_api_server "https://github.com/shagunagg12/carbonverify/blob/main/backend/src/index.ts"
click node_document_routes "https://github.com/shagunagg12/carbonverify/blob/main/backend/src/routes/documentRoutes.ts"
click node_user_routes "https://github.com/shagunagg12/carbonverify/blob/main/backend/src/routes/userRoutes.ts"
click node_hashing "https://github.com/shagunagg12/carbonverify/blob/main/backend/src/utils/hash.ts"
click node_ocr "https://github.com/shagunagg12/carbonverify/blob/main/backend/src/services/ocrService.ts"
click node_db_client "https://github.com/shagunagg12/carbonverify/blob/main/backend/src/db.ts"
click node_database "https://github.com/shagunagg12/carbonverify/blob/main/backend/prisma/schema.prisma"

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_identity,node_header,node_capture_view,node_sync_queue,node_reviewer toneBlue
class node_review_board,node_document_detail toneAmber
class node_api_server,node_document_routes,node_user_routes toneMint
class node_hashing,node_ocr toneRose
class node_db_client,node_database,node_operator,node_tesseract toneIndigo
```

## Components

### Capture & Sync

- [App routing](https://github.com/shagunagg12/carbonverify/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [User context](https://github.com/shagunagg12/carbonverify/blob/main/frontend/src/context/UserContext.tsx): `frontend/src/context/UserContext.tsx`
- [Navigation & status](https://github.com/shagunagg12/carbonverify/blob/main/frontend/src/components/Header.tsx): `frontend/src/components/Header.tsx`
- [Evidence capture](https://github.com/shagunagg12/carbonverify/blob/main/frontend/src/pages/Capture.tsx): `frontend/src/pages/Capture.tsx`
- [Offline queue](https://github.com/shagunagg12/carbonverify/blob/main/frontend/src/lib/syncQueue.ts): `frontend/src/lib/syncQueue.ts`

### Review Experience

- [Review dashboard](https://github.com/shagunagg12/carbonverify/blob/main/frontend/src/pages/ReviewBoard.tsx): `frontend/src/pages/ReviewBoard.tsx`
- [Document verification](https://github.com/shagunagg12/carbonverify/blob/main/frontend/src/pages/DocumentDetail.tsx): `frontend/src/pages/DocumentDetail.tsx`

### Evidence API

- [Express API](https://github.com/shagunagg12/carbonverify/blob/main/backend/src/index.ts): `backend/src/index.ts`
- [Document endpoints](https://github.com/shagunagg12/carbonverify/blob/main/backend/src/routes/documentRoutes.ts): `backend/src/routes/documentRoutes.ts`
- [User endpoints](https://github.com/shagunagg12/carbonverify/blob/main/backend/src/routes/userRoutes.ts): `backend/src/routes/userRoutes.ts`

### Extraction

- [Duplicate hashing](https://github.com/shagunagg12/carbonverify/blob/main/backend/src/utils/hash.ts): `backend/src/utils/hash.ts`
- [OCR extraction](https://github.com/shagunagg12/carbonverify/blob/main/backend/src/services/ocrService.ts): `backend/src/services/ocrService.ts`

### Persistence

- [Prisma client](https://github.com/shagunagg12/carbonverify/blob/main/backend/src/db.ts): `backend/src/db.ts`
- [Evidence database](https://github.com/shagunagg12/carbonverify/blob/main/backend/prisma/schema.prisma): `backend/prisma/schema.prisma`

### Other components

- **Field operator**
- **Reviewer**
- **Tesseract engine**

## Connections

- Field operator → Evidence capture: captures evidence (evidence: `README.md`)
- App routing → Evidence capture: routes to (evidence: `frontend/src/App.tsx`)
- App routing → Review dashboard: routes to (evidence: `frontend/src/App.tsx`)
- App routing → Document verification: routes to (evidence: `frontend/src/App.tsx`)
- App routing → Offline queue: syncs queue (evidence: `frontend/src/App.tsx`)
- App routing → Navigation & status: renders (evidence: `frontend/src/App.tsx`)
- App routing → User context: provides users (evidence: `frontend/src/App.tsx`)
- User context → User endpoints: fetches users (evidence: `frontend/src/context/UserContext.tsx`)
- Navigation & status → User context: selects user (evidence: `frontend/src/components/Header.tsx`)
- Navigation & status → Offline queue: reads queue (evidence: `frontend/src/components/Header.tsx`)
- Evidence capture → Offline queue: queues offline (evidence: `frontend/src/pages/Capture.tsx`)
- Evidence capture → Document endpoints: uploads image (evidence: `frontend/src/pages/Capture.tsx`)
- Reviewer → Review dashboard: searches evidence (evidence: `README.md`)
- Review dashboard → Offline queue: reads queue (evidence: `frontend/src/pages/ReviewBoard.tsx`)
- Review dashboard → Document endpoints: requests metrics (evidence: `README.md`)
- Review dashboard → Document verification: opens document (evidence: `frontend/src/pages/ReviewBoard.tsx`)
- Document verification → Document endpoints: loads and reviews (evidence: `README.md`)
- Express API → Document endpoints: registers routes (evidence: `backend/src/index.ts`)
- Express API → User endpoints: registers routes (evidence: `backend/src/index.ts`)
- Document endpoints → Duplicate hashing: checks duplicate (evidence: `backend/src/routes/documentRoutes.ts`)
- Document endpoints → OCR extraction: runs extraction (evidence: `backend/src/routes/documentRoutes.ts`)
- OCR extraction → Tesseract engine: recognizes image (evidence: `backend/src/services/ocrService.ts`)
- Document endpoints → Prisma client: persists evidence (evidence: `backend/src/routes/documentRoutes.ts`)
- User endpoints → Prisma client: reads and seeds users (evidence: `backend/src/routes/userRoutes.ts`)
- Prisma client → Evidence database: queries records
