How kanhaiya-js/campuscare works
SmartCampus is a campus infrastructure issue-resolution platform. Students and faculty report facility problems through a guided flow or room QR scan; issues are checked, prioritized, ticketed, and assigned, then staff and administrators track resolution. The map, campus directories, transport, clubs, and printable QR placards are parallel product capabilities. The README documents these capabilities; sampled route excerpts establish several issue-creation calls. Other API and page internals were not sampled, so their detailed wiring is omitted.
Main entry points: route.ts Issue API · admin/page.tsx Admin Console · report/page.tsx Report Wizard · scan/page.tsx Room QR Scanner
Components 25
Issue Reporting
- Report Wizard
app/issues/report/page.tsx - Room QR Scanner
app/scan/page.tsx - Issue API
app/api/issues/route.ts - Duplicate Detection
lib/services/duplicate-detector.ts - Evidence Uploads
lib/storage/upload.ts
Issue Operations
- Priority Engine
lib/services/priority-engine.ts - Assignment Engine
lib/services/assignment-engine.ts - Ticket ID Generator
lib/services/issue-id.ts - Issue Tracking
app/issues/page.tsx - Issue Details
app/issues/[id]/page.tsx - Staff Workspace
app/staff/page.tsx - Notifications
lib/services/notification.ts
Campus Services
- Campus Map
components/maps/campus-map-inner.tsx - Facilities Directory
app/facilities/page.tsx - Campus Transport
app/transport/page.tsx - Clubs Directory
app/clubs/page.tsx - QR Placards
app/admin/qr-codes/page.tsx
Administration
- Admin Console
app/admin/page.tsx - Issue Administration
app/admin/issues/page.tsx - Analytics & Reports
app/admin/analytics/page.tsx - Audit Logs
app/admin/audit-logs/page.tsx
Shared Platform
- Session & Access
lib/auth/session.ts - Campus Database
lib/db/prisma.ts - Audit Service
lib/services/audit.ts
Other components
- Students & Faculty
Connections 25
- Students & Faculty → Report Wizard: report problems
- Students & Faculty → Room QR Scanner: scan room codes
- Report Wizard → Issue API: submit reports
- Room QR Scanner → Report Wizard: start reporting
- Issue API → Duplicate Detection: check duplicates
- Issue API → Priority Engine: calculate priority
app/api/issues/route.ts - Issue API → Ticket ID Generator: generate ticket ID
app/api/issues/route.ts - Issue API → Assignment Engine: find staff
app/api/issues/route.ts - Issue API → Campus Database: create issue
app/api/issues/route.ts - Issue API → Notifications: send notifications
app/api/issues/route.ts - Report Wizard → Evidence Uploads: attach evidence
- Issue Tracking → Issue API: retrieve tickets
- Issue Details → Issue API: view and update
- Staff Workspace → Issue API: manage assigned work
- Students & Faculty → Campus Map: explore hotspots
- Students & Faculty → Facilities Directory: browse facilities
- Students & Faculty → Campus Transport: view bus routes
- Students & Faculty → Clubs Directory: browse societies
- Admin Console → Issue Administration: manage issues
- Admin Console → Analytics & Reports: review operations
- Admin Console → Audit Logs: review activity
- Admin Console → QR Placards: prepare placards
- Issue API → Session & Access: get session
app/api/issues/route.ts - Issue API → Audit Service: record activity
app/api/issues/route.ts - Audit Service → Campus Database: write audit log
lib/services/audit.ts