How sefe/dorc works
DOrc is a deployment orchestration platform: users manage projects, environments, and configuration in the Web UI, then initiate deployments that the API validates and coordinates through deployment requests, build-artifact lookup, and Runner agents. Monitor handles deployment activity and observability; API events provide real-time updates. The API also exposes reference-data, access-control, audit, analytics, and Terraform capabilities. The principal request path is documented in the README; edges for unsampled subsystems are limited to documented relationships rather than inferred calls.
Main entry points: Program.cs DOrc API · RequestController.cs Deployment requests · DeploymentEngine.cs Deployment monitor · routes.ts Web UI
Components 21
User experience
- Web UI
src/dorc-web/src/router/routes.ts
API and management
- DOrc API
src/Dorc.Api/Program.cs - Deployment requests
src/Dorc.Api/Controllers/RequestController.cs - Environment and reference data
src/Dorc.Api/Controllers/RefDataEnvironmentsController.cs - Analytics and audit
src/Dorc.Api/Controllers/AnalyticsController.cs - Identity and permissions
src/Dorc.Api/Security/ClaimsPrincipalReaderFactory.cs - Request service
src/Dorc.Api/Services/RequestService.cs - Request contracts
src/Dorc.ApiModel/CreateRequest.cs
Deployment execution
- Request orchestration
src/Dorc.Core/RequestsManager.cs - Runner agent
src/Dorc.Runner/Program.cs - Deployment monitor
src/Dorc.Monitor/DeploymentEngine.cs - Deployment events
src/Dorc.Api/Events/DirectDeploymentEventPublisher.cs - Kafka event substrate
src/Dorc.Kafka.Events/DependencyInjection/KafkaResultsStatusSubstrateServiceCollectionExtensions.cs - Terraform support
src/Dorc.Api/Controllers/TerraformController.cs
Persistence and integrations
- Persistent data
src/Dorc.PersistentData/Sources/Interfaces/IEnvironmentsPersistentSource.cs - Build providers
src/Dorc.Api/Services/DeployableBuildFactory.cs - Azure DevOps client
src/Dorc.AzureDevOps.Client/AzureDevOpsApiClientFactory.cs
Other components
- Users and teams
- Azure DevOps
- Target servers
- OpenSearch logging
Connections 26
- Users and teams → Web UI: use
README.md - Web UI → DOrc API: REST calls
README.md - Web UI → DOrc API: subscribe updates
README.md - DOrc API → Deployment requests: routes requests
- DOrc API → Environment and reference data: routes management
- DOrc API → Analytics and audit: routes analytics
- Deployment requests → Request service: delegates
- Deployment requests → Persistent data: reads projects
src/Dorc.Api/Controllers/RequestController.cs - Deployment requests → Deployment events: publishes status
src/Dorc.Api/Controllers/RequestController.cs - Request service → Request orchestration: coordinates
- Request orchestration → Persistent data: reads project data
src/Dorc.Core/RequestsManager.cs - Request orchestration → Build providers: selects provider
src/Dorc.Core/RequestsManager.cs - Build providers → Azure DevOps client: uses client
- Azure DevOps client → Azure DevOps: fetches artifacts
README.md - DOrc API → Persistent data: reads and writes
README.md - DOrc API → Identity and permissions: authenticates requests
README.md - DOrc API → Runner agent: sends job instructions
README.md - Runner agent → DOrc API: reports status
README.md - Runner agent → Target servers: executes scripts
README.md - DOrc API → Deployment events: publishes updates
README.md - Deployment events → Deployment monitor: sends deployment events
README.md - Deployment monitor → OpenSearch logging: pushes logs
README.md - Deployment monitor → DOrc API: subscribes events
README.md - Deployment monitor → Kafka event substrate: signals request polling
- DOrc API → Terraform support: serves Terraform API
- Deployment requests → Request contracts: accepts request data
src/Dorc.Api/Controllers/RequestController.cs