# diogonunes2798/smartparking.hybrid architecture

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

- Interactive diagram: https://gitdiagram.com/diogonunes2798/smartparking.hybrid
- Repository: https://github.com/diogonunes2798/smartparking.hybrid

## Overview

SmartParking.Hybrid is a parking-management backend. Drivers or facility systems submit occupancy batches; the API validates and publishes them, workers persist events and update an availability read model, and clients can search availability. The API also exposes session and configuration operations, backed by relational persistence and domain rules. The tree documents these distinct capabilities, but their endpoint implementations were not sampled, so those links are left unverified. Worker registrations and selected ingestion code support the event and projection relationships shown below.

Main entry points: [`src/SmartParking.Workers/Program.cs`](https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Workers/Program.cs) (Workers host), [`src/SmartParking.Application/Sessions/SessionCommands.cs`](https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Application/Sessions/SessionCommands.cs) (Session commands), [`src/SmartParking.Infrastructure.Cache/Availability/RedisAvailabilityReadModel.cs`](https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Infrastructure.Cache/Availability/RedisAvailabilityReadModel.cs) (Redis availability read model), [`src/SmartParking.Api/Endpoints/IngestionEndpoints.cs`](https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Api/Endpoints/IngestionEndpoints.cs) (Occupancy endpoint)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and application"]
  node_api_host["HTTP API<br/>[Program.cs]"]
  node_ingest_api["Occupancy endpoint"]
  node_ingest_handler["Batch validation and publish"]
  node_availability_api["Availability search API"]
  node_availability_search["Availability search"]
  node_configuration_api["Configuration API"]
  node_session_api["Parking session API"]
  node_session_commands["Session commands<br/>[SessionCommands.cs]"]
end

subgraph group_domain["Parking domain"]
  node_domain_sessions["Session lifecycle<br/>[ParkingSession.cs]"]
  node_tariffs["Tariff rules<br/>[Tariff.cs]"]
end

subgraph group_workers["Event processing"]
  node_workers_host["Workers host<br/>[Program.cs]"]
  node_log_consumer["Occupancy log consumer"]
  node_log_writer["Occupancy log writer"]
  node_availability_projector["Availability projector"]
  node_config_projector["Configuration projector"]
  node_read_model_rebuilder["Read model rebuild"]
  node_read_model_initializer["Read model initializer"]
end

subgraph group_stores["Persistence and messaging"]
  node_relational[("Relational persistence")]
  node_event_bus["Event bus contract<br/>[Messaging.cs]"]
  node_redis_bus["Redis Streams bus"]
  node_event_log[("Mongo event log")]
  node_read_model[("Redis availability read model")]
end

subgraph group_operations["Observability"]
  node_telemetry["Telemetry and health"]
end

node_client(("Parking clients"))
node_sensor(("Occupancy sensors"))

node_sensor -.->|"submits events"| node_ingest_api
node_client -.->|"searches availability"| node_availability_api
node_client -.->|"manages sessions"| node_session_api
node_client -.->|"manages configuration"| node_configuration_api
node_ingest_api -->|"invokes"| node_ingest_handler
node_ingest_handler -->|"publishes messages"| node_event_bus
node_redis_bus -->|"implements"| node_event_bus
node_workers_host -->|"registers consumer"| node_log_consumer
node_workers_host -->|"registers handler"| node_log_writer
node_workers_host -->|"registers projector"| node_availability_projector
node_workers_host -->|"registers projector"| node_config_projector
node_log_writer -.->|"writes events"| node_event_log
node_availability_projector -.->|"updates projection"| node_read_model
node_config_projector -.->|"updates projection"| node_read_model
node_availability_api -.->|"invokes"| node_availability_search
node_availability_search -->|"queries"| node_read_model
node_session_api -.->|"invokes"| node_session_commands
node_session_commands -->|"applies lifecycle rules"| node_domain_sessions
node_session_commands -->|"uses pricing rules"| node_tariffs
node_session_commands -.->|"persists sessions"| node_relational
node_configuration_api -.->|"reads and updates"| node_relational
node_workers_host -->|"registers initializer"| node_read_model_initializer
node_read_model_initializer -->|"invokes rebuild"| node_read_model_rebuilder
node_workers_host -->|"runs rebuild command"| node_read_model_rebuilder
node_api_host -->|"configures defaults"| node_telemetry
node_workers_host -->|"configures defaults"| node_telemetry

click node_api_host "https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Api/Program.cs"
click node_ingest_api "https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Api/Endpoints/IngestionEndpoints.cs"
click node_ingest_handler "https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Application/Ingestion/IngestOccupancyBatchHandler.cs"
click node_availability_api "https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Api/Endpoints/AvailabilityEndpoints.cs"
click node_availability_search "https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Application/Availability/AvailabilitySearch.cs"
click node_configuration_api "https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Api/Endpoints/ConfigurationEndpoints.cs"
click node_session_api "https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Api/Endpoints/SessionEndpoints.cs"
click node_session_commands "https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Application/Sessions/SessionCommands.cs"
click node_domain_sessions "https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Domain/Sessions/ParkingSession.cs"
click node_tariffs "https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Domain/Tariffs/Tariff.cs"
click node_relational "https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Infrastructure.Relational/SmartParkingDbContext.cs"
click node_event_bus "https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Application/Abstractions/Messaging.cs"
click node_redis_bus "https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Infrastructure.Messaging/RedisStreamsEventBus.cs"
click node_workers_host "https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Workers/Program.cs"
click node_log_consumer "https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Application/Ingestion/OccupancyLogConsumer.cs"
click node_log_writer "https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Application/Ingestion/OccupancyLogWriter.cs"
click node_event_log "https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Infrastructure.Documents/OccupancyEvents/MongoOccupancyEventLog.cs"
click node_availability_projector "https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Application/Availability/AvailabilityProjector.cs"
click node_config_projector "https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Application/Availability/ConfigurationProjector.cs"
click node_read_model "https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Infrastructure.Cache/Availability/RedisAvailabilityReadModel.cs"
click node_read_model_rebuilder "https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Application/Availability/ReadModelRebuilder.cs"
click node_read_model_initializer "https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Workers/ReadModel/ReadModelInitializer.cs"
click node_telemetry "https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.ServiceDefaults/ServiceDefaultsExtensions.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_api_host,node_ingest_api,node_ingest_handler,node_availability_api,node_availability_search,node_configuration_api,node_session_api,node_session_commands,node_client toneBlue
class node_domain_sessions,node_tariffs toneAmber
class node_workers_host,node_log_consumer,node_log_writer,node_availability_projector,node_config_projector,node_read_model_rebuilder,node_read_model_initializer toneMint
class node_relational,node_event_bus,node_redis_bus,node_event_log,node_read_model toneRose
class node_telemetry,node_sensor toneIndigo
```

## Components

### API and application

- [HTTP API](https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Api/Program.cs): `src/SmartParking.Api/Program.cs`
- [Occupancy endpoint](https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Api/Endpoints/IngestionEndpoints.cs): `src/SmartParking.Api/Endpoints/IngestionEndpoints.cs`
- [Batch validation and publish](https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Application/Ingestion/IngestOccupancyBatchHandler.cs): `src/SmartParking.Application/Ingestion/IngestOccupancyBatchHandler.cs`
- [Availability search API](https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Api/Endpoints/AvailabilityEndpoints.cs): `src/SmartParking.Api/Endpoints/AvailabilityEndpoints.cs`
- [Availability search](https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Application/Availability/AvailabilitySearch.cs): `src/SmartParking.Application/Availability/AvailabilitySearch.cs`
- [Configuration API](https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Api/Endpoints/ConfigurationEndpoints.cs): `src/SmartParking.Api/Endpoints/ConfigurationEndpoints.cs`
- [Parking session API](https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Api/Endpoints/SessionEndpoints.cs): `src/SmartParking.Api/Endpoints/SessionEndpoints.cs`
- [Session commands](https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Application/Sessions/SessionCommands.cs): `src/SmartParking.Application/Sessions/SessionCommands.cs`

### Parking domain

- [Session lifecycle](https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Domain/Sessions/ParkingSession.cs): `src/SmartParking.Domain/Sessions/ParkingSession.cs`
- [Tariff rules](https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Domain/Tariffs/Tariff.cs): `src/SmartParking.Domain/Tariffs/Tariff.cs`

### Event processing

- [Workers host](https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Workers/Program.cs): `src/SmartParking.Workers/Program.cs`
- [Occupancy log consumer](https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Application/Ingestion/OccupancyLogConsumer.cs): `src/SmartParking.Application/Ingestion/OccupancyLogConsumer.cs`
- [Occupancy log writer](https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Application/Ingestion/OccupancyLogWriter.cs): `src/SmartParking.Application/Ingestion/OccupancyLogWriter.cs`
- [Availability projector](https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Application/Availability/AvailabilityProjector.cs): `src/SmartParking.Application/Availability/AvailabilityProjector.cs`
- [Configuration projector](https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Application/Availability/ConfigurationProjector.cs): `src/SmartParking.Application/Availability/ConfigurationProjector.cs`
- [Read model rebuild](https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Application/Availability/ReadModelRebuilder.cs): `src/SmartParking.Application/Availability/ReadModelRebuilder.cs`
- [Read model initializer](https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Workers/ReadModel/ReadModelInitializer.cs): `src/SmartParking.Workers/ReadModel/ReadModelInitializer.cs`

### Persistence and messaging

- [Relational persistence](https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Infrastructure.Relational/SmartParkingDbContext.cs): `src/SmartParking.Infrastructure.Relational/SmartParkingDbContext.cs`
- [Event bus contract](https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Application/Abstractions/Messaging.cs): `src/SmartParking.Application/Abstractions/Messaging.cs`
- [Redis Streams bus](https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Infrastructure.Messaging/RedisStreamsEventBus.cs): `src/SmartParking.Infrastructure.Messaging/RedisStreamsEventBus.cs`
- [Mongo event log](https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Infrastructure.Documents/OccupancyEvents/MongoOccupancyEventLog.cs): `src/SmartParking.Infrastructure.Documents/OccupancyEvents/MongoOccupancyEventLog.cs`
- [Redis availability read model](https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.Infrastructure.Cache/Availability/RedisAvailabilityReadModel.cs): `src/SmartParking.Infrastructure.Cache/Availability/RedisAvailabilityReadModel.cs`

### Observability

- [Telemetry and health](https://github.com/diogonunes2798/smartparking.hybrid/blob/main/src/SmartParking.ServiceDefaults/ServiceDefaultsExtensions.cs): `src/SmartParking.ServiceDefaults/ServiceDefaultsExtensions.cs`

### Other components

- **Parking clients**
- **Occupancy sensors**

## Connections

- Occupancy sensors → Occupancy endpoint: submits events
- Parking clients → Availability search API: searches availability
- Parking clients → Parking session API: manages sessions
- Parking clients → Configuration API: manages configuration
- Occupancy endpoint → Batch validation and publish: invokes (evidence: `src/SmartParking.Api/Endpoints/IngestionEndpoints.cs`)
- Batch validation and publish → Event bus contract: publishes messages (evidence: `src/SmartParking.Application/Ingestion/IngestOccupancyBatchHandler.cs`)
- Redis Streams bus → Event bus contract: implements (evidence: `src/SmartParking.Infrastructure.Messaging/DependencyInjection.cs`)
- Workers host → Occupancy log consumer: registers consumer (evidence: `src/SmartParking.Workers/Program.cs`)
- Workers host → Occupancy log writer: registers handler (evidence: `src/SmartParking.Workers/Program.cs`)
- Workers host → Availability projector: registers projector (evidence: `src/SmartParking.Workers/Program.cs`)
- Workers host → Configuration projector: registers projector (evidence: `src/SmartParking.Workers/Program.cs`)
- Occupancy log writer → Mongo event log: writes events
- Availability projector → Redis availability read model: updates projection
- Configuration projector → Redis availability read model: updates projection
- Availability search API → Availability search: invokes
- Availability search → Redis availability read model: queries (evidence: `src/SmartParking.Infrastructure.Cache/Availability/RedisAvailabilityReadModel.cs`)
- Parking session API → Session commands: invokes
- Session commands → Session lifecycle: applies lifecycle rules (evidence: `src/SmartParking.Application/Sessions/SessionCommands.cs`)
- Session commands → Tariff rules: uses pricing rules (evidence: `src/SmartParking.Application/Sessions/SessionCommands.cs`)
- Session commands → Relational persistence: persists sessions
- Configuration API → Relational persistence: reads and updates
- Workers host → Read model initializer: registers initializer (evidence: `src/SmartParking.Workers/Program.cs`)
- Read model initializer → Read model rebuild: invokes rebuild (evidence: `src/SmartParking.Workers/ReadModel/ReadModelInitializer.cs`)
- Workers host → Read model rebuild: runs rebuild command (evidence: `src/SmartParking.Workers/Program.cs`)
- HTTP API → Telemetry and health: configures defaults (evidence: `src/SmartParking.Api/Program.cs`)
- Workers host → Telemetry and health: configures defaults (evidence: `src/SmartParking.Workers/Program.cs`)
