# developeregrem/fewohbee architecture

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

- Interactive diagram: https://gitdiagram.com/developeregrem/fewohbee
- Repository: https://github.com/developeregrem/fewohbee

## Overview

FewohBee is a self-hosted property-management system for guesthouses and hotels. Its central workflow is managing rooms, guests, reservations and prices, then supporting the stay with front-desk operations, invoicing and accounting. Separate capabilities cover public online booking, guest check-in, calendar synchronization, automation, reporting and integrations. The graph preserves these documented product branches; source-level links are limited to relationships visible in the supplied excerpts or SOURCE INDEX, so some documented capabilities have no inferred internal call chain.

Main entry points: [`src/Entity/Reservation.php`](https://github.com/developeregrem/fewohbee/blob/master/src/Entity/Reservation.php) (Reservation records), [`src/Controller/ReservationServiceController.php`](https://github.com/developeregrem/fewohbee/blob/master/src/Controller/ReservationServiceController.php) (Reservation management), [`src/Workflow/WorkflowEngine.php`](https://github.com/developeregrem/fewohbee/blob/master/src/Workflow/WorkflowEngine.php) (Workflow automation), [`src/Controller/Api/PriceApiController.php`](https://github.com/developeregrem/fewohbee/blob/master/src/Controller/Api/PriceApiController.php) (Price quote API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_booking["Reservations &amp; Booking"]
  node_reservation_ui["Reservation management"]
  node_reservation[("Reservation records<br/>[Reservation.php]")]
  node_customer[("Guest profiles<br/>[Customer.php]")]
  node_property[("Properties &amp; rooms<br/>[Appartment.php]")]
  node_room_category[("Room categories<br/>[RoomCategory.php]")]
  node_reservation_origin[("Booking origins")]
  node_reservation_status[("Reservation statuses")]
  node_pricing[("Price rules<br/>[Price.php]")]
  node_public_booking["Online booking"]
  node_calendar_sync["Calendar sync"]
end

subgraph group_guestops["Guest Operations"]
  node_frontdesk["Front desk &amp; housekeeping"]
  node_guest_checkin["Guest check-in"]
end

subgraph group_finance["Finance &amp; Reporting"]
  node_invoice["Invoices &amp; e-invoicing<br/>[InvoiceService.php]"]
  node_accounting["Accounting journal"]
  node_statistics["Statistics &amp; reports"]
end

subgraph group_platform["Platform &amp; Integrations"]
  node_workflow["Workflow automation<br/>[WorkflowEngine.php]"]
  node_correspondence[("Correspondence &amp; templates<br/>[Template.php]")]
  node_rest_api["Read-only REST API"]
  node_api_prices["Price quote API"]
  node_api_day_prices["Day price API"]
  node_price_quote_service["Price quote service"]
  node_day_price_service["Day price services"]
  node_price_calendar_service["Price calendar service"]
  node_reservation_repository["Reservation queries"]
  node_price_repository["Price queries"]
  node_calendar_preview["Calendar import preview"]
  node_ics_client["ICS feed client<br/>[IcsFeedClient.php]"]
  node_ics_reader["ICS occurrence reader"]
  node_workflow_repository["Workflow records"]
  node_workflow_log["Workflow logging"]
  node_api_tokens["Scoped API tokens"]
end

node_staff(("Property staff"))

node_staff -->|"manages stays"| node_reservation_ui
node_staff -->|"runs operations"| node_frontdesk
node_staff -->|"records accounts"| node_accounting
node_public_booking -.->|"creates bookings"| node_reservation
node_reservation_ui -->|"manages"| node_reservation
node_reservation_repository -->|"queries"| node_reservation
node_price_repository -->|"queries"| node_pricing
node_api_prices -->|"requests quotes"| node_price_quote_service
node_api_prices -->|"queries prices"| node_price_repository
node_api_day_prices -->|"requests day prices"| node_day_price_service
node_api_day_prices -->|"requests calendar"| node_price_calendar_service
node_calendar_preview -->|"fetches feeds"| node_ics_client
node_calendar_preview -->|"reads occurrences"| node_ics_reader
node_workflow -->|"loads workflows"| node_workflow_repository
node_workflow -->|"logs outcomes"| node_workflow_log
node_reservation_ui -.->|"supports invoicing"| node_invoice
node_invoice -.->|"supports bookkeeping"| node_accounting
node_calendar_sync -.->|"syncs bookings"| node_reservation
node_rest_api -.->|"authenticates requests"| node_api_tokens

click node_reservation_ui "https://github.com/developeregrem/fewohbee/blob/master/src/Controller/ReservationServiceController.php"
click node_reservation "https://github.com/developeregrem/fewohbee/blob/master/src/Entity/Reservation.php"
click node_customer "https://github.com/developeregrem/fewohbee/blob/master/src/Entity/Customer.php"
click node_property "https://github.com/developeregrem/fewohbee/blob/master/src/Entity/Appartment.php"
click node_room_category "https://github.com/developeregrem/fewohbee/blob/master/src/Entity/RoomCategory.php"
click node_reservation_origin "https://github.com/developeregrem/fewohbee/blob/master/src/Entity/ReservationOrigin.php"
click node_reservation_status "https://github.com/developeregrem/fewohbee/blob/master/src/Entity/ReservationStatus.php"
click node_pricing "https://github.com/developeregrem/fewohbee/blob/master/src/Entity/Price.php"
click node_public_booking "https://github.com/developeregrem/fewohbee/tree/master/src/Service/OnlineBooking"
click node_calendar_sync "https://github.com/developeregrem/fewohbee/tree/master/src/Service/Calendar/Sync"
click node_frontdesk "https://github.com/developeregrem/fewohbee/blob/master/src/Service/FrontdeskViewService.php"
click node_guest_checkin "https://github.com/developeregrem/fewohbee/tree/master/src/Service/GuestCheckIn"
click node_invoice "https://github.com/developeregrem/fewohbee/blob/master/src/Service/InvoiceService.php"
click node_accounting "https://github.com/developeregrem/fewohbee/tree/master/src/Service/BookingJournal"
click node_statistics "https://github.com/developeregrem/fewohbee/blob/master/src/Service/MonthlyStatsService.php"
click node_workflow "https://github.com/developeregrem/fewohbee/blob/master/src/Workflow/WorkflowEngine.php"
click node_correspondence "https://github.com/developeregrem/fewohbee/blob/master/src/Entity/Template.php"
click node_rest_api "https://github.com/developeregrem/fewohbee/tree/master/src/Controller/Api"
click node_api_prices "https://github.com/developeregrem/fewohbee/blob/master/src/Controller/Api/PriceApiController.php"
click node_api_day_prices "https://github.com/developeregrem/fewohbee/blob/master/src/Controller/Api/DayPriceApiController.php"
click node_price_quote_service "https://github.com/developeregrem/fewohbee/blob/master/src/Service/Api/PriceQuoteService.php"
click node_day_price_service "https://github.com/developeregrem/fewohbee/blob/master/src/Service/Pricing/DayPriceService.php"
click node_price_calendar_service "https://github.com/developeregrem/fewohbee/blob/master/src/Service/Pricing/PriceCalendarService.php"
click node_reservation_repository "https://github.com/developeregrem/fewohbee/blob/master/src/Repository/ReservationRepository.php"
click node_price_repository "https://github.com/developeregrem/fewohbee/blob/master/src/Repository/PriceRepository.php"
click node_calendar_preview "https://github.com/developeregrem/fewohbee/blob/master/src/Service/Calendar/Sync/CalendarImportPreviewService.php"
click node_ics_client "https://github.com/developeregrem/fewohbee/blob/master/src/Service/Calendar/Sync/Ics/IcsFeedClient.php"
click node_ics_reader "https://github.com/developeregrem/fewohbee/blob/master/src/Service/Calendar/Sync/Ics/IcsOccurrenceReader.php"
click node_workflow_repository "https://github.com/developeregrem/fewohbee/blob/master/src/Repository/WorkflowRepository.php"
click node_workflow_log "https://github.com/developeregrem/fewohbee/blob/master/src/Workflow/WorkflowLogService.php"
click node_api_tokens "https://github.com/developeregrem/fewohbee/blob/master/src/Service/ApiTokenService.php"

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_reservation_ui,node_reservation,node_customer,node_property,node_room_category,node_reservation_origin,node_reservation_status,node_pricing,node_public_booking,node_calendar_sync toneBlue
class node_frontdesk,node_guest_checkin toneAmber
class node_invoice,node_accounting,node_statistics toneMint
class node_workflow,node_correspondence,node_rest_api,node_api_prices,node_api_day_prices,node_price_quote_service,node_day_price_service,node_price_calendar_service,node_reservation_repository,node_price_repository,node_calendar_preview,node_ics_client,node_ics_reader,node_workflow_repository,node_workflow_log,node_api_tokens toneRose
class node_staff toneIndigo
```

## Components

### Reservations & Booking

- [Reservation management](https://github.com/developeregrem/fewohbee/blob/master/src/Controller/ReservationServiceController.php): `src/Controller/ReservationServiceController.php`
- [Reservation records](https://github.com/developeregrem/fewohbee/blob/master/src/Entity/Reservation.php): `src/Entity/Reservation.php`
- [Guest profiles](https://github.com/developeregrem/fewohbee/blob/master/src/Entity/Customer.php): `src/Entity/Customer.php`
- [Properties & rooms](https://github.com/developeregrem/fewohbee/blob/master/src/Entity/Appartment.php): `src/Entity/Appartment.php`
- [Room categories](https://github.com/developeregrem/fewohbee/blob/master/src/Entity/RoomCategory.php): `src/Entity/RoomCategory.php`
- [Booking origins](https://github.com/developeregrem/fewohbee/blob/master/src/Entity/ReservationOrigin.php): `src/Entity/ReservationOrigin.php`
- [Reservation statuses](https://github.com/developeregrem/fewohbee/blob/master/src/Entity/ReservationStatus.php): `src/Entity/ReservationStatus.php`
- [Price rules](https://github.com/developeregrem/fewohbee/blob/master/src/Entity/Price.php): `src/Entity/Price.php`
- [Online booking](https://github.com/developeregrem/fewohbee/tree/master/src/Service/OnlineBooking): `src/Service/OnlineBooking`
- [Calendar sync](https://github.com/developeregrem/fewohbee/tree/master/src/Service/Calendar/Sync): `src/Service/Calendar/Sync`

### Guest Operations

- [Front desk & housekeeping](https://github.com/developeregrem/fewohbee/blob/master/src/Service/FrontdeskViewService.php): `src/Service/FrontdeskViewService.php`
- [Guest check-in](https://github.com/developeregrem/fewohbee/tree/master/src/Service/GuestCheckIn): `src/Service/GuestCheckIn`

### Finance & Reporting

- [Invoices & e-invoicing](https://github.com/developeregrem/fewohbee/blob/master/src/Service/InvoiceService.php): `src/Service/InvoiceService.php`
- [Accounting journal](https://github.com/developeregrem/fewohbee/tree/master/src/Service/BookingJournal): `src/Service/BookingJournal`
- [Statistics & reports](https://github.com/developeregrem/fewohbee/blob/master/src/Service/MonthlyStatsService.php): `src/Service/MonthlyStatsService.php`

### Platform & Integrations

- [Workflow automation](https://github.com/developeregrem/fewohbee/blob/master/src/Workflow/WorkflowEngine.php): `src/Workflow/WorkflowEngine.php`
- [Correspondence & templates](https://github.com/developeregrem/fewohbee/blob/master/src/Entity/Template.php): `src/Entity/Template.php`
- [Read-only REST API](https://github.com/developeregrem/fewohbee/tree/master/src/Controller/Api): `src/Controller/Api`
- [Price quote API](https://github.com/developeregrem/fewohbee/blob/master/src/Controller/Api/PriceApiController.php): `src/Controller/Api/PriceApiController.php`
- [Day price API](https://github.com/developeregrem/fewohbee/blob/master/src/Controller/Api/DayPriceApiController.php): `src/Controller/Api/DayPriceApiController.php`
- [Price quote service](https://github.com/developeregrem/fewohbee/blob/master/src/Service/Api/PriceQuoteService.php): `src/Service/Api/PriceQuoteService.php`
- [Day price services](https://github.com/developeregrem/fewohbee/blob/master/src/Service/Pricing/DayPriceService.php): `src/Service/Pricing/DayPriceService.php`
- [Price calendar service](https://github.com/developeregrem/fewohbee/blob/master/src/Service/Pricing/PriceCalendarService.php): `src/Service/Pricing/PriceCalendarService.php`
- [Reservation queries](https://github.com/developeregrem/fewohbee/blob/master/src/Repository/ReservationRepository.php): `src/Repository/ReservationRepository.php`
- [Price queries](https://github.com/developeregrem/fewohbee/blob/master/src/Repository/PriceRepository.php): `src/Repository/PriceRepository.php`
- [Calendar import preview](https://github.com/developeregrem/fewohbee/blob/master/src/Service/Calendar/Sync/CalendarImportPreviewService.php): `src/Service/Calendar/Sync/CalendarImportPreviewService.php`
- [ICS feed client](https://github.com/developeregrem/fewohbee/blob/master/src/Service/Calendar/Sync/Ics/IcsFeedClient.php): `src/Service/Calendar/Sync/Ics/IcsFeedClient.php`
- [ICS occurrence reader](https://github.com/developeregrem/fewohbee/blob/master/src/Service/Calendar/Sync/Ics/IcsOccurrenceReader.php): `src/Service/Calendar/Sync/Ics/IcsOccurrenceReader.php`
- [Workflow records](https://github.com/developeregrem/fewohbee/blob/master/src/Repository/WorkflowRepository.php): `src/Repository/WorkflowRepository.php`
- [Workflow logging](https://github.com/developeregrem/fewohbee/blob/master/src/Workflow/WorkflowLogService.php): `src/Workflow/WorkflowLogService.php`
- [Scoped API tokens](https://github.com/developeregrem/fewohbee/blob/master/src/Service/ApiTokenService.php): `src/Service/ApiTokenService.php`

### Other components

- **Property staff**

## Connections

- Property staff → Reservation management: manages stays (evidence: `README.md`)
- Property staff → Front desk & housekeeping: runs operations (evidence: `README.md`)
- Property staff → Accounting journal: records accounts (evidence: `README.md`)
- Online booking → Reservation records: creates bookings
- Reservation management → Reservation records: manages (evidence: `src/Controller/ReservationServiceController.php`)
- Reservation queries → Reservation records: queries (evidence: `src/Repository/ReservationRepository.php`)
- Price queries → Price rules: queries (evidence: `src/Repository/PriceRepository.php`)
- Price quote API → Price quote service: requests quotes (evidence: `src/Controller/Api/PriceApiController.php`)
- Price quote API → Price queries: queries prices (evidence: `src/Controller/Api/PriceApiController.php`)
- Day price API → Day price services: requests day prices (evidence: `src/Controller/Api/DayPriceApiController.php`)
- Day price API → Price calendar service: requests calendar (evidence: `src/Controller/Api/DayPriceApiController.php`)
- Calendar import preview → ICS feed client: fetches feeds (evidence: `src/Service/Calendar/Sync/CalendarImportPreviewService.php`)
- Calendar import preview → ICS occurrence reader: reads occurrences (evidence: `src/Service/Calendar/Sync/CalendarImportPreviewService.php`)
- Workflow automation → Workflow records: loads workflows (evidence: `src/Workflow/WorkflowEngine.php`)
- Workflow automation → Workflow logging: logs outcomes (evidence: `src/Workflow/WorkflowEngine.php`)
- Reservation management → Invoices & e-invoicing: supports invoicing (evidence: `src/Controller/ReservationServiceController.php`)
- Invoices & e-invoicing → Accounting journal: supports bookkeeping
- Calendar sync → Reservation records: syncs bookings
- Read-only REST API → Scoped API tokens: authenticates requests
