# eshwargit2/java_placement_training_app architecture

> Architecture diagram of the GitHub repository eshwargit2/java_placement_training_app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/eshwargit2/java_placement_training_app
- Repository: https://github.com/eshwargit2/java_placement_training_app

## Overview

This is a Java placement-preparation portal with a 41-day learning roadmap, daily assessments, student progress tracking, and batch analytics. The main flow is learners accessing the portal, retrieving day-based questions, submitting answers for grading, and having results and progress stored for later review; administrators manage students and question banks and review reports. The sampled routes and models support these backend links. Frontend-to-API calls and the compile route’s execution details were not shown, so those connections are left unverified or omitted.

Main entry points: [`backend/server.js`](https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/server.js) (HTTP server), [`backend/routes/assessments.js`](https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/routes/assessments.js) (Assessment workflow), [`backend/models/User.js`](https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/models/User.js) (User records), [`backend/routes/stats.js`](https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/routes/stats.js) (Batch analytics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portal["Portal screens"]
  node_learner["Learner portal<br/>[student.html]"]
  node_assessment_ui["Assessment screen<br/>[assessment.html]"]
  node_admin_ui["Admin dashboard<br/>[admin.html]"]
  node_student_admin_ui["Student management<br/>[students.html]"]
  node_reports_ui["Reports and results<br/>[reports.html]"]
  node_results_ui["Result details<br/>[results.html]"]
  node_api_client["Browser API client<br/>[api.js]"]
  node_ui_logic["Portal interactions<br/>[script.js]"]
end

subgraph group_api["API workflows"]
  node_auth["Authentication<br/>[auth.js]"]
  node_students["Student profiles<br/>[students.js]"]
  node_questions["Question bank<br/>[questions.js]"]
  node_assessments["Assessment workflow<br/>[assessments.js]"]
  node_evaluation["Answer evaluation<br/>[evaluator.js]"]
  node_analytics["Batch analytics<br/>[stats.js]"]
  node_compilation["Code compilation<br/>[compile.js]"]
end

subgraph group_domain["Assessment data"]
  node_user_data[("User records<br/>[User.js]")]
  node_question_data[("Question records<br/>[Question.js]")]
  node_submission_data[("Submission history<br/>[Submission.js]")]
end

subgraph group_runtime["Service runtime"]
  node_server["HTTP server<br/>[server.js]"]
  node_database[("MongoDB connection<br/>[db.js]")]
  node_seeder["Initial data seeding<br/>[seeder.js]"]
end

node_student_actor(("Student"))
node_admin_actor(("Administrator"))

node_server -->|"connects"| node_database
node_server -->|"seeds data"| node_seeder
node_server -->|"mounts route"| node_auth
node_server -->|"mounts route"| node_students
node_server -->|"mounts route"| node_questions
node_server -->|"mounts route"| node_assessments
node_server -->|"mounts route"| node_analytics
node_server -->|"mounts route"| node_compilation
node_server -->|"serves static files"| node_learner
node_student_actor -.->|"uses"| node_learner
node_admin_actor -.->|"uses"| node_admin_ui
node_api_client -.->|"requests API"| node_server
node_auth -->|"reads"| node_user_data
node_students -->|"manages"| node_user_data
node_students -->|"reads and deletes"| node_submission_data
node_questions -->|"queries and imports"| node_question_data
node_assessments -->|"loads questions"| node_question_data
node_assessments -->|"evaluates answers"| node_evaluation
node_assessments -->|"reads and updates"| node_user_data
node_assessments -->|"saves submissions"| node_submission_data
node_analytics -->|"counts students"| node_user_data
node_analytics -->|"counts questions"| node_question_data
node_analytics -->|"aggregates scores"| node_submission_data
node_seeder -->|"seeds accounts"| node_user_data
node_seeder -->|"imports questions"| node_question_data
node_learner -.->|"takes assessments"| node_assessment_ui
node_admin_ui -.->|"manages students"| node_student_admin_ui
node_admin_ui -.->|"reviews analytics"| node_reports_ui
node_assessment_ui -.->|"reviews scores"| node_results_ui

click node_learner "https://github.com/eshwargit2/java_placement_training_app/blob/main/frontend/student.html"
click node_assessment_ui "https://github.com/eshwargit2/java_placement_training_app/blob/main/frontend/assessment.html"
click node_admin_ui "https://github.com/eshwargit2/java_placement_training_app/blob/main/frontend/admin.html"
click node_student_admin_ui "https://github.com/eshwargit2/java_placement_training_app/blob/main/frontend/students.html"
click node_reports_ui "https://github.com/eshwargit2/java_placement_training_app/blob/main/frontend/reports.html"
click node_results_ui "https://github.com/eshwargit2/java_placement_training_app/blob/main/frontend/results.html"
click node_api_client "https://github.com/eshwargit2/java_placement_training_app/blob/main/frontend/api.js"
click node_ui_logic "https://github.com/eshwargit2/java_placement_training_app/blob/main/frontend/script.js"
click node_auth "https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/routes/auth.js"
click node_students "https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/routes/students.js"
click node_questions "https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/routes/questions.js"
click node_assessments "https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/routes/assessments.js"
click node_evaluation "https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/utils/evaluator.js"
click node_analytics "https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/routes/stats.js"
click node_compilation "https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/routes/compile.js"
click node_user_data "https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/models/User.js"
click node_question_data "https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/models/Question.js"
click node_submission_data "https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/models/Submission.js"
click node_server "https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/server.js"
click node_database "https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/config/db.js"
click node_seeder "https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/utils/seeder.js"

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_learner,node_assessment_ui,node_admin_ui,node_student_admin_ui,node_reports_ui,node_results_ui,node_api_client,node_ui_logic toneBlue
class node_auth,node_students,node_questions,node_assessments,node_evaluation,node_analytics,node_compilation toneAmber
class node_user_data,node_question_data,node_submission_data toneMint
class node_server,node_database,node_seeder toneRose
class node_student_actor,node_admin_actor toneIndigo
```

## Components

### Portal screens

- [Learner portal](https://github.com/eshwargit2/java_placement_training_app/blob/main/frontend/student.html): `frontend/student.html`
- [Assessment screen](https://github.com/eshwargit2/java_placement_training_app/blob/main/frontend/assessment.html): `frontend/assessment.html`
- [Admin dashboard](https://github.com/eshwargit2/java_placement_training_app/blob/main/frontend/admin.html): `frontend/admin.html`
- [Student management](https://github.com/eshwargit2/java_placement_training_app/blob/main/frontend/students.html): `frontend/students.html`
- [Reports and results](https://github.com/eshwargit2/java_placement_training_app/blob/main/frontend/reports.html): `frontend/reports.html`
- [Result details](https://github.com/eshwargit2/java_placement_training_app/blob/main/frontend/results.html): `frontend/results.html`
- [Browser API client](https://github.com/eshwargit2/java_placement_training_app/blob/main/frontend/api.js): `frontend/api.js`
- [Portal interactions](https://github.com/eshwargit2/java_placement_training_app/blob/main/frontend/script.js): `frontend/script.js`

### API workflows

- [Authentication](https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/routes/auth.js): `backend/routes/auth.js`
- [Student profiles](https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/routes/students.js): `backend/routes/students.js`
- [Question bank](https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/routes/questions.js): `backend/routes/questions.js`
- [Assessment workflow](https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/routes/assessments.js): `backend/routes/assessments.js`
- [Answer evaluation](https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/utils/evaluator.js): `backend/utils/evaluator.js`
- [Batch analytics](https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/routes/stats.js): `backend/routes/stats.js`
- [Code compilation](https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/routes/compile.js): `backend/routes/compile.js`

### Assessment data

- [User records](https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/models/User.js): `backend/models/User.js`
- [Question records](https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/models/Question.js): `backend/models/Question.js`
- [Submission history](https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/models/Submission.js): `backend/models/Submission.js`

### Service runtime

- [HTTP server](https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/server.js): `backend/server.js`
- [MongoDB connection](https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/config/db.js): `backend/config/db.js`
- [Initial data seeding](https://github.com/eshwargit2/java_placement_training_app/blob/main/backend/utils/seeder.js): `backend/utils/seeder.js`

### Other components

- **Student**
- **Administrator**

## Connections

- HTTP server → MongoDB connection: connects (evidence: `backend/server.js`)
- HTTP server → Initial data seeding: seeds data (evidence: `backend/server.js`)
- HTTP server → Authentication: mounts route (evidence: `backend/server.js`)
- HTTP server → Student profiles: mounts route (evidence: `backend/server.js`)
- HTTP server → Question bank: mounts route (evidence: `backend/server.js`)
- HTTP server → Assessment workflow: mounts route (evidence: `backend/server.js`)
- HTTP server → Batch analytics: mounts route (evidence: `backend/server.js`)
- HTTP server → Code compilation: mounts route (evidence: `backend/server.js`)
- HTTP server → Learner portal: serves static files (evidence: `backend/server.js`)
- Student → Learner portal: uses (evidence: `README.md`)
- Administrator → Admin dashboard: uses (evidence: `README.md`)
- Browser API client → HTTP server: requests API
- Authentication → User records: reads (evidence: `backend/routes/auth.js`)
- Student profiles → User records: manages (evidence: `backend/routes/students.js`)
- Student profiles → Submission history: reads and deletes (evidence: `backend/routes/students.js`)
- Question bank → Question records: queries and imports (evidence: `backend/routes/questions.js`)
- Assessment workflow → Question records: loads questions (evidence: `backend/routes/assessments.js`)
- Assessment workflow → Answer evaluation: evaluates answers (evidence: `backend/routes/assessments.js`)
- Assessment workflow → User records: reads and updates (evidence: `backend/routes/assessments.js`)
- Assessment workflow → Submission history: saves submissions (evidence: `backend/routes/assessments.js`)
- Batch analytics → User records: counts students (evidence: `backend/routes/stats.js`)
- Batch analytics → Question records: counts questions (evidence: `backend/routes/stats.js`)
- Batch analytics → Submission history: aggregates scores (evidence: `backend/routes/stats.js`)
- Initial data seeding → User records: seeds accounts (evidence: `backend/utils/seeder.js`)
- Initial data seeding → Question records: imports questions (evidence: `backend/utils/seeder.js`)
- Learner portal → Assessment screen: takes assessments (evidence: `README.md`)
- Admin dashboard → Student management: manages students (evidence: `README.md`)
- Admin dashboard → Reports and results: reviews analytics (evidence: `README.md`)
- Assessment screen → Result details: reviews scores (evidence: `README.md`)
