How snehacodes27/achieveit-main- works
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: api.js HTTP API client · ocr.py Certificate scan API · achievements.py Achievement API · session.py Database sessions
Components 30
Web experience
- Student dashboard
frontend/src/pages/student/StudentDashboard.jsx - Professor dashboard
frontend/src/pages/teacher/TeacherDashboard.jsx - Admin command center
frontend/src/pages/admin/AdminDashboard.jsx - Login views
frontend/src/pages/auth/LoginPage.jsx - Role-based app
frontend/src/App.jsx - Session context
frontend/src/context/AuthContext.jsx - File compressor
frontend/src/utils/fileCompressor.js - HTTP API client
frontend/src/services/api.js
API workflows
- Authentication API
backend/app/api/v1/endpoints/auth.py - User management API
backend/app/api/v1/endpoints/users.py - Certificate scan API
backend/app/api/v1/endpoints/ocr.py - Achievement API
backend/app/api/v1/endpoints/achievements.py - Assistant API
backend/app/api/v1/endpoints/rag.py - API router
backend/app/api/v1/router.py
Domain and persistence
- Achievement records
backend/app/models/achievement.py - User records
backend/app/models/user.py - SQL database
Certificate verification
- Owner name validation
backend/app/services/name_validation_service.py - Duplicate detection
backend/app/services/duplicate_service.py - AI certificate OCR
backend/app/services/ocr_service.py - Certificate storage
backend/app/services/storage_service.py - Supabase Storage
Platform services
- RAG assistant service
backend/app/services/rag_service.py - Gemini AI
- JWT user dependency
backend/app/api/deps.py - Password and JWT security
backend/app/core/security.py - Database sessions
backend/app/db/session.py - Application settings
backend/app/core/config.py - FastAPI application
backend/app/main.py
Other components
- Portal visitor
Connections 48
- Portal visitor → Role-based app: opens portal
frontend/src/App.jsx - Role-based app → Session context: provides session
frontend/src/App.jsx - Role-based app → Login views: routes login
frontend/src/App.jsx - Role-based app → Student dashboard: routes student
frontend/src/App.jsx - Role-based app → Professor dashboard: routes faculty
frontend/src/App.jsx - Role-based app → Admin command center: routes admin
frontend/src/App.jsx - Login views → Session context: uses session
frontend/src/pages/auth/LoginPage.jsx - Session context → HTTP API client: requests login
frontend/src/context/AuthContext.jsx - Student dashboard → HTTP API client: calls achievement APIs
frontend/src/pages/student/StudentDashboard.jsx - Professor dashboard → HTTP API client: calls management APIs
frontend/src/pages/teacher/TeacherDashboard.jsx - Admin command center → HTTP API client: calls admin APIs
frontend/src/pages/admin/AdminDashboard.jsx - Student dashboard → File compressor: compresses uploads
frontend/src/pages/student/StudentDashboard.jsx - Professor dashboard → File compressor: compresses uploads
frontend/src/pages/teacher/TeacherDashboard.jsx - HTTP API client → Authentication API: posts login
frontend/src/services/api.js - HTTP API client → Achievement API: submits and fetches
frontend/src/services/api.js - HTTP API client → Certificate scan API: sends scan request
frontend/src/services/api.js - HTTP API client → User management API: requests user services
frontend/src/services/api.js - HTTP API client → Assistant API: sends query
frontend/src/services/api.js - API router → Authentication API: registers route
backend/app/api/v1/router.py - API router → User management API: registers route
backend/app/api/v1/router.py - API router → Certificate scan API: registers route
backend/app/api/v1/router.py - API router → Achievement API: registers route
backend/app/api/v1/router.py - API router → Assistant API: registers route
backend/app/api/v1/router.py - FastAPI application → API router: mounts routes
backend/app/main.py - Authentication API → Password and JWT security: uses password and JWT
backend/app/api/v1/endpoints/auth.py - JWT user dependency → Password and JWT security: decodes token
backend/app/api/deps.py - JWT user dependency → Database sessions: gets database session
backend/app/api/deps.py - JWT user dependency → User records: loads current user
backend/app/api/deps.py - Authentication API → Database sessions: queries database
backend/app/api/v1/endpoints/auth.py - User management API → Database sessions: queries database
backend/app/api/v1/endpoints/users.py - Achievement API → Database sessions: queries database
backend/app/api/v1/endpoints/achievements.py - Certificate scan API → Database sessions: queries database
backend/app/api/v1/endpoints/ocr.py - Assistant API → Database sessions: provides database session
backend/app/api/v1/endpoints/rag.py - Database sessions → SQL database: connects
backend/app/db/session.py - Achievement API → Achievement records: creates and reads
backend/app/api/v1/endpoints/achievements.py - Achievement API → Duplicate detection: checks duplicates
backend/app/api/v1/endpoints/achievements.py - Achievement API → Owner name validation: validates owner
backend/app/api/v1/endpoints/achievements.py - Achievement API → Certificate storage: stores certificate
backend/app/api/v1/endpoints/achievements.py - Certificate scan API → AI certificate OCR: extracts certificate fields
backend/app/api/v1/endpoints/ocr.py - Certificate scan API → Duplicate detection: checks duplicates
backend/app/api/v1/endpoints/ocr.py - Certificate scan API → Owner name validation: validates owner
backend/app/api/v1/endpoints/ocr.py - Certificate scan API → Certificate storage: stores certificate
backend/app/api/v1/endpoints/ocr.py - Certificate storage → Supabase Storage: uploads and signs
backend/app/services/storage_service.py - Assistant API → RAG assistant service: answers query
backend/app/api/v1/endpoints/rag.py - RAG assistant service → Achievement records: reads records
backend/app/services/rag_service.py - RAG assistant service → User records: joins user details
backend/app/services/rag_service.py - RAG assistant service → Gemini AI: generates response
backend/app/services/rag_service.py - Password and JWT security → Application settings: reads token settings
backend/app/core/security.py