How varsha042006/falcon_pbl works
Falcon PBL Project Hub is a university workflow system for publishing projects, forming teams, allocating guides, collecting review evidence, assessing work, and verifying results. The graph includes the major README capabilities and the sampled authentication, team creation, rubric configuration, student import, and verified-PDF implementation. Several page and route implementations were not sampled, so uncertain UI-to-API wiring is omitted; unsampled subsystems use paths present in the tree.
Main entry points: db.ts PostgreSQL · page.tsx Sign in · login/route.ts Login handler · [itemId]/route.ts Evidence file access
Components 24
Access and administration
- Sign in
app/login/page.tsx - Login handler
app/api/auth/login/route.ts - Student import
app/api/hod/imports/students/route.ts - Coordinator assignment
app/api/hod/pbl-coordinators/route.ts
Projects and allocation
- Project catalog
app/projects/page.tsx - Project publishing
app/api/projects/route.ts - Faculty applications
app/faculty/applications/page.tsx - Guide requests
app/api/guide-requests/route.ts - Guide limits
app/api/coordinator/guide-limits/route.ts - Student-owned project
app/api/student/own-project/route.ts - Team creation
app/api/teams/route.ts
Reviews and assessment
- Review and rubric setup
app/api/coordinator/rubrics/route.ts - Student review
app/student/reviews/[reviewId]/page.tsx - Evidence submission
app/api/student/review-submissions/[reviewId]/submit/route.ts - Faculty assessment
app/api/faculty/reviews/[reviewId]/team/[teamId]/submit/route.ts - Evidence file access
app/api/review-submission-files/[itemId]/route.ts
Verification and records
- HoD verification
app/api/hod/review-verification/[evaluationId]/route.ts - Verified rubric PDF
app/student/reviews/[reviewId]/rubric-sheet/route.ts
Application foundation
- Session and roles
lib/auth.ts - PostgreSQL
lib/db.ts
Other components
- Student
- Faculty
- PBL Coordinator
- HoD
Connections 38
- Student → Sign in: signs in
- Faculty → Sign in: signs in
- PBL Coordinator → Sign in: signs in
- HoD → Sign in: signs in
- Sign in → Login handler: submits credentials
- Login handler → Session and roles: creates session
- Login handler → PostgreSQL: checks account
- HoD → Student import: imports roster
- Student import → PostgreSQL: writes enrollments
- HoD → Coordinator assignment: assigns coordinator
- Coordinator assignment → PostgreSQL: updates assignments
- Student → Project catalog: browses projects
- Faculty → Project catalog: publishes projects
- Project publishing → PostgreSQL: reads and writes
- Student → Student-owned project: creates project
- Student-owned project → PostgreSQL: stores project
- Student → Faculty applications: applies to projects
- Faculty applications → Project publishing: submits application
- Faculty → Guide requests: decides requests
- Guide requests → PostgreSQL: updates allocation
- PBL Coordinator → Guide limits: sets capacity
- Guide limits → PostgreSQL: stores limits
- PBL Coordinator → Team creation: forms teams
- Team creation → PostgreSQL: stores membership
- PBL Coordinator → Review and rubric setup: configures reviews
- Review and rubric setup → PostgreSQL: stores rubric and requirements
- Student → Student review: views reviews
- Student → Evidence submission: submits evidence
- Evidence submission → PostgreSQL: stores submission
- Faculty → Faculty assessment: evaluates team
- Faculty assessment → PostgreSQL: stores evaluation
- HoD → HoD verification: verifies evaluation
- HoD verification → PostgreSQL: records decision
- Student → Verified rubric PDF: downloads verified sheet
- Verified rubric PDF → PostgreSQL: reads results and logs access
- Faculty → Evidence file access: retrieves evidence
- Student → Evidence file access: retrieves own evidence
- Evidence file access → PostgreSQL: reads stored file