How pyunpyunn/g10-capstone works
RESQPERATION coordinates barangay disaster response through HQ/Admin web operations and household/rescuer mobile workflows, backed by a Laravel API and shared operational database. Residents report household status and location; HQ reviews the operational picture, coordinates dispatch and resources, and records situations; rescuers receive assignments and send field updates. The README also describes mapping, weather and hazard context, notifications, archives, and external partner handoffs. Source excerpts are selective, so unsampled subsystem links are omitted unless documented in the README.
Main entry points: api.php Laravel JSON API · index.tsx Mobile App · App.jsx HQ Web App · Mobile Household Workflows
Components 25
User Applications
- HQ Web App
frontend-web/src/App.jsx - Mobile App
frontend-mobile/app/index.tsx - Evacuation Routes
frontend-mobile/components/household/HouseholdRouteScreen.native.tsx
Backend API
- Laravel JSON API
backend-laravel/routes/api.php - Authentication
backend-laravel/app/Services/Shared/AuthService.php
Response Operations
- HQ Operations
backend-laravel/app/Services/Web - Household Workflows
backend-laravel/app/Services/Mobile - Rescue Dispatch
backend-laravel/app/Services/Web/RescueDispatchService.php - Resource Requests
backend-laravel/app/Services/Web/ResourceRequestService.php - Situation & Archives
backend-laravel/app/Services/Web/SituationReportService.php - Route Precompute
backend-laravel/app/Services/Navigation/RoutePrecomputeService.php - Weather & Hazards
backend-laravel/app/Services/Shared/WeatherService.php - Notifications
backend-laravel/app/Services/Shared/OneSignalNotificationService.php
Operational Data
- Household Records
backend-laravel/app/Models/Household.php - User Accounts
backend-laravel/app/Models/User.php - Schema Capability
backend-laravel/app/Support/RequestSchema.php - Shared Database
External Services
- Open-Meteo
- PAGASA / PHIVOLCS
- OSM / Routing
- Push Services
- External Partners
Other components
- HQ / Admin
- Residents
- Rescuers
Connections 31
- HQ / Admin → HQ Web App: uses
- Residents → Mobile App: uses
- Rescuers → Mobile App: uses
- HQ Web App → Laravel JSON API: calls API
- Mobile App → Laravel JSON API: calls API
- Laravel JSON API → Authentication: authenticates
backend-laravel/app/Services/Shared/AuthService.php - Laravel JSON API → HQ Operations: routes operations
- Laravel JSON API → Household Workflows: routes mobile work
- Laravel JSON API → Rescue Dispatch: routes dispatch
- Laravel JSON API → Resource Requests: routes requests
- Laravel JSON API → Situation & Archives: routes reporting
- Laravel JSON API → Route Precompute: routes navigation
- Laravel JSON API → Weather & Hazards: routes context
- Laravel JSON API → Notifications: delivers notifications
- Evacuation Routes → Mobile App: renders in
frontend-mobile/components/household/HouseholdRouteScreen.native.tsx - Mobile App → Evacuation Routes: shows evacuation routes
- Household Workflows → Household Records: reads household data
- HQ Operations → Shared Database: reads and writes
- Household Workflows → Shared Database: reads and writes
- Rescue Dispatch → Shared Database: records assignments
- Resource Requests → Shared Database: records requests
- Situation & Archives → Shared Database: stores records
- Route Precompute → Shared Database: stores routes
- Authentication → User Accounts: uses accounts
backend-laravel/app/Services/Shared/AuthService.php - Schema Capability → Shared Database: checks schema
backend-laravel/app/Support/RequestSchema.php - Weather & Hazards → Open-Meteo: fetches forecasts
- Weather & Hazards → PAGASA / PHIVOLCS: presents advisories
- HQ Web App → OSM / Routing: uses map and routes
- Notifications → Push Services: sends push
- Resource Requests → External Partners: hands off requests
- Situation & Archives → External Partners: exchanges reports