How kishorgunithi/ai-based-project-evaluation-backend works
This is an Express backend for an AI project-evaluation platform, combining account access and project/team administration with human and AI assessment. A client submits project documents or a GitHub URL; the API queues work, document and repository workers prepare evidence, and evaluation agents produce results. The backend also exposes judge, student, analytics, and notification APIs. Some feature routes and worker internals are unsampled, so those branches are shown at subsystem level; edges are limited to documented or indexed relationships.
Main entry points: app.ts Express app · evaluationservices.ts Evaluation service · routes Domain APIs · evalution-graph.ts Evaluation graph
Components 22
API and access
- Express app
src/app.ts - Authentication
src/auth/auth.ts
Project operations
- Domain APIs
src/features/health/routes - Judge operations
src/services/judgeservices.ts - Student operations
src/services/studentservices.ts - Team operations
src/services/teamservices.ts - Analytics
src/services/analyticsservice.ts - Notifications
src/services/notificationservice.ts
AI evaluation
- Project evaluation API
src/features/project-evaluation/controllers/project-evaluation-controller.ts - Evaluation service
src/services/evaluationservices.ts - Evaluation graph
src/features/project-evaluation/langgraph/evalution-graph.ts - Repository analysis
src/features/project-evaluation/github/github-parser-service.ts - Hybrid evidence search
src/features/project-evaluation/rag/hybrid-rag-service.ts - LLM service
src/features/project-evaluation/services/llm-evaluation-service.ts
Workers and infrastructure
- Prisma database
src/database/prisma.ts - RabbitMQ
src/config/rabbitmq.ts - Queue producer
src/queue/producer.ts - Document worker
src/workers/doc-worker.ts - Agent worker
src/workers/agent-worker.ts - GitHub worker
src/workers/github-worker.ts - Prisma bridge
src/db/prisma.ts
Other components
- API client
Connections 21
- API client → Express app: sends requests
- Express app → Authentication: mounts auth
src/app.ts - Authentication → Prisma database: uses adapter
src/auth/auth.ts - Express app → Project evaluation API: mounts evaluation
src/app.ts - Express app → Domain APIs: mounts routes
src/app.ts - Domain APIs → Judge operations: uses service
src/features/health/routes/judgeRoutes.ts - Domain APIs → Student operations: routes requests
src/features/health/routes/studentRoutes.ts - Project evaluation API → Queue producer: publishes jobs
src/features/project-evaluation/controllers/project-evaluation-controller.ts - Queue producer → RabbitMQ: sends messages
src/queue/producer.ts - Document worker → RabbitMQ: consumes jobs
src/workers/doc-worker.ts - GitHub worker → RabbitMQ: consumes jobs
src/workers/github-worker.ts - Document worker → Agent worker: signals readiness
src/workers/doc-worker.ts - GitHub worker → Agent worker: signals readiness
src/workers/github-worker.ts - Agent worker → Evaluation graph: invokes agents
src/workers/agent-worker.ts - Evaluation service → Evaluation graph: builds graph
src/services/evaluationservices.ts - Evaluation service → Prisma bridge: queries records
src/services/evaluationservices.ts - Evaluation service → Notifications: uses service
src/services/evaluationservices.ts - Evaluation graph → Repository analysis: runs repository analysis
src/features/project-evaluation/langgraph/evalution-graph.ts - LLM service → Hybrid evidence search: retrieves evidence
- Team operations → Prisma bridge: queries records
src/services/teamservices.ts - Express app → Evaluation service: serves evaluation APIs