How phutti19/ruts-realaids works
RUTS-REALAIDS is a campus emergency-alert and first-aid management system with student and staff Next.js interfaces backed by a NestJS API and PostgreSQL. The principal flow is a student submitting a GPS-located incident, staff tracking and updating it, and the reporter receiving status updates; related care workflows cover visits, medication dispensing, and certificates. Other documented capabilities include appointments, inventory, reports, authentication, notifications, and PWA support. Several backend service and frontend feature paths are represented from the tree and README; their internal wiring is not asserted where source excerpts do not show it.
Main entry points: main.ts HTTP API · db.service.ts PostgreSQL · student Student portal · staff Staff portal
Components 23
Web clients
- Student portal
frontend/src/app/student - Staff portal
frontend/src/app/staff
API access
- HTTP API
backend/src/main.ts - Authentication
backend/src/modules/auth/auth.service.ts - Request authorization
backend/src/common/guards/auth.guard.ts
Emergency and care
- Incident handling
backend/src/modules/emergency/emergency.service.ts - Incident maps
frontend/src/components/maps/EmergencyMap.tsx - Patient visits
backend/src/modules/visits/visits.service.ts - Medical certificates
backend/src/modules/certificates/certificates.service.ts
Clinic operations
- Appointments
backend/src/modules/appointments/appointments.service.ts - Medicine inventory
backend/src/modules/medicines/medicines.service.ts - Reports and statistics
backend/src/modules/reports/reports.service.ts - Administration settings
backend/src/modules/settings/settings.service.ts - User profiles
backend/src/modules/users/users.service.ts
Shared platform
- Notifications
backend/src/modules/notifications/notifications.service.ts - WebSocket updates
backend/src/websocket/ws.service.ts - Push subscriptions
frontend/src/hooks/usePushNotification.ts - Offline and install
frontend/public/sw.js - PostgreSQL
backend/src/database/db.service.ts - Email delivery
backend/src/email/email.service.ts
Other components
- Student
- Clinic staff
- Web Push service
Connections 31
- Student → Student portal: uses
README.md - Clinic staff → Staff portal: uses
README.md - Student portal → HTTP API: requests
README.md - Staff portal → HTTP API: requests
README.md - HTTP API → Authentication: authenticates
- Authentication → PostgreSQL: reads and writes
backend/src/modules/auth/auth.service.ts - HTTP API → Request authorization: guards routes
backend/src/common/guards/auth.guard.ts - Request authorization → Authentication: verifies JWT
- HTTP API → Incident handling: routes incidents
- Incident handling → PostgreSQL: stores incident data
- Staff portal → Incident maps: views incidents
README.md - Student portal → HTTP API: reports emergencies
README.md - HTTP API → Patient visits: routes visits
- Patient visits → Medical certificates: requests certificate
backend/src/modules/visits/visits.controller.ts - Patient visits → PostgreSQL: persists care records
- HTTP API → Appointments: routes bookings
- Appointments → PostgreSQL: persists bookings
backend/src/modules/appointments/appointments.service.ts - HTTP API → Medicine inventory: routes inventory
- Medicine inventory → PostgreSQL: persists stock
- HTTP API → Reports and statistics: routes reports
- HTTP API → Administration settings: routes administration
- HTTP API → User profiles: routes profiles
- HTTP API → Notifications: routes notifications
- Notifications → WebSocket updates: delivers live updates
- Student portal → WebSocket updates: receives updates
- Staff portal → WebSocket updates: receives updates
- Push subscriptions → Web Push service: subscribes
- Notifications → Web Push service: sends push
- Student portal → Offline and install: runs offline
README.md - Authentication → Email delivery: sends account email
backend/src/modules/auth/auth.service.ts - HTTP API → PostgreSQL: health and domain queries