How gitnonta/uni-activity works
The repository’s main product is a university activity platform: students and staff authenticate, discover and register for activities, then record attendance through QR, walk-in or selfie verification; administrators manage activities and review results. The README also documents real-time chat and notifications, LINE integration, governance, and official reporting. A separate Go monitor and React dashboard provide cluster operations. Edges are limited to relationships shown in excerpts, indexed references, or README claims; unverified integration links are dashed.
Main entry points: CheckInController.php Check-in Entry · Activity.php Activity Domain · CheckInService.php Check-in Rules · LoginOtpController.php Authentication & OTP
Components 21
Access & Governance
- Users & Identity
app/Models/User.php - Authentication & OTP
app/Http/Controllers/Auth/LoginOtpController.php - Role Policies
app/Providers/AuthServiceProvider.php - Audit Logging
app/Http/Middleware/AuditLogMiddleware.php
Activity Lifecycle
- Activity Administration
app/Http/Controllers/Admin/ActivityAdminController.php - Activity Domain
app/Models/Activity.php - Registrations
app/Models/Registration.php - Activity Categories
app/Models/ActivityCategory.php
Attendance Verification
- Check-in Entry
app/Http/Controllers/CheckInController.php - Check-in Rules
app/Services/CheckInService.php - Attendance Records
app/Models/Attendance.php - Face Verification
app/Services/FaceVerificationService.php - AI Face Service
ai_service/server.py - QR Code Service
app/Services/QrCodeService.php
Communications & Records
- Real-time Events & Chat
app/Events/ActivityPublished.php - LINE Notifications
app/Services/LineService.php - Reports & Transcripts
app/Http/Controllers/Admin/ExcelExportController.php
Cluster Operations
- Monitor Dashboard
monitor-ui/src/App.jsx - Monitor Backend
go-monitor/main.go
Other components
- Student / Staff
- System Operator
Connections 21
- Student / Staff → Authentication & OTP: authenticates
- Authentication & OTP → Users & Identity: checks identity
app/Http/Controllers/Auth/LoginOtpController.php - Student / Staff → Activity Administration: manages activities
- Activity Administration → Activity Domain: creates and updates
app/Http/Controllers/Admin/ActivityAdminController.php - Activity Domain → Registrations: has registrations
app/Models/Activity.php - Activity Domain → Activity Categories: has category
app/Models/Activity.php - Student / Staff → Check-in Entry: scans or checks in
- Check-in Entry → Activity Domain: loads activity
app/Http/Controllers/CheckInController.php - Check-in Entry → Check-in Rules: delegates check-in
app/Http/Controllers/CheckInController.php - Check-in Rules → Attendance Records: records attendance
app/Services/CheckInService.php - Check-in Entry → Face Verification: verifies selfie
app/Http/Controllers/CheckInController.php - Check-in Entry → QR Code Service: uses QR service
app/Http/Controllers/CheckInController.php - Face Verification → AI Face Service: requests verification
- Check-in Rules → Registrations: uses registration
app/Services/CheckInService.php - Student / Staff → Real-time Events & Chat: uses live features
- Real-time Events & Chat → LINE Notifications: triggers notifications
- Student / Staff → Reports & Transcripts: requests records
- Student / Staff → Role Policies: accesses protected features
- Role Policies → Users & Identity: checks roles
app/Providers/AuthServiceProvider.php - System Operator → Monitor Dashboard: operates cluster
- Monitor Dashboard → Monitor Backend: receives live status