# shabareesh390/evalai architecture

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

- Interactive diagram: https://gitdiagram.com/shabareesh390/evalai
- Repository: https://github.com/shabareesh390/evalai

## Overview

EvalAI is a Flutter app for educators to extract exam content from key-answer PDFs and evaluate student exams with Gemini AI. The documented workflow covers PDF-based exam extraction and automated grading; the README also names Firebase authentication and storage. The tree shows corresponding feature screens, providers, models, and services, but their source was not excerpted, so internal calls and detailed data flow cannot be verified. Native desktop runner components are included as runtime hosts, not as product build infrastructure.

Main entry points: [`lib/features/evaluation/screens/evaluate_student_screen.dart`](https://github.com/shabareesh390/evalai/blob/main/lib/features/evaluation/screens/evaluate_student_screen.dart) (Evaluation), [`lib/core/services/firestore_service.dart`](https://github.com/shabareesh390/evalai/blob/main/lib/core/services/firestore_service.dart) (Firestore access), [`lib/main.dart`](https://github.com/shabareesh390/evalai/blob/main/lib/main.dart) (Flutter app), [`lib/features/exam/screens/create_exam_screen.dart`](https://github.com/shabareesh390/evalai/blob/main/lib/features/exam/screens/create_exam_screen.dart) (Exam setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Exam workflow"]
  node_app["Flutter app<br/>[main.dart]"]
  node_exam_creation["Exam setup"]
  node_key_pdf["Key PDF extraction<br/>[ocr_service.dart]"]
  node_exam_provider["Exam management<br/>[exam_provider.dart]"]
  node_sheet_upload["Sheet upload"]
  node_evaluation["Evaluation"]
  node_gemini["Gemini grading"]
  node_evaluation_model["Evaluation records"]
  node_reports["PDF reports"]
  node_analytics["Analytics"]
end

subgraph group_identity["Access and overview"]
  node_auth_ui["Sign-in screens<br/>[login_screen.dart]"]
  node_auth_service["Firebase authentication<br/>[auth_service.dart]"]
  node_firebase[("Firebase services")]
  node_dashboard["Dashboard"]
  node_firestore["Firestore access"]
  node_user_model["User records<br/>[user_model.dart]"]
end

subgraph group_platform["Platform hosts"]
  node_windows_host["Windows Flutter host<br/>[flutter_window.h]"]
  node_windows_window["Windows window<br/>[win32_window.h]"]
  node_linux_app["Linux application<br/>[my_application.h]"]
end

node_educator(("Educator"))

node_educator -->|"uses"| node_app
node_app -.->|"starts exam setup"| node_exam_creation
node_exam_creation -->|"extracts key PDF"| node_key_pdf
node_key_pdf -.->|"provides exam content"| node_exam_provider
node_educator -.->|"uploads sheets"| node_sheet_upload
node_sheet_upload -.->|"submits for grading"| node_evaluation
node_evaluation -->|"requests grading"| node_gemini
node_gemini -.->|"produces evaluation"| node_evaluation_model
node_evaluation -.->|"creates report"| node_reports
node_evaluation_model -.->|"informs analytics"| node_analytics
node_educator -->|"signs in"| node_auth_ui
node_auth_ui -.->|"authenticates"| node_auth_service
node_auth_service -->|"uses Firebase auth"| node_firebase
node_dashboard -.->|"reads stored data"| node_firestore
node_firestore -->|"uses Firebase storage"| node_firebase
node_firestore -.->|"maps user data"| node_user_model
node_windows_host -->|"hosts view"| node_windows_window
node_linux_app -.->|"hosts Flutter app"| node_app

click node_app "https://github.com/shabareesh390/evalai/blob/main/lib/main.dart"
click node_exam_creation "https://github.com/shabareesh390/evalai/blob/main/lib/features/exam/screens/create_exam_screen.dart"
click node_key_pdf "https://github.com/shabareesh390/evalai/blob/main/lib/core/services/ocr_service.dart"
click node_exam_provider "https://github.com/shabareesh390/evalai/blob/main/lib/features/exam/providers/exam_provider.dart"
click node_sheet_upload "https://github.com/shabareesh390/evalai/blob/main/lib/features/exam/screens/upload_sheets_screen.dart"
click node_evaluation "https://github.com/shabareesh390/evalai/blob/main/lib/features/evaluation/screens/evaluate_student_screen.dart"
click node_gemini "https://github.com/shabareesh390/evalai/blob/main/lib/core/services/gemini_service.dart"
click node_evaluation_model "https://github.com/shabareesh390/evalai/blob/main/lib/core/models/evaluation_model.dart"
click node_reports "https://github.com/shabareesh390/evalai/blob/main/lib/core/services/pdf_report_service.dart"
click node_analytics "https://github.com/shabareesh390/evalai/blob/main/lib/features/analytics/screens/analytics_screen.dart"
click node_auth_ui "https://github.com/shabareesh390/evalai/blob/main/lib/features/authentication/screens/login_screen.dart"
click node_auth_service "https://github.com/shabareesh390/evalai/blob/main/lib/core/services/auth_service.dart"
click node_dashboard "https://github.com/shabareesh390/evalai/blob/main/lib/features/dashboard/screens/dashboard_screen.dart"
click node_firestore "https://github.com/shabareesh390/evalai/blob/main/lib/core/services/firestore_service.dart"
click node_user_model "https://github.com/shabareesh390/evalai/blob/main/lib/core/models/user_model.dart"
click node_windows_host "https://github.com/shabareesh390/evalai/blob/main/windows/runner/flutter_window.h"
click node_windows_window "https://github.com/shabareesh390/evalai/blob/main/windows/runner/win32_window.h"
click node_linux_app "https://github.com/shabareesh390/evalai/blob/main/linux/runner/my_application.h"

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_exam_creation,node_key_pdf,node_exam_provider,node_sheet_upload,node_evaluation,node_gemini,node_evaluation_model,node_reports,node_analytics toneBlue
class node_auth_ui,node_auth_service,node_firebase,node_dashboard,node_firestore,node_user_model toneAmber
class node_windows_host,node_windows_window,node_linux_app toneMint
class node_educator toneIndigo
```

## Components

### Exam workflow

- [Flutter app](https://github.com/shabareesh390/evalai/blob/main/lib/main.dart): `lib/main.dart`
- [Exam setup](https://github.com/shabareesh390/evalai/blob/main/lib/features/exam/screens/create_exam_screen.dart): `lib/features/exam/screens/create_exam_screen.dart`
- [Key PDF extraction](https://github.com/shabareesh390/evalai/blob/main/lib/core/services/ocr_service.dart): `lib/core/services/ocr_service.dart`
- [Exam management](https://github.com/shabareesh390/evalai/blob/main/lib/features/exam/providers/exam_provider.dart): `lib/features/exam/providers/exam_provider.dart`
- [Sheet upload](https://github.com/shabareesh390/evalai/blob/main/lib/features/exam/screens/upload_sheets_screen.dart): `lib/features/exam/screens/upload_sheets_screen.dart`
- [Evaluation](https://github.com/shabareesh390/evalai/blob/main/lib/features/evaluation/screens/evaluate_student_screen.dart): `lib/features/evaluation/screens/evaluate_student_screen.dart`
- [Gemini grading](https://github.com/shabareesh390/evalai/blob/main/lib/core/services/gemini_service.dart): `lib/core/services/gemini_service.dart`
- [Evaluation records](https://github.com/shabareesh390/evalai/blob/main/lib/core/models/evaluation_model.dart): `lib/core/models/evaluation_model.dart`
- [PDF reports](https://github.com/shabareesh390/evalai/blob/main/lib/core/services/pdf_report_service.dart): `lib/core/services/pdf_report_service.dart`
- [Analytics](https://github.com/shabareesh390/evalai/blob/main/lib/features/analytics/screens/analytics_screen.dart): `lib/features/analytics/screens/analytics_screen.dart`

### Access and overview

- [Sign-in screens](https://github.com/shabareesh390/evalai/blob/main/lib/features/authentication/screens/login_screen.dart): `lib/features/authentication/screens/login_screen.dart`
- [Firebase authentication](https://github.com/shabareesh390/evalai/blob/main/lib/core/services/auth_service.dart): `lib/core/services/auth_service.dart`
- **Firebase services**
- [Dashboard](https://github.com/shabareesh390/evalai/blob/main/lib/features/dashboard/screens/dashboard_screen.dart): `lib/features/dashboard/screens/dashboard_screen.dart`
- [Firestore access](https://github.com/shabareesh390/evalai/blob/main/lib/core/services/firestore_service.dart): `lib/core/services/firestore_service.dart`
- [User records](https://github.com/shabareesh390/evalai/blob/main/lib/core/models/user_model.dart): `lib/core/models/user_model.dart`

### Platform hosts

- [Windows Flutter host](https://github.com/shabareesh390/evalai/blob/main/windows/runner/flutter_window.h): `windows/runner/flutter_window.h`
- [Windows window](https://github.com/shabareesh390/evalai/blob/main/windows/runner/win32_window.h): `windows/runner/win32_window.h`
- [Linux application](https://github.com/shabareesh390/evalai/blob/main/linux/runner/my_application.h): `linux/runner/my_application.h`

### Other components

- **Educator**

## Connections

- Educator → Flutter app: uses (evidence: `README.md`)
- Flutter app → Exam setup: starts exam setup
- Exam setup → Key PDF extraction: extracts key PDF (evidence: `README.md`)
- Key PDF extraction → Exam management: provides exam content
- Educator → Sheet upload: uploads sheets
- Sheet upload → Evaluation: submits for grading
- Evaluation → Gemini grading: requests grading (evidence: `README.md`)
- Gemini grading → Evaluation records: produces evaluation
- Evaluation → PDF reports: creates report
- Evaluation records → Analytics: informs analytics
- Educator → Sign-in screens: signs in (evidence: `README.md`)
- Sign-in screens → Firebase authentication: authenticates
- Firebase authentication → Firebase services: uses Firebase auth (evidence: `README.md`)
- Dashboard → Firestore access: reads stored data
- Firestore access → Firebase services: uses Firebase storage (evidence: `README.md`)
- Firestore access → User records: maps user data
- Windows Flutter host → Windows window: hosts view (evidence: `windows/runner/flutter_window.h`)
- Linux application → Flutter app: hosts Flutter app
