# awakenedarpit/careersync architecture

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

- Interactive diagram: https://gitdiagram.com/awakenedarpit/careersync
- Repository: https://github.com/awakenedarpit/careersync

## Overview

CarrerSync is a multi-tenant collegiate placement intelligence platform. Its primary lifecycle moves from student-submitted evidence through skill verification and gap diagnosis into preparation and recruiter placement matching; TPO and institutional tools govern that lifecycle with explainable analytics, approvals, and accreditation reporting. The graph preserves the role-based client, document ingestion, prediction, and tenant administration capabilities documented in the README. Some feature links are documented rather than source-verified; those edges cite the README, and unsampled implementation details are not inferred.

Main entry points: [`client/src/pages/student/Overview.jsx`](https://github.com/awakenedarpit/careersync/blob/main/client/src/pages/student/Overview.jsx) (Student Portal), [`client/src/pages/tpo/VerificationPortal.jsx`](https://github.com/awakenedarpit/careersync/blob/main/client/src/pages/tpo/VerificationPortal.jsx) (Skill Verification), [`server/src/readiness/skill-gap.service.ts`](https://github.com/awakenedarpit/careersync/blob/main/server/src/readiness/skill-gap.service.ts) (Skill Gap Diagnostics), [`server/src/institutional/institutional-kpi.service.ts`](https://github.com/awakenedarpit/careersync/blob/main/server/src/institutional/institutional-kpi.service.ts) (Institutional Intelligence)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Role-Based Experience"]
  node_student["Student Portal<br/>[Overview.jsx]"]
  node_app["Web Application<br/>[App.jsx]"]
  node_routes["Role-Based Routes<br/>[AppRoutes.jsx]"]
end

subgraph group_evidence["Evidence and Readiness"]
  node_verification["Skill Verification"]
  node_ingestion["Document Ingestion"]
  node_skillgap["Skill Gap Diagnostics"]
  node_learning["Learning and Assessment"]
  node_readiness["Readiness Analytics"]
end

subgraph group_placement["Placement Intelligence"]
  node_recruiter["Recruiter Matching"]
  node_eligibility["Eligibility Rules"]
  node_mockdrives["Mock Drives"]
  node_industry["Industry Intelligence"]
end

subgraph group_governance["Governance and Analytics"]
  node_prediction["Placement Predictions"]
  node_fairness["Fairness Governance"]
  node_accreditation["Accreditation Reporting"]
  node_orchestrator["Agent Orchestration"]
  node_orchestrationapi["Workflow Routes"]
  node_institutional["Institutional Intelligence"]
end

subgraph group_platform["Platform Services"]
  node_api["Client API<br/>[api.js]"]
  node_studentservice["Student Services<br/>[student_service.py]"]
  node_backendmodels[("Student and Skill Models<br/>[student.py]")]
  node_backenddb[("Backend Database<br/>[database.py]")]
  node_auth["Authentication<br/>[auth_service.py]"]
  node_workersauth["Worker Authentication Routes<br/>[auth.routes.ts]"]
  node_workeradmin["Tenant Administration"]
  node_workerdb[("Worker Database Client<br/>[client.ts]")]
end

node_studentactor(("Student"))
node_tpoactor(("TPO"))
node_recruiteractor(("Recruiter"))

node_app -->|"loads routes"| node_routes
node_studentactor -.->|"uses portal"| node_student
node_tpoactor -->|"reviews evidence"| node_verification
node_student -.->|"submits evidence"| node_ingestion
node_ingestion -->|"extracts evidence"| node_verification
node_verification -->|"verifies skills"| node_skillgap
node_skillgap -->|"guides preparation"| node_learning
node_learning -.->|"builds readiness"| node_readiness
node_readiness -->|"supports matching"| node_recruiter
node_recruiteractor -.->|"discovers candidates"| node_recruiter
node_eligibility -->|"filters eligibility"| node_recruiter
node_student -.->|"practices drives"| node_mockdrives
node_industry -.->|"supplies job needs"| node_skillgap
node_prediction -.->|"informs reporting"| node_institutional
node_institutional -->|"supports compliance"| node_accreditation
node_fairness -.->|"governs outcomes"| node_institutional
node_orchestrationapi -->|"calls workflows"| node_orchestrator
node_api -->|"requests workflows"| node_orchestrationapi
node_studentservice -->|"uses models"| node_backendmodels
node_backenddb -->|"provides sessions"| node_studentservice
node_workersauth -->|"queries database"| node_workerdb
node_workeradmin -->|"queries database"| node_workerdb
node_auth -->|"authenticates users"| node_backendmodels

click node_student "https://github.com/awakenedarpit/careersync/blob/main/client/src/pages/student/Overview.jsx"
click node_verification "https://github.com/awakenedarpit/careersync/blob/main/client/src/pages/tpo/VerificationPortal.jsx"
click node_ingestion "https://github.com/awakenedarpit/careersync/blob/main/server/src/ingestion/ingestion.service.ts"
click node_skillgap "https://github.com/awakenedarpit/careersync/blob/main/server/src/readiness/skill-gap.service.ts"
click node_learning "https://github.com/awakenedarpit/careersync/blob/main/server/src/assessment/learning-path.service.ts"
click node_readiness "https://github.com/awakenedarpit/careersync/blob/main/server/src/readiness/readiness.service.ts"
click node_recruiter "https://github.com/awakenedarpit/careersync/blob/main/server/src/recruiter/recruiter.service.ts"
click node_eligibility "https://github.com/awakenedarpit/careersync/blob/main/server/src/eligibility/eligibility.service.ts"
click node_mockdrives "https://github.com/awakenedarpit/careersync/blob/main/server/src/assessment/mock-drive.service.ts"
click node_industry "https://github.com/awakenedarpit/careersync/blob/main/server/src/industry/industry-intelligence.service.ts"
click node_prediction "https://github.com/awakenedarpit/careersync/blob/main/server/src/analytics/prediction-engine.service.ts"
click node_fairness "https://github.com/awakenedarpit/careersync/blob/main/server/src/institutional/fairness-governance.service.ts"
click node_accreditation "https://github.com/awakenedarpit/careersync/blob/main/server/src/institutional/accreditation-reporting.service.ts"
click node_orchestrator "https://github.com/awakenedarpit/careersync/blob/main/server/src/orchestration/agent-orchestration.service.ts"
click node_orchestrationapi "https://github.com/awakenedarpit/careersync/blob/main/server/src/routes/orchestration.routes.ts"
click node_institutional "https://github.com/awakenedarpit/careersync/blob/main/server/src/institutional/institutional-kpi.service.ts"
click node_app "https://github.com/awakenedarpit/careersync/blob/main/client/src/App.jsx"
click node_routes "https://github.com/awakenedarpit/careersync/blob/main/client/src/routes/AppRoutes.jsx"
click node_api "https://github.com/awakenedarpit/careersync/blob/main/client/src/services/api.js"
click node_studentservice "https://github.com/awakenedarpit/careersync/blob/main/backend/src/services/student_service.py"
click node_backendmodels "https://github.com/awakenedarpit/careersync/blob/main/backend/src/models/student.py"
click node_backenddb "https://github.com/awakenedarpit/careersync/blob/main/backend/src/database.py"
click node_auth "https://github.com/awakenedarpit/careersync/blob/main/backend/src/services/auth_service.py"
click node_workersauth "https://github.com/awakenedarpit/careersync/blob/main/workers/src/routes/auth.routes.ts"
click node_workeradmin "https://github.com/awakenedarpit/careersync/blob/main/workers/src/routes/superadmin.routes.ts"
click node_workerdb "https://github.com/awakenedarpit/careersync/blob/main/workers/src/db/client.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_student,node_app,node_routes toneBlue
class node_verification,node_ingestion,node_skillgap,node_learning,node_readiness toneAmber
class node_recruiter,node_eligibility,node_mockdrives,node_industry toneMint
class node_prediction,node_fairness,node_accreditation,node_orchestrator,node_orchestrationapi,node_institutional toneRose
class node_api,node_studentservice,node_backendmodels,node_backenddb,node_auth,node_workersauth,node_workeradmin,node_workerdb,node_studentactor,node_tpoactor,node_recruiteractor toneIndigo
```

## Components

### Role-Based Experience

- [Student Portal](https://github.com/awakenedarpit/careersync/blob/main/client/src/pages/student/Overview.jsx): `client/src/pages/student/Overview.jsx`
- [Web Application](https://github.com/awakenedarpit/careersync/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Role-Based Routes](https://github.com/awakenedarpit/careersync/blob/main/client/src/routes/AppRoutes.jsx): `client/src/routes/AppRoutes.jsx`

### Evidence and Readiness

- [Skill Verification](https://github.com/awakenedarpit/careersync/blob/main/client/src/pages/tpo/VerificationPortal.jsx): `client/src/pages/tpo/VerificationPortal.jsx`
- [Document Ingestion](https://github.com/awakenedarpit/careersync/blob/main/server/src/ingestion/ingestion.service.ts): `server/src/ingestion/ingestion.service.ts`
- [Skill Gap Diagnostics](https://github.com/awakenedarpit/careersync/blob/main/server/src/readiness/skill-gap.service.ts): `server/src/readiness/skill-gap.service.ts`
- [Learning and Assessment](https://github.com/awakenedarpit/careersync/blob/main/server/src/assessment/learning-path.service.ts): `server/src/assessment/learning-path.service.ts`
- [Readiness Analytics](https://github.com/awakenedarpit/careersync/blob/main/server/src/readiness/readiness.service.ts): `server/src/readiness/readiness.service.ts`

### Placement Intelligence

- [Recruiter Matching](https://github.com/awakenedarpit/careersync/blob/main/server/src/recruiter/recruiter.service.ts): `server/src/recruiter/recruiter.service.ts`
- [Eligibility Rules](https://github.com/awakenedarpit/careersync/blob/main/server/src/eligibility/eligibility.service.ts): `server/src/eligibility/eligibility.service.ts`
- [Mock Drives](https://github.com/awakenedarpit/careersync/blob/main/server/src/assessment/mock-drive.service.ts): `server/src/assessment/mock-drive.service.ts`
- [Industry Intelligence](https://github.com/awakenedarpit/careersync/blob/main/server/src/industry/industry-intelligence.service.ts): `server/src/industry/industry-intelligence.service.ts`

### Governance and Analytics

- [Placement Predictions](https://github.com/awakenedarpit/careersync/blob/main/server/src/analytics/prediction-engine.service.ts): `server/src/analytics/prediction-engine.service.ts`
- [Fairness Governance](https://github.com/awakenedarpit/careersync/blob/main/server/src/institutional/fairness-governance.service.ts): `server/src/institutional/fairness-governance.service.ts`
- [Accreditation Reporting](https://github.com/awakenedarpit/careersync/blob/main/server/src/institutional/accreditation-reporting.service.ts): `server/src/institutional/accreditation-reporting.service.ts`
- [Agent Orchestration](https://github.com/awakenedarpit/careersync/blob/main/server/src/orchestration/agent-orchestration.service.ts): `server/src/orchestration/agent-orchestration.service.ts`
- [Workflow Routes](https://github.com/awakenedarpit/careersync/blob/main/server/src/routes/orchestration.routes.ts): `server/src/routes/orchestration.routes.ts`
- [Institutional Intelligence](https://github.com/awakenedarpit/careersync/blob/main/server/src/institutional/institutional-kpi.service.ts): `server/src/institutional/institutional-kpi.service.ts`

### Platform Services

- [Client API](https://github.com/awakenedarpit/careersync/blob/main/client/src/services/api.js): `client/src/services/api.js`
- [Student Services](https://github.com/awakenedarpit/careersync/blob/main/backend/src/services/student_service.py): `backend/src/services/student_service.py`
- [Student and Skill Models](https://github.com/awakenedarpit/careersync/blob/main/backend/src/models/student.py): `backend/src/models/student.py`
- [Backend Database](https://github.com/awakenedarpit/careersync/blob/main/backend/src/database.py): `backend/src/database.py`
- [Authentication](https://github.com/awakenedarpit/careersync/blob/main/backend/src/services/auth_service.py): `backend/src/services/auth_service.py`
- [Worker Authentication Routes](https://github.com/awakenedarpit/careersync/blob/main/workers/src/routes/auth.routes.ts): `workers/src/routes/auth.routes.ts`
- [Tenant Administration](https://github.com/awakenedarpit/careersync/blob/main/workers/src/routes/superadmin.routes.ts): `workers/src/routes/superadmin.routes.ts`
- [Worker Database Client](https://github.com/awakenedarpit/careersync/blob/main/workers/src/db/client.ts): `workers/src/db/client.ts`

### Other components

- **Student**
- **TPO**
- **Recruiter**

## Connections

- Web Application → Role-Based Routes: loads routes (evidence: `client/src/App.jsx`)
- Student → Student Portal: uses portal (evidence: `README.md`)
- TPO → Skill Verification: reviews evidence (evidence: `README.md`)
- Student Portal → Document Ingestion: submits evidence (evidence: `README.md`)
- Document Ingestion → Skill Verification: extracts evidence (evidence: `README.md`)
- Skill Verification → Skill Gap Diagnostics: verifies skills (evidence: `README.md`)
- Skill Gap Diagnostics → Learning and Assessment: guides preparation (evidence: `README.md`)
- Learning and Assessment → Readiness Analytics: builds readiness (evidence: `README.md`)
- Readiness Analytics → Recruiter Matching: supports matching (evidence: `README.md`)
- Recruiter → Recruiter Matching: discovers candidates (evidence: `README.md`)
- Eligibility Rules → Recruiter Matching: filters eligibility (evidence: `README.md`)
- Student Portal → Mock Drives: practices drives (evidence: `README.md`)
- Industry Intelligence → Skill Gap Diagnostics: supplies job needs (evidence: `README.md`)
- Placement Predictions → Institutional Intelligence: informs reporting (evidence: `README.md`)
- Institutional Intelligence → Accreditation Reporting: supports compliance (evidence: `README.md`)
- Fairness Governance → Institutional Intelligence: governs outcomes (evidence: `README.md`)
- Workflow Routes → Agent Orchestration: calls workflows (evidence: `server/src/routes/orchestration.routes.ts`)
- Client API → Workflow Routes: requests workflows
- Student Services → Student and Skill Models: uses models (evidence: `backend/src/services/student_service.py`)
- Backend Database → Student Services: provides sessions (evidence: `backend/src/database.py`)
- Worker Authentication Routes → Worker Database Client: queries database (evidence: `workers/src/routes/auth.routes.ts`)
- Tenant Administration → Worker Database Client: queries database (evidence: `workers/src/routes/superadmin.routes.ts`)
- Authentication → Student and Skill Models: authenticates users (evidence: `backend/src/services/auth_service.py`)
