# falwin/churchtools-gemeinde-apps architecture

> Architecture diagram of the GitHub repository falwin/churchtools-gemeinde-apps, 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/falwin/churchtools-gemeinde-apps
- Repository: https://github.com/falwin/churchtools-gemeinde-apps

## Overview

This repository is a suite of ChurchTools-connected community apps: music/setlists, service planning, organizational charts, meeting minutes, prayer-night streaming, and an in-progress registration app. The main user workflow is to open an app, load church data, perform its domain task, and—where supported—write changes back to ChurchTools. The README documents the integrations and product capabilities; sampled app entry points show loading and view selection. Details of unsampled internals and several app-to-server connections are therefore omitted rather than inferred.

Main entry points: [`ui/bedienung/useMedienAbfrage.ts`](https://github.com/falwin/churchtools-gemeinde-apps/blob/main/ui/bedienung/useMedienAbfrage.ts) (Shared UI), [`client/src/App.tsx`](https://github.com/falwin/churchtools-gemeinde-apps/blob/main/client/src/App.tsx) (Music app), [`dienstplaner/src/App.tsx`](https://github.com/falwin/churchtools-gemeinde-apps/blob/main/dienstplaner/src/App.tsx) (Dienstplaner), [`organigramm/src/App.tsx`](https://github.com/falwin/churchtools-gemeinde-apps/blob/main/organigramm/src/App.tsx) (Organigramm)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_music["Music app"]
  node_musicapp["Music app<br/>[App.tsx]"]
  node_setlists["Setlists and charts<br/>[Setlist.tsx]"]
  node_songservice["Song and setlist API"]
end

subgraph group_planning["Planning apps"]
  node_serviceplanner["Dienstplaner<br/>[App.tsx]"]
  node_plans["Service planning<br/>[Planen.tsx]"]
end

subgraph group_records["Records and structure"]
  node_organigram["Organigramm<br/>[App.tsx]"]
  node_orgviews["Structure views<br/>[Organigramm.tsx]"]
  node_minutes["Protokolle<br/>[App.tsx]"]
  node_meetingdocs["Meeting records"]
  node_registrations["Anmeldungen<br/>[App.tsx]"]
  node_registrationproofs["Registration evidence<br/>[NachweisSeite.tsx]"]
end

subgraph group_community["Community apps"]
  node_prayer["Gebetsabend<br/>[App.tsx]"]
  node_listening["Audio and video<br/>[Zuhoeren.tsx]"]
end

subgraph group_platform["Shared platform"]
  node_sharedui["Shared UI"]
end

node_user(("Church member"))
node_churchtools[("ChurchTools")]

node_user -->|"uses"| node_musicapp
node_user -->|"uses"| node_serviceplanner
node_user -->|"uses"| node_organigram
node_user -->|"uses"| node_minutes
node_user -->|"uses"| node_prayer
node_user -->|"uses"| node_registrations
node_musicapp -.->|"opens"| node_setlists
node_setlists -.->|"requests"| node_songservice
node_musicapp -->|"reads and writes"| node_churchtools
node_serviceplanner -->|"reads and writes"| node_churchtools
node_organigram -->|"reads and writes"| node_churchtools
node_minutes -->|"reads and writes"| node_churchtools
node_prayer -->|"integrates with"| node_churchtools
node_registrations -->|"integrates with"| node_churchtools
node_serviceplanner -->|"loads views"| node_plans
node_organigram -->|"renders"| node_orgviews
node_minutes -->|"offers"| node_meetingdocs
node_registrations -->|"offers"| node_registrationproofs
node_prayer -.->|"offers"| node_listening
node_musicapp -.->|"uses"| node_sharedui
node_serviceplanner -->|"uses"| node_sharedui
node_organigram -->|"uses"| node_sharedui
node_minutes -->|"uses"| node_sharedui
node_prayer -->|"uses"| node_sharedui
node_registrations -->|"uses"| node_sharedui

click node_musicapp "https://github.com/falwin/churchtools-gemeinde-apps/blob/main/client/src/App.tsx"
click node_setlists "https://github.com/falwin/churchtools-gemeinde-apps/blob/main/client/src/pages/Setlist.tsx"
click node_songservice "https://github.com/falwin/churchtools-gemeinde-apps/blob/main/server/src/controllers/setlistController.ts"
click node_serviceplanner "https://github.com/falwin/churchtools-gemeinde-apps/blob/main/dienstplaner/src/App.tsx"
click node_plans "https://github.com/falwin/churchtools-gemeinde-apps/blob/main/dienstplaner/src/Planen.tsx"
click node_organigram "https://github.com/falwin/churchtools-gemeinde-apps/blob/main/organigramm/src/App.tsx"
click node_orgviews "https://github.com/falwin/churchtools-gemeinde-apps/blob/main/organigramm/src/Organigramm.tsx"
click node_minutes "https://github.com/falwin/churchtools-gemeinde-apps/blob/main/protokolle/src/App.tsx"
click node_meetingdocs "https://github.com/falwin/churchtools-gemeinde-apps/blob/main/protokolle/src/ProtokollSchreiben.tsx"
click node_registrations "https://github.com/falwin/churchtools-gemeinde-apps/blob/main/anmeldungen/src/App.tsx"
click node_registrationproofs "https://github.com/falwin/churchtools-gemeinde-apps/blob/main/anmeldungen/src/NachweisSeite.tsx"
click node_prayer "https://github.com/falwin/churchtools-gemeinde-apps/blob/main/gebetsabend/src/App.tsx"
click node_listening "https://github.com/falwin/churchtools-gemeinde-apps/blob/main/gebetsabend/src/Zuhoeren.tsx"
click node_sharedui "https://github.com/falwin/churchtools-gemeinde-apps/blob/main/ui/bedienung/useMedienAbfrage.ts"

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_musicapp,node_setlists,node_songservice toneBlue
class node_serviceplanner,node_plans,node_churchtools toneAmber
class node_organigram,node_orgviews,node_minutes,node_meetingdocs,node_registrations,node_registrationproofs toneMint
class node_prayer,node_listening toneRose
class node_sharedui,node_user toneIndigo
```

## Components

### Music app

- [Music app](https://github.com/falwin/churchtools-gemeinde-apps/blob/main/client/src/App.tsx): `client/src/App.tsx`
- [Setlists and charts](https://github.com/falwin/churchtools-gemeinde-apps/blob/main/client/src/pages/Setlist.tsx): `client/src/pages/Setlist.tsx`
- [Song and setlist API](https://github.com/falwin/churchtools-gemeinde-apps/blob/main/server/src/controllers/setlistController.ts): `server/src/controllers/setlistController.ts`

### Planning apps

- [Dienstplaner](https://github.com/falwin/churchtools-gemeinde-apps/blob/main/dienstplaner/src/App.tsx): `dienstplaner/src/App.tsx`
- [Service planning](https://github.com/falwin/churchtools-gemeinde-apps/blob/main/dienstplaner/src/Planen.tsx): `dienstplaner/src/Planen.tsx`

### Records and structure

- [Organigramm](https://github.com/falwin/churchtools-gemeinde-apps/blob/main/organigramm/src/App.tsx): `organigramm/src/App.tsx`
- [Structure views](https://github.com/falwin/churchtools-gemeinde-apps/blob/main/organigramm/src/Organigramm.tsx): `organigramm/src/Organigramm.tsx`
- [Protokolle](https://github.com/falwin/churchtools-gemeinde-apps/blob/main/protokolle/src/App.tsx): `protokolle/src/App.tsx`
- [Meeting records](https://github.com/falwin/churchtools-gemeinde-apps/blob/main/protokolle/src/ProtokollSchreiben.tsx): `protokolle/src/ProtokollSchreiben.tsx`
- [Anmeldungen](https://github.com/falwin/churchtools-gemeinde-apps/blob/main/anmeldungen/src/App.tsx): `anmeldungen/src/App.tsx`
- [Registration evidence](https://github.com/falwin/churchtools-gemeinde-apps/blob/main/anmeldungen/src/NachweisSeite.tsx): `anmeldungen/src/NachweisSeite.tsx`

### Community apps

- [Gebetsabend](https://github.com/falwin/churchtools-gemeinde-apps/blob/main/gebetsabend/src/App.tsx): `gebetsabend/src/App.tsx`
- [Audio and video](https://github.com/falwin/churchtools-gemeinde-apps/blob/main/gebetsabend/src/Zuhoeren.tsx): `gebetsabend/src/Zuhoeren.tsx`

### Shared platform

- [Shared UI](https://github.com/falwin/churchtools-gemeinde-apps/blob/main/ui/bedienung/useMedienAbfrage.ts): `ui/bedienung/useMedienAbfrage.ts`

### Other components

- **Church member**
- **ChurchTools**

## Connections

- Church member → Music app: uses (evidence: `README.md`)
- Church member → Dienstplaner: uses (evidence: `README.md`)
- Church member → Organigramm: uses (evidence: `README.md`)
- Church member → Protokolle: uses (evidence: `README.md`)
- Church member → Gebetsabend: uses (evidence: `README.md`)
- Church member → Anmeldungen: uses (evidence: `README.md`)
- Music app → Setlists and charts: opens
- Setlists and charts → Song and setlist API: requests
- Music app → ChurchTools: reads and writes (evidence: `README.md`)
- Dienstplaner → ChurchTools: reads and writes (evidence: `README.md`)
- Organigramm → ChurchTools: reads and writes (evidence: `README.md`)
- Protokolle → ChurchTools: reads and writes (evidence: `README.md`)
- Gebetsabend → ChurchTools: integrates with (evidence: `README.md`)
- Anmeldungen → ChurchTools: integrates with (evidence: `README.md`)
- Dienstplaner → Service planning: loads views (evidence: `dienstplaner/src/App.tsx`)
- Organigramm → Structure views: renders (evidence: `organigramm/src/App.tsx`)
- Protokolle → Meeting records: offers (evidence: `protokolle/src/App.tsx`)
- Anmeldungen → Registration evidence: offers (evidence: `anmeldungen/src/App.tsx`)
- Gebetsabend → Audio and video: offers (evidence: `gebetsabend/src/App.tsx`)
- Music app → Shared UI: uses
- Dienstplaner → Shared UI: uses (evidence: `dienstplaner/src/App.tsx`)
- Organigramm → Shared UI: uses (evidence: `organigramm/src/App.tsx`)
- Protokolle → Shared UI: uses (evidence: `protokolle/src/App.tsx`)
- Gebetsabend → Shared UI: uses (evidence: `gebetsabend/src/App.tsx`)
- Anmeldungen → Shared UI: uses (evidence: `anmeldungen/src/App.tsx`)
