How razvanandreir/unihack2026 works
Buburu is a safety-first walking app: users sign in, view their location and nearby services, request routes that account for active danger reports, and use friend, chat, and SOS features. The React frontend presents these workflows and the Spring backend provides their API and persistence. The excerpts show route avoidance, identity provisioning, messaging, trusted contacts, and SOS handling; several other feature links are documented in the README but their implementation was not sampled.
Main entry points: HomePage.jsx Map and location · RouteService.java Route orchestration · MessageService.java Chat service · App.jsx Buburu web app
Components 25
Web client
- Buburu web app
UNIHACK2026-frontend/src/App.jsx - Map and location
UNIHACK2026-frontend/src/HomePage.jsx - Route workflow
UNIHACK2026-frontend/src/RouteTab.jsx - Safety reports
UNIHACK2026-frontend/src/ReportsPage.jsx - Friends and chat
UNIHACK2026-frontend/src/FriendsSection.jsx - SOS workflow
UNIHACK2026-frontend/src/SosPage.jsx - Backend API client
UNIHACK2026-frontend/src/api.js
Identity and access
- Auth0 login
UNIHACK2026-frontend/src/auth.js - Current user
UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/AuthCurrentUserService.java - User provisioning
UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/AuthUserProvisioningService.java
Walking safety
- Route orchestration
UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/RouteService.java - Report handling
UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/ReportService.java - Nearby places
UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/PlaceService.java - Avoidance geometry
UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/GeoJsonService.java - Routing provider client
UNIHACK2026-backend/src/main/java/com/hackathon/backend/clients/OpenRouteServiceClient.java
Friends and messaging
- Trusted contacts
UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/TrustedContactService.java - Chat service
UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/MessageService.java - SOS alerts
UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/SosAlertService.java
Backend persistence
- User records
UNIHACK2026-backend/src/main/java/com/hackathon/backend/repositories/UserRepository.java - Report records
UNIHACK2026-backend/src/main/java/com/hackathon/backend/repositories/ReportRepository.java - Contact records
UNIHACK2026-backend/src/main/java/com/hackathon/backend/repositories/TrustedContactRepository.java - Message records
UNIHACK2026-backend/src/main/java/com/hackathon/backend/repositories/MessageRepository.java - Alert records
UNIHACK2026-backend/src/main/java/com/hackathon/backend/repositories/SosAlertRepository.java
Other components
- Walker
- OpenRouteService
Connections 20
- Walker → Buburu web app: uses
- Buburu web app → Map and location: renders
UNIHACK2026-frontend/src/App.jsx - Map and location → Route workflow: offers routing
- Map and location → Safety reports: offers reports
- Map and location → Friends and chat: offers friends
- Map and location → SOS workflow: offers SOS
- Buburu web app → Backend API client: uses API
- Walker → Auth0 login: signs in
- Current user → User provisioning: resolves identity
UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/AuthCurrentUserService.java - User provisioning → User records: looks up and saves
UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/AuthUserProvisioningService.java - Route orchestration → Report records: loads active reports
UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/RouteService.java - Route orchestration → Avoidance geometry: builds avoidance
UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/RouteService.java - Route orchestration → Routing provider client: requests route
UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/RouteService.java - Routing provider client → OpenRouteService: requests directions
UNIHACK2026-backend/src/main/java/com/hackathon/backend/clients/OpenRouteServiceClient.java - Trusted contacts → Contact records: reads and writes
UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/TrustedContactService.java - Trusted contacts → User records: finds users
UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/TrustedContactService.java - Chat service → Contact records: checks friendship
UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/MessageService.java - Chat service → User records: finds recipients
UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/MessageService.java - Chat service → Message records: reads and writes
UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/MessageService.java - SOS alerts → Alert records: reads and writes
UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/SosAlertService.java