How natskie101/osas_beacon works
BEACON OSAS is a server-rendered student-affairs portal for students, coordinators, and administrators. Users enter through web routes, authenticate or register, then use role-scoped portal workflows for student services or administration; controllers coordinate domain operations and persist state. The README documents orientation, announcements, events, requests, support, broadcasts, notifications, analytics, and reports. The source index and excerpts support some controller-to-service/model links; unsampled feature internals are represented at their listed controller paths, with no guessed internal call chains.
Main entry points: web.php Web routes · OrientationController.php Orientation learning · FileStorage.php Protected file storage · LoginController.php Authentication
Components 23
Web entry and access
- HTTP entry
public/index.php - App bootstrap
bootstrap/app.php - Web routes
routes/web.php
Accounts and identity
- Authentication
app/Http/Controllers/Auth/LoginController.php - Student registration
app/Http/Controllers/Auth/RegisterController.php - Account management
app/Http/Controllers/Admin/UserController.php - User operations
app/Services/UserService.php
Student services
- Student dashboard
app/Http/Controllers/Student/DashboardController.php - Announcements
app/Http/Controllers/Student/AnnouncementController.php - Orientation learning
app/Http/Controllers/Student/OrientationController.php - Orientation quizzes
app/Services/OrientationQuizService.php - Requests and support
app/Http/Controllers/Student/SupportController.php - Lost and found
app/Http/Controllers/Student/LostFoundController.php - Events and rules
app/Http/Controllers/Student/EventController.php
Administration
- Admin workspace
app/Http/Controllers/Admin/DashboardController.php - Broadcast delivery
app/Http/Controllers/Admin/BroadcastController.php - Analytics and reports
app/Http/Controllers/Admin/ReportController.php
Shared platform
- Notifications
app/Services/NotificationService.php - Audit trail
app/Services/AuditLogger.php - Protected file storage
app/Services/FileStorage.php - Optional R2 storage
app/Services/R2Storage.php - PostgreSQL
Other components
- Portal user
Connections 29
- Portal user → HTTP entry: sends requests
- HTTP entry → App bootstrap: boots app
public/index.php - App bootstrap → Web routes: loads routes
bootstrap/app.php - Web routes → Authentication: dispatches auth
routes/web.php - Web routes → Student registration: dispatches signup
routes/web.php - Web routes → Account management: dispatches admin
routes/web.php - Web routes → Student dashboard: dispatches student
routes/web.php - Web routes → Announcements: dispatches service
routes/web.php - Web routes → Orientation learning: dispatches learning
routes/web.php - Web routes → Requests and support: dispatches support
routes/web.php - Web routes → Lost and found: dispatches claims
routes/web.php - Web routes → Events and rules: dispatches events
routes/web.php - Web routes → Admin workspace: dispatches dashboard
routes/web.php - Web routes → Broadcast delivery: dispatches broadcasts
routes/web.php - Web routes → Analytics and reports: dispatches reports
routes/web.php - Student registration → User operations: creates accounts
app/Http/Controllers/Auth/RegisterController.php - Account management → User operations: manages users
app/Http/Controllers/Admin/UserController.php - Orientation learning → Orientation quizzes: uses quiz service
app/Http/Controllers/Student/OrientationController.php - Orientation learning → Protected file storage: stores media
app/Http/Controllers/Student/OrientationController.php - Orientation learning → Notifications: notifies audience
app/Http/Controllers/Student/OrientationController.php - Broadcast delivery → Notifications: delivers portal alerts
- Authentication → Audit trail: records sign-in
app/Http/Controllers/Auth/LoginController.php - Account management → Protected file storage: handles uploads
app/Http/Controllers/Admin/UserController.php - Protected file storage → Optional R2 storage: stores remotely
app/Services/FileStorage.php - Authentication → PostgreSQL: reads identity
- User operations → PostgreSQL: persists accounts
- Notifications → PostgreSQL: persists alerts
- Audit trail → PostgreSQL: writes audit records
app/Services/AuditLogger.php - Protected file storage → PostgreSQL: stores file records
app/Services/FileStorage.php