How genix2096/disaster-response-system works
This is a disaster-reporting and alert-management web application. Citizens authenticate, submit incident details and optional photographs, then receive a report record; administrators review, classify, update, or delete reports and manage users. The backend assigns priority and departments, enriches submissions with image metadata and an AI summary, stores records, and dispatches alerts. The graph preserves the separate citizen and administrator authentication paths and the documented AWS integrations. Relationships are limited to README statements and shown source references; some page-level and service wiring is documented but not excerpted.
Main entry points: incidentController.js Incident handling · api.js API clients · dynamoService.js DynamoDB access · s3Service.js Photo storage
Components 28
Citizen portal
- Citizen portal
frontend/src/pages/ReportIncident.jsx - Incident history
frontend/src/pages/UserDashboard.jsx - Citizen auth state
frontend/src/context/UserAuthContext.jsx - Cognito client
frontend/src/services/cognito.js
Admin workspace
- Admin dashboard
frontend/src/pages/AdminDashboard.jsx - Incident review
frontend/src/pages/IncidentDetails.jsx - User management
frontend/src/components/UserManagement.jsx - Admin auth state
frontend/src/context/AuthContext.jsx
API and identity
- API clients
frontend/src/services/api.js - Express API
backend/src/server.js - Incident routes
backend/src/routes/incidentRoutes.js
Incident processing
- Incident handling
backend/src/controllers/incidentController.js - Admin handling
backend/src/controllers/adminController.js - User endpoints
backend/src/controllers/userController.js - Priority rules
backend/src/utils/priority.js - Image validation
backend/src/utils/imageValidator.js
Cloud services
- DynamoDB access
backend/src/services/dynamoService.js - User profiles
backend/src/services/userService.js - Photo storage
backend/src/services/s3Service.js - AI summaries
backend/src/services/groqService.js - Department alerts
backend/src/services/snsService.js
Other components
- Citizen
- Administrator
- Amazon Cognito
- Amazon DynamoDB
- Amazon S3
- Groq API
- Amazon SNS
Connections 29
- Citizen → Citizen portal: uses
README.md - Administrator → Admin dashboard: uses
README.md - Citizen portal → API clients: submits reports
- Incident history → API clients: fetches history
- Citizen auth state → Cognito client: authenticates with
frontend/src/context/UserAuthContext.jsx - Citizen auth state → API clients: loads profile
frontend/src/context/UserAuthContext.jsx - Cognito client → Amazon Cognito: authenticates
README.md - Admin dashboard → API clients: manages reports
frontend/src/pages/AdminDashboard.jsx - Incident review → API clients: updates reports
frontend/src/pages/IncidentDetails.jsx - User management → API clients: manages users
frontend/src/components/UserManagement.jsx - Admin auth state → API clients: supplies admin token
- API clients → Express API: sends API requests
README.md - Express API → Incident routes: mounts routes
backend/src/server.js - Incident routes → Incident handling: dispatches requests
backend/src/routes/incidentRoutes.js - Incident handling → Priority rules: determines priority
backend/src/controllers/incidentController.js - Incident handling → Image validation: validates image
backend/src/controllers/incidentController.js - Incident handling → DynamoDB access: stores and reads incidents
backend/src/controllers/incidentController.js - Incident handling → Photo storage: uploads and signs photos
backend/src/controllers/incidentController.js - Incident handling → AI summaries: generates summary
backend/src/controllers/incidentController.js - Incident handling → Department alerts: publishes alert
backend/src/controllers/incidentController.js - Admin handling → DynamoDB access: marks reports fake
backend/src/controllers/adminController.js - Admin handling → User profiles: manages user risk
backend/src/controllers/adminController.js - User endpoints → DynamoDB access: reads user incidents
backend/src/controllers/userController.js - User endpoints → Photo storage: signs photo URLs
backend/src/controllers/userController.js - DynamoDB access → Amazon DynamoDB: reads and writes
README.md - User profiles → Amazon DynamoDB: reads and writes profiles
README.md - Photo storage → Amazon S3: stores photographs
README.md - AI summaries → Groq API: requests summaries
README.md - Department alerts → Amazon SNS: sends notifications
README.md