# devmentors/packit architecture

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

- Interactive diagram: https://gitdiagram.com/devmentors/packit
- Repository: https://github.com/devmentors/packit

## Overview

PackIT is a packing-list application using HTTP endpoints, CQRS handlers, domain rules, and PostgreSQL-backed read/write persistence. The main workflow creates a list using localization and weather data, generates default items, and stores it; users can also search/read lists and mutate items. The graph preserves the documented application shape and the major subsystems visible in the tree. Some dispatcher registrations and infrastructure wiring were not sampled, so those links are omitted rather than inferred.

Main entry points: [`src/PackIT.Api/Controllers/PackingListsController.cs`](https://github.com/devmentors/packit/blob/master/src/PackIT.Api/Controllers/PackingListsController.cs) (Packing Lists API), [`src/PackIT.Application/Commands/Handlers/CreatePackingListWithItemsHandler.cs`](https://github.com/devmentors/packit/blob/master/src/PackIT.Application/Commands/Handlers/CreatePackingListWithItemsHandler.cs) (Create List Handler), [`src/PackIT.Infrastructure/EF/Queries/Handlers/SearchPackingListsHandler.cs`](https://github.com/devmentors/packit/blob/master/src/PackIT.Infrastructure/EF/Queries/Handlers/SearchPackingListsHandler.cs) (Search Handler), [`src/PackIT.Domain/Factories/PackingListFactory.cs`](https://github.com/devmentors/packit/blob/master/src/PackIT.Domain/Factories/PackingListFactory.cs) (List Factory)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_controller["Packing Lists API"]
end

subgraph group_application["Application CQRS"]
  node_command_handlers["Command Handlers<br/>[Handlers]"]
  node_create_handler["Create List Handler"]
  node_query_definitions["List Queries<br/>[Queries]"]
  node_dto["Packing List DTO<br/>[PackingListDto.cs]"]
  node_weather_contract["Weather Service Contract<br/>[IWeatherService.cs]"]
end

subgraph group_domain["Packing Domain"]
  node_factory["List Factory"]
  node_policies["Item Policies<br/>[Policies]"]
  node_aggregate["Packing List Aggregate<br/>[PackingList.cs]"]
  node_value_objects["Domain Values<br/>[ValueObjects]"]
  node_repository_contract["Repository Contract"]
end

subgraph group_infrastructure["Persistence and Services"]
  node_query_handlers["Read Query Handlers<br/>[Handlers]"]
  node_search_handler["Search Handler"]
  node_write_repository["Postgres Repository"]
  node_write_context[("Write Context<br/>[WriteDbContext.cs]")]
  node_read_service["List Read Service"]
  node_read_context[("Read Context<br/>[ReadDbContext.cs]")]
  node_read_models["Read Models"]
  node_weather_service["Weather Service"]
end

subgraph group_shared["CQRS Runtime"]
  node_command_dispatch["Command Dispatcher"]
  node_query_dispatch["Query Dispatcher"]
end

node_user(("API Client"))

node_user -->|"sends requests"| node_controller
node_controller -->|"dispatches commands"| node_command_dispatch
node_controller -->|"submits queries"| node_query_dispatch
node_controller -->|"binds queries"| node_query_definitions
node_controller -->|"returns DTOs"| node_dto
node_create_handler -->|"checks name"| node_read_service
node_create_handler -->|"gets weather"| node_weather_contract
node_create_handler -->|"creates list"| node_factory
node_create_handler -->|"adds aggregate"| node_repository_contract
node_factory -->|"constructs aggregate"| node_aggregate
node_factory -->|"uses policies"| node_policies
node_aggregate -->|"uses values"| node_value_objects
node_write_repository -->|"uses context"| node_write_context
node_write_repository -->|"implements contract"| node_repository_contract
node_read_service -->|"queries context"| node_read_context
node_search_handler -->|"queries lists"| node_read_context
node_search_handler -->|"projects models"| node_read_models
node_search_handler -->|"maps results"| node_dto
node_weather_service -->|"implements contract"| node_weather_contract
node_command_dispatch -.->|"routes commands"| node_command_handlers
node_query_dispatch -.->|"routes queries"| node_query_handlers
node_query_handlers -.->|"includes search"| node_search_handler
node_command_handlers -.->|"includes create"| node_create_handler

click node_controller "https://github.com/devmentors/packit/blob/master/src/PackIT.Api/Controllers/PackingListsController.cs"
click node_command_dispatch "https://github.com/devmentors/packit/blob/master/src/PackIT.Shared/Commands/InMemoryCommandDispatcher.cs"
click node_query_dispatch "https://github.com/devmentors/packit/blob/master/src/PackIT.Shared/Queries/InMemoryQueryDispatcher.cs"
click node_command_handlers "https://github.com/devmentors/packit/tree/master/src/PackIT.Application/Commands/Handlers"
click node_create_handler "https://github.com/devmentors/packit/blob/master/src/PackIT.Application/Commands/Handlers/CreatePackingListWithItemsHandler.cs"
click node_query_handlers "https://github.com/devmentors/packit/tree/master/src/PackIT.Infrastructure/EF/Queries/Handlers"
click node_search_handler "https://github.com/devmentors/packit/blob/master/src/PackIT.Infrastructure/EF/Queries/Handlers/SearchPackingListsHandler.cs"
click node_query_definitions "https://github.com/devmentors/packit/tree/master/src/PackIT.Application/Queries"
click node_dto "https://github.com/devmentors/packit/blob/master/src/PackIT.Application/DTO/PackingListDto.cs"
click node_factory "https://github.com/devmentors/packit/blob/master/src/PackIT.Domain/Factories/PackingListFactory.cs"
click node_policies "https://github.com/devmentors/packit/tree/master/src/PackIT.Domain/Policies"
click node_aggregate "https://github.com/devmentors/packit/blob/master/src/PackIT.Domain/Entities/PackingList.cs"
click node_value_objects "https://github.com/devmentors/packit/tree/master/src/PackIT.Domain/ValueObjects"
click node_repository_contract "https://github.com/devmentors/packit/blob/master/src/PackIT.Domain/Repositories/IPackingListRepository.cs"
click node_write_repository "https://github.com/devmentors/packit/blob/master/src/PackIT.Infrastructure/EF/Repositories/PostgresPackingListRepository.cs"
click node_write_context "https://github.com/devmentors/packit/blob/master/src/PackIT.Infrastructure/EF/Contexts/WriteDbContext.cs"
click node_read_service "https://github.com/devmentors/packit/blob/master/src/PackIT.Infrastructure/EF/Services/PostgresPackingListReadService.cs"
click node_read_context "https://github.com/devmentors/packit/blob/master/src/PackIT.Infrastructure/EF/Contexts/ReadDbContext.cs"
click node_read_models "https://github.com/devmentors/packit/blob/master/src/PackIT.Infrastructure/EF/Models/PackingListReadModel.cs"
click node_weather_contract "https://github.com/devmentors/packit/blob/master/src/PackIT.Application/Services/IWeatherService.cs"
click node_weather_service "https://github.com/devmentors/packit/blob/master/src/PackIT.Infrastructure/Services/DumbWeatherService.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_controller,node_user toneBlue
class node_command_handlers,node_create_handler,node_query_definitions,node_dto,node_weather_contract toneAmber
class node_factory,node_policies,node_aggregate,node_value_objects,node_repository_contract toneMint
class node_query_handlers,node_search_handler,node_write_repository,node_write_context,node_read_service,node_read_context,node_read_models,node_weather_service toneRose
class node_command_dispatch,node_query_dispatch toneIndigo
```

## Components

### HTTP API

- [Packing Lists API](https://github.com/devmentors/packit/blob/master/src/PackIT.Api/Controllers/PackingListsController.cs): `src/PackIT.Api/Controllers/PackingListsController.cs`

### Application CQRS

- [Command Handlers](https://github.com/devmentors/packit/tree/master/src/PackIT.Application/Commands/Handlers): `src/PackIT.Application/Commands/Handlers`
- [Create List Handler](https://github.com/devmentors/packit/blob/master/src/PackIT.Application/Commands/Handlers/CreatePackingListWithItemsHandler.cs): `src/PackIT.Application/Commands/Handlers/CreatePackingListWithItemsHandler.cs`
- [List Queries](https://github.com/devmentors/packit/tree/master/src/PackIT.Application/Queries): `src/PackIT.Application/Queries`
- [Packing List DTO](https://github.com/devmentors/packit/blob/master/src/PackIT.Application/DTO/PackingListDto.cs): `src/PackIT.Application/DTO/PackingListDto.cs`
- [Weather Service Contract](https://github.com/devmentors/packit/blob/master/src/PackIT.Application/Services/IWeatherService.cs): `src/PackIT.Application/Services/IWeatherService.cs`

### Packing Domain

- [List Factory](https://github.com/devmentors/packit/blob/master/src/PackIT.Domain/Factories/PackingListFactory.cs): `src/PackIT.Domain/Factories/PackingListFactory.cs`
- [Item Policies](https://github.com/devmentors/packit/tree/master/src/PackIT.Domain/Policies): `src/PackIT.Domain/Policies`
- [Packing List Aggregate](https://github.com/devmentors/packit/blob/master/src/PackIT.Domain/Entities/PackingList.cs): `src/PackIT.Domain/Entities/PackingList.cs`
- [Domain Values](https://github.com/devmentors/packit/tree/master/src/PackIT.Domain/ValueObjects): `src/PackIT.Domain/ValueObjects`
- [Repository Contract](https://github.com/devmentors/packit/blob/master/src/PackIT.Domain/Repositories/IPackingListRepository.cs): `src/PackIT.Domain/Repositories/IPackingListRepository.cs`

### Persistence and Services

- [Read Query Handlers](https://github.com/devmentors/packit/tree/master/src/PackIT.Infrastructure/EF/Queries/Handlers): `src/PackIT.Infrastructure/EF/Queries/Handlers`
- [Search Handler](https://github.com/devmentors/packit/blob/master/src/PackIT.Infrastructure/EF/Queries/Handlers/SearchPackingListsHandler.cs): `src/PackIT.Infrastructure/EF/Queries/Handlers/SearchPackingListsHandler.cs`
- [Postgres Repository](https://github.com/devmentors/packit/blob/master/src/PackIT.Infrastructure/EF/Repositories/PostgresPackingListRepository.cs): `src/PackIT.Infrastructure/EF/Repositories/PostgresPackingListRepository.cs`
- [Write Context](https://github.com/devmentors/packit/blob/master/src/PackIT.Infrastructure/EF/Contexts/WriteDbContext.cs): `src/PackIT.Infrastructure/EF/Contexts/WriteDbContext.cs`
- [List Read Service](https://github.com/devmentors/packit/blob/master/src/PackIT.Infrastructure/EF/Services/PostgresPackingListReadService.cs): `src/PackIT.Infrastructure/EF/Services/PostgresPackingListReadService.cs`
- [Read Context](https://github.com/devmentors/packit/blob/master/src/PackIT.Infrastructure/EF/Contexts/ReadDbContext.cs): `src/PackIT.Infrastructure/EF/Contexts/ReadDbContext.cs`
- [Read Models](https://github.com/devmentors/packit/blob/master/src/PackIT.Infrastructure/EF/Models/PackingListReadModel.cs): `src/PackIT.Infrastructure/EF/Models/PackingListReadModel.cs`
- [Weather Service](https://github.com/devmentors/packit/blob/master/src/PackIT.Infrastructure/Services/DumbWeatherService.cs): `src/PackIT.Infrastructure/Services/DumbWeatherService.cs`

### CQRS Runtime

- [Command Dispatcher](https://github.com/devmentors/packit/blob/master/src/PackIT.Shared/Commands/InMemoryCommandDispatcher.cs): `src/PackIT.Shared/Commands/InMemoryCommandDispatcher.cs`
- [Query Dispatcher](https://github.com/devmentors/packit/blob/master/src/PackIT.Shared/Queries/InMemoryQueryDispatcher.cs): `src/PackIT.Shared/Queries/InMemoryQueryDispatcher.cs`

### Other components

- **API Client**

## Connections

- API Client → Packing Lists API: sends requests (evidence: `src/PackIT.Api/Controllers/PackingListsController.cs`)
- Packing Lists API → Command Dispatcher: dispatches commands (evidence: `src/PackIT.Api/Controllers/PackingListsController.cs`)
- Packing Lists API → Query Dispatcher: submits queries (evidence: `src/PackIT.Api/Controllers/PackingListsController.cs`)
- Packing Lists API → List Queries: binds queries (evidence: `src/PackIT.Api/Controllers/PackingListsController.cs`)
- Packing Lists API → Packing List DTO: returns DTOs (evidence: `src/PackIT.Api/Controllers/PackingListsController.cs`)
- Create List Handler → List Read Service: checks name (evidence: `src/PackIT.Application/Commands/Handlers/CreatePackingListWithItemsHandler.cs`)
- Create List Handler → Weather Service Contract: gets weather (evidence: `src/PackIT.Application/Commands/Handlers/CreatePackingListWithItemsHandler.cs`)
- Create List Handler → List Factory: creates list (evidence: `src/PackIT.Application/Commands/Handlers/CreatePackingListWithItemsHandler.cs`)
- Create List Handler → Repository Contract: adds aggregate (evidence: `src/PackIT.Application/Commands/Handlers/CreatePackingListWithItemsHandler.cs`)
- List Factory → Packing List Aggregate: constructs aggregate (evidence: `src/PackIT.Domain/Factories/PackingListFactory.cs`)
- List Factory → Item Policies: uses policies (evidence: `src/PackIT.Domain/Factories/PackingListFactory.cs`)
- Packing List Aggregate → Domain Values: uses values (evidence: `src/PackIT.Domain/Entities/PackingList.cs`)
- Postgres Repository → Write Context: uses context (evidence: `src/PackIT.Infrastructure/EF/Repositories/PostgresPackingListRepository.cs`)
- Postgres Repository → Repository Contract: implements contract (evidence: `src/PackIT.Infrastructure/EF/Repositories/PostgresPackingListRepository.cs`)
- List Read Service → Read Context: queries context (evidence: `src/PackIT.Infrastructure/EF/Services/PostgresPackingListReadService.cs`)
- Search Handler → Read Context: queries lists (evidence: `src/PackIT.Infrastructure/EF/Queries/Handlers/SearchPackingListsHandler.cs`)
- Search Handler → Read Models: projects models (evidence: `src/PackIT.Infrastructure/EF/Queries/Handlers/SearchPackingListsHandler.cs`)
- Search Handler → Packing List DTO: maps results (evidence: `src/PackIT.Infrastructure/EF/Queries/Handlers/SearchPackingListsHandler.cs`)
- Weather Service → Weather Service Contract: implements contract (evidence: `src/PackIT.Infrastructure/Services/DumbWeatherService.cs`)
- Command Dispatcher → Command Handlers: routes commands
- Query Dispatcher → Read Query Handlers: routes queries
- Read Query Handlers → Search Handler: includes search
- Command Handlers → Create List Handler: includes create
