How gagandk5/rrce-erp works
RRCE ERP is a college administration system with role-based portals for admissions, executive and department oversight, faculty, and students. Its main workflows cover enrollment and USN assignment, timetable scheduling and clash checks, attendance with a 24-hour lockout, and student-facing academic and fee services. Route handlers and server actions implement backend operations over Prisma; shared modules provide authentication and domain rules. The README documents several capabilities whose individual wiring is not shown in the sampled source, so those links are documented at the capability level rather than presented as inspected calls.
Main entry points: prisma.ts Prisma data access · auth.ts Session authentication · page.tsx Principal portal · route.ts Timetable API
Components 22
Role Portals
- Login
app/login/page.tsx - Admissions portal
app/admissions/page.tsx - Principal portal
app/principal/page.tsx - HOD portal
app/hod/page.tsx - Faculty portal
app/faculty/page.tsx - Student portal
app/student/page.tsx
Academic Operations
- Attendance sessions
app/api/attendance/session/route.ts - Lockout override
app/api/attendance/unlock/route.ts - Faculty roll call
app/faculty/attendance/actions.ts - Timetable API
app/api/timetable/route.ts - Clash validation
lib/clash-engine.ts - Assignment submissions
app/api/assignments/route.ts - Assignment file access
app/api/assignments/files/[storageKey]/route.ts
Enrollment and Oversight
- Student enrollment
app/api/students/route.ts - Branch reallocation
lib/reallocation.ts - Fee invoices
app/api/invoices/route.ts - Audit logs
app/api/audit-logs/route.ts
Shared Services
- Session authentication
lib/auth.ts - USN and lockout rules
lib/utils.ts - Prisma data access
lib/prisma.ts - Database seeding
lib/seed-service.ts
Other components
- College users
Connections 37
- College users → Login: sign in
- College users → Admissions portal: manage intake
- College users → Principal portal: oversee institution
- College users → HOD portal: manage department
- College users → Faculty portal: manage classes
- College users → Student portal: view records
- Admissions portal → Student enrollment: enroll students
- Admissions portal → Branch reallocation: reallocate branch
- Principal portal → Fee invoices: review fees
- Principal portal → Audit logs: review audit
- HOD portal → Lockout override: override lockout
- Principal portal → Lockout override: override lockout
- Faculty portal → Faculty roll call: record roll call
- Faculty portal → Timetable API: manage schedule
- Student portal → Assignment submissions: submit work
- Student portal → Fee invoices: view and pay
- Timetable API → Clash validation: validate clashes
app/api/timetable/route.ts - Attendance sessions → USN and lockout rules: check lockout
app/api/attendance/session/route.ts - Student enrollment → Session authentication: check session
app/api/students/route.ts - Student enrollment → USN and lockout rules: generate USN
app/api/students/route.ts - Student enrollment → Prisma data access: read and write
app/api/students/route.ts - Attendance sessions → Session authentication: check session
app/api/attendance/session/route.ts - Attendance sessions → Prisma data access: read and write
app/api/attendance/session/route.ts - Lockout override → Session authentication: check session
app/api/attendance/unlock/route.ts - Lockout override → Prisma data access: update sessions
app/api/attendance/unlock/route.ts - Timetable API → Session authentication: check session
app/api/timetable/route.ts - Timetable API → Prisma data access: read and write
app/api/timetable/route.ts - Clash validation → Prisma data access: read schedule
lib/clash-engine.ts - Assignment submissions → Session authentication: check session
app/api/assignments/route.ts - Assignment submissions → Prisma data access: store submissions
app/api/assignments/route.ts - Assignment submissions → Assignment file access: serve file URL
app/api/assignments/route.ts - Fee invoices → Session authentication: check session
app/api/invoices/route.ts - Fee invoices → Prisma data access: read and update
app/api/invoices/route.ts - Branch reallocation → Prisma data access: reallocate transaction
- Database seeding → Prisma data access: populate records
lib/seed-service.ts - Database seeding → Session authentication: hash passwords
lib/seed-service.ts - Database seeding → USN and lockout rules: generate identifiers
lib/seed-service.ts