# snehacodes27/achieveit-main- architecture

> Architecture diagram of the GitHub repository snehacodes27/achieveit-main-, 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/snehacodes27/achieveit-main-
- Repository: https://github.com/snehacodes27/achieveit-main-

## Overview

AchieveIT is an institutional achievement submission, verification, and reporting portal. Students and faculty authenticate, submit achievement details and certificate proofs, and review role-specific dashboards; administrators manage users and records, export reports, and query institutional data through an AI assistant. The graph covers the documented OCR, duplicate and ownership checks, certificate storage, and reporting capabilities. Some subsystem links rely on the SOURCE INDEX or README because their implementation excerpts were not provided.

Main entry points: [`frontend/src/services/api.js`](https://github.com/snehacodes27/achieveit-main-/blob/main/frontend/src/services/api.js) (HTTP API client), [`backend/app/api/v1/endpoints/ocr.py`](https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/api/v1/endpoints/ocr.py) (Certificate scan API), [`backend/app/api/v1/endpoints/achievements.py`](https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/api/v1/endpoints/achievements.py) (Achievement API), [`backend/app/db/session.py`](https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/db/session.py) (Database sessions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Web experience"]
  node_student["Student dashboard"]
  node_faculty["Professor dashboard"]
  node_admin["Admin command center<br/>[AdminDashboard.jsx]"]
  node_login["Login views<br/>[LoginPage.jsx]"]
  node_app["Role-based app<br/>[App.jsx]"]
  node_authctx["Session context<br/>[AuthContext.jsx]"]
  node_compressor["File compressor<br/>[fileCompressor.js]"]
  node_client["HTTP API client<br/>[api.js]"]
end

subgraph group_api["API workflows"]
  node_authapi["Authentication API<br/>[auth.py]"]
  node_usersapi["User management API<br/>[users.py]"]
  node_ocrapi["Certificate scan API<br/>[ocr.py]"]
  node_achapi["Achievement API<br/>[achievements.py]"]
  node_ragapi["Assistant API<br/>[rag.py]"]
  node_router["API router<br/>[router.py]"]
end

subgraph group_domain["Domain and persistence"]
  node_achievements["Achievement records<br/>[achievement.py]"]
  node_users["User records<br/>[user.py]"]
  node_database[("SQL database")]
end

subgraph group_verification["Certificate verification"]
  node_namecheck["Owner name validation"]
  node_duplicate["Duplicate detection"]
  node_ocr["AI certificate OCR<br/>[ocr_service.py]"]
  node_storage["Certificate storage<br/>[storage_service.py]"]
  node_supabase[("Supabase Storage")]
end

subgraph group_platform["Platform services"]
  node_rag["RAG assistant service<br/>[rag_service.py]"]
  node_gemini(("Gemini AI"))
  node_deps["JWT user dependency<br/>[deps.py]"]
  node_security["Password and JWT security<br/>[security.py]"]
  node_session["Database sessions<br/>[session.py]"]
  node_config["Application settings<br/>[config.py]"]
  node_main["FastAPI application<br/>[main.py]"]
end

node_visitor(("Portal visitor"))

node_visitor -->|"opens portal"| node_app
node_app -->|"provides session"| node_authctx
node_app -->|"routes login"| node_login
node_app -->|"routes student"| node_student
node_app -->|"routes faculty"| node_faculty
node_app -->|"routes admin"| node_admin
node_login -->|"uses session"| node_authctx
node_authctx -->|"requests login"| node_client
node_student -->|"calls achievement APIs"| node_client
node_faculty -->|"calls management APIs"| node_client
node_admin -->|"calls admin APIs"| node_client
node_student -->|"compresses uploads"| node_compressor
node_faculty -->|"compresses uploads"| node_compressor
node_client -->|"posts login"| node_authapi
node_client -->|"submits and fetches"| node_achapi
node_client -->|"sends scan request"| node_ocrapi
node_client -->|"requests user services"| node_usersapi
node_client -->|"sends query"| node_ragapi
node_router -->|"registers route"| node_authapi
node_router -->|"registers route"| node_usersapi
node_router -->|"registers route"| node_ocrapi
node_router -->|"registers route"| node_achapi
node_router -->|"registers route"| node_ragapi
node_main -->|"mounts routes"| node_router
node_authapi -->|"uses password and JWT"| node_security
node_deps -->|"decodes token"| node_security
node_deps -->|"gets database session"| node_session
node_deps -->|"loads current user"| node_users
node_authapi -->|"queries database"| node_session
node_usersapi -->|"queries database"| node_session
node_achapi -->|"queries database"| node_session
node_ocrapi -->|"queries database"| node_session
node_ragapi -->|"provides database session"| node_session
node_session -->|"connects"| node_database
node_achapi -->|"creates and reads"| node_achievements
node_achapi -->|"checks duplicates"| node_duplicate
node_achapi -->|"validates owner"| node_namecheck
node_achapi -->|"stores certificate"| node_storage
node_ocrapi -->|"extracts certificate fields"| node_ocr
node_ocrapi -->|"checks duplicates"| node_duplicate
node_ocrapi -->|"validates owner"| node_namecheck
node_ocrapi -->|"stores certificate"| node_storage
node_storage -->|"uploads and signs"| node_supabase
node_ragapi -->|"answers query"| node_rag
node_rag -->|"reads records"| node_achievements
node_rag -->|"joins user details"| node_users
node_rag -->|"generates response"| node_gemini
node_security -->|"reads token settings"| node_config

click node_student "https://github.com/snehacodes27/achieveit-main-/blob/main/frontend/src/pages/student/StudentDashboard.jsx"
click node_faculty "https://github.com/snehacodes27/achieveit-main-/blob/main/frontend/src/pages/teacher/TeacherDashboard.jsx"
click node_admin "https://github.com/snehacodes27/achieveit-main-/blob/main/frontend/src/pages/admin/AdminDashboard.jsx"
click node_login "https://github.com/snehacodes27/achieveit-main-/blob/main/frontend/src/pages/auth/LoginPage.jsx"
click node_app "https://github.com/snehacodes27/achieveit-main-/blob/main/frontend/src/App.jsx"
click node_authctx "https://github.com/snehacodes27/achieveit-main-/blob/main/frontend/src/context/AuthContext.jsx"
click node_compressor "https://github.com/snehacodes27/achieveit-main-/blob/main/frontend/src/utils/fileCompressor.js"
click node_client "https://github.com/snehacodes27/achieveit-main-/blob/main/frontend/src/services/api.js"
click node_authapi "https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/api/v1/endpoints/auth.py"
click node_usersapi "https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/api/v1/endpoints/users.py"
click node_ocrapi "https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/api/v1/endpoints/ocr.py"
click node_achapi "https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/api/v1/endpoints/achievements.py"
click node_ragapi "https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/api/v1/endpoints/rag.py"
click node_router "https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/api/v1/router.py"
click node_achievements "https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/models/achievement.py"
click node_users "https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/models/user.py"
click node_namecheck "https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/services/name_validation_service.py"
click node_duplicate "https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/services/duplicate_service.py"
click node_ocr "https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/services/ocr_service.py"
click node_storage "https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/services/storage_service.py"
click node_rag "https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/services/rag_service.py"
click node_deps "https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/api/deps.py"
click node_security "https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/core/security.py"
click node_session "https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/db/session.py"
click node_config "https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/core/config.py"
click node_main "https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/main.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_student,node_faculty,node_admin,node_login,node_app,node_authctx,node_compressor,node_client toneBlue
class node_authapi,node_usersapi,node_ocrapi,node_achapi,node_ragapi,node_router toneAmber
class node_achievements,node_users,node_database toneMint
class node_namecheck,node_duplicate,node_ocr,node_storage,node_supabase toneRose
class node_rag,node_gemini,node_deps,node_security,node_session,node_config,node_main,node_visitor toneIndigo
```

## Components

### Web experience

- [Student dashboard](https://github.com/snehacodes27/achieveit-main-/blob/main/frontend/src/pages/student/StudentDashboard.jsx): `frontend/src/pages/student/StudentDashboard.jsx`
- [Professor dashboard](https://github.com/snehacodes27/achieveit-main-/blob/main/frontend/src/pages/teacher/TeacherDashboard.jsx): `frontend/src/pages/teacher/TeacherDashboard.jsx`
- [Admin command center](https://github.com/snehacodes27/achieveit-main-/blob/main/frontend/src/pages/admin/AdminDashboard.jsx): `frontend/src/pages/admin/AdminDashboard.jsx`
- [Login views](https://github.com/snehacodes27/achieveit-main-/blob/main/frontend/src/pages/auth/LoginPage.jsx): `frontend/src/pages/auth/LoginPage.jsx`
- [Role-based app](https://github.com/snehacodes27/achieveit-main-/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Session context](https://github.com/snehacodes27/achieveit-main-/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [File compressor](https://github.com/snehacodes27/achieveit-main-/blob/main/frontend/src/utils/fileCompressor.js): `frontend/src/utils/fileCompressor.js`
- [HTTP API client](https://github.com/snehacodes27/achieveit-main-/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### API workflows

- [Authentication API](https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/api/v1/endpoints/auth.py): `backend/app/api/v1/endpoints/auth.py`
- [User management API](https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/api/v1/endpoints/users.py): `backend/app/api/v1/endpoints/users.py`
- [Certificate scan API](https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/api/v1/endpoints/ocr.py): `backend/app/api/v1/endpoints/ocr.py`
- [Achievement API](https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/api/v1/endpoints/achievements.py): `backend/app/api/v1/endpoints/achievements.py`
- [Assistant API](https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/api/v1/endpoints/rag.py): `backend/app/api/v1/endpoints/rag.py`
- [API router](https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/api/v1/router.py): `backend/app/api/v1/router.py`

### Domain and persistence

- [Achievement records](https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/models/achievement.py): `backend/app/models/achievement.py`
- [User records](https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/models/user.py): `backend/app/models/user.py`
- **SQL database**

### Certificate verification

- [Owner name validation](https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/services/name_validation_service.py): `backend/app/services/name_validation_service.py`
- [Duplicate detection](https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/services/duplicate_service.py): `backend/app/services/duplicate_service.py`
- [AI certificate OCR](https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/services/ocr_service.py): `backend/app/services/ocr_service.py`
- [Certificate storage](https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/services/storage_service.py): `backend/app/services/storage_service.py`
- **Supabase Storage**

### Platform services

- [RAG assistant service](https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/services/rag_service.py): `backend/app/services/rag_service.py`
- **Gemini AI**
- [JWT user dependency](https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/api/deps.py): `backend/app/api/deps.py`
- [Password and JWT security](https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/core/security.py): `backend/app/core/security.py`
- [Database sessions](https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/db/session.py): `backend/app/db/session.py`
- [Application settings](https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/core/config.py): `backend/app/core/config.py`
- [FastAPI application](https://github.com/snehacodes27/achieveit-main-/blob/main/backend/app/main.py): `backend/app/main.py`

### Other components

- **Portal visitor**

## Connections

- Portal visitor → Role-based app: opens portal (evidence: `frontend/src/App.jsx`)
- Role-based app → Session context: provides session (evidence: `frontend/src/App.jsx`)
- Role-based app → Login views: routes login (evidence: `frontend/src/App.jsx`)
- Role-based app → Student dashboard: routes student (evidence: `frontend/src/App.jsx`)
- Role-based app → Professor dashboard: routes faculty (evidence: `frontend/src/App.jsx`)
- Role-based app → Admin command center: routes admin (evidence: `frontend/src/App.jsx`)
- Login views → Session context: uses session (evidence: `frontend/src/pages/auth/LoginPage.jsx`)
- Session context → HTTP API client: requests login (evidence: `frontend/src/context/AuthContext.jsx`)
- Student dashboard → HTTP API client: calls achievement APIs (evidence: `frontend/src/pages/student/StudentDashboard.jsx`)
- Professor dashboard → HTTP API client: calls management APIs (evidence: `frontend/src/pages/teacher/TeacherDashboard.jsx`)
- Admin command center → HTTP API client: calls admin APIs (evidence: `frontend/src/pages/admin/AdminDashboard.jsx`)
- Student dashboard → File compressor: compresses uploads (evidence: `frontend/src/pages/student/StudentDashboard.jsx`)
- Professor dashboard → File compressor: compresses uploads (evidence: `frontend/src/pages/teacher/TeacherDashboard.jsx`)
- HTTP API client → Authentication API: posts login (evidence: `frontend/src/services/api.js`)
- HTTP API client → Achievement API: submits and fetches (evidence: `frontend/src/services/api.js`)
- HTTP API client → Certificate scan API: sends scan request (evidence: `frontend/src/services/api.js`)
- HTTP API client → User management API: requests user services (evidence: `frontend/src/services/api.js`)
- HTTP API client → Assistant API: sends query (evidence: `frontend/src/services/api.js`)
- API router → Authentication API: registers route (evidence: `backend/app/api/v1/router.py`)
- API router → User management API: registers route (evidence: `backend/app/api/v1/router.py`)
- API router → Certificate scan API: registers route (evidence: `backend/app/api/v1/router.py`)
- API router → Achievement API: registers route (evidence: `backend/app/api/v1/router.py`)
- API router → Assistant API: registers route (evidence: `backend/app/api/v1/router.py`)
- FastAPI application → API router: mounts routes (evidence: `backend/app/main.py`)
- Authentication API → Password and JWT security: uses password and JWT (evidence: `backend/app/api/v1/endpoints/auth.py`)
- JWT user dependency → Password and JWT security: decodes token (evidence: `backend/app/api/deps.py`)
- JWT user dependency → Database sessions: gets database session (evidence: `backend/app/api/deps.py`)
- JWT user dependency → User records: loads current user (evidence: `backend/app/api/deps.py`)
- Authentication API → Database sessions: queries database (evidence: `backend/app/api/v1/endpoints/auth.py`)
- User management API → Database sessions: queries database (evidence: `backend/app/api/v1/endpoints/users.py`)
- Achievement API → Database sessions: queries database (evidence: `backend/app/api/v1/endpoints/achievements.py`)
- Certificate scan API → Database sessions: queries database (evidence: `backend/app/api/v1/endpoints/ocr.py`)
- Assistant API → Database sessions: provides database session (evidence: `backend/app/api/v1/endpoints/rag.py`)
- Database sessions → SQL database: connects (evidence: `backend/app/db/session.py`)
- Achievement API → Achievement records: creates and reads (evidence: `backend/app/api/v1/endpoints/achievements.py`)
- Achievement API → Duplicate detection: checks duplicates (evidence: `backend/app/api/v1/endpoints/achievements.py`)
- Achievement API → Owner name validation: validates owner (evidence: `backend/app/api/v1/endpoints/achievements.py`)
- Achievement API → Certificate storage: stores certificate (evidence: `backend/app/api/v1/endpoints/achievements.py`)
- Certificate scan API → AI certificate OCR: extracts certificate fields (evidence: `backend/app/api/v1/endpoints/ocr.py`)
- Certificate scan API → Duplicate detection: checks duplicates (evidence: `backend/app/api/v1/endpoints/ocr.py`)
- Certificate scan API → Owner name validation: validates owner (evidence: `backend/app/api/v1/endpoints/ocr.py`)
- Certificate scan API → Certificate storage: stores certificate (evidence: `backend/app/api/v1/endpoints/ocr.py`)
- Certificate storage → Supabase Storage: uploads and signs (evidence: `backend/app/services/storage_service.py`)
- Assistant API → RAG assistant service: answers query (evidence: `backend/app/api/v1/endpoints/rag.py`)
- RAG assistant service → Achievement records: reads records (evidence: `backend/app/services/rag_service.py`)
- RAG assistant service → User records: joins user details (evidence: `backend/app/services/rag_service.py`)
- RAG assistant service → Gemini AI: generates response (evidence: `backend/app/services/rag_service.py`)
- Password and JWT security → Application settings: reads token settings (evidence: `backend/app/core/security.py`)
