xieshie/student-services

How xieshie/student-services works

Student Services is a Laravel/Livewire application for school staff to manage students and service requests, with a Sanctum REST API and asynchronous Excel imports. The main workflow is staff login, student lookup or maintenance, then creating and reviewing requests; administrators can upload imports whose rows create students and pending requests and produce import logs. The README documents capabilities and route roles; some component and route wiring is represented from that documentation because those sources were not sampled.

Main entry points: web.php Web routes · Student.php Students · ServiceRequest.php Service requests · ProcessServiceRequestImport.php Import processor

Components 24

Staff Web

Web routes routes/web.php
Login app/Livewire/Auth/Login.php
Dashboard app/Livewire/Dashboard.php
Student pages app/Livewire/Students/StudentIndex.php
Student forms app/Livewire/Students/StudentCreate.php
Request pages app/Livewire/ServiceRequests/ServiceRequestIndex.php
Request creation app/Livewire/ServiceRequests/ServiceRequestCreate.php
Request review app/Livewire/ServiceRequests/ServiceRequestShow.php

REST API

Student API app/Http/Controllers/Api/StudentApiController.php
Request API app/Http/Controllers/Api/ServiceRequestApiController.php
API routes routes/api.php
Role middleware app/Http/Middleware/AdminMiddleware.php

Excel Import

Import logs UI app/Livewire/Imports/ImportIndex.php
Import upload app/Http/Controllers/ImportUploadController.php
Import processor app/Jobs/ProcessServiceRequestImport.php
Excel reader
Laravel queue config/queue.php

Domain Data

Students app/Models/Student.php
Service requests app/Models/ServiceRequest.php
Import logs app/Models/ImportLog.php
Users app/Models/User.php
Database config/database.php

Other components

Staff
API client

Connections 34

Staff → Web routes: opens pages
Web routes → Login: routes login
Web routes → Dashboard: routes dashboard
Web routes → Student pages: routes students
Web routes → Student forms: routes edits
Web routes → Request pages: routes requests
Web routes → Request creation: routes creation
Web routes → Request review: routes review
Web routes → Import logs UI: routes imports
Student pages → Students: queries
Student forms → Students: creates or updates
Request pages → Service requests: queries
Request creation → Students: searches
Request creation → Service requests: creates
Request review → Service requests: updates status
API client → API routes: calls
API routes → Student API: dispatches
API routes → Request API: dispatches
API routes → Role middleware: protects routes
Student API → Students: queries
Request API → Service requests: queries and updates
Staff → Import upload: uploads workbook
Import upload → Import logs: creates log
Import upload → Laravel queue: dispatches job
Laravel queue → Import processor: runs job
Import processor → Excel reader: reads workbook
Import processor → Students: finds or creates
Import processor → Service requests: checks and creates
Import processor → Import logs: updates summary
Students → Database: persists
Service requests → Database: persists
Import logs → Database: persists
Users → Database: persists
Import logs UI → Import logs: shows logs

More Blade diagrams: ryandaaa/siakad · samir-gamal/invoices_project · ekramasif/inventory_management_system · eduayme/rescueapp · mzainzulifqar/laravel-point-of-sale

Drawn by GitDiagram on September 29, 2026 from the repository's file tree, README and source files. Read as Markdown ·