# olenagalu/dogwalker-showcase architecture

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

- Interactive diagram: https://gitdiagram.com/olenagalu/dogwalker-showcase
- Repository: https://github.com/olenagalu/dogwalker-showcase

## Overview

Princess Dog Walker is a pet-care booking and operations web app. Customers browse services, check open times, create accounts and dog profiles, and submit regular or overnight booking requests; the owner manages bookings, services, and schedules, while assistants support team workflows. The README documents the overall browser-to-API-to-PostgreSQL flow. Source excerpts show scheduling validation, booking persistence, and content management; some frontend-to-endpoint and controller-to-service details are not shown, so those internal links are omitted.

Main entry points: [`backend/PawsAndPaths.Api/Data/AppDbContext.cs`](https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Data/AppDbContext.cs) (EF data access), [`backend/PawsAndPaths.Api/Services/BookingService.cs`](https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Services/BookingService.cs) (Booking rules), [`backend/PawsAndPaths.Api/Services/AvailabilityService.cs`](https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Services/AvailabilityService.cs) (Slot validation), [`frontend/js`](https://github.com/olenagalu/dogwalker-showcase/tree/main/frontend/js) (Web interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Browser experience"]
  node_frontend["Web interface"]
  node_customer_ui["Accounts and dogs<br/>[auth.js]"]
  node_booking_ui["Booking calendar<br/>[availability.js]"]
  node_dashboard_ui["Customer dashboard<br/>[dashboard.js]"]
  node_owner_ui["Owner tools<br/>[owner.js]"]
  node_assistant_ui["Assistant tools<br/>[assistant.js]"]
end

subgraph group_api["API workflows"]
  node_api_host["ASP.NET API<br/>[Program.cs]"]
  node_auth["Account access<br/>[AuthController.cs]"]
  node_dogs["Dog profiles<br/>[DogsController.cs]"]
  node_services["Service catalog"]
  node_content_team["Site and team content"]
  node_availability_api["Availability endpoints"]
  node_booking_api["Booking endpoints"]
end

subgraph group_domain["Scheduling and booking"]
  node_availability["Slot validation"]
  node_booking_service["Booking rules<br/>[BookingService.cs]"]
  node_schedule["Overnight schedule<br/>[BookingSchedule.cs]"]
end

subgraph group_records["Application records"]
  node_db_context["EF data access<br/>[AppDbContext.cs]"]
  node_postgres[("PostgreSQL")]
  node_account_records["Account and dog records<br/>[AppUser.cs]"]
  node_booking_records["Booking records<br/>[Booking.cs]"]
  node_availability_records["Availability rules"]
  node_service_records["Service offerings<br/>[ServiceOffering.cs]"]
  node_site_records["Site content<br/>[SiteContent.cs]"]
end

node_visitor(("Visitor or customer"))

node_visitor -->|"uses"| node_frontend
node_frontend -->|"calls API"| node_api_host
node_api_host -->|"stores records"| node_postgres
node_auth -->|"reads and writes"| node_db_context
node_dogs -->|"reads and writes"| node_db_context
node_content_team -->|"reads and writes"| node_db_context
node_availability_api -->|"reads schedule data"| node_db_context
node_booking_api -->|"accesses bookings"| node_db_context
node_booking_service -->|"checks slots"| node_availability
node_booking_service -->|"expands windows"| node_schedule
node_availability -->|"builds windows"| node_schedule
node_availability -->|"reads schedule data"| node_db_context
node_booking_service -->|"saves bookings"| node_db_context
node_db_context -->|"maps"| node_account_records
node_db_context -->|"maps"| node_booking_records
node_db_context -->|"maps"| node_availability_records
node_db_context -->|"maps"| node_service_records
node_db_context -->|"maps"| node_site_records

click node_frontend "https://github.com/olenagalu/dogwalker-showcase/tree/main/frontend/js"
click node_customer_ui "https://github.com/olenagalu/dogwalker-showcase/blob/main/frontend/js/auth.js"
click node_booking_ui "https://github.com/olenagalu/dogwalker-showcase/blob/main/frontend/js/availability.js"
click node_dashboard_ui "https://github.com/olenagalu/dogwalker-showcase/blob/main/frontend/js/dashboard.js"
click node_owner_ui "https://github.com/olenagalu/dogwalker-showcase/blob/main/frontend/js/owner.js"
click node_assistant_ui "https://github.com/olenagalu/dogwalker-showcase/blob/main/frontend/js/assistant.js"
click node_api_host "https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Program.cs"
click node_auth "https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Controllers/AuthController.cs"
click node_dogs "https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Controllers/DogsController.cs"
click node_services "https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Controllers/ServicesController.cs"
click node_content_team "https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Controllers/SiteContentController.cs"
click node_availability_api "https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Controllers/AvailabilityController.cs"
click node_booking_api "https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Controllers/BookingsController.cs"
click node_availability "https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Services/AvailabilityService.cs"
click node_booking_service "https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Services/BookingService.cs"
click node_schedule "https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Services/BookingSchedule.cs"
click node_db_context "https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Data/AppDbContext.cs"
click node_account_records "https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Models/AppUser.cs"
click node_booking_records "https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Models/Booking.cs"
click node_availability_records "https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Models/AvailabilityRule.cs"
click node_service_records "https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Models/ServiceOffering.cs"
click node_site_records "https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Models/SiteContent.cs"

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_frontend,node_customer_ui,node_booking_ui,node_dashboard_ui,node_owner_ui,node_assistant_ui toneBlue
class node_api_host,node_auth,node_dogs,node_services,node_content_team,node_availability_api,node_booking_api toneAmber
class node_availability,node_booking_service,node_schedule toneMint
class node_db_context,node_postgres,node_account_records,node_booking_records,node_availability_records,node_service_records,node_site_records toneRose
class node_visitor toneIndigo
```

## Components

### Browser experience

- [Web interface](https://github.com/olenagalu/dogwalker-showcase/tree/main/frontend/js): `frontend/js`
- [Accounts and dogs](https://github.com/olenagalu/dogwalker-showcase/blob/main/frontend/js/auth.js): `frontend/js/auth.js`
- [Booking calendar](https://github.com/olenagalu/dogwalker-showcase/blob/main/frontend/js/availability.js): `frontend/js/availability.js`
- [Customer dashboard](https://github.com/olenagalu/dogwalker-showcase/blob/main/frontend/js/dashboard.js): `frontend/js/dashboard.js`
- [Owner tools](https://github.com/olenagalu/dogwalker-showcase/blob/main/frontend/js/owner.js): `frontend/js/owner.js`
- [Assistant tools](https://github.com/olenagalu/dogwalker-showcase/blob/main/frontend/js/assistant.js): `frontend/js/assistant.js`

### API workflows

- [ASP.NET API](https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Program.cs): `backend/PawsAndPaths.Api/Program.cs`
- [Account access](https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Controllers/AuthController.cs): `backend/PawsAndPaths.Api/Controllers/AuthController.cs`
- [Dog profiles](https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Controllers/DogsController.cs): `backend/PawsAndPaths.Api/Controllers/DogsController.cs`
- [Service catalog](https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Controllers/ServicesController.cs): `backend/PawsAndPaths.Api/Controllers/ServicesController.cs`
- [Site and team content](https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Controllers/SiteContentController.cs): `backend/PawsAndPaths.Api/Controllers/SiteContentController.cs`
- [Availability endpoints](https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Controllers/AvailabilityController.cs): `backend/PawsAndPaths.Api/Controllers/AvailabilityController.cs`
- [Booking endpoints](https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Controllers/BookingsController.cs): `backend/PawsAndPaths.Api/Controllers/BookingsController.cs`

### Scheduling and booking

- [Slot validation](https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Services/AvailabilityService.cs): `backend/PawsAndPaths.Api/Services/AvailabilityService.cs`
- [Booking rules](https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Services/BookingService.cs): `backend/PawsAndPaths.Api/Services/BookingService.cs`
- [Overnight schedule](https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Services/BookingSchedule.cs): `backend/PawsAndPaths.Api/Services/BookingSchedule.cs`

### Application records

- [EF data access](https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Data/AppDbContext.cs): `backend/PawsAndPaths.Api/Data/AppDbContext.cs`
- **PostgreSQL**
- [Account and dog records](https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Models/AppUser.cs): `backend/PawsAndPaths.Api/Models/AppUser.cs`
- [Booking records](https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Models/Booking.cs): `backend/PawsAndPaths.Api/Models/Booking.cs`
- [Availability rules](https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Models/AvailabilityRule.cs): `backend/PawsAndPaths.Api/Models/AvailabilityRule.cs`
- [Service offerings](https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Models/ServiceOffering.cs): `backend/PawsAndPaths.Api/Models/ServiceOffering.cs`
- [Site content](https://github.com/olenagalu/dogwalker-showcase/blob/main/backend/PawsAndPaths.Api/Models/SiteContent.cs): `backend/PawsAndPaths.Api/Models/SiteContent.cs`

### Other components

- **Visitor or customer**

## Connections

- Visitor or customer → Web interface: uses (evidence: `README.md`)
- Web interface → ASP.NET API: calls API (evidence: `README.md`)
- ASP.NET API → PostgreSQL: stores records (evidence: `README.md`)
- Account access → EF data access: reads and writes (evidence: `backend/PawsAndPaths.Api/Controllers/AuthController.cs`)
- Dog profiles → EF data access: reads and writes (evidence: `backend/PawsAndPaths.Api/Controllers/DogsController.cs`)
- Site and team content → EF data access: reads and writes (evidence: `backend/PawsAndPaths.Api/Controllers/SiteContentController.cs`)
- Availability endpoints → EF data access: reads schedule data (evidence: `backend/PawsAndPaths.Api/Controllers/AvailabilityController.cs`)
- Booking endpoints → EF data access: accesses bookings (evidence: `backend/PawsAndPaths.Api/Controllers/BookingsController.cs`)
- Booking rules → Slot validation: checks slots (evidence: `backend/PawsAndPaths.Api/Services/BookingService.cs`)
- Booking rules → Overnight schedule: expands windows (evidence: `backend/PawsAndPaths.Api/Services/BookingService.cs`)
- Slot validation → Overnight schedule: builds windows (evidence: `backend/PawsAndPaths.Api/Services/AvailabilityService.cs`)
- Slot validation → EF data access: reads schedule data (evidence: `backend/PawsAndPaths.Api/Services/AvailabilityService.cs`)
- Booking rules → EF data access: saves bookings (evidence: `backend/PawsAndPaths.Api/Services/BookingService.cs`)
- EF data access → Account and dog records: maps (evidence: `backend/PawsAndPaths.Api/Data/AppDbContext.cs`)
- EF data access → Booking records: maps (evidence: `backend/PawsAndPaths.Api/Data/AppDbContext.cs`)
- EF data access → Availability rules: maps (evidence: `backend/PawsAndPaths.Api/Data/AppDbContext.cs`)
- EF data access → Service offerings: maps (evidence: `backend/PawsAndPaths.Api/Data/AppDbContext.cs`)
- EF data access → Site content: maps (evidence: `backend/PawsAndPaths.Api/Data/AppDbContext.cs`)
