# aluro7in/university-evaluation-system architecture

> Architecture diagram of the GitHub repository aluro7in/university-evaluation-system, 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/aluro7in/university-evaluation-system
- Repository: https://github.com/aluro7in/university-evaluation-system

## Overview

This is a university evaluation platform: students and administrators use a React interface to manage academic records and view grades, transcripts, and dashboards. Requests pass through the TypeScript tRPC gateway, which persists web records and delegates GPA and grade validation to the Java REST service when available. The Java backend provides academic policies and business services, persistence, and broader analysis, planning, attendance, and reporting capabilities. Some Java subsystems are documented but their internal call paths were not sampled, so those links are omitted or marked unverified.

Main entry points: [`java-backend/src/main/java/university/backend/service`](https://github.com/aluro7in/university-evaluation-system/tree/master/java-backend/src/main/java/university/backend/service) (Academic services), [`java-backend/src/main/java/university/backend/controller`](https://github.com/aluro7in/university-evaluation-system/tree/master/java-backend/src/main/java/university/backend/controller) (Spring REST API), [`server/routers.ts`](https://github.com/aluro7in/university-evaluation-system/blob/master/server/routers.ts) (tRPC gateway), [`client/src/App.tsx`](https://github.com/aluro7in/university-evaluation-system/blob/master/client/src/App.tsx) (React interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_web_ui["React interface<br/>[App.tsx]"]
  node_profiles_grades["Profiles and grades<br/>[StudentProfile.tsx]"]
  node_transcripts_dashboard["Transcript and dashboard<br/>[Transcript.tsx]"]
end

subgraph group_gateway["Web gateway"]
  node_trpc["tRPC gateway<br/>[routers.ts]"]
  node_web_db_access["Web data access<br/>[db.ts]"]
  node_java_adapter["Java API adapter<br/>[javaBackend.ts]"]
end

subgraph group_academic["Academic engine"]
  node_java_api["Spring REST API"]
  node_academic_services["Academic services"]
  node_enrollment_service["Enrollment workflow"]
  node_evaluation_policies["GPA policies"]
  node_grade_scale["Grade conversion<br/>[GradeScale.java]"]
  node_attendance["Attendance tracking"]
end

subgraph group_insight["Analysis and planning"]
  node_analysis["Analytics and risk"]
  node_forecast["Performance forecasts"]
  node_planning["Academic planning"]
  node_reports["Academic reports"]
end

subgraph group_persistence["Persistence"]
  node_web_schema[("Web records<br/>[schema.ts]")]
  node_web_store[("Web database")]
  node_java_persistence[("Academic records")]
  node_java_entities["Academic entities"]
  node_java_db[("Java database")]
end

node_student_admin(("Students and admins"))

node_student_admin -->|"uses"| node_web_ui
node_web_ui -->|"navigates"| node_profiles_grades
node_web_ui -->|"navigates"| node_transcripts_dashboard
node_profiles_grades -->|"requests data"| node_trpc
node_transcripts_dashboard -->|"requests data"| node_trpc
node_trpc -->|"reads and writes"| node_web_db_access
node_web_db_access -->|"uses schema"| node_web_schema
node_web_db_access -->|"persists records"| node_web_store
node_trpc -->|"delegates GPA"| node_java_adapter
node_java_adapter -->|"calls REST API"| node_java_api
node_java_api -.->|"dispatches requests"| node_academic_services
node_java_api -->|"dispatches enrollment"| node_enrollment_service
node_enrollment_service -->|"reads and writes"| node_java_persistence
node_enrollment_service -->|"checks prerequisites"| node_academic_services
node_java_persistence -.->|"stores entities"| node_java_entities
node_java_persistence -->|"persists records"| node_java_db
node_java_api -.->|"uses policies"| node_evaluation_policies
node_evaluation_policies -->|"converts grades"| node_grade_scale
node_academic_services -.->|"supports analytics"| node_analysis
node_academic_services -.->|"supports forecasts"| node_forecast
node_academic_services -.->|"supports planning"| node_planning
node_academic_services -.->|"supports attendance"| node_attendance
node_analysis -.->|"informs reports"| node_reports

click node_web_ui "https://github.com/aluro7in/university-evaluation-system/blob/master/client/src/App.tsx"
click node_profiles_grades "https://github.com/aluro7in/university-evaluation-system/blob/master/client/src/pages/StudentProfile.tsx"
click node_transcripts_dashboard "https://github.com/aluro7in/university-evaluation-system/blob/master/client/src/pages/Transcript.tsx"
click node_trpc "https://github.com/aluro7in/university-evaluation-system/blob/master/server/routers.ts"
click node_web_db_access "https://github.com/aluro7in/university-evaluation-system/blob/master/server/db.ts"
click node_java_adapter "https://github.com/aluro7in/university-evaluation-system/blob/master/server/javaBackend.ts"
click node_web_schema "https://github.com/aluro7in/university-evaluation-system/blob/master/drizzle/schema.ts"
click node_java_api "https://github.com/aluro7in/university-evaluation-system/tree/master/java-backend/src/main/java/university/backend/controller"
click node_academic_services "https://github.com/aluro7in/university-evaluation-system/tree/master/java-backend/src/main/java/university/backend/service"
click node_enrollment_service "https://github.com/aluro7in/university-evaluation-system/blob/master/java-backend/src/main/java/university/backend/service/EnrollmentService.java"
click node_evaluation_policies "https://github.com/aluro7in/university-evaluation-system/tree/master/java-backend/src/main/java/university/backend/policy"
click node_grade_scale "https://github.com/aluro7in/university-evaluation-system/blob/master/java-backend/src/main/java/university/backend/policy/GradeScale.java"
click node_java_persistence "https://github.com/aluro7in/university-evaluation-system/tree/master/java-backend/src/main/java/university/backend/repository"
click node_java_entities "https://github.com/aluro7in/university-evaluation-system/tree/master/java-backend/src/main/java/university/backend/domain/entity"
click node_analysis "https://github.com/aluro7in/university-evaluation-system/tree/master/java-backend/src/main/java/university/backend/analysis"
click node_forecast "https://github.com/aluro7in/university-evaluation-system/tree/master/java-backend/src/main/java/university/backend/forecast"
click node_planning "https://github.com/aluro7in/university-evaluation-system/tree/master/java-backend/src/main/java/university/backend/planning"
click node_attendance "https://github.com/aluro7in/university-evaluation-system/blob/master/java-backend/src/main/java/university/backend/business/AttendancePolicyService.java"
click node_reports "https://github.com/aluro7in/university-evaluation-system/tree/master/java-backend/src/main/java/university/backend/report"

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_web_ui,node_profiles_grades,node_transcripts_dashboard toneBlue
class node_trpc,node_web_db_access,node_java_adapter toneAmber
class node_java_api,node_academic_services,node_enrollment_service,node_evaluation_policies,node_grade_scale,node_attendance toneMint
class node_analysis,node_forecast,node_planning,node_reports toneRose
class node_web_schema,node_web_store,node_java_persistence,node_java_entities,node_java_db,node_student_admin toneIndigo
```

## Components

### Web experience

- [React interface](https://github.com/aluro7in/university-evaluation-system/blob/master/client/src/App.tsx): `client/src/App.tsx`
- [Profiles and grades](https://github.com/aluro7in/university-evaluation-system/blob/master/client/src/pages/StudentProfile.tsx): `client/src/pages/StudentProfile.tsx`
- [Transcript and dashboard](https://github.com/aluro7in/university-evaluation-system/blob/master/client/src/pages/Transcript.tsx): `client/src/pages/Transcript.tsx`

### Web gateway

- [tRPC gateway](https://github.com/aluro7in/university-evaluation-system/blob/master/server/routers.ts): `server/routers.ts`
- [Web data access](https://github.com/aluro7in/university-evaluation-system/blob/master/server/db.ts): `server/db.ts`
- [Java API adapter](https://github.com/aluro7in/university-evaluation-system/blob/master/server/javaBackend.ts): `server/javaBackend.ts`

### Academic engine

- [Spring REST API](https://github.com/aluro7in/university-evaluation-system/tree/master/java-backend/src/main/java/university/backend/controller): `java-backend/src/main/java/university/backend/controller`
- [Academic services](https://github.com/aluro7in/university-evaluation-system/tree/master/java-backend/src/main/java/university/backend/service): `java-backend/src/main/java/university/backend/service`
- [Enrollment workflow](https://github.com/aluro7in/university-evaluation-system/blob/master/java-backend/src/main/java/university/backend/service/EnrollmentService.java): `java-backend/src/main/java/university/backend/service/EnrollmentService.java`
- [GPA policies](https://github.com/aluro7in/university-evaluation-system/tree/master/java-backend/src/main/java/university/backend/policy): `java-backend/src/main/java/university/backend/policy`
- [Grade conversion](https://github.com/aluro7in/university-evaluation-system/blob/master/java-backend/src/main/java/university/backend/policy/GradeScale.java): `java-backend/src/main/java/university/backend/policy/GradeScale.java`
- [Attendance tracking](https://github.com/aluro7in/university-evaluation-system/blob/master/java-backend/src/main/java/university/backend/business/AttendancePolicyService.java): `java-backend/src/main/java/university/backend/business/AttendancePolicyService.java`

### Analysis and planning

- [Analytics and risk](https://github.com/aluro7in/university-evaluation-system/tree/master/java-backend/src/main/java/university/backend/analysis): `java-backend/src/main/java/university/backend/analysis`
- [Performance forecasts](https://github.com/aluro7in/university-evaluation-system/tree/master/java-backend/src/main/java/university/backend/forecast): `java-backend/src/main/java/university/backend/forecast`
- [Academic planning](https://github.com/aluro7in/university-evaluation-system/tree/master/java-backend/src/main/java/university/backend/planning): `java-backend/src/main/java/university/backend/planning`
- [Academic reports](https://github.com/aluro7in/university-evaluation-system/tree/master/java-backend/src/main/java/university/backend/report): `java-backend/src/main/java/university/backend/report`

### Persistence

- [Web records](https://github.com/aluro7in/university-evaluation-system/blob/master/drizzle/schema.ts): `drizzle/schema.ts`
- **Web database**
- [Academic records](https://github.com/aluro7in/university-evaluation-system/tree/master/java-backend/src/main/java/university/backend/repository): `java-backend/src/main/java/university/backend/repository`
- [Academic entities](https://github.com/aluro7in/university-evaluation-system/tree/master/java-backend/src/main/java/university/backend/domain/entity): `java-backend/src/main/java/university/backend/domain/entity`
- **Java database**

### Other components

- **Students and admins**

## Connections

- Students and admins → React interface: uses (evidence: `README.md`)
- React interface → Profiles and grades: navigates (evidence: `client/src/App.tsx`)
- React interface → Transcript and dashboard: navigates (evidence: `client/src/App.tsx`)
- Profiles and grades → tRPC gateway: requests data (evidence: `README.md`)
- Transcript and dashboard → tRPC gateway: requests data (evidence: `README.md`)
- tRPC gateway → Web data access: reads and writes (evidence: `server/routers.ts`)
- Web data access → Web records: uses schema (evidence: `server/db.ts`)
- Web data access → Web database: persists records (evidence: `README.md`)
- tRPC gateway → Java API adapter: delegates GPA (evidence: `server/routers.ts`)
- Java API adapter → Spring REST API: calls REST API (evidence: `README.md`)
- Spring REST API → Academic services: dispatches requests (evidence: `java-backend/src/main/java/university/backend/controller/EnrollmentController.java`)
- Spring REST API → Enrollment workflow: dispatches enrollment (evidence: `java-backend/src/main/java/university/backend/controller/EnrollmentController.java`)
- Enrollment workflow → Academic records: reads and writes (evidence: `java-backend/src/main/java/university/backend/service/EnrollmentService.java`)
- Enrollment workflow → Academic services: checks prerequisites (evidence: `java-backend/src/main/java/university/backend/service/EnrollmentService.java`)
- Academic records → Academic entities: stores entities (evidence: `java-backend/src/main/java/university/backend/repository/EnrollmentRepository.java`)
- Academic records → Java database: persists records (evidence: `README.md`)
- Spring REST API → GPA policies: uses policies
- GPA policies → Grade conversion: converts grades (evidence: `java-backend/src/main/java/university/backend/policy/EngineeringEvaluationPolicy.java`)
- Academic services → Analytics and risk: supports analytics
- Academic services → Performance forecasts: supports forecasts
- Academic services → Academic planning: supports planning
- Academic services → Attendance tracking: supports attendance
- Analytics and risk → Academic reports: informs reports
