How javierub32/urbanpulse works
UrbanPulse is a city-incident reporting and management system: residents use an Expo app to authenticate, report incidents, and explore incident information served by a Spring Boot API backed by PostGIS. The backend also documents role-aware incident access, mapping, status history, and atmospheric enrichment. The graph preserves these distinct areas, but unsampled frontend screens and backend subsystems have limited verifiable call relationships; dashed edges indicate unverified integration rather than inspected control flow.
Main entry points: IncidentController.java Incident endpoints · IncidentService.java Incident service · AtmosphericIncidentEnrichmentService.java Weather enrichment · _layout.tsx Expo client
Components 20
Mobile app
- Expo client
frontend/src/app/_layout.tsx - Report incident
frontend/src/app/(tabs)/report.tsx - Browse incidents
frontend/src/app/(tabs)/explore.tsx - Incident detail
frontend/src/pages/incident-detail/index.tsx - Sign in
frontend/src/context/AuthContext.tsx
Identity and access
- Auth endpoints
backend/src/main/java/com/leftjoiner/urbanpulse/urbanpulse/controller/AuthController.java - Auth service
backend/src/main/java/com/leftjoiner/urbanpulse/urbanpulse/service/AuthService.java - JWT service
backend/src/main/java/com/leftjoiner/urbanpulse/urbanpulse/security/JwtService.java - User principal
backend/src/main/java/com/leftjoiner/urbanpulse/urbanpulse/security/UrbanPulsePrincipal.java
Incident management
- Incident endpoints
backend/src/main/java/com/leftjoiner/urbanpulse/urbanpulse/controller/IncidentController.java - Incident service
backend/src/main/java/com/leftjoiner/urbanpulse/urbanpulse/service/IncidentService.java - Incident records
backend/src/main/java/com/leftjoiner/urbanpulse/urbanpulse/entity/IncidentEntity.java
Mapping and context
- Map queries
backend/src/main/java/com/leftjoiner/urbanpulse/urbanpulse/service/IncidentMapService.java - Weather enrichment
backend/src/main/java/com/leftjoiner/urbanpulse/urbanpulse/service/AtmosphericIncidentEnrichmentService.java - Open-Meteo client
backend/src/main/java/com/leftjoiner/urbanpulse/urbanpulse/integration/openmeteo/OpenMeteoClient.java - Context service
backend/src/main/java/com/leftjoiner/urbanpulse/urbanpulse/service/AtmosphericContextService.java
Persistence
- Context repository
backend/src/main/java/com/leftjoiner/urbanpulse/urbanpulse/repository/UrbanContextRepository.java - PostGIS
Other components
- Resident
- Spring API
backend/src/main/java/com/leftjoiner/urbanpulse/urbanpulse/UrbanPulseApplication.java
Connections 19
- Resident → Expo client: uses
README.md - Expo client → Spring API: calls API
README.md - Resident → Report incident: reports
- Report incident → Incident endpoints: submits report
- Browse incidents → Incident endpoints: requests incidents
- Incident detail → Incident endpoints: loads detail
- Sign in → Auth endpoints: authenticates
- Auth endpoints → Auth service: delegates to
backend/src/main/java/com/leftjoiner/urbanpulse/urbanpulse/controller/AuthController.java - Auth service → JWT service: issues token
backend/src/main/java/com/leftjoiner/urbanpulse/urbanpulse/service/AuthService.java - JWT service → User principal: creates principal
backend/src/main/java/com/leftjoiner/urbanpulse/urbanpulse/security/JwtService.java - Incident endpoints → Incident service: delegates to
backend/src/main/java/com/leftjoiner/urbanpulse/urbanpulse/controller/IncidentController.java - Incident endpoints → Map queries: requests map data
backend/src/main/java/com/leftjoiner/urbanpulse/urbanpulse/controller/IncidentController.java - Incident service → Incident records: manages records
backend/src/main/java/com/leftjoiner/urbanpulse/urbanpulse/service/IncidentService.java - Incident service → Weather enrichment: enriches incident
backend/src/main/java/com/leftjoiner/urbanpulse/urbanpulse/service/IncidentService.java - Weather enrichment → Open-Meteo client: fetches readings
backend/src/main/java/com/leftjoiner/urbanpulse/urbanpulse/service/AtmosphericIncidentEnrichmentService.java - Weather enrichment → Context service: stores context
backend/src/main/java/com/leftjoiner/urbanpulse/urbanpulse/service/AtmosphericIncidentEnrichmentService.java - Context service → Context repository: reads and writes
backend/src/main/java/com/leftjoiner/urbanpulse/urbanpulse/service/AtmosphericContextService.java - Context repository → PostGIS: persists context
- Spring API → PostGIS: uses PostGIS
README.md