# godlevsk1y/not-crm architecture

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

- Interactive diagram: https://gitdiagram.com/godlevsk1y/not-crm
- Repository: https://github.com/godlevsk1y/not-crm

## Overview

DirectoryService is an organizational directory backend for departments, locations, and positions. Its apparent user workflow is an HTTP request to manage or query directory data, followed by application handling and a response; the tree identifies controllers and feature handlers, but their routing and dispatch are not shown. Department hierarchy is a distinct domain capability, with slug/path modeling and ancestor/tree queries. PostgreSQL persistence supports the service. The README provides no product details, so several cross-layer links below are marked unverified; source excerpts show query handlers opening database connections and building paged results.

Main entry points: [`backend/DirectoryService/src/DirectoryService.Web/Controllers`](https://github.com/godlevsk1y/not-crm/tree/main/backend/DirectoryService/src/DirectoryService.Web/Controllers) (Resource controllers), [`backend/DirectoryService/src/DirectoryService.Core/Features/Locations`](https://github.com/godlevsk1y/not-crm/tree/main/backend/DirectoryService/src/DirectoryService.Core/Features/Locations) (Location features), [`backend/DirectoryService/src/DirectoryService.Core/Features/Departments/Queries`](https://github.com/godlevsk1y/not-crm/tree/main/backend/DirectoryService/src/DirectoryService.Core/Features/Departments/Queries) (Department queries), [`backend/DirectoryService/src/DirectoryService.Infrastructure.Postgres/Repositories`](https://github.com/godlevsk1y/not-crm/tree/main/backend/DirectoryService/src/DirectoryService.Infrastructure.Postgres/Repositories) (Repositories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["HTTP API"]
  node_controllers["Resource controllers<br/>[Controllers]"]
  node_results["HTTP results<br/>[EndpointResults.cs]"]
end

subgraph group_core["Application Features"]
  node_dept_commands["Department commands<br/>[Commands]"]
  node_dept_queries["Department queries<br/>[Queries]"]
  node_location_features["Location features<br/>[Locations]"]
  node_position_features["Position features<br/>[Positions]"]
  node_db_abstractions["Database interfaces<br/>[Database]"]
end

subgraph group_domain["Directory Domain"]
  node_department_model["Department model<br/>[Department.cs]"]
  node_domain_values["Hierarchy values<br/>[ValueObjects]"]
  node_other_models["Location and position<br/>[Models]"]
end

subgraph group_persistence["PostgreSQL Persistence"]
  node_db_context[("EF read context")]
  node_repositories["Repositories<br/>[Repositories]"]
end

subgraph group_contracts["API Contracts"]
  node_contracts["Request and response DTOs"]
  node_paged_result["Paged results<br/>[PagedResult.cs]"]
end

node_client(("API caller"))
node_seed_tool["Database seeder<br/>[main.go]"]

node_client -.->|"sends requests"| node_controllers
node_controllers -.->|"dispatches commands"| node_dept_commands
node_controllers -.->|"dispatches queries"| node_dept_queries
node_controllers -.->|"dispatches requests"| node_location_features
node_controllers -.->|"dispatches requests"| node_position_features
node_controllers -.->|"returns responses"| node_results
node_dept_queries -->|"opens connections"| node_db_abstractions
node_dept_queries -->|"builds DTOs"| node_contracts
node_dept_queries -->|"returns pages"| node_paged_result
node_location_features -->|"opens connections"| node_db_abstractions
node_location_features -->|"maps results"| node_contracts
node_location_features -->|"returns pages"| node_paged_result
node_db_context -->|"exposes entity"| node_department_model
node_db_context -->|"exposes entities"| node_other_models
node_repositories -.->|"persists data"| node_db_context
node_dept_commands -.->|"uses repositories"| node_repositories
node_location_features -.->|"uses repositories"| node_repositories
node_position_features -.->|"uses repositories"| node_repositories
node_department_model -->|"uses hierarchy values"| node_domain_values

click node_controllers "https://github.com/godlevsk1y/not-crm/tree/main/backend/DirectoryService/src/DirectoryService.Web/Controllers"
click node_results "https://github.com/godlevsk1y/not-crm/blob/main/backend/DirectoryService/src/DirectoryService.Web/Results/EndpointResults.cs"
click node_dept_commands "https://github.com/godlevsk1y/not-crm/tree/main/backend/DirectoryService/src/DirectoryService.Core/Features/Departments/Commands"
click node_dept_queries "https://github.com/godlevsk1y/not-crm/tree/main/backend/DirectoryService/src/DirectoryService.Core/Features/Departments/Queries"
click node_location_features "https://github.com/godlevsk1y/not-crm/tree/main/backend/DirectoryService/src/DirectoryService.Core/Features/Locations"
click node_position_features "https://github.com/godlevsk1y/not-crm/tree/main/backend/DirectoryService/src/DirectoryService.Core/Features/Positions"
click node_db_abstractions "https://github.com/godlevsk1y/not-crm/tree/main/backend/DirectoryService/src/DirectoryService.Core/Database"
click node_department_model "https://github.com/godlevsk1y/not-crm/blob/main/backend/DirectoryService/src/DirectoryService.Domain/Models/Department.cs"
click node_domain_values "https://github.com/godlevsk1y/not-crm/tree/main/backend/DirectoryService/src/DirectoryService.Domain/ValueObjects"
click node_other_models "https://github.com/godlevsk1y/not-crm/tree/main/backend/DirectoryService/src/DirectoryService.Domain/Models"
click node_db_context "https://github.com/godlevsk1y/not-crm/blob/main/backend/DirectoryService/src/DirectoryService.Infrastructure.Postgres/DirectoryServiceDbContext.cs"
click node_repositories "https://github.com/godlevsk1y/not-crm/tree/main/backend/DirectoryService/src/DirectoryService.Infrastructure.Postgres/Repositories"
click node_contracts "https://github.com/godlevsk1y/not-crm/tree/main/backend/DirectoryService/src/DirectoryService.Contracts"
click node_paged_result "https://github.com/godlevsk1y/not-crm/blob/main/backend/DirectoryService/src/DirectoryService.Shared/Results/PagedResult.cs"
click node_seed_tool "https://github.com/godlevsk1y/not-crm/blob/main/scripts/seed-directory-service-db/main.go"

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_controllers,node_results toneBlue
class node_dept_commands,node_dept_queries,node_location_features,node_position_features,node_db_abstractions,node_seed_tool toneAmber
class node_department_model,node_domain_values,node_other_models,node_client toneMint
class node_db_context,node_repositories toneRose
class node_contracts,node_paged_result toneIndigo
```

## Components

### HTTP API

- [Resource controllers](https://github.com/godlevsk1y/not-crm/tree/main/backend/DirectoryService/src/DirectoryService.Web/Controllers): `backend/DirectoryService/src/DirectoryService.Web/Controllers`
- [HTTP results](https://github.com/godlevsk1y/not-crm/blob/main/backend/DirectoryService/src/DirectoryService.Web/Results/EndpointResults.cs): `backend/DirectoryService/src/DirectoryService.Web/Results/EndpointResults.cs`

### Application Features

- [Department commands](https://github.com/godlevsk1y/not-crm/tree/main/backend/DirectoryService/src/DirectoryService.Core/Features/Departments/Commands): `backend/DirectoryService/src/DirectoryService.Core/Features/Departments/Commands`
- [Department queries](https://github.com/godlevsk1y/not-crm/tree/main/backend/DirectoryService/src/DirectoryService.Core/Features/Departments/Queries): `backend/DirectoryService/src/DirectoryService.Core/Features/Departments/Queries`
- [Location features](https://github.com/godlevsk1y/not-crm/tree/main/backend/DirectoryService/src/DirectoryService.Core/Features/Locations): `backend/DirectoryService/src/DirectoryService.Core/Features/Locations`
- [Position features](https://github.com/godlevsk1y/not-crm/tree/main/backend/DirectoryService/src/DirectoryService.Core/Features/Positions): `backend/DirectoryService/src/DirectoryService.Core/Features/Positions`
- [Database interfaces](https://github.com/godlevsk1y/not-crm/tree/main/backend/DirectoryService/src/DirectoryService.Core/Database): `backend/DirectoryService/src/DirectoryService.Core/Database`

### Directory Domain

- [Department model](https://github.com/godlevsk1y/not-crm/blob/main/backend/DirectoryService/src/DirectoryService.Domain/Models/Department.cs): `backend/DirectoryService/src/DirectoryService.Domain/Models/Department.cs`
- [Hierarchy values](https://github.com/godlevsk1y/not-crm/tree/main/backend/DirectoryService/src/DirectoryService.Domain/ValueObjects): `backend/DirectoryService/src/DirectoryService.Domain/ValueObjects`
- [Location and position](https://github.com/godlevsk1y/not-crm/tree/main/backend/DirectoryService/src/DirectoryService.Domain/Models): `backend/DirectoryService/src/DirectoryService.Domain/Models`

### PostgreSQL Persistence

- [EF read context](https://github.com/godlevsk1y/not-crm/blob/main/backend/DirectoryService/src/DirectoryService.Infrastructure.Postgres/DirectoryServiceDbContext.cs): `backend/DirectoryService/src/DirectoryService.Infrastructure.Postgres/DirectoryServiceDbContext.cs`
- [Repositories](https://github.com/godlevsk1y/not-crm/tree/main/backend/DirectoryService/src/DirectoryService.Infrastructure.Postgres/Repositories): `backend/DirectoryService/src/DirectoryService.Infrastructure.Postgres/Repositories`

### API Contracts

- [Request and response DTOs](https://github.com/godlevsk1y/not-crm/tree/main/backend/DirectoryService/src/DirectoryService.Contracts): `backend/DirectoryService/src/DirectoryService.Contracts`
- [Paged results](https://github.com/godlevsk1y/not-crm/blob/main/backend/DirectoryService/src/DirectoryService.Shared/Results/PagedResult.cs): `backend/DirectoryService/src/DirectoryService.Shared/Results/PagedResult.cs`

### Other components

- **API caller**
- [Database seeder](https://github.com/godlevsk1y/not-crm/blob/main/scripts/seed-directory-service-db/main.go): `scripts/seed-directory-service-db/main.go`

## Connections

- API caller → Resource controllers: sends requests
- Resource controllers → Department commands: dispatches commands (evidence: `backend/DirectoryService/src/DirectoryService.Web/Controllers/DepartmentsController.cs`)
- Resource controllers → Department queries: dispatches queries (evidence: `backend/DirectoryService/src/DirectoryService.Web/Controllers/DepartmentsController.cs`)
- Resource controllers → Location features: dispatches requests (evidence: `backend/DirectoryService/src/DirectoryService.Web/Controllers/LocationsController.cs`)
- Resource controllers → Position features: dispatches requests (evidence: `backend/DirectoryService/src/DirectoryService.Web/Controllers/PositionsController.cs`)
- Resource controllers → HTTP results: returns responses (evidence: `backend/DirectoryService/src/DirectoryService.Web/Controllers/DepartmentsController.cs`)
- Department queries → Database interfaces: opens connections (evidence: `backend/DirectoryService/src/DirectoryService.Core/Features/Departments/Queries/GetDepartmentTreeByName/GetDepartmentTreeByNameQueryHandler.cs`)
- Department queries → Request and response DTOs: builds DTOs (evidence: `backend/DirectoryService/src/DirectoryService.Core/Features/Departments/Queries/GetDepartmentTreeByName/GetDepartmentTreeByNameQueryHandler.cs`)
- Department queries → Paged results: returns pages (evidence: `backend/DirectoryService/src/DirectoryService.Core/Features/Departments/Queries/GetDepartmentTreeByName/GetDepartmentTreeByNameQueryHandler.cs`)
- Location features → Database interfaces: opens connections (evidence: `backend/DirectoryService/src/DirectoryService.Core/Features/Locations/Queries/GetLocationsList/GetLocationListQueryHandler.cs`)
- Location features → Request and response DTOs: maps results (evidence: `backend/DirectoryService/src/DirectoryService.Core/Features/Locations/Queries/GetLocationsList/GetLocationListQueryHandler.cs`)
- Location features → Paged results: returns pages (evidence: `backend/DirectoryService/src/DirectoryService.Core/Features/Locations/Queries/GetLocationsList/GetLocationListQueryHandler.cs`)
- EF read context → Department model: exposes entity (evidence: `backend/DirectoryService/src/DirectoryService.Infrastructure.Postgres/DirectoryServiceDbContext.cs`)
- EF read context → Location and position: exposes entities (evidence: `backend/DirectoryService/src/DirectoryService.Infrastructure.Postgres/DirectoryServiceDbContext.cs`)
- Repositories → EF read context: persists data (evidence: `backend/DirectoryService/src/DirectoryService.Infrastructure.Postgres/Repositories/DepartmentsRepository.cs`)
- Department commands → Repositories: uses repositories
- Location features → Repositories: uses repositories
- Position features → Repositories: uses repositories
- Department model → Hierarchy values: uses hierarchy values (evidence: `backend/DirectoryService/src/DirectoryService.Domain/Models/Department.cs`)
