# razvanandreir/unihack2026 architecture

> Architecture diagram of the GitHub repository razvanandreir/unihack2026, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/razvanandreir/unihack2026
- Repository: https://github.com/razvanandreir/unihack2026

## Overview

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: [`UNIHACK2026-frontend/src/HomePage.jsx`](https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-frontend/src/HomePage.jsx) (Map and location), [`UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/RouteService.java`](https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/RouteService.java) (Route orchestration), [`UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/MessageService.java`](https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/MessageService.java) (Chat service), [`UNIHACK2026-frontend/src/App.jsx`](https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-frontend/src/App.jsx) (Buburu web app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_webapp["Buburu web app<br/>[App.jsx]"]
  node_home["Map and location<br/>[HomePage.jsx]"]
  node_routeui["Route workflow<br/>[RouteTab.jsx]"]
  node_reportsui["Safety reports<br/>[ReportsPage.jsx]"]
  node_socialui["Friends and chat<br/>[FriendsSection.jsx]"]
  node_sosui["SOS workflow<br/>[SosPage.jsx]"]
  node_api["Backend API client<br/>[api.js]"]
end

subgraph group_identity["Identity and access"]
  node_auth["Auth0 login<br/>[auth.js]"]
  node_authcurrent["Current user"]
  node_provision["User provisioning"]
end

subgraph group_safety["Walking safety"]
  node_route["Route orchestration<br/>[RouteService.java]"]
  node_reports["Report handling<br/>[ReportService.java]"]
  node_places["Nearby places<br/>[PlaceService.java]"]
  node_geojson["Avoidance geometry"]
  node_orsclient["Routing provider client"]
end

subgraph group_social["Friends and messaging"]
  node_contacts["Trusted contacts"]
  node_messages["Chat service"]
  node_sos["SOS alerts"]
end

subgraph group_persistence["Backend persistence"]
  node_usersdb[("User records")]
  node_reportsdb[("Report records")]
  node_contactsdb[("Contact records")]
  node_messagesdb[("Message records")]
  node_sosdb[("Alert records")]
end

node_walker(("Walker"))
node_ors{{"OpenRouteService"}}

node_walker -->|"uses"| node_webapp
node_webapp -->|"renders"| node_home
node_home -.->|"offers routing"| node_routeui
node_home -.->|"offers reports"| node_reportsui
node_home -.->|"offers friends"| node_socialui
node_home -.->|"offers SOS"| node_sosui
node_webapp -.->|"uses API"| node_api
node_walker -->|"signs in"| node_auth
node_authcurrent -->|"resolves identity"| node_provision
node_provision -->|"looks up and saves"| node_usersdb
node_route -->|"loads active reports"| node_reportsdb
node_route -->|"builds avoidance"| node_geojson
node_route -->|"requests route"| node_orsclient
node_orsclient -->|"requests directions"| node_ors
node_contacts -->|"reads and writes"| node_contactsdb
node_contacts -->|"finds users"| node_usersdb
node_messages -->|"checks friendship"| node_contactsdb
node_messages -->|"finds recipients"| node_usersdb
node_messages -->|"reads and writes"| node_messagesdb
node_sos -->|"reads and writes"| node_sosdb

click node_webapp "https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-frontend/src/App.jsx"
click node_home "https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-frontend/src/HomePage.jsx"
click node_routeui "https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-frontend/src/RouteTab.jsx"
click node_reportsui "https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-frontend/src/ReportsPage.jsx"
click node_socialui "https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-frontend/src/FriendsSection.jsx"
click node_sosui "https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-frontend/src/SosPage.jsx"
click node_api "https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-frontend/src/api.js"
click node_auth "https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-frontend/src/auth.js"
click node_authcurrent "https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/AuthCurrentUserService.java"
click node_provision "https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/AuthUserProvisioningService.java"
click node_route "https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/RouteService.java"
click node_reports "https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/ReportService.java"
click node_places "https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/PlaceService.java"
click node_geojson "https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/GeoJsonService.java"
click node_orsclient "https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/clients/OpenRouteServiceClient.java"
click node_contacts "https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/TrustedContactService.java"
click node_messages "https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/MessageService.java"
click node_sos "https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/SosAlertService.java"
click node_usersdb "https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/repositories/UserRepository.java"
click node_reportsdb "https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/repositories/ReportRepository.java"
click node_contactsdb "https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/repositories/TrustedContactRepository.java"
click node_messagesdb "https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/repositories/MessageRepository.java"
click node_sosdb "https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/repositories/SosAlertRepository.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_webapp,node_home,node_routeui,node_reportsui,node_socialui,node_sosui,node_api toneBlue
class node_auth,node_authcurrent,node_provision toneAmber
class node_route,node_reports,node_places,node_geojson,node_orsclient,node_ors toneMint
class node_contacts,node_messages,node_sos toneRose
class node_usersdb,node_reportsdb,node_contactsdb,node_messagesdb,node_sosdb,node_walker toneIndigo
```

## Components

### Web client

- [Buburu web app](https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-frontend/src/App.jsx): `UNIHACK2026-frontend/src/App.jsx`
- [Map and location](https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-frontend/src/HomePage.jsx): `UNIHACK2026-frontend/src/HomePage.jsx`
- [Route workflow](https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-frontend/src/RouteTab.jsx): `UNIHACK2026-frontend/src/RouteTab.jsx`
- [Safety reports](https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-frontend/src/ReportsPage.jsx): `UNIHACK2026-frontend/src/ReportsPage.jsx`
- [Friends and chat](https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-frontend/src/FriendsSection.jsx): `UNIHACK2026-frontend/src/FriendsSection.jsx`
- [SOS workflow](https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-frontend/src/SosPage.jsx): `UNIHACK2026-frontend/src/SosPage.jsx`
- [Backend API client](https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-frontend/src/api.js): `UNIHACK2026-frontend/src/api.js`

### Identity and access

- [Auth0 login](https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-frontend/src/auth.js): `UNIHACK2026-frontend/src/auth.js`
- [Current user](https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/AuthCurrentUserService.java): `UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/AuthCurrentUserService.java`
- [User provisioning](https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/AuthUserProvisioningService.java): `UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/AuthUserProvisioningService.java`

### Walking safety

- [Route orchestration](https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/RouteService.java): `UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/RouteService.java`
- [Report handling](https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/ReportService.java): `UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/ReportService.java`
- [Nearby places](https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/PlaceService.java): `UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/PlaceService.java`
- [Avoidance geometry](https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/GeoJsonService.java): `UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/GeoJsonService.java`
- [Routing provider client](https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/clients/OpenRouteServiceClient.java): `UNIHACK2026-backend/src/main/java/com/hackathon/backend/clients/OpenRouteServiceClient.java`

### Friends and messaging

- [Trusted contacts](https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/TrustedContactService.java): `UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/TrustedContactService.java`
- [Chat service](https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/MessageService.java): `UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/MessageService.java`
- [SOS alerts](https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/SosAlertService.java): `UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/SosAlertService.java`

### Backend persistence

- [User records](https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/repositories/UserRepository.java): `UNIHACK2026-backend/src/main/java/com/hackathon/backend/repositories/UserRepository.java`
- [Report records](https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/repositories/ReportRepository.java): `UNIHACK2026-backend/src/main/java/com/hackathon/backend/repositories/ReportRepository.java`
- [Contact records](https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/repositories/TrustedContactRepository.java): `UNIHACK2026-backend/src/main/java/com/hackathon/backend/repositories/TrustedContactRepository.java`
- [Message records](https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/repositories/MessageRepository.java): `UNIHACK2026-backend/src/main/java/com/hackathon/backend/repositories/MessageRepository.java`
- [Alert records](https://github.com/razvanandreir/unihack2026/blob/main/UNIHACK2026-backend/src/main/java/com/hackathon/backend/repositories/SosAlertRepository.java): `UNIHACK2026-backend/src/main/java/com/hackathon/backend/repositories/SosAlertRepository.java`

### Other components

- **Walker**
- **OpenRouteService**

## Connections

- Walker → Buburu web app: uses
- Buburu web app → Map and location: renders (evidence: `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 (evidence: `UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/AuthCurrentUserService.java`)
- User provisioning → User records: looks up and saves (evidence: `UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/AuthUserProvisioningService.java`)
- Route orchestration → Report records: loads active reports (evidence: `UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/RouteService.java`)
- Route orchestration → Avoidance geometry: builds avoidance (evidence: `UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/RouteService.java`)
- Route orchestration → Routing provider client: requests route (evidence: `UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/RouteService.java`)
- Routing provider client → OpenRouteService: requests directions (evidence: `UNIHACK2026-backend/src/main/java/com/hackathon/backend/clients/OpenRouteServiceClient.java`)
- Trusted contacts → Contact records: reads and writes (evidence: `UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/TrustedContactService.java`)
- Trusted contacts → User records: finds users (evidence: `UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/TrustedContactService.java`)
- Chat service → Contact records: checks friendship (evidence: `UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/MessageService.java`)
- Chat service → User records: finds recipients (evidence: `UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/MessageService.java`)
- Chat service → Message records: reads and writes (evidence: `UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/MessageService.java`)
- SOS alerts → Alert records: reads and writes (evidence: `UNIHACK2026-backend/src/main/java/com/hackathon/backend/services/SosAlertService.java`)
