# gitnonta/uni-activity architecture

> Architecture diagram of the GitHub repository gitnonta/uni-activity, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gitnonta/uni-activity
- Repository: https://github.com/gitnonta/uni-activity

## Overview

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: [`app/Http/Controllers/CheckInController.php`](https://github.com/gitnonta/uni-activity/blob/main/app/Http/Controllers/CheckInController.php) (Check-in Entry), [`app/Models/Activity.php`](https://github.com/gitnonta/uni-activity/blob/main/app/Models/Activity.php) (Activity Domain), [`app/Services/CheckInService.php`](https://github.com/gitnonta/uni-activity/blob/main/app/Services/CheckInService.php) (Check-in Rules), [`app/Http/Controllers/Auth/LoginOtpController.php`](https://github.com/gitnonta/uni-activity/blob/main/app/Http/Controllers/Auth/LoginOtpController.php) (Authentication & OTP)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access &amp; Governance"]
  node_users["Users &amp; Identity<br/>[User.php]"]
  node_auth["Authentication &amp; OTP"]
  node_authorization["Role Policies"]
  node_audit["Audit Logging"]
end

subgraph group_activities["Activity Lifecycle"]
  node_activity_admin["Activity Administration"]
  node_activity_domain["Activity Domain<br/>[Activity.php]"]
  node_registrations["Registrations<br/>[Registration.php]"]
  node_categories["Activity Categories"]
end

subgraph group_verification["Attendance Verification"]
  node_checkin_entry["Check-in Entry"]
  node_checkin_service["Check-in Rules<br/>[CheckInService.php]"]
  node_attendance[("Attendance Records<br/>[Attendance.php]")]
  node_face_service["Face Verification"]
  node_ai_service["AI Face Service<br/>[server.py]"]
  node_qr_service["QR Code Service<br/>[QrCodeService.php]"]
end

subgraph group_communications["Communications &amp; Records"]
  node_realtime["Real-time Events &amp; Chat"]
  node_line["LINE Notifications<br/>[LineService.php]"]
  node_reporting["Reports &amp; Transcripts"]
end

subgraph group_operations["Cluster Operations"]
  node_monitor_ui["Monitor Dashboard<br/>[App.jsx]"]
  node_monitor_backend["Monitor Backend<br/>[main.go]"]
end

node_student(("Student / Staff"))
node_operator(("System Operator"))

node_student -->|"authenticates"| node_auth
node_auth -->|"checks identity"| node_users
node_student -->|"manages activities"| node_activity_admin
node_activity_admin -->|"creates and updates"| node_activity_domain
node_activity_domain -->|"has registrations"| node_registrations
node_activity_domain -->|"has category"| node_categories
node_student -->|"scans or checks in"| node_checkin_entry
node_checkin_entry -->|"loads activity"| node_activity_domain
node_checkin_entry -->|"delegates check-in"| node_checkin_service
node_checkin_service -->|"records attendance"| node_attendance
node_checkin_entry -->|"verifies selfie"| node_face_service
node_checkin_entry -.->|"uses QR service"| node_qr_service
node_face_service -.->|"requests verification"| node_ai_service
node_checkin_service -->|"uses registration"| node_registrations
node_student -->|"uses live features"| node_realtime
node_realtime -->|"triggers notifications"| node_line
node_student -->|"requests records"| node_reporting
node_student -->|"accesses protected features"| node_authorization
node_authorization -->|"checks roles"| node_users
node_operator -.->|"operates cluster"| node_monitor_ui
node_monitor_ui -.->|"receives live status"| node_monitor_backend

click node_users "https://github.com/gitnonta/uni-activity/blob/main/app/Models/User.php"
click node_auth "https://github.com/gitnonta/uni-activity/blob/main/app/Http/Controllers/Auth/LoginOtpController.php"
click node_authorization "https://github.com/gitnonta/uni-activity/blob/main/app/Providers/AuthServiceProvider.php"
click node_audit "https://github.com/gitnonta/uni-activity/blob/main/app/Http/Middleware/AuditLogMiddleware.php"
click node_activity_admin "https://github.com/gitnonta/uni-activity/blob/main/app/Http/Controllers/Admin/ActivityAdminController.php"
click node_activity_domain "https://github.com/gitnonta/uni-activity/blob/main/app/Models/Activity.php"
click node_registrations "https://github.com/gitnonta/uni-activity/blob/main/app/Models/Registration.php"
click node_categories "https://github.com/gitnonta/uni-activity/blob/main/app/Models/ActivityCategory.php"
click node_checkin_entry "https://github.com/gitnonta/uni-activity/blob/main/app/Http/Controllers/CheckInController.php"
click node_checkin_service "https://github.com/gitnonta/uni-activity/blob/main/app/Services/CheckInService.php"
click node_attendance "https://github.com/gitnonta/uni-activity/blob/main/app/Models/Attendance.php"
click node_face_service "https://github.com/gitnonta/uni-activity/blob/main/app/Services/FaceVerificationService.php"
click node_ai_service "https://github.com/gitnonta/uni-activity/blob/main/ai_service/server.py"
click node_qr_service "https://github.com/gitnonta/uni-activity/blob/main/app/Services/QrCodeService.php"
click node_realtime "https://github.com/gitnonta/uni-activity/blob/main/app/Events/ActivityPublished.php"
click node_line "https://github.com/gitnonta/uni-activity/blob/main/app/Services/LineService.php"
click node_reporting "https://github.com/gitnonta/uni-activity/blob/main/app/Http/Controllers/Admin/ExcelExportController.php"
click node_monitor_ui "https://github.com/gitnonta/uni-activity/blob/main/monitor-ui/src/App.jsx"
click node_monitor_backend "https://github.com/gitnonta/uni-activity/blob/main/go-monitor/main.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_users,node_auth,node_authorization,node_audit toneBlue
class node_activity_admin,node_activity_domain,node_registrations,node_categories toneAmber
class node_checkin_entry,node_checkin_service,node_attendance,node_face_service,node_ai_service,node_qr_service toneMint
class node_realtime,node_line,node_reporting toneRose
class node_monitor_ui,node_monitor_backend,node_student,node_operator toneIndigo
```

## Components

### Access & Governance

- [Users & Identity](https://github.com/gitnonta/uni-activity/blob/main/app/Models/User.php): `app/Models/User.php`
- [Authentication & OTP](https://github.com/gitnonta/uni-activity/blob/main/app/Http/Controllers/Auth/LoginOtpController.php): `app/Http/Controllers/Auth/LoginOtpController.php`
- [Role Policies](https://github.com/gitnonta/uni-activity/blob/main/app/Providers/AuthServiceProvider.php): `app/Providers/AuthServiceProvider.php`
- [Audit Logging](https://github.com/gitnonta/uni-activity/blob/main/app/Http/Middleware/AuditLogMiddleware.php): `app/Http/Middleware/AuditLogMiddleware.php`

### Activity Lifecycle

- [Activity Administration](https://github.com/gitnonta/uni-activity/blob/main/app/Http/Controllers/Admin/ActivityAdminController.php): `app/Http/Controllers/Admin/ActivityAdminController.php`
- [Activity Domain](https://github.com/gitnonta/uni-activity/blob/main/app/Models/Activity.php): `app/Models/Activity.php`
- [Registrations](https://github.com/gitnonta/uni-activity/blob/main/app/Models/Registration.php): `app/Models/Registration.php`
- [Activity Categories](https://github.com/gitnonta/uni-activity/blob/main/app/Models/ActivityCategory.php): `app/Models/ActivityCategory.php`

### Attendance Verification

- [Check-in Entry](https://github.com/gitnonta/uni-activity/blob/main/app/Http/Controllers/CheckInController.php): `app/Http/Controllers/CheckInController.php`
- [Check-in Rules](https://github.com/gitnonta/uni-activity/blob/main/app/Services/CheckInService.php): `app/Services/CheckInService.php`
- [Attendance Records](https://github.com/gitnonta/uni-activity/blob/main/app/Models/Attendance.php): `app/Models/Attendance.php`
- [Face Verification](https://github.com/gitnonta/uni-activity/blob/main/app/Services/FaceVerificationService.php): `app/Services/FaceVerificationService.php`
- [AI Face Service](https://github.com/gitnonta/uni-activity/blob/main/ai_service/server.py): `ai_service/server.py`
- [QR Code Service](https://github.com/gitnonta/uni-activity/blob/main/app/Services/QrCodeService.php): `app/Services/QrCodeService.php`

### Communications & Records

- [Real-time Events & Chat](https://github.com/gitnonta/uni-activity/blob/main/app/Events/ActivityPublished.php): `app/Events/ActivityPublished.php`
- [LINE Notifications](https://github.com/gitnonta/uni-activity/blob/main/app/Services/LineService.php): `app/Services/LineService.php`
- [Reports & Transcripts](https://github.com/gitnonta/uni-activity/blob/main/app/Http/Controllers/Admin/ExcelExportController.php): `app/Http/Controllers/Admin/ExcelExportController.php`

### Cluster Operations

- [Monitor Dashboard](https://github.com/gitnonta/uni-activity/blob/main/monitor-ui/src/App.jsx): `monitor-ui/src/App.jsx`
- [Monitor Backend](https://github.com/gitnonta/uni-activity/blob/main/go-monitor/main.go): `go-monitor/main.go`

### Other components

- **Student / Staff**
- **System Operator**

## Connections

- Student / Staff → Authentication & OTP: authenticates
- Authentication & OTP → Users & Identity: checks identity (evidence: `app/Http/Controllers/Auth/LoginOtpController.php`)
- Student / Staff → Activity Administration: manages activities
- Activity Administration → Activity Domain: creates and updates (evidence: `app/Http/Controllers/Admin/ActivityAdminController.php`)
- Activity Domain → Registrations: has registrations (evidence: `app/Models/Activity.php`)
- Activity Domain → Activity Categories: has category (evidence: `app/Models/Activity.php`)
- Student / Staff → Check-in Entry: scans or checks in
- Check-in Entry → Activity Domain: loads activity (evidence: `app/Http/Controllers/CheckInController.php`)
- Check-in Entry → Check-in Rules: delegates check-in (evidence: `app/Http/Controllers/CheckInController.php`)
- Check-in Rules → Attendance Records: records attendance (evidence: `app/Services/CheckInService.php`)
- Check-in Entry → Face Verification: verifies selfie (evidence: `app/Http/Controllers/CheckInController.php`)
- Check-in Entry → QR Code Service: uses QR service (evidence: `app/Http/Controllers/CheckInController.php`)
- Face Verification → AI Face Service: requests verification
- Check-in Rules → Registrations: uses registration (evidence: `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 (evidence: `app/Providers/AuthServiceProvider.php`)
- System Operator → Monitor Dashboard: operates cluster
- Monitor Dashboard → Monitor Backend: receives live status
