# at-ade/berlin-party-map architecture

> Architecture diagram of the GitHub repository at-ade/berlin-party-map, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/at-ade/berlin-party-map
- Repository: https://github.com/at-ade/berlin-party-map

## Overview

Berlin Party Map is an Android app for discovering affordable nearby Berlin events, viewing them on a map or in a list, and checking event details. Users can also save events and revisit past events. The README documents an MVVM-style UI, ViewModel, repository, and data-layer architecture, with Room caching and API-provided event and artist data. The source excerpts contain no app implementation, so feature-to-code wiring is not verified; dashed links mark those limits.

Main entry points: [`app/src/main/java/com/example/berlinpartymap/berlinpartymap/data/repository/EventRepositoryImpl.kt`](https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/data/repository/EventRepositoryImpl.kt) (Event repository), [`app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/map/MapScreen.kt`](https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/map/MapScreen.kt) (Map and list), [`app/src/main/java/com/example/berlinpartymap/berlinpartymap/data/remote/api/BpmAPI.kt`](https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/data/remote/api/BpmAPI.kt) (Event API), [`app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/map/EventViewModel.kt`](https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/map/EventViewModel.kt) (Event state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Event discovery"]
  node_map["Map and list<br/>[MapScreen.kt]"]
  node_map_container["Map display<br/>[MapContainer.kt]"]
  node_event_detail["Event details<br/>[EventDetailView.kt]"]
  node_event_list["Event cards<br/>[EventListItem.kt]"]
  node_event_vm["Event state<br/>[EventViewModel.kt]"]
end

subgraph group_personal["Saved and history"]
  node_saved["Saved events"]
  node_saved_vm["Saved state"]
  node_history["Party history"]
  node_history_vm["History state"]
end

subgraph group_data["Data access"]
  node_repository["Event repository"]
  node_api["Event API<br/>[BpmAPI.kt]"]
  node_mock["Mock event data<br/>[MockApiService.kt]"]
  node_room[("Room database<br/>[EventDatabase.kt]")]
  node_dao["Event access<br/>[EventDao.kt]"]
  node_models["Events and lineup<br/>[EventWithLineup.kt]"]
end

subgraph group_app["App foundation"]
  node_entry["App entry<br/>[MainActivity.kt]"]
  node_start["App start<br/>[AppStart.kt]"]
end

node_user(("Partygoer"))
node_server["Ktor server"]

node_user -.->|"opens app"| node_entry
node_entry -.->|"starts UI"| node_start
node_start -.->|"shows discovery"| node_map
node_map -.->|"uses state"| node_event_vm
node_map -.->|"renders map"| node_map_container
node_map -.->|"offers list"| node_event_list
node_event_detail -.->|"shows event"| node_event_list
node_saved -.->|"uses state"| node_saved_vm
node_history -.->|"uses state"| node_history_vm
node_event_vm -->|"requests data"| node_repository
node_saved_vm -.->|"requests data"| node_repository
node_history_vm -.->|"requests data"| node_repository
node_repository -->|"gets events"| node_api
node_api -->|"fetches events"| node_server
node_api -->|"uses mock data"| node_mock
node_repository -->|"caches locally"| node_dao
node_dao -.->|"accesses store"| node_room
node_room -->|"stores lineup"| node_models

click node_entry "https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/MainActivity.kt"
click node_start "https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/AppStart.kt"
click node_map "https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/map/MapScreen.kt"
click node_map_container "https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/map/MapContainer.kt"
click node_event_detail "https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/components/EventDetailView.kt"
click node_event_list "https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/components/EventListItem.kt"
click node_event_vm "https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/map/EventViewModel.kt"
click node_saved "https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/savedevents/SavedEventsScreen.kt"
click node_saved_vm "https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/savedevents/SavedEventsViewModel.kt"
click node_history "https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/partyhistory/PartyHistoryScreen.kt"
click node_history_vm "https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/partyhistory/PartyHistoryViewModel.kt"
click node_repository "https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/data/repository/EventRepositoryImpl.kt"
click node_api "https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/data/remote/api/BpmAPI.kt"
click node_mock "https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/data/remote/api/MockApiService.kt"
click node_room "https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/data/local/EventDatabase.kt"
click node_dao "https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/data/local/EventDao.kt"
click node_models "https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/data/local/EventWithLineup.kt"

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_map,node_map_container,node_event_detail,node_event_list,node_event_vm toneBlue
class node_saved,node_saved_vm,node_history,node_history_vm toneAmber
class node_repository,node_api,node_mock,node_room,node_dao,node_models,node_server toneMint
class node_entry,node_start toneRose
class node_user toneIndigo
```

## Components

### Event discovery

- [Map and list](https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/map/MapScreen.kt): `app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/map/MapScreen.kt`
- [Map display](https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/map/MapContainer.kt): `app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/map/MapContainer.kt`
- [Event details](https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/components/EventDetailView.kt): `app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/components/EventDetailView.kt`
- [Event cards](https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/components/EventListItem.kt): `app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/components/EventListItem.kt`
- [Event state](https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/map/EventViewModel.kt): `app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/map/EventViewModel.kt`

### Saved and history

- [Saved events](https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/savedevents/SavedEventsScreen.kt): `app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/savedevents/SavedEventsScreen.kt`
- [Saved state](https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/savedevents/SavedEventsViewModel.kt): `app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/savedevents/SavedEventsViewModel.kt`
- [Party history](https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/partyhistory/PartyHistoryScreen.kt): `app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/partyhistory/PartyHistoryScreen.kt`
- [History state](https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/partyhistory/PartyHistoryViewModel.kt): `app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/partyhistory/PartyHistoryViewModel.kt`

### Data access

- [Event repository](https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/data/repository/EventRepositoryImpl.kt): `app/src/main/java/com/example/berlinpartymap/berlinpartymap/data/repository/EventRepositoryImpl.kt`
- [Event API](https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/data/remote/api/BpmAPI.kt): `app/src/main/java/com/example/berlinpartymap/berlinpartymap/data/remote/api/BpmAPI.kt`
- [Mock event data](https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/data/remote/api/MockApiService.kt): `app/src/main/java/com/example/berlinpartymap/berlinpartymap/data/remote/api/MockApiService.kt`
- [Room database](https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/data/local/EventDatabase.kt): `app/src/main/java/com/example/berlinpartymap/berlinpartymap/data/local/EventDatabase.kt`
- [Event access](https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/data/local/EventDao.kt): `app/src/main/java/com/example/berlinpartymap/berlinpartymap/data/local/EventDao.kt`
- [Events and lineup](https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/data/local/EventWithLineup.kt): `app/src/main/java/com/example/berlinpartymap/berlinpartymap/data/local/EventWithLineup.kt`

### App foundation

- [App entry](https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/MainActivity.kt): `app/src/main/java/com/example/berlinpartymap/berlinpartymap/MainActivity.kt`
- [App start](https://github.com/at-ade/berlin-party-map/blob/main/app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/AppStart.kt): `app/src/main/java/com/example/berlinpartymap/berlinpartymap/ui/AppStart.kt`

### Other components

- **Partygoer**
- **Ktor server**

## Connections

- Partygoer → App entry: opens app
- App entry → App start: starts UI
- App start → Map and list: shows discovery
- Map and list → Event state: uses state
- Map and list → Map display: renders map
- Map and list → Event cards: offers list
- Event details → Event cards: shows event
- Saved events → Saved state: uses state
- Party history → History state: uses state
- Event state → Event repository: requests data (evidence: `README.md`)
- Saved state → Event repository: requests data
- History state → Event repository: requests data
- Event repository → Event API: gets events (evidence: `README.md`)
- Event API → Ktor server: fetches events (evidence: `README.md`)
- Event API → Mock event data: uses mock data (evidence: `README.md`)
- Event repository → Event access: caches locally (evidence: `README.md`)
- Event access → Room database: accesses store
- Room database → Events and lineup: stores lineup (evidence: `README.md`)
