How voss-labs/verp works
VERP is a college ERP for student and faculty records, course offerings, marks, attendance, and departmental administration. Its principal workflow is VOSS sign-in, matching the verified identity to a roster record, then applying capability and record-scope checks before academic work is read or changed. The dashboard exposes role-specific operations; import preview and submission are distinct stages. The graph preserves documented academic, administrative, audit, and reporting areas. Evidence is limited to the README and sampled/indexed references; unsampled implementation links are omitted.
Main entry points: session.ts Identity binding · import/route.ts Roster import · preview/route.ts Marks import preview · dashboard Role dashboards
Components 22
Identity and access
- Authentication
src/lib/auth.ts - Identity binding
src/lib/session.ts - Capabilities and scope
src/lib/rbac.ts
Academic operations
- Role dashboards
src/app/dashboard - Class and marks pages
src/app/dashboard/class - Roster import preview
src/app/api/students/import/preview/route.ts - Roster import
src/app/api/students/import/route.ts - Marks import preview
src/app/api/marks/import/preview/route.ts - Import parsing
src/lib/marks-import.ts - Courses and offerings
src/db/queries/courses.ts - Attendance tracking
src/db/queries/attendance.ts - Marks and results
src/db/queries/marks.ts
Administration
- Department actions
src/app/dashboard/dept/actions.ts - Admin operations
src/app/dashboard/admin/actions.ts - Audit records
src/db/queries/audit.ts
Persistence and reporting
- Student records
src/db/queries/students.ts - Import history
src/db/queries/import-batches.ts - Overview reporting
src/db/queries/overview.ts - Database
src/db/index.ts - Academic schema
src/db/schema
External services
- VOSS identity
Other components
- College users
Connections 26
- College users → VOSS identity: signs in
- VOSS identity → Authentication: provides identity
- Authentication → Identity binding: resolves identity
src/lib/session.ts - Identity binding → Capabilities and scope: resolves capabilities
src/lib/session.ts - College users → Role dashboards: uses
- Role dashboards → Department actions: invokes
src/app/dashboard/dept/client.tsx - Role dashboards → Admin operations: invokes
src/app/dashboard/admin/departments/client.tsx - Role dashboards → Class and marks pages: shows
- Roster import preview → Identity binding: checks access
src/app/api/students/import/preview/route.ts - Roster import → Identity binding: checks access
src/app/api/students/import/route.ts - Roster import → Capabilities and scope: checks capability
src/app/api/students/import/route.ts - Roster import → Student records: creates records
src/app/api/students/import/route.ts - Roster import → Import history: records batch
src/app/api/students/import/route.ts - Marks import preview → Identity binding: checks access
src/app/api/marks/import/preview/route.ts - Marks import preview → Capabilities and scope: checks capability
src/app/api/marks/import/preview/route.ts - Marks import preview → Import parsing: parses marks
src/app/api/marks/import/preview/route.ts - Marks import preview → Student records: matches roster
src/app/api/marks/import/preview/route.ts - Department actions → Courses and offerings: calls queries
src/app/dashboard/dept/actions.ts - Department actions → Student records: calls queries
src/app/dashboard/dept/actions.ts - Database → Academic schema: configures ORM
src/db/index.ts - Overview reporting → Database: queries
src/db/queries/overview.ts - Overview reporting → Audit records: reads records
src/db/queries/overview.ts - College users → Attendance tracking: tracks attendance
- College users → Marks and results: enters and views
- College users → Audit records: reviews activity
- College users → Overview reporting: views summaries