# praveenofficial12/vsbec-track architecture

> Architecture diagram of the GitHub repository praveenofficial12/vsbec-track, 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/praveenofficial12/vsbec-track
- Repository: https://github.com/praveenofficial12/vsbec-track

## Overview

VSBEC Track is a campus placement management platform. Students register, maintain academic and skills profiles, discover drives, confirm participation, follow recruitment rounds, and review outcomes; placement staff manage records, drives, round results, and reporting. The README documents these portal-to-platform capabilities, while sampled code confirms participation updates, drive creation, persistence, and drive-email dispatch. The source index supports several additional API-to-database links. Unsampled capability implementations are represented by their exact existing directories; unverified internal wiring is omitted.

Main entry points: [`src/components/admin`](https://github.com/praveenofficial12/vsbec-track/tree/main/src/components/admin) (Admin Portal), [`src/lib/db.ts`](https://github.com/praveenofficial12/vsbec-track/blob/main/src/lib/db.ts) (Application Database), [`src/components/student`](https://github.com/praveenofficial12/vsbec-track/tree/main/src/components/student) (Student Portal), [`src/app/api/drives`](https://github.com/praveenofficial12/vsbec-track/tree/main/src/app/api/drives) (Drive Management API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portals["Role Portals"]
  node_student_portal["Student Portal"]
  node_student_profile["Profile and Skills<br/>[StudentProfile.tsx]"]
  node_student_agent["Student Agent<br/>[StudentAgent.tsx]"]
  node_admin_portal["Admin Portal"]
end

subgraph group_placement["Placement Workflow"]
  node_admin_drive["Drive Management"]
  node_companies["Company Records"]
  node_drives["Drive Management API"]
  node_participations["Round Outcomes<br/>[route.ts]"]
  node_student_drives["Drive Discovery"]
end

subgraph group_operations["Admin Operations"]
  node_students["Student Records"]
  node_analytics["Placement Analytics<br/>[route.ts]"]
  node_reports["Placement Reports<br/>[route.ts]"]
  node_audit["Audit Logs<br/>[route.ts]"]
end

subgraph group_platform["Application Services"]
  node_auth["Authentication"]
  node_api_client["API Client<br/>[api.ts]"]
  node_app_state["Client State<br/>[store.ts]"]
  node_activity["Activity Logging<br/>[activity.ts]"]
  node_database[("Application Database<br/>[db.ts]")]
  node_email_notifications["Email Notifications"]
  node_email_service["Email Service<br/>[index.ts]"]
  node_common_ui["Shared UI"]
  node_college_config["College Configuration<br/>[college.ts]"]
end

node_student(("Student"))
node_admin(("Placement Staff"))

node_student -->|"uses"| node_student_portal
node_admin -->|"uses"| node_admin_portal
node_student_portal -->|"manages profile"| node_student_profile
node_student_portal -->|"browses drives"| node_student_drives
node_student_portal -.->|"accesses"| node_student_agent
node_admin_portal -->|"manages records"| node_students
node_admin_portal -->|"manages companies"| node_companies
node_admin_portal -->|"configures drives"| node_admin_drive
node_admin_portal -->|"reviews metrics"| node_analytics
node_admin_portal -->|"exports reports"| node_reports
node_admin_portal -->|"reviews history"| node_audit
node_admin_drive -->|"manages drives"| node_drives
node_student_drives -->|"posts participation"| node_api_client
node_api_client -->|"sends requests"| node_participations
node_participations -->|"updates outcomes"| node_database
node_drives -->|"reads and writes"| node_database
node_drives -->|"dispatches notices"| node_email_notifications
node_email_notifications -->|"selects recipients"| node_database
node_email_notifications -.->|"sends email"| node_email_service
node_students -->|"reads records"| node_database
node_analytics -->|"queries metrics"| node_database
node_reports -->|"queries reports"| node_database
node_auth -->|"accesses accounts"| node_database
node_auth -->|"logs registration"| node_activity
node_activity -->|"records activity"| node_database
node_student_portal -.->|"maintains session"| node_app_state
node_common_ui -.->|"supports screens"| node_student_portal
node_common_ui -.->|"supports screens"| node_admin_portal

click node_student_portal "https://github.com/praveenofficial12/vsbec-track/tree/main/src/components/student"
click node_student_profile "https://github.com/praveenofficial12/vsbec-track/blob/main/src/components/student/StudentProfile.tsx"
click node_student_agent "https://github.com/praveenofficial12/vsbec-track/blob/main/src/components/student/StudentAgent.tsx"
click node_admin_portal "https://github.com/praveenofficial12/vsbec-track/tree/main/src/components/admin"
click node_admin_drive "https://github.com/praveenofficial12/vsbec-track/blob/main/src/components/admin/AdminDriveDetail.tsx"
click node_companies "https://github.com/praveenofficial12/vsbec-track/tree/main/src/app/api/companies"
click node_drives "https://github.com/praveenofficial12/vsbec-track/tree/main/src/app/api/drives"
click node_participations "https://github.com/praveenofficial12/vsbec-track/blob/main/src/app/api/participations/route.ts"
click node_student_drives "https://github.com/praveenofficial12/vsbec-track/blob/main/src/components/student/StudentCompanies.tsx"
click node_students "https://github.com/praveenofficial12/vsbec-track/tree/main/src/app/api/students"
click node_analytics "https://github.com/praveenofficial12/vsbec-track/blob/main/src/app/api/analytics/route.ts"
click node_reports "https://github.com/praveenofficial12/vsbec-track/blob/main/src/app/api/reports/route.ts"
click node_audit "https://github.com/praveenofficial12/vsbec-track/blob/main/src/app/api/audit-logs/route.ts"
click node_auth "https://github.com/praveenofficial12/vsbec-track/tree/main/src/app/api/auth"
click node_api_client "https://github.com/praveenofficial12/vsbec-track/blob/main/src/lib/api.ts"
click node_app_state "https://github.com/praveenofficial12/vsbec-track/blob/main/src/lib/store.ts"
click node_activity "https://github.com/praveenofficial12/vsbec-track/blob/main/src/lib/activity.ts"
click node_database "https://github.com/praveenofficial12/vsbec-track/blob/main/src/lib/db.ts"
click node_email_notifications "https://github.com/praveenofficial12/vsbec-track/blob/main/src/lib/email-notifications.ts"
click node_email_service "https://github.com/praveenofficial12/vsbec-track/blob/main/mini-services/email-service/index.ts"
click node_common_ui "https://github.com/praveenofficial12/vsbec-track/tree/main/src/components/common"
click node_college_config "https://github.com/praveenofficial12/vsbec-track/blob/main/src/lib/college.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_portal,node_student_profile,node_student_agent,node_admin_portal toneBlue
class node_admin_drive,node_companies,node_drives,node_participations,node_student_drives toneAmber
class node_students,node_analytics,node_reports,node_audit toneMint
class node_auth,node_api_client,node_app_state,node_activity,node_database,node_email_notifications,node_email_service,node_common_ui,node_college_config toneRose
class node_student,node_admin toneIndigo
```

## Components

### Role Portals

- [Student Portal](https://github.com/praveenofficial12/vsbec-track/tree/main/src/components/student): `src/components/student`
- [Profile and Skills](https://github.com/praveenofficial12/vsbec-track/blob/main/src/components/student/StudentProfile.tsx): `src/components/student/StudentProfile.tsx`
- [Student Agent](https://github.com/praveenofficial12/vsbec-track/blob/main/src/components/student/StudentAgent.tsx): `src/components/student/StudentAgent.tsx`
- [Admin Portal](https://github.com/praveenofficial12/vsbec-track/tree/main/src/components/admin): `src/components/admin`

### Placement Workflow

- [Drive Management](https://github.com/praveenofficial12/vsbec-track/blob/main/src/components/admin/AdminDriveDetail.tsx): `src/components/admin/AdminDriveDetail.tsx`
- [Company Records](https://github.com/praveenofficial12/vsbec-track/tree/main/src/app/api/companies): `src/app/api/companies`
- [Drive Management API](https://github.com/praveenofficial12/vsbec-track/tree/main/src/app/api/drives): `src/app/api/drives`
- [Round Outcomes](https://github.com/praveenofficial12/vsbec-track/blob/main/src/app/api/participations/route.ts): `src/app/api/participations/route.ts`
- [Drive Discovery](https://github.com/praveenofficial12/vsbec-track/blob/main/src/components/student/StudentCompanies.tsx): `src/components/student/StudentCompanies.tsx`

### Admin Operations

- [Student Records](https://github.com/praveenofficial12/vsbec-track/tree/main/src/app/api/students): `src/app/api/students`
- [Placement Analytics](https://github.com/praveenofficial12/vsbec-track/blob/main/src/app/api/analytics/route.ts): `src/app/api/analytics/route.ts`
- [Placement Reports](https://github.com/praveenofficial12/vsbec-track/blob/main/src/app/api/reports/route.ts): `src/app/api/reports/route.ts`
- [Audit Logs](https://github.com/praveenofficial12/vsbec-track/blob/main/src/app/api/audit-logs/route.ts): `src/app/api/audit-logs/route.ts`

### Application Services

- [Authentication](https://github.com/praveenofficial12/vsbec-track/tree/main/src/app/api/auth): `src/app/api/auth`
- [API Client](https://github.com/praveenofficial12/vsbec-track/blob/main/src/lib/api.ts): `src/lib/api.ts`
- [Client State](https://github.com/praveenofficial12/vsbec-track/blob/main/src/lib/store.ts): `src/lib/store.ts`
- [Activity Logging](https://github.com/praveenofficial12/vsbec-track/blob/main/src/lib/activity.ts): `src/lib/activity.ts`
- [Application Database](https://github.com/praveenofficial12/vsbec-track/blob/main/src/lib/db.ts): `src/lib/db.ts`
- [Email Notifications](https://github.com/praveenofficial12/vsbec-track/blob/main/src/lib/email-notifications.ts): `src/lib/email-notifications.ts`
- [Email Service](https://github.com/praveenofficial12/vsbec-track/blob/main/mini-services/email-service/index.ts): `mini-services/email-service/index.ts`
- [Shared UI](https://github.com/praveenofficial12/vsbec-track/tree/main/src/components/common): `src/components/common`
- [College Configuration](https://github.com/praveenofficial12/vsbec-track/blob/main/src/lib/college.ts): `src/lib/college.ts`

### Other components

- **Student**
- **Placement Staff**

## Connections

- Student → Student Portal: uses (evidence: `README.md`)
- Placement Staff → Admin Portal: uses (evidence: `README.md`)
- Student Portal → Profile and Skills: manages profile (evidence: `README.md`)
- Student Portal → Drive Discovery: browses drives (evidence: `README.md`)
- Student Portal → Student Agent: accesses (evidence: `src/components/student/StudentLayout.tsx`)
- Admin Portal → Student Records: manages records (evidence: `README.md`)
- Admin Portal → Company Records: manages companies (evidence: `README.md`)
- Admin Portal → Drive Management: configures drives (evidence: `README.md`)
- Admin Portal → Placement Analytics: reviews metrics (evidence: `README.md`)
- Admin Portal → Placement Reports: exports reports (evidence: `README.md`)
- Admin Portal → Audit Logs: reviews history (evidence: `README.md`)
- Drive Management → Drive Management API: manages drives (evidence: `src/components/admin/AdminDriveDetail.tsx`)
- Drive Discovery → API Client: posts participation (evidence: `src/components/student/StudentCompanies.tsx`)
- API Client → Round Outcomes: sends requests (evidence: `src/lib/api.ts`)
- Round Outcomes → Application Database: updates outcomes (evidence: `src/app/api/participations/route.ts`)
- Drive Management API → Application Database: reads and writes (evidence: `src/app/api/drives/route.ts`)
- Drive Management API → Email Notifications: dispatches notices (evidence: `src/app/api/drives/route.ts`)
- Email Notifications → Application Database: selects recipients (evidence: `src/lib/email-notifications.ts`)
- Email Notifications → Email Service: sends email
- Student Records → Application Database: reads records (evidence: `src/app/api/students/route.ts`)
- Placement Analytics → Application Database: queries metrics (evidence: `src/app/api/analytics/route.ts`)
- Placement Reports → Application Database: queries reports (evidence: `src/app/api/reports/route.ts`)
- Authentication → Application Database: accesses accounts (evidence: `src/app/api/auth/student-register/route.ts`)
- Authentication → Activity Logging: logs registration (evidence: `src/app/api/auth/student-register/route.ts`)
- Activity Logging → Application Database: records activity (evidence: `src/lib/activity.ts`)
- Student Portal → Client State: maintains session (evidence: `src/components/student/StudentCompanies.tsx`)
- Shared UI → Student Portal: supports screens (evidence: `src/components/student/StudentCompanies.tsx`)
- Shared UI → Admin Portal: supports screens (evidence: `src/components/admin/AdminDriveDetail.tsx`)
