# joy2502072/campuslink architecture

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

- Interactive diagram: https://gitdiagram.com/joy2502072/campuslink
- Repository: https://github.com/joy2502072/campuslink

## Overview

This is a placement-management platform for students and placement staff, with a React interface and an Express/MySQL backend. Users move among dashboards, recruiter and student workflows, risk/readiness analysis, drive scheduling, offers, matching, skill gaps, curriculum insights, analytics, and communications. The backend exposes corresponding API areas; sampled code shows matching and readiness calculations, offer retrieval, and notification operations backed by repositories. The frontend-to-API request wiring is not established by the supplied excerpts, so no UI-to-API edges are asserted. Several frontend and backend branches are identified from the tree and index rather than inspected source.

Main entry points: [`frontend/src/App.jsx`](https://github.com/joy2502072/campuslink/blob/main/frontend/src/App.jsx) (Workspace app), [`backend/src/services/readiness.service.js`](https://github.com/joy2502072/campuslink/blob/main/backend/src/services/readiness.service.js) (Readiness assessment), [`backend/src/config/database.js`](https://github.com/joy2502072/campuslink/blob/main/backend/src/config/database.js) (Database pool), [`backend/src/app.js`](https://github.com/joy2502072/campuslink/blob/main/backend/src/app.js) (HTTP application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Placement workspace"]
  node_app["Workspace app<br/>[App.jsx]"]
  node_layout["App layout<br/>[Layout.jsx]"]
  node_dashboard["Dashboard<br/>[DashboardHome.jsx]"]
  node_recruiter["Recruiter workflow"]
  node_studentportal["Student portal<br/>[StudentPortal.jsx]"]
  node_atrisk["At-risk students<br/>[AtRiskStudents.jsx]"]
  node_readinessui["Readiness view"]
  node_matchingui["Student matching"]
  node_skillgapui["Skill-gap analysis"]
  node_schedulerui["Drive scheduling"]
  node_offersui["Offer tracking<br/>[OfferTracking.jsx]"]
  node_communicationui["Communications hub"]
  node_curriculumui["Curriculum insights"]
  node_analyticsui["Placement analytics"]
end

subgraph group_api["API and access"]
  node_server["HTTP application<br/>[app.js]"]
  node_matchingroutes["Matching routes<br/>[matching.routes.js]"]
  node_notificationroutes["Notification routes"]
  node_readinessroutes["Readiness routes"]
  node_offerroutes["Offer routes<br/>[offer.routes.js]"]
  node_matchingcontroller["Matching controller"]
  node_notificationcontroller["Notification controller"]
  node_readinesscontroller["Readiness controller"]
  node_offercontroller["Offer controller"]
end

subgraph group_domain["Placement services"]
  node_matchingservice["Candidate matching"]
  node_readinessservice["Readiness assessment"]
  node_notificationservice["Notification operations"]
end

subgraph group_storage["Persistence"]
  node_studentrepo["Student records"]
  node_driverepo["Drive records"]
  node_offerrepo["Offer records"]
  node_notificationrepo["Notification records"]
  node_databaseconfig["Database pool<br/>[database.js]"]
end

node_user(("Placement user"))
node_mysql[("MySQL database")]

node_user -->|"uses"| node_app
node_app -->|"renders"| node_layout
node_app -->|"selects view"| node_dashboard
node_app -->|"selects view"| node_recruiter
node_app -->|"selects view"| node_studentportal
node_app -->|"selects view"| node_atrisk
node_app -->|"selects view"| node_readinessui
node_app -->|"selects view"| node_matchingui
node_app -->|"selects view"| node_skillgapui
node_app -->|"selects view"| node_schedulerui
node_app -->|"selects view"| node_offersui
node_app -->|"selects view"| node_communicationui
node_app -->|"selects view"| node_curriculumui
node_app -->|"selects view"| node_analyticsui
node_server -->|"mounts"| node_matchingroutes
node_server -->|"mounts"| node_notificationroutes
node_server -->|"mounts"| node_readinessroutes
node_server -->|"mounts"| node_offerroutes
node_matchingroutes -->|"routes to"| node_matchingcontroller
node_notificationroutes -->|"routes to"| node_notificationcontroller
node_readinessroutes -->|"routes to"| node_readinesscontroller
node_offerroutes -->|"routes to"| node_offercontroller
node_matchingcontroller -->|"evaluates via"| node_matchingservice
node_matchingcontroller -->|"loads students"| node_studentrepo
node_notificationcontroller -->|"dispatches"| node_notificationservice
node_readinesscontroller -->|"requests analysis"| node_readinessservice
node_offercontroller -->|"queries offers"| node_offerrepo
node_matchingservice -->|"reads students"| node_studentrepo
node_matchingservice -->|"reads drives"| node_driverepo
node_matchingservice -->|"uses readiness"| node_readinessservice
node_readinessservice -->|"reads students"| node_studentrepo
node_readinessservice -->|"reads drives"| node_driverepo
node_readinessservice -->|"checks offers"| node_offerrepo
node_notificationservice -->|"uses records"| node_notificationrepo
node_studentrepo -->|"uses pool"| node_databaseconfig
node_driverepo -->|"uses pool"| node_databaseconfig
node_offerrepo -->|"uses pool"| node_databaseconfig
node_notificationrepo -->|"uses pool"| node_databaseconfig
node_databaseconfig -->|"connects"| node_mysql

click node_app "https://github.com/joy2502072/campuslink/blob/main/frontend/src/App.jsx"
click node_layout "https://github.com/joy2502072/campuslink/blob/main/frontend/src/components/layout/Layout.jsx"
click node_dashboard "https://github.com/joy2502072/campuslink/blob/main/frontend/src/components/dashboard/DashboardHome.jsx"
click node_recruiter "https://github.com/joy2502072/campuslink/blob/main/frontend/src/components/recruiter/RecruiterWorkflow.jsx"
click node_studentportal "https://github.com/joy2502072/campuslink/blob/main/frontend/src/components/studentPortal/StudentPortal.jsx"
click node_atrisk "https://github.com/joy2502072/campuslink/blob/main/frontend/src/components/atRisk/AtRiskStudents.jsx"
click node_readinessui "https://github.com/joy2502072/campuslink/blob/main/frontend/src/components/readiness/StudentReadiness.jsx"
click node_matchingui "https://github.com/joy2502072/campuslink/blob/main/frontend/src/components/matching/StudentJobMatching.jsx"
click node_skillgapui "https://github.com/joy2502072/campuslink/blob/main/frontend/src/components/skillGap/SkillGapAnalysis.jsx"
click node_schedulerui "https://github.com/joy2502072/campuslink/blob/main/frontend/src/components/scheduler/SchedulerOverview.jsx"
click node_offersui "https://github.com/joy2502072/campuslink/blob/main/frontend/src/components/offers/OfferTracking.jsx"
click node_communicationui "https://github.com/joy2502072/campuslink/blob/main/frontend/src/components/communication/CommunicationHub.jsx"
click node_curriculumui "https://github.com/joy2502072/campuslink/blob/main/frontend/src/components/curriculum/CurriculumIntelligence.jsx"
click node_analyticsui "https://github.com/joy2502072/campuslink/blob/main/frontend/src/components/analytics/AnalyticsOverview.jsx"
click node_server "https://github.com/joy2502072/campuslink/blob/main/backend/src/app.js"
click node_matchingroutes "https://github.com/joy2502072/campuslink/blob/main/backend/src/routes/matching.routes.js"
click node_notificationroutes "https://github.com/joy2502072/campuslink/blob/main/backend/src/routes/notification.routes.js"
click node_readinessroutes "https://github.com/joy2502072/campuslink/blob/main/backend/src/routes/readiness.routes.js"
click node_offerroutes "https://github.com/joy2502072/campuslink/blob/main/backend/src/routes/offer.routes.js"
click node_matchingcontroller "https://github.com/joy2502072/campuslink/blob/main/backend/src/controllers/matching.controller.js"
click node_notificationcontroller "https://github.com/joy2502072/campuslink/blob/main/backend/src/controllers/notification.controller.js"
click node_readinesscontroller "https://github.com/joy2502072/campuslink/blob/main/backend/src/controllers/readiness.controller.js"
click node_offercontroller "https://github.com/joy2502072/campuslink/blob/main/backend/src/controllers/offer.controller.js"
click node_matchingservice "https://github.com/joy2502072/campuslink/blob/main/backend/src/services/matching.service.js"
click node_readinessservice "https://github.com/joy2502072/campuslink/blob/main/backend/src/services/readiness.service.js"
click node_notificationservice "https://github.com/joy2502072/campuslink/blob/main/backend/src/services/notification.service.js"
click node_studentrepo "https://github.com/joy2502072/campuslink/blob/main/backend/src/repositories/student.repository.js"
click node_driverepo "https://github.com/joy2502072/campuslink/blob/main/backend/src/repositories/drive.repository.js"
click node_offerrepo "https://github.com/joy2502072/campuslink/blob/main/backend/src/repositories/offer.repository.js"
click node_notificationrepo "https://github.com/joy2502072/campuslink/blob/main/backend/src/repositories/notification.repository.js"
click node_databaseconfig "https://github.com/joy2502072/campuslink/blob/main/backend/src/config/database.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_app,node_layout,node_dashboard,node_recruiter,node_studentportal,node_atrisk,node_readinessui,node_matchingui,node_skillgapui,node_schedulerui,node_offersui,node_communicationui,node_curriculumui,node_analyticsui,node_user toneBlue
class node_server,node_matchingroutes,node_notificationroutes,node_readinessroutes,node_offerroutes,node_matchingcontroller,node_notificationcontroller,node_readinesscontroller,node_offercontroller,node_mysql toneAmber
class node_matchingservice,node_readinessservice,node_notificationservice toneMint
class node_studentrepo,node_driverepo,node_offerrepo,node_notificationrepo,node_databaseconfig toneRose
```

## Components

### Placement workspace

- [Workspace app](https://github.com/joy2502072/campuslink/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [App layout](https://github.com/joy2502072/campuslink/blob/main/frontend/src/components/layout/Layout.jsx): `frontend/src/components/layout/Layout.jsx`
- [Dashboard](https://github.com/joy2502072/campuslink/blob/main/frontend/src/components/dashboard/DashboardHome.jsx): `frontend/src/components/dashboard/DashboardHome.jsx`
- [Recruiter workflow](https://github.com/joy2502072/campuslink/blob/main/frontend/src/components/recruiter/RecruiterWorkflow.jsx): `frontend/src/components/recruiter/RecruiterWorkflow.jsx`
- [Student portal](https://github.com/joy2502072/campuslink/blob/main/frontend/src/components/studentPortal/StudentPortal.jsx): `frontend/src/components/studentPortal/StudentPortal.jsx`
- [At-risk students](https://github.com/joy2502072/campuslink/blob/main/frontend/src/components/atRisk/AtRiskStudents.jsx): `frontend/src/components/atRisk/AtRiskStudents.jsx`
- [Readiness view](https://github.com/joy2502072/campuslink/blob/main/frontend/src/components/readiness/StudentReadiness.jsx): `frontend/src/components/readiness/StudentReadiness.jsx`
- [Student matching](https://github.com/joy2502072/campuslink/blob/main/frontend/src/components/matching/StudentJobMatching.jsx): `frontend/src/components/matching/StudentJobMatching.jsx`
- [Skill-gap analysis](https://github.com/joy2502072/campuslink/blob/main/frontend/src/components/skillGap/SkillGapAnalysis.jsx): `frontend/src/components/skillGap/SkillGapAnalysis.jsx`
- [Drive scheduling](https://github.com/joy2502072/campuslink/blob/main/frontend/src/components/scheduler/SchedulerOverview.jsx): `frontend/src/components/scheduler/SchedulerOverview.jsx`
- [Offer tracking](https://github.com/joy2502072/campuslink/blob/main/frontend/src/components/offers/OfferTracking.jsx): `frontend/src/components/offers/OfferTracking.jsx`
- [Communications hub](https://github.com/joy2502072/campuslink/blob/main/frontend/src/components/communication/CommunicationHub.jsx): `frontend/src/components/communication/CommunicationHub.jsx`
- [Curriculum insights](https://github.com/joy2502072/campuslink/blob/main/frontend/src/components/curriculum/CurriculumIntelligence.jsx): `frontend/src/components/curriculum/CurriculumIntelligence.jsx`
- [Placement analytics](https://github.com/joy2502072/campuslink/blob/main/frontend/src/components/analytics/AnalyticsOverview.jsx): `frontend/src/components/analytics/AnalyticsOverview.jsx`

### API and access

- [HTTP application](https://github.com/joy2502072/campuslink/blob/main/backend/src/app.js): `backend/src/app.js`
- [Matching routes](https://github.com/joy2502072/campuslink/blob/main/backend/src/routes/matching.routes.js): `backend/src/routes/matching.routes.js`
- [Notification routes](https://github.com/joy2502072/campuslink/blob/main/backend/src/routes/notification.routes.js): `backend/src/routes/notification.routes.js`
- [Readiness routes](https://github.com/joy2502072/campuslink/blob/main/backend/src/routes/readiness.routes.js): `backend/src/routes/readiness.routes.js`
- [Offer routes](https://github.com/joy2502072/campuslink/blob/main/backend/src/routes/offer.routes.js): `backend/src/routes/offer.routes.js`
- [Matching controller](https://github.com/joy2502072/campuslink/blob/main/backend/src/controllers/matching.controller.js): `backend/src/controllers/matching.controller.js`
- [Notification controller](https://github.com/joy2502072/campuslink/blob/main/backend/src/controllers/notification.controller.js): `backend/src/controllers/notification.controller.js`
- [Readiness controller](https://github.com/joy2502072/campuslink/blob/main/backend/src/controllers/readiness.controller.js): `backend/src/controllers/readiness.controller.js`
- [Offer controller](https://github.com/joy2502072/campuslink/blob/main/backend/src/controllers/offer.controller.js): `backend/src/controllers/offer.controller.js`

### Placement services

- [Candidate matching](https://github.com/joy2502072/campuslink/blob/main/backend/src/services/matching.service.js): `backend/src/services/matching.service.js`
- [Readiness assessment](https://github.com/joy2502072/campuslink/blob/main/backend/src/services/readiness.service.js): `backend/src/services/readiness.service.js`
- [Notification operations](https://github.com/joy2502072/campuslink/blob/main/backend/src/services/notification.service.js): `backend/src/services/notification.service.js`

### Persistence

- [Student records](https://github.com/joy2502072/campuslink/blob/main/backend/src/repositories/student.repository.js): `backend/src/repositories/student.repository.js`
- [Drive records](https://github.com/joy2502072/campuslink/blob/main/backend/src/repositories/drive.repository.js): `backend/src/repositories/drive.repository.js`
- [Offer records](https://github.com/joy2502072/campuslink/blob/main/backend/src/repositories/offer.repository.js): `backend/src/repositories/offer.repository.js`
- [Notification records](https://github.com/joy2502072/campuslink/blob/main/backend/src/repositories/notification.repository.js): `backend/src/repositories/notification.repository.js`
- [Database pool](https://github.com/joy2502072/campuslink/blob/main/backend/src/config/database.js): `backend/src/config/database.js`

### Other components

- **Placement user**
- **MySQL database**

## Connections

- Placement user → Workspace app: uses (evidence: `frontend/src/App.jsx`)
- Workspace app → App layout: renders (evidence: `frontend/src/App.jsx`)
- Workspace app → Dashboard: selects view (evidence: `frontend/src/App.jsx`)
- Workspace app → Recruiter workflow: selects view (evidence: `frontend/src/App.jsx`)
- Workspace app → Student portal: selects view (evidence: `frontend/src/App.jsx`)
- Workspace app → At-risk students: selects view (evidence: `frontend/src/App.jsx`)
- Workspace app → Readiness view: selects view (evidence: `frontend/src/App.jsx`)
- Workspace app → Student matching: selects view (evidence: `frontend/src/App.jsx`)
- Workspace app → Skill-gap analysis: selects view (evidence: `frontend/src/App.jsx`)
- Workspace app → Drive scheduling: selects view (evidence: `frontend/src/App.jsx`)
- Workspace app → Offer tracking: selects view (evidence: `frontend/src/App.jsx`)
- Workspace app → Communications hub: selects view (evidence: `frontend/src/App.jsx`)
- Workspace app → Curriculum insights: selects view (evidence: `frontend/src/App.jsx`)
- Workspace app → Placement analytics: selects view (evidence: `frontend/src/App.jsx`)
- HTTP application → Matching routes: mounts (evidence: `backend/src/app.js`)
- HTTP application → Notification routes: mounts (evidence: `backend/src/app.js`)
- HTTP application → Readiness routes: mounts (evidence: `backend/src/app.js`)
- HTTP application → Offer routes: mounts (evidence: `backend/src/app.js`)
- Matching routes → Matching controller: routes to (evidence: `backend/src/routes/matching.routes.js`)
- Notification routes → Notification controller: routes to (evidence: `backend/src/routes/notification.routes.js`)
- Readiness routes → Readiness controller: routes to (evidence: `backend/src/routes/readiness.routes.js`)
- Offer routes → Offer controller: routes to (evidence: `backend/src/routes/offer.routes.js`)
- Matching controller → Candidate matching: evaluates via (evidence: `backend/src/controllers/matching.controller.js`)
- Matching controller → Student records: loads students (evidence: `backend/src/controllers/matching.controller.js`)
- Notification controller → Notification operations: dispatches (evidence: `backend/src/controllers/notification.controller.js`)
- Readiness controller → Readiness assessment: requests analysis (evidence: `backend/src/controllers/readiness.controller.js`)
- Offer controller → Offer records: queries offers (evidence: `backend/src/controllers/offer.controller.js`)
- Candidate matching → Student records: reads students (evidence: `backend/src/services/matching.service.js`)
- Candidate matching → Drive records: reads drives (evidence: `backend/src/services/matching.service.js`)
- Candidate matching → Readiness assessment: uses readiness (evidence: `backend/src/services/matching.service.js`)
- Readiness assessment → Student records: reads students (evidence: `backend/src/services/readiness.service.js`)
- Readiness assessment → Drive records: reads drives (evidence: `backend/src/services/readiness.service.js`)
- Readiness assessment → Offer records: checks offers (evidence: `backend/src/services/readiness.service.js`)
- Notification operations → Notification records: uses records (evidence: `backend/src/services/notification.service.js`)
- Student records → Database pool: uses pool (evidence: `backend/src/repositories/student.repository.js`)
- Drive records → Database pool: uses pool (evidence: `backend/src/repositories/drive.repository.js`)
- Offer records → Database pool: uses pool (evidence: `backend/src/repositories/offer.repository.js`)
- Notification records → Database pool: uses pool (evidence: `backend/src/repositories/notification.repository.js`)
- Database pool → MySQL database: connects (evidence: `backend/src/config/database.js`)
