# kishorgunithi/ai-based-project-evaluation-backend architecture

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

- Interactive diagram: https://gitdiagram.com/kishorgunithi/ai-based-project-evaluation-backend
- Repository: https://github.com/kishorgunithi/ai-based-project-evaluation-backend

## Overview

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: [`src/app.ts`](https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/app.ts) (Express app), [`src/services/evaluationservices.ts`](https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/services/evaluationservices.ts) (Evaluation service), [`src/features/health/routes`](https://github.com/kishorgunithi/ai-based-project-evaluation-backend/tree/main/src/features/health/routes) (Domain APIs), [`src/features/project-evaluation/langgraph/evalution-graph.ts`](https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/features/project-evaluation/langgraph/evalution-graph.ts) (Evaluation graph)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and access"]
  node_app["Express app<br/>[app.ts]"]
  node_auth["Authentication<br/>[auth.ts]"]
end

subgraph group_domain["Project operations"]
  node_featureapi["Domain APIs"]
  node_judge["Judge operations<br/>[judgeservices.ts]"]
  node_student["Student operations<br/>[studentservices.ts]"]
  node_teams["Team operations<br/>[teamservices.ts]"]
  node_analytics["Analytics"]
  node_notifications["Notifications"]
end

subgraph group_evaluation["AI evaluation"]
  node_projectapi["Project evaluation API"]
  node_evalservice["Evaluation service"]
  node_graph["Evaluation graph<br/>[evalution-graph.ts]"]
  node_github["Repository analysis"]
  node_rag["Hybrid evidence search"]
  node_nim["LLM service"]
end

subgraph group_runtime["Workers and infrastructure"]
  node_authdb[("Prisma database<br/>[prisma.ts]")]
  node_rabbit["RabbitMQ<br/>[rabbitmq.ts]"]
  node_producer["Queue producer<br/>[producer.ts]"]
  node_docworker["Document worker<br/>[doc-worker.ts]"]
  node_agentworker["Agent worker<br/>[agent-worker.ts]"]
  node_githubworker["GitHub worker<br/>[github-worker.ts]"]
  node_dbbridge["Prisma bridge<br/>[prisma.ts]"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_app
node_app -->|"mounts auth"| node_auth
node_auth -->|"uses adapter"| node_authdb
node_app -->|"mounts evaluation"| node_projectapi
node_app -->|"mounts routes"| node_featureapi
node_featureapi -->|"uses service"| node_judge
node_featureapi -->|"routes requests"| node_student
node_projectapi -->|"publishes jobs"| node_producer
node_producer -->|"sends messages"| node_rabbit
node_docworker -->|"consumes jobs"| node_rabbit
node_githubworker -->|"consumes jobs"| node_rabbit
node_docworker -->|"signals readiness"| node_agentworker
node_githubworker -->|"signals readiness"| node_agentworker
node_agentworker -->|"invokes agents"| node_graph
node_evalservice -->|"builds graph"| node_graph
node_evalservice -->|"queries records"| node_dbbridge
node_evalservice -->|"uses service"| node_notifications
node_graph -->|"runs repository analysis"| node_github
node_nim -.->|"retrieves evidence"| node_rag
node_teams -->|"queries records"| node_dbbridge
node_app -.->|"serves evaluation APIs"| node_evalservice

click node_app "https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/app.ts"
click node_auth "https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/auth/auth.ts"
click node_authdb "https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/database/prisma.ts"
click node_projectapi "https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/features/project-evaluation/controllers/project-evaluation-controller.ts"
click node_featureapi "https://github.com/kishorgunithi/ai-based-project-evaluation-backend/tree/main/src/features/health/routes"
click node_judge "https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/services/judgeservices.ts"
click node_student "https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/services/studentservices.ts"
click node_teams "https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/services/teamservices.ts"
click node_analytics "https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/services/analyticsservice.ts"
click node_notifications "https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/services/notificationservice.ts"
click node_evalservice "https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/services/evaluationservices.ts"
click node_graph "https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/features/project-evaluation/langgraph/evalution-graph.ts"
click node_github "https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/features/project-evaluation/github/github-parser-service.ts"
click node_rag "https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/features/project-evaluation/rag/hybrid-rag-service.ts"
click node_rabbit "https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/config/rabbitmq.ts"
click node_producer "https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/queue/producer.ts"
click node_docworker "https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/workers/doc-worker.ts"
click node_agentworker "https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/workers/agent-worker.ts"
click node_githubworker "https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/workers/github-worker.ts"
click node_dbbridge "https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/db/prisma.ts"
click node_nim "https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/features/project-evaluation/services/llm-evaluation-service.ts"

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_auth,node_client toneBlue
class node_featureapi,node_judge,node_student,node_teams,node_analytics,node_notifications toneAmber
class node_projectapi,node_evalservice,node_graph,node_github,node_rag,node_nim toneMint
class node_authdb,node_rabbit,node_producer,node_docworker,node_agentworker,node_githubworker,node_dbbridge toneRose
```

## Components

### API and access

- [Express app](https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/app.ts): `src/app.ts`
- [Authentication](https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/auth/auth.ts): `src/auth/auth.ts`

### Project operations

- [Domain APIs](https://github.com/kishorgunithi/ai-based-project-evaluation-backend/tree/main/src/features/health/routes): `src/features/health/routes`
- [Judge operations](https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/services/judgeservices.ts): `src/services/judgeservices.ts`
- [Student operations](https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/services/studentservices.ts): `src/services/studentservices.ts`
- [Team operations](https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/services/teamservices.ts): `src/services/teamservices.ts`
- [Analytics](https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/services/analyticsservice.ts): `src/services/analyticsservice.ts`
- [Notifications](https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/services/notificationservice.ts): `src/services/notificationservice.ts`

### AI evaluation

- [Project evaluation API](https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/features/project-evaluation/controllers/project-evaluation-controller.ts): `src/features/project-evaluation/controllers/project-evaluation-controller.ts`
- [Evaluation service](https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/services/evaluationservices.ts): `src/services/evaluationservices.ts`
- [Evaluation graph](https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/features/project-evaluation/langgraph/evalution-graph.ts): `src/features/project-evaluation/langgraph/evalution-graph.ts`
- [Repository analysis](https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/features/project-evaluation/github/github-parser-service.ts): `src/features/project-evaluation/github/github-parser-service.ts`
- [Hybrid evidence search](https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/features/project-evaluation/rag/hybrid-rag-service.ts): `src/features/project-evaluation/rag/hybrid-rag-service.ts`
- [LLM service](https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/features/project-evaluation/services/llm-evaluation-service.ts): `src/features/project-evaluation/services/llm-evaluation-service.ts`

### Workers and infrastructure

- [Prisma database](https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/database/prisma.ts): `src/database/prisma.ts`
- [RabbitMQ](https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/config/rabbitmq.ts): `src/config/rabbitmq.ts`
- [Queue producer](https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/queue/producer.ts): `src/queue/producer.ts`
- [Document worker](https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/workers/doc-worker.ts): `src/workers/doc-worker.ts`
- [Agent worker](https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/workers/agent-worker.ts): `src/workers/agent-worker.ts`
- [GitHub worker](https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/workers/github-worker.ts): `src/workers/github-worker.ts`
- [Prisma bridge](https://github.com/kishorgunithi/ai-based-project-evaluation-backend/blob/main/src/db/prisma.ts): `src/db/prisma.ts`

### Other components

- **API client**

## Connections

- API client → Express app: sends requests
- Express app → Authentication: mounts auth (evidence: `src/app.ts`)
- Authentication → Prisma database: uses adapter (evidence: `src/auth/auth.ts`)
- Express app → Project evaluation API: mounts evaluation (evidence: `src/app.ts`)
- Express app → Domain APIs: mounts routes (evidence: `src/app.ts`)
- Domain APIs → Judge operations: uses service (evidence: `src/features/health/routes/judgeRoutes.ts`)
- Domain APIs → Student operations: routes requests (evidence: `src/features/health/routes/studentRoutes.ts`)
- Project evaluation API → Queue producer: publishes jobs (evidence: `src/features/project-evaluation/controllers/project-evaluation-controller.ts`)
- Queue producer → RabbitMQ: sends messages (evidence: `src/queue/producer.ts`)
- Document worker → RabbitMQ: consumes jobs (evidence: `src/workers/doc-worker.ts`)
- GitHub worker → RabbitMQ: consumes jobs (evidence: `src/workers/github-worker.ts`)
- Document worker → Agent worker: signals readiness (evidence: `src/workers/doc-worker.ts`)
- GitHub worker → Agent worker: signals readiness (evidence: `src/workers/github-worker.ts`)
- Agent worker → Evaluation graph: invokes agents (evidence: `src/workers/agent-worker.ts`)
- Evaluation service → Evaluation graph: builds graph (evidence: `src/services/evaluationservices.ts`)
- Evaluation service → Prisma bridge: queries records (evidence: `src/services/evaluationservices.ts`)
- Evaluation service → Notifications: uses service (evidence: `src/services/evaluationservices.ts`)
- Evaluation graph → Repository analysis: runs repository analysis (evidence: `src/features/project-evaluation/langgraph/evalution-graph.ts`)
- LLM service → Hybrid evidence search: retrieves evidence
- Team operations → Prisma bridge: queries records (evidence: `src/services/teamservices.ts`)
- Express app → Evaluation service: serves evaluation APIs
