# dimaakk1/autoservicemicroservices architecture

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

- Interactive diagram: https://gitdiagram.com/dimaakk1/autoservicemicroservices
- Repository: https://github.com/dimaakk1/autoservicemicroservices

## Overview

This repository implements an auto-service booking and management platform: customers browse services, manage vehicles, book work, pay, and review completed orders; administrators and mechanics have separate workflows. A React frontend talks to a collection of .NET services, with aggregation supporting review/order views. The tree also includes AI diagnostics and event-driven notification services. The README is empty, and source excerpts are limited, so some subsystem links are omitted rather than inferred.

Main entry points: [`src/Frontend/src/App.tsx`](https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Frontend/src/App.tsx) (Route and access shell), [`src/Aggregator/Services/AggregationService.cs`](https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Aggregator/Services/AggregationService.cs) (Order-review aggregation), [`src/Frontend/src/api/api.ts`](https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Frontend/src/api/api.ts) (HTTP client), [`src/Frontend/src/pages/admin/AdminServices.tsx`](https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Frontend/src/pages/admin/AdminServices.tsx) (Service administration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Customer and staff UI"]
  node_app["Route and access shell<br/>[App.tsx]"]
  node_booking["Booking and bookings<br/>[Booking.tsx]"]
  node_servicebrowse["Service discovery<br/>[Services.tsx]"]
  node_adminservices["Service administration<br/>[AdminServices.tsx]"]
  node_reviewsui["Review experience<br/>[Reviews.tsx]"]
  node_adminorders["Order administration<br/>[AdminOrders.tsx]"]
  node_adminusers["User administration<br/>[AdminUsers.tsx]"]
  node_mechanicui["Mechanic dashboard"]
  node_authcontext["Session state<br/>[auth-context.tsx]"]
  node_httpapi["HTTP client<br/>[api.ts]"]
end

subgraph group_operations["Booking and catalog"]
  node_orders["Orders and payments<br/>[OrderService.cs]"]
  node_catalog["Parts and catalog<br/>[PartService.cs]"]
end

subgraph group_identity["Identity and vehicles"]
  node_users["Authentication and users<br/>[AuthService.cs]"]
  node_vehicles["Vehicle registry<br/>[VehicleService.cs]"]
  node_vin["VIN decoding"]
end

subgraph group_feedback["Reviews and aggregation"]
  node_reviewapi["Review API"]
  node_reviewqueries["Review query handlers"]
  node_reviewstore[("Review repository")]
  node_aggregation["Order-review aggregation"]
  node_aggregationapi["Aggregation endpoint"]
end

subgraph group_integrations["AI and notifications"]
  node_ai["AI diagnostics"]
  node_notifications["Order notifications"]
end

node_customer(("Customer or staff"))

node_customer -->|"uses"| node_app
node_app -->|"routes to"| node_booking
node_app -->|"routes to"| node_reviewsui
node_app -->|"routes to"| node_adminorders
node_app -->|"routes to"| node_adminusers
node_app -->|"routes to"| node_adminservices
node_app -->|"routes to"| node_mechanicui
node_app -->|"provides session"| node_authcontext
node_authcontext -->|"requests profile"| node_httpapi
node_reviewsui -->|"loads data"| node_httpapi
node_servicebrowse -->|"requests services"| node_httpapi
node_adminservices -->|"manages services"| node_httpapi
node_reviewapi -->|"dispatches queries"| node_reviewqueries
node_reviewqueries -->|"reads reviews"| node_reviewstore
node_aggregationapi -->|"delegates"| node_aggregation
node_aggregation -->|"reads orders"| node_orders
node_aggregation -->|"reads users"| node_users
node_aggregation -.->|"combines reviews"| node_reviewapi
node_orders -.->|"publishes events"| node_notifications
node_vehicles -.->|"uses decoder"| node_vin

click node_app "https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Frontend/src/App.tsx"
click node_booking "https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Frontend/src/pages/Booking.tsx"
click node_servicebrowse "https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Frontend/src/pages/Services.tsx"
click node_adminservices "https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Frontend/src/pages/admin/AdminServices.tsx"
click node_reviewsui "https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Frontend/src/pages/Reviews.tsx"
click node_adminorders "https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Frontend/src/pages/admin/AdminOrders.tsx"
click node_adminusers "https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Frontend/src/pages/admin/AdminUsers.tsx"
click node_mechanicui "https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Frontend/src/pages/mechanic/MechanicDashboard.tsx"
click node_authcontext "https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Frontend/src/lib/auth-context.tsx"
click node_httpapi "https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Frontend/src/api/api.ts"
click node_orders "https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Services/Orders/BLL/Services/OrderService.cs"
click node_catalog "https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Services/Catalog/BLL/Services/PartService.cs"
click node_users "https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Services/Users/BLL/Services/AuthService.cs"
click node_vehicles "https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Services/Vehicles/BLL/Services/VehicleService.cs"
click node_vin "https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Services/Vehicles/BLL/Services/NhtsaVinDecoderService.cs"
click node_reviewapi "https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Services/Reviews/API/Controllers/ReviewsController.cs"
click node_reviewqueries "https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Services/Reviews/Application/Handlers/GetReviewsByOrderIdQueryHandler.cs"
click node_reviewstore "https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Services/Reviews/Infrastructure/Repositories/ReviewRepository.cs"
click node_aggregation "https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Aggregator/Services/AggregationService.cs"
click node_aggregationapi "https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Aggregator/Controllers/AggregationController.cs"
click node_ai "https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Services/AI/BLL/Services/AIDiagnostService.cs"
click node_notifications "https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Services/Notifications/OrderCreatedConsumer.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_app,node_booking,node_servicebrowse,node_adminservices,node_reviewsui,node_adminorders,node_adminusers,node_mechanicui,node_authcontext,node_httpapi toneBlue
class node_orders,node_catalog toneAmber
class node_users,node_vehicles,node_vin toneMint
class node_reviewapi,node_reviewqueries,node_reviewstore,node_aggregation,node_aggregationapi toneRose
class node_ai,node_notifications,node_customer toneIndigo
```

## Components

### Customer and staff UI

- [Route and access shell](https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Frontend/src/App.tsx): `src/Frontend/src/App.tsx`
- [Booking and bookings](https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Frontend/src/pages/Booking.tsx): `src/Frontend/src/pages/Booking.tsx`
- [Service discovery](https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Frontend/src/pages/Services.tsx): `src/Frontend/src/pages/Services.tsx`
- [Service administration](https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Frontend/src/pages/admin/AdminServices.tsx): `src/Frontend/src/pages/admin/AdminServices.tsx`
- [Review experience](https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Frontend/src/pages/Reviews.tsx): `src/Frontend/src/pages/Reviews.tsx`
- [Order administration](https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Frontend/src/pages/admin/AdminOrders.tsx): `src/Frontend/src/pages/admin/AdminOrders.tsx`
- [User administration](https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Frontend/src/pages/admin/AdminUsers.tsx): `src/Frontend/src/pages/admin/AdminUsers.tsx`
- [Mechanic dashboard](https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Frontend/src/pages/mechanic/MechanicDashboard.tsx): `src/Frontend/src/pages/mechanic/MechanicDashboard.tsx`
- [Session state](https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Frontend/src/lib/auth-context.tsx): `src/Frontend/src/lib/auth-context.tsx`
- [HTTP client](https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Frontend/src/api/api.ts): `src/Frontend/src/api/api.ts`

### Booking and catalog

- [Orders and payments](https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Services/Orders/BLL/Services/OrderService.cs): `src/Services/Orders/BLL/Services/OrderService.cs`
- [Parts and catalog](https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Services/Catalog/BLL/Services/PartService.cs): `src/Services/Catalog/BLL/Services/PartService.cs`

### Identity and vehicles

- [Authentication and users](https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Services/Users/BLL/Services/AuthService.cs): `src/Services/Users/BLL/Services/AuthService.cs`
- [Vehicle registry](https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Services/Vehicles/BLL/Services/VehicleService.cs): `src/Services/Vehicles/BLL/Services/VehicleService.cs`
- [VIN decoding](https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Services/Vehicles/BLL/Services/NhtsaVinDecoderService.cs): `src/Services/Vehicles/BLL/Services/NhtsaVinDecoderService.cs`

### Reviews and aggregation

- [Review API](https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Services/Reviews/API/Controllers/ReviewsController.cs): `src/Services/Reviews/API/Controllers/ReviewsController.cs`
- [Review query handlers](https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Services/Reviews/Application/Handlers/GetReviewsByOrderIdQueryHandler.cs): `src/Services/Reviews/Application/Handlers/GetReviewsByOrderIdQueryHandler.cs`
- [Review repository](https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Services/Reviews/Infrastructure/Repositories/ReviewRepository.cs): `src/Services/Reviews/Infrastructure/Repositories/ReviewRepository.cs`
- [Order-review aggregation](https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Aggregator/Services/AggregationService.cs): `src/Aggregator/Services/AggregationService.cs`
- [Aggregation endpoint](https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Aggregator/Controllers/AggregationController.cs): `src/Aggregator/Controllers/AggregationController.cs`

### AI and notifications

- [AI diagnostics](https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Services/AI/BLL/Services/AIDiagnostService.cs): `src/Services/AI/BLL/Services/AIDiagnostService.cs`
- [Order notifications](https://github.com/dimaakk1/autoservicemicroservices/blob/master/src/Services/Notifications/OrderCreatedConsumer.cs): `src/Services/Notifications/OrderCreatedConsumer.cs`

### Other components

- **Customer or staff**

## Connections

- Customer or staff → Route and access shell: uses (evidence: `src/Frontend/src/App.tsx`)
- Route and access shell → Booking and bookings: routes to (evidence: `src/Frontend/src/App.tsx`)
- Route and access shell → Review experience: routes to (evidence: `src/Frontend/src/App.tsx`)
- Route and access shell → Order administration: routes to (evidence: `src/Frontend/src/App.tsx`)
- Route and access shell → User administration: routes to (evidence: `src/Frontend/src/App.tsx`)
- Route and access shell → Service administration: routes to (evidence: `src/Frontend/src/App.tsx`)
- Route and access shell → Mechanic dashboard: routes to (evidence: `src/Frontend/src/App.tsx`)
- Route and access shell → Session state: provides session (evidence: `src/Frontend/src/App.tsx`)
- Session state → HTTP client: requests profile (evidence: `src/Frontend/src/lib/auth-context.tsx`)
- Review experience → HTTP client: loads data (evidence: `src/Frontend/src/pages/Reviews.tsx`)
- Service discovery → HTTP client: requests services (evidence: `src/Frontend/src/pages/Services.tsx`)
- Service administration → HTTP client: manages services (evidence: `src/Frontend/src/pages/admin/AdminServices.tsx`)
- Review API → Review query handlers: dispatches queries (evidence: `src/Services/Reviews/API/Controllers/ReviewsController.cs`)
- Review query handlers → Review repository: reads reviews (evidence: `src/Services/Reviews/Application/Handlers/GetReviewsByOrderIdQueryHandler.cs`)
- Aggregation endpoint → Order-review aggregation: delegates (evidence: `src/Aggregator/Controllers/AggregationController.cs`)
- Order-review aggregation → Orders and payments: reads orders (evidence: `src/Aggregator/Services/AggregationService.cs`)
- Order-review aggregation → Authentication and users: reads users (evidence: `src/Aggregator/Services/AggregationService.cs`)
- Order-review aggregation → Review API: combines reviews
- Orders and payments → Order notifications: publishes events
- Vehicle registry → VIN decoding: uses decoder
