How singhadi0/phd works
Research X is a multi-tenant PhD lifecycle platform for administrators, scholars, supervisors, and developers. Users authenticate, select or resolve a tenant membership, then enter a role-specific workspace. Admin workflows cover admissions, programs, scholar enrollment, communications, documents, and fees; scholars track onboarding, coursework, finances, and meetings, while supervisors and developers have dedicated workspaces. The README documents these capabilities; several routes and modules were not sampled, so their internal connections are shown only where documented or indexed.
Main entry points: [tenantSlug] Tenant workspace entry · admin Admin console · db.ts PostgreSQL database · session.ts Session and membership
Components 20
Identity and tenancy
- Login and registration
app/(public) - Auth endpoints
app/api/auth - Session and membership
lib/auth/session.ts - Role access checks
lib/auth/rbac.ts - Tenant workspace entry
app/(tenant)/[tenantSlug] - Role dashboard routing
lib/auth/navigation.ts
Academic operations
- Admin console
app/(tenant)/[tenantSlug]/(dashboard)/admin - Admissions management
lib/admin/admissions.ts - Programs and courses
lib/admin/programs.ts - Scholar administration
lib/admin/scholars.ts - Fee ledger
lib/admin/finance.ts - Admin communications
lib/admin/communications.ts
Role workspaces
- Scholar workspace
app/(tenant)/[tenantSlug]/(dashboard)/scholar - Scholar dashboard summary
lib/dashboard/scholar.ts - Supervisor workspace
app/(tenant)/[tenantSlug]/(dashboard)/supervisor - Developer console
app/(tenant)/[tenantSlug]/(dashboard)/developer
Data and messaging
- PostgreSQL database
lib/db.ts - Scholar invitation email
lib/email/scholar-invite.ts - Email delivery
lib/email/mailer.ts
Other components
- Platform user
Connections 29
- Platform user → Login and registration: signs in
- Login and registration → Auth endpoints: submits credentials
- Auth endpoints → Session and membership: resolves session
app/api/auth/post-login/route.ts - Auth endpoints → PostgreSQL database: updates tenant
app/api/auth/tenant/route.ts - Auth endpoints → Role dashboard routing: resolves redirect
app/api/auth/post-login/route.ts - Platform user → Tenant workspace entry: opens tenant
- Tenant workspace entry → Session and membership: requires session
app/(tenant)/[tenantSlug]/page.tsx - Tenant workspace entry → Role access checks: checks roles
app/(tenant)/[tenantSlug]/page.tsx - Tenant workspace entry → Role dashboard routing: checks membership
app/(tenant)/[tenantSlug]/page.tsx - Role dashboard routing → Session and membership: requires membership
lib/auth/navigation.ts - Tenant workspace entry → Admin console: routes managers
app/(tenant)/[tenantSlug]/page.tsx - Tenant workspace entry → Scholar workspace: routes scholars
app/(tenant)/[tenantSlug]/page.tsx - Tenant workspace entry → Supervisor workspace: routes supervisors
app/(tenant)/[tenantSlug]/page.tsx - Tenant workspace entry → Developer console: routes developers
app/(tenant)/[tenantSlug]/page.tsx - Admin console → Session and membership: requires membership
app/(tenant)/[tenantSlug]/(dashboard)/admin/page.tsx - Admin console → Role access checks: checks roles
app/(tenant)/[tenantSlug]/(dashboard)/admin/page.tsx - Admin console → Admissions management: manages admissions
- Admin console → Programs and courses: manages catalogs
- Admin console → Scholar administration: enrolls scholars
- Admin console → Fee ledger: manages fees
- Admin console → Admin communications: sends broadcasts
- Scholar workspace → Session and membership: requires membership
app/(tenant)/[tenantSlug]/(dashboard)/scholar/page.tsx - Scholar workspace → Scholar dashboard summary: loads summary
app/(tenant)/[tenantSlug]/(dashboard)/scholar/page.tsx - Scholar dashboard summary → PostgreSQL database: reads records
lib/dashboard/scholar.ts - Scholar workspace → PostgreSQL database: loads tenant data
- Scholar administration → PostgreSQL database: reads and writes
lib/admin/scholars.ts - Scholar administration → Scholar invitation email: sends invitations
lib/admin/scholars.ts - Scholar invitation email → Email delivery: delegates delivery
lib/email/scholar-invite.ts - PostgreSQL database → Platform user: stores platform data