How ricci141/directoryservice works
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: DirectoryServiceDbContext.cs Directory Database · DepartmentController.cs Department API · LocationsController.cs Location API · PositionController.cs Position API
Components 21
Directory API
- Department API
backend/DirectoryService/src/DirectoryService.Presentation/Departments/DepartmentController.cs - Location API
backend/DirectoryService/src/DirectoryService.Presentation/Locations/LocationsController.cs - Position API
backend/DirectoryService/src/DirectoryService.Presentation/Positions/PositionController.cs - Request Contracts
backend/DirectoryService/src/DirectoryService.Contracts
Application Workflows
- Department Commands
backend/DirectoryService/src/DirectoryService.Application/Departments/Command - Department Queries
backend/DirectoryService/src/DirectoryService.Application/Departments/Queries - Location Commands
backend/DirectoryService/src/DirectoryService.Application/Locations/Command - Location Queries
backend/DirectoryService/src/DirectoryService.Application/Locations/Queries - Position Commands
backend/DirectoryService/src/DirectoryService.Application/Positions/Command - Position Queries
backend/DirectoryService/src/DirectoryService.Application/Positions/Queries
Directory Domain
- Departments
backend/DirectoryService/src/DirectoryService.Domain/Departments/Department.cs - Locations
backend/DirectoryService/src/DirectoryService.Domain/Locations/Location.cs - Positions
backend/DirectoryService/src/DirectoryService.Domain/Positions/Position.cs - Department Locations
backend/DirectoryService/src/DirectoryService.Domain/DepartmentLocations/DepartmentLocation.cs - Department Positions
backend/DirectoryService/src/DirectoryService.Domain/DepartmentPositions/DepartmentPosition.cs
Persistence
- Directory Database
backend/DirectoryService/src/DirectoryService.Infrastructure.Postgres/DirectoryServiceDbContext.cs
File Service
- File HTTP Client
backend/FileService/FileService.Contracts/HttpCommunication/FileHttpClient.cs - File Operations
backend/FileService/FileService.Core - Media Asset Store
backend/FileService/FileService.Infrastructure.Postgres/Repositories/MediaAssetsRepository.cs - S3 Storage
backend/FileService/FileService.Infrastructure.S3/S3Provider.cs
Other components
- Internal Services
Connections 26
- Internal Services → Department API: requests
- Internal Services → Location API: requests
- Internal Services → Position API: requests
- Department API → Department Commands: dispatches commands
backend/DirectoryService/src/DirectoryService.Presentation/Departments/DepartmentController.cs - Department API → Department Queries: dispatches queries
backend/DirectoryService/src/DirectoryService.Presentation/Departments/DepartmentController.cs - Location API → Location Commands: dispatches commands
backend/DirectoryService/src/DirectoryService.Presentation/Locations/LocationsController.cs - Location API → Location Queries: dispatches queries
backend/DirectoryService/src/DirectoryService.Presentation/Locations/LocationsController.cs - Position API → Position Commands: dispatches commands
backend/DirectoryService/src/DirectoryService.Presentation/Positions/PositionController.cs - Position API → Position Queries: dispatches queries
backend/DirectoryService/src/DirectoryService.Presentation/Positions/PositionController.cs - Department API → Request Contracts: accepts requests
backend/DirectoryService/src/DirectoryService.Presentation/Departments/DepartmentController.cs - Location API → Request Contracts: accepts requests
backend/DirectoryService/src/DirectoryService.Presentation/Locations/LocationsController.cs - Position API → Request Contracts: accepts requests
backend/DirectoryService/src/DirectoryService.Presentation/Positions/PositionController.cs - Directory Database → Departments: maps entities
backend/DirectoryService/src/DirectoryService.Infrastructure.Postgres/DirectoryServiceDbContext.cs - Directory Database → Locations: maps entities
backend/DirectoryService/src/DirectoryService.Infrastructure.Postgres/DirectoryServiceDbContext.cs - Directory Database → Positions: maps entities
backend/DirectoryService/src/DirectoryService.Infrastructure.Postgres/DirectoryServiceDbContext.cs - Directory Database → Department Locations: maps entities
backend/DirectoryService/src/DirectoryService.Infrastructure.Postgres/DirectoryServiceDbContext.cs - Directory Database → Department Positions: maps entities
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
backend/FileService/FileService.Contracts/HttpCommunication/FileHttpClient.cs - File Operations → Media Asset Store: stores metadata
backend/FileService/FileService.Infrastructure.Postgres/Repositories/MediaAssetsRepository.cs - File Operations → S3 Storage: stores files