# ricci141/directoryservice architecture

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

- Interactive diagram: https://gitdiagram.com/ricci141/directoryservice
- Repository: https://github.com/ricci141/directoryservice

## Overview

Directory Service is the repository’s documented product: a shared source of truth for organizational units, locations, and positions. Its API accepts CRUD and structure queries, delegates requests to application handlers, and returns results; the README also documents hierarchical departments and many-to-many department/location and department/position relationships. The frontend and File Service are present in the tree, but their full runtime wiring is not shown in the excerpts, so those relationships are omitted. Persistence wiring beyond the DbContext’s entity sets is not verified.

Main entry points: [`backend/DirectoryService/src/DirectoryService.Infrastructure.Postgres/DirectoryServiceDbContext.cs`](https://github.com/ricci141/directoryservice/blob/main/backend/DirectoryService/src/DirectoryService.Infrastructure.Postgres/DirectoryServiceDbContext.cs) (Directory Database), [`backend/DirectoryService/src/DirectoryService.Presentation/Departments/DepartmentController.cs`](https://github.com/ricci141/directoryservice/blob/main/backend/DirectoryService/src/DirectoryService.Presentation/Departments/DepartmentController.cs) (Department API), [`backend/DirectoryService/src/DirectoryService.Presentation/Locations/LocationsController.cs`](https://github.com/ricci141/directoryservice/blob/main/backend/DirectoryService/src/DirectoryService.Presentation/Locations/LocationsController.cs) (Location API), [`backend/DirectoryService/src/DirectoryService.Presentation/Positions/PositionController.cs`](https://github.com/ricci141/directoryservice/blob/main/backend/DirectoryService/src/DirectoryService.Presentation/Positions/PositionController.cs) (Position API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Directory API"]
  node_dept_api["Department API"]
  node_location_api["Location API"]
  node_position_api["Position API"]
  node_contracts["Request Contracts"]
end

subgraph group_application["Application Workflows"]
  node_dept_workflows["Department Commands<br/>[Command]"]
  node_dept_queries["Department Queries<br/>[Queries]"]
  node_location_workflows["Location Commands<br/>[Command]"]
  node_location_queries["Location Queries<br/>[Queries]"]
  node_position_workflows["Position Commands<br/>[Command]"]
  node_position_queries["Position Queries<br/>[Queries]"]
end

subgraph group_domain["Directory Domain"]
  node_department_domain["Departments<br/>[Department.cs]"]
  node_location_domain["Locations<br/>[Location.cs]"]
  node_position_domain["Positions<br/>[Position.cs]"]
  node_department_location["Department Locations"]
  node_department_position["Department Positions"]
end

subgraph group_persistence["Persistence"]
  node_directory_db[("Directory Database")]
end

subgraph group_file["File Service"]
  node_file_api["File HTTP Client<br/>[FileHttpClient.cs]"]
  node_file_core["File Operations<br/>[FileService.Core]"]
  node_file_metadata[("Media Asset Store")]
  node_object_storage["S3 Storage<br/>[S3Provider.cs]"]
end

node_clients(("Internal Services"))

node_clients -.->|"requests"| node_dept_api
node_clients -.->|"requests"| node_location_api
node_clients -.->|"requests"| node_position_api
node_dept_api -->|"dispatches commands"| node_dept_workflows
node_dept_api -->|"dispatches queries"| node_dept_queries
node_location_api -->|"dispatches commands"| node_location_workflows
node_location_api -->|"dispatches queries"| node_location_queries
node_position_api -->|"dispatches commands"| node_position_workflows
node_position_api -->|"dispatches queries"| node_position_queries
node_dept_api -->|"accepts requests"| node_contracts
node_location_api -->|"accepts requests"| node_contracts
node_position_api -->|"accepts requests"| node_contracts
node_directory_db -->|"maps entities"| node_department_domain
node_directory_db -->|"maps entities"| node_location_domain
node_directory_db -->|"maps entities"| node_position_domain
node_directory_db -->|"maps entities"| node_department_location
node_directory_db -->|"maps entities"| node_department_position
node_dept_workflows -.->|"persists changes"| node_directory_db
node_dept_queries -.->|"reads data"| node_directory_db
node_location_workflows -.->|"persists changes"| node_directory_db
node_location_queries -.->|"reads data"| node_directory_db
node_position_workflows -.->|"persists changes"| node_directory_db
node_position_queries -.->|"reads data"| node_directory_db
node_file_api -.->|"calls remotely"| node_file_core
node_file_core -.->|"stores metadata"| node_file_metadata
node_file_core -.->|"stores files"| node_object_storage

click node_dept_api "https://github.com/ricci141/directoryservice/blob/main/backend/DirectoryService/src/DirectoryService.Presentation/Departments/DepartmentController.cs"
click node_location_api "https://github.com/ricci141/directoryservice/blob/main/backend/DirectoryService/src/DirectoryService.Presentation/Locations/LocationsController.cs"
click node_position_api "https://github.com/ricci141/directoryservice/blob/main/backend/DirectoryService/src/DirectoryService.Presentation/Positions/PositionController.cs"
click node_contracts "https://github.com/ricci141/directoryservice/tree/main/backend/DirectoryService/src/DirectoryService.Contracts"
click node_dept_workflows "https://github.com/ricci141/directoryservice/tree/main/backend/DirectoryService/src/DirectoryService.Application/Departments/Command"
click node_dept_queries "https://github.com/ricci141/directoryservice/tree/main/backend/DirectoryService/src/DirectoryService.Application/Departments/Queries"
click node_location_workflows "https://github.com/ricci141/directoryservice/tree/main/backend/DirectoryService/src/DirectoryService.Application/Locations/Command"
click node_location_queries "https://github.com/ricci141/directoryservice/tree/main/backend/DirectoryService/src/DirectoryService.Application/Locations/Queries"
click node_position_workflows "https://github.com/ricci141/directoryservice/tree/main/backend/DirectoryService/src/DirectoryService.Application/Positions/Command"
click node_position_queries "https://github.com/ricci141/directoryservice/tree/main/backend/DirectoryService/src/DirectoryService.Application/Positions/Queries"
click node_department_domain "https://github.com/ricci141/directoryservice/blob/main/backend/DirectoryService/src/DirectoryService.Domain/Departments/Department.cs"
click node_location_domain "https://github.com/ricci141/directoryservice/blob/main/backend/DirectoryService/src/DirectoryService.Domain/Locations/Location.cs"
click node_position_domain "https://github.com/ricci141/directoryservice/blob/main/backend/DirectoryService/src/DirectoryService.Domain/Positions/Position.cs"
click node_department_location "https://github.com/ricci141/directoryservice/blob/main/backend/DirectoryService/src/DirectoryService.Domain/DepartmentLocations/DepartmentLocation.cs"
click node_department_position "https://github.com/ricci141/directoryservice/blob/main/backend/DirectoryService/src/DirectoryService.Domain/DepartmentPositions/DepartmentPosition.cs"
click node_directory_db "https://github.com/ricci141/directoryservice/blob/main/backend/DirectoryService/src/DirectoryService.Infrastructure.Postgres/DirectoryServiceDbContext.cs"
click node_file_api "https://github.com/ricci141/directoryservice/blob/main/backend/FileService/FileService.Contracts/HttpCommunication/FileHttpClient.cs"
click node_file_core "https://github.com/ricci141/directoryservice/tree/main/backend/FileService/FileService.Core"
click node_file_metadata "https://github.com/ricci141/directoryservice/blob/main/backend/FileService/FileService.Infrastructure.Postgres/Repositories/MediaAssetsRepository.cs"
click node_object_storage "https://github.com/ricci141/directoryservice/blob/main/backend/FileService/FileService.Infrastructure.S3/S3Provider.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_dept_api,node_location_api,node_position_api,node_contracts toneBlue
class node_dept_workflows,node_dept_queries,node_location_workflows,node_location_queries,node_position_workflows,node_position_queries toneAmber
class node_department_domain,node_location_domain,node_position_domain,node_department_location,node_department_position toneMint
class node_directory_db toneRose
class node_file_api,node_file_core,node_file_metadata,node_object_storage,node_clients toneIndigo
```

## Components

### Directory API

- [Department API](https://github.com/ricci141/directoryservice/blob/main/backend/DirectoryService/src/DirectoryService.Presentation/Departments/DepartmentController.cs): `backend/DirectoryService/src/DirectoryService.Presentation/Departments/DepartmentController.cs`
- [Location API](https://github.com/ricci141/directoryservice/blob/main/backend/DirectoryService/src/DirectoryService.Presentation/Locations/LocationsController.cs): `backend/DirectoryService/src/DirectoryService.Presentation/Locations/LocationsController.cs`
- [Position API](https://github.com/ricci141/directoryservice/blob/main/backend/DirectoryService/src/DirectoryService.Presentation/Positions/PositionController.cs): `backend/DirectoryService/src/DirectoryService.Presentation/Positions/PositionController.cs`
- [Request Contracts](https://github.com/ricci141/directoryservice/tree/main/backend/DirectoryService/src/DirectoryService.Contracts): `backend/DirectoryService/src/DirectoryService.Contracts`

### Application Workflows

- [Department Commands](https://github.com/ricci141/directoryservice/tree/main/backend/DirectoryService/src/DirectoryService.Application/Departments/Command): `backend/DirectoryService/src/DirectoryService.Application/Departments/Command`
- [Department Queries](https://github.com/ricci141/directoryservice/tree/main/backend/DirectoryService/src/DirectoryService.Application/Departments/Queries): `backend/DirectoryService/src/DirectoryService.Application/Departments/Queries`
- [Location Commands](https://github.com/ricci141/directoryservice/tree/main/backend/DirectoryService/src/DirectoryService.Application/Locations/Command): `backend/DirectoryService/src/DirectoryService.Application/Locations/Command`
- [Location Queries](https://github.com/ricci141/directoryservice/tree/main/backend/DirectoryService/src/DirectoryService.Application/Locations/Queries): `backend/DirectoryService/src/DirectoryService.Application/Locations/Queries`
- [Position Commands](https://github.com/ricci141/directoryservice/tree/main/backend/DirectoryService/src/DirectoryService.Application/Positions/Command): `backend/DirectoryService/src/DirectoryService.Application/Positions/Command`
- [Position Queries](https://github.com/ricci141/directoryservice/tree/main/backend/DirectoryService/src/DirectoryService.Application/Positions/Queries): `backend/DirectoryService/src/DirectoryService.Application/Positions/Queries`

### Directory Domain

- [Departments](https://github.com/ricci141/directoryservice/blob/main/backend/DirectoryService/src/DirectoryService.Domain/Departments/Department.cs): `backend/DirectoryService/src/DirectoryService.Domain/Departments/Department.cs`
- [Locations](https://github.com/ricci141/directoryservice/blob/main/backend/DirectoryService/src/DirectoryService.Domain/Locations/Location.cs): `backend/DirectoryService/src/DirectoryService.Domain/Locations/Location.cs`
- [Positions](https://github.com/ricci141/directoryservice/blob/main/backend/DirectoryService/src/DirectoryService.Domain/Positions/Position.cs): `backend/DirectoryService/src/DirectoryService.Domain/Positions/Position.cs`
- [Department Locations](https://github.com/ricci141/directoryservice/blob/main/backend/DirectoryService/src/DirectoryService.Domain/DepartmentLocations/DepartmentLocation.cs): `backend/DirectoryService/src/DirectoryService.Domain/DepartmentLocations/DepartmentLocation.cs`
- [Department Positions](https://github.com/ricci141/directoryservice/blob/main/backend/DirectoryService/src/DirectoryService.Domain/DepartmentPositions/DepartmentPosition.cs): `backend/DirectoryService/src/DirectoryService.Domain/DepartmentPositions/DepartmentPosition.cs`

### Persistence

- [Directory Database](https://github.com/ricci141/directoryservice/blob/main/backend/DirectoryService/src/DirectoryService.Infrastructure.Postgres/DirectoryServiceDbContext.cs): `backend/DirectoryService/src/DirectoryService.Infrastructure.Postgres/DirectoryServiceDbContext.cs`

### File Service

- [File HTTP Client](https://github.com/ricci141/directoryservice/blob/main/backend/FileService/FileService.Contracts/HttpCommunication/FileHttpClient.cs): `backend/FileService/FileService.Contracts/HttpCommunication/FileHttpClient.cs`
- [File Operations](https://github.com/ricci141/directoryservice/tree/main/backend/FileService/FileService.Core): `backend/FileService/FileService.Core`
- [Media Asset Store](https://github.com/ricci141/directoryservice/blob/main/backend/FileService/FileService.Infrastructure.Postgres/Repositories/MediaAssetsRepository.cs): `backend/FileService/FileService.Infrastructure.Postgres/Repositories/MediaAssetsRepository.cs`
- [S3 Storage](https://github.com/ricci141/directoryservice/blob/main/backend/FileService/FileService.Infrastructure.S3/S3Provider.cs): `backend/FileService/FileService.Infrastructure.S3/S3Provider.cs`

### Other components

- **Internal Services**

## Connections

- Internal Services → Department API: requests
- Internal Services → Location API: requests
- Internal Services → Position API: requests
- Department API → Department Commands: dispatches commands (evidence: `backend/DirectoryService/src/DirectoryService.Presentation/Departments/DepartmentController.cs`)
- Department API → Department Queries: dispatches queries (evidence: `backend/DirectoryService/src/DirectoryService.Presentation/Departments/DepartmentController.cs`)
- Location API → Location Commands: dispatches commands (evidence: `backend/DirectoryService/src/DirectoryService.Presentation/Locations/LocationsController.cs`)
- Location API → Location Queries: dispatches queries (evidence: `backend/DirectoryService/src/DirectoryService.Presentation/Locations/LocationsController.cs`)
- Position API → Position Commands: dispatches commands (evidence: `backend/DirectoryService/src/DirectoryService.Presentation/Positions/PositionController.cs`)
- Position API → Position Queries: dispatches queries (evidence: `backend/DirectoryService/src/DirectoryService.Presentation/Positions/PositionController.cs`)
- Department API → Request Contracts: accepts requests (evidence: `backend/DirectoryService/src/DirectoryService.Presentation/Departments/DepartmentController.cs`)
- Location API → Request Contracts: accepts requests (evidence: `backend/DirectoryService/src/DirectoryService.Presentation/Locations/LocationsController.cs`)
- Position API → Request Contracts: accepts requests (evidence: `backend/DirectoryService/src/DirectoryService.Presentation/Positions/PositionController.cs`)
- Directory Database → Departments: maps entities (evidence: `backend/DirectoryService/src/DirectoryService.Infrastructure.Postgres/DirectoryServiceDbContext.cs`)
- Directory Database → Locations: maps entities (evidence: `backend/DirectoryService/src/DirectoryService.Infrastructure.Postgres/DirectoryServiceDbContext.cs`)
- Directory Database → Positions: maps entities (evidence: `backend/DirectoryService/src/DirectoryService.Infrastructure.Postgres/DirectoryServiceDbContext.cs`)
- Directory Database → Department Locations: maps entities (evidence: `backend/DirectoryService/src/DirectoryService.Infrastructure.Postgres/DirectoryServiceDbContext.cs`)
- Directory Database → Department Positions: maps entities (evidence: `backend/DirectoryService/src/DirectoryService.Infrastructure.Postgres/DirectoryServiceDbContext.cs`)
- Department Commands → Directory Database: persists changes
- Department Queries → Directory Database: reads data
- Location Commands → Directory Database: persists changes
- Location Queries → Directory Database: reads data
- Position Commands → Directory Database: persists changes
- Position Queries → Directory Database: reads data
- File HTTP Client → File Operations: calls remotely (evidence: `backend/FileService/FileService.Contracts/HttpCommunication/FileHttpClient.cs`)
- File Operations → Media Asset Store: stores metadata (evidence: `backend/FileService/FileService.Infrastructure.Postgres/Repositories/MediaAssetsRepository.cs`)
- File Operations → S3 Storage: stores files
