How pupbtfocus/pup-bataan-focus works
PUP FOCUS is a role-based university faculty compliance and document-submission system. Faculty submit required documents and track status; staff and administrators manage accounts, submission windows, academic terms, reviews, and records. The tree also shows notifications, audit/transaction logs, backups, and reporting capabilities. The excerpts confirm several API-to-service and API-to-database interactions; most page-to-API wiring and unsampled feature internals are not shown, so those relationships are omitted or marked unverified.
Main entry points: create/route.ts Submission intake · server.ts Server database client · submission-window/route.ts Window administration · academic-terms/route.ts Academic term management
Components 22
Access and roles
- Sign-in and invites
pup-focus/components/auth/login-form.tsx - Authentication API
pup-focus/app/api/auth/login/route.ts - Role policy
pup-focus/config/roles.ts
Faculty submissions
- Faculty portal
pup-focus/app/(faculty)/faculty/submit/page.tsx - Submission intake
pup-focus/app/api/faculty/submissions/create/route.ts - Window and term rules
pup-focus/features/submissions/services/submission-window.service.ts - Compliance progress
pup-focus/features/compliance-management/services/compliance-engine.service.ts - Submission history and data
pup-focus/features/submissions/services/faculty-data.service.ts
Staff operations
- Submission review
pup-focus/features/document-review/actions/review-submission.action.ts - Staff operations portal
pup-focus/features/faculty-management/components/staff-dashboard.tsx - Academic term management
pup-focus/app/api/staff/academic-terms/route.ts - Window administration
pup-focus/app/api/staff/submission-window/route.ts - Account management
pup-focus/app/api/staff/user-registration-logs/route.ts - Backup and archive
pup-focus/app/api/staff/backups/route.ts - Report export
pup-focus/app/api/reports/export/route.ts
Shared services
- Notifications
pup-focus/features/notifications/services/notification.service.ts - Audit logging
pup-focus/features/audit-logs/services/audit-log.service.ts - Server database client
pup-focus/lib/supabase/server.ts
Other components
- Faculty user
- Staff and admin
- Supabase data and storage
- Email delivery
Connections 28
- Faculty user → Sign-in and invites: signs in
- Staff and admin → Sign-in and invites: signs in
- Sign-in and invites → Authentication API: authenticates
- Authentication API → Server database client: creates session
- Faculty user → Faculty portal: uses portal
- Staff and admin → Staff operations portal: uses portal
- Faculty portal → Submission intake: submits documents
- Submission intake → Server database client: authenticates
pup-focus/app/api/faculty/submissions/create/route.ts - Submission intake → Window and term rules: checks window
pup-focus/app/api/faculty/submissions/create/route.ts - Submission intake → Notifications: creates alert
pup-focus/app/api/faculty/submissions/create/route.ts - Submission intake → Audit logging: logs event
pup-focus/app/api/faculty/submissions/create/route.ts - Submission intake → Supabase data and storage: stores submission
pup-focus/app/api/faculty/submissions/create/route.ts - Window administration → Server database client: authenticates
pup-focus/app/api/staff/submission-window/route.ts - Window administration → Window and term rules: evaluates schedule
pup-focus/app/api/staff/submission-window/route.ts - Window administration → Supabase data and storage: updates window
pup-focus/app/api/staff/submission-window/route.ts - Window administration → Email delivery: sends reminders
pup-focus/app/api/staff/submission-window/route.ts - Academic term management → Server database client: authenticates
pup-focus/app/api/staff/academic-terms/route.ts - Academic term management → Window and term rules: normalizes term
pup-focus/app/api/staff/academic-terms/route.ts - Academic term management → Supabase data and storage: reads term data
pup-focus/app/api/staff/academic-terms/route.ts - Account management → Server database client: authenticates
pup-focus/app/api/staff/user-registration-logs/route.ts - Account management → Email delivery: sends invitations
pup-focus/app/api/staff/user-registration-logs/route.ts - Account management → Supabase data and storage: manages accounts
pup-focus/app/api/staff/user-registration-logs/route.ts - Submission review → Supabase data and storage: reviews records
- Submission history and data → Supabase data and storage: reads submissions
- Compliance progress → Faculty portal: shows progress
- Backup and archive → Supabase data and storage: archives data
- Report export → Supabase data and storage: exports records
- Role policy → Staff operations portal: defines roles