# polymind-inc/acmebot architecture

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

- Interactive diagram: https://gitdiagram.com/polymind-inc/acmebot
- Repository: https://github.com/polymind-inc/acmebot

## Overview

Acmebot automates DNS-01 ACME certificate issuance and renewal, storing managed certificates in Azure Key Vault and exposing HTTP, dashboard, and CLI operations. The main workflow starts with a dashboard or CLI request, passes through the HTTP API and durable issuance orchestration, provisions DNS challenges through configured providers, completes ACME protocol steps, and persists the certificate. Separate paths support certificate inventory and ARI-aware renewal scheduling, DNS zone discovery, account management, and operation webhooks. Several links are documented capabilities or inferred from the component layout because the relevant handlers and orchestration activities were not excerpted.

Main entry points: [`src/Acmebot.App/Functions/Orchestration/CertificateIssuanceOrchestrator.cs`](https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Functions/Orchestration/CertificateIssuanceOrchestrator.cs) (Issuance orchestrator), [`src/Acmebot.App/Functions/Orchestration/CertificateRenewalSchedulerOrchestrator.cs`](https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Functions/Orchestration/CertificateRenewalSchedulerOrchestrator.cs) (Renewal scheduler), [`src/Acmebot.App/Functions/Orchestration/AcmeOrderActivities.cs`](https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Functions/Orchestration/AcmeOrderActivities.cs) (ACME order activities), [`src/Acmebot.App/Functions/Http`](https://github.com/polymind-inc/acmebot/tree/master/src/Acmebot.App/Functions/Http) (HTTP API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_operations["Operator interfaces"]
  node_dashboard["Management dashboard<br/>[App.vue]"]
  node_cli["CLI commands<br/>[CliApplication.cs]"]
  node_cli_api["CLI API client"]
  node_http_api["HTTP API<br/>[Http]"]
end

subgraph group_workflow["Certificate workflows"]
  node_operations_api["Certificate operations"]
  node_issuance["Issuance orchestrator"]
  node_acme_activities["ACME order activities"]
  node_dns_activities["DNS challenge activities"]
end

subgraph group_protocol["ACME protocol"]
  node_acme_client["ACME client<br/>[AcmeClient.cs]"]
  node_account_factory["Account client factory"]
  node_acme_state[("ACME account state")]
end

subgraph group_integrations["Azure and DNS integrations"]
  node_dns_provider["DNS providers<br/>[IDnsProvider.cs]"]
  node_key_vault[("Azure Key Vault")]
  node_certificates["Certificate query"]
  node_zone_query["DNS zone query"]
end

subgraph group_renewal["Renewal and monitoring"]
  node_renewal_scheduler["Renewal scheduler"]
  node_renewal_eval["Renewal evaluation"]
  node_renewal_timer["Renewal timer"]
  node_webhook_activity["Webhook activity"]
  node_webhook_invoker["Webhook delivery<br/>[WebhookInvoker.cs]"]
end

node_operator(("Operator"))
node_webhook_endpoint(("Webhook endpoint"))
node_acme_ca(("ACME authority"))

node_operator -->|"uses"| node_dashboard
node_operator -->|"runs"| node_cli
node_dashboard -.->|"requests"| node_http_api
node_cli -->|"calls"| node_cli_api
node_cli_api -->|"sends requests"| node_http_api
node_http_api -.->|"delegates"| node_operations_api
node_operations_api -.->|"starts"| node_issuance
node_issuance -.->|"dispatches"| node_acme_activities
node_issuance -.->|"dispatches"| node_dns_activities
node_acme_activities -.->|"uses"| node_acme_client
node_account_factory -->|"creates"| node_acme_client
node_account_factory -->|"loads and saves"| node_acme_state
node_acme_client -->|"ACME requests"| node_acme_ca
node_dns_activities -.->|"updates challenge DNS"| node_dns_provider
node_acme_activities -.->|"stores certificate"| node_key_vault
node_certificates -->|"reads certificates"| node_key_vault
node_zone_query -->|"lists zones"| node_dns_provider
node_renewal_timer -.->|"triggers"| node_renewal_scheduler
node_renewal_scheduler -.->|"evaluates timing"| node_renewal_eval
node_renewal_scheduler -.->|"gets targets"| node_certificates
node_renewal_scheduler -.->|"starts renewals"| node_issuance
node_issuance -.->|"reports outcome"| node_webhook_activity
node_webhook_activity -->|"invokes"| node_webhook_invoker
node_webhook_invoker -.->|"sends notification"| node_webhook_endpoint

click node_dashboard "https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/ClientApp/src/App.vue"
click node_cli "https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.Cli/CliApplication.cs"
click node_cli_api "https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.Cli/AcmebotApiClient.cs"
click node_http_api "https://github.com/polymind-inc/acmebot/tree/master/src/Acmebot.App/Functions/Http"
click node_operations_api "https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Services/CertificateOperationService.cs"
click node_issuance "https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Functions/Orchestration/CertificateIssuanceOrchestrator.cs"
click node_acme_activities "https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Functions/Orchestration/AcmeOrderActivities.cs"
click node_dns_activities "https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Functions/Orchestration/DnsChallengeActivities.cs"
click node_acme_client "https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.Acme/AcmeClient.cs"
click node_account_factory "https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Acme/AcmeClientFactory.cs"
click node_acme_state "https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Acme/BlobAcmeStateStore.cs"
click node_dns_provider "https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Providers/IDnsProvider.cs"
click node_certificates "https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Services/CertificateQueryService.cs"
click node_zone_query "https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Services/DnsZoneQueryService.cs"
click node_renewal_scheduler "https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Functions/Orchestration/CertificateRenewalSchedulerOrchestrator.cs"
click node_renewal_eval "https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Services/CertificateRenewalScheduleEvaluator.cs"
click node_renewal_timer "https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Functions/Timer/RenewCertificates.cs"
click node_webhook_activity "https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Functions/Orchestration/WebhookActivities.cs"
click node_webhook_invoker "https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Notifications/WebhookInvoker.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_dashboard,node_cli,node_cli_api,node_http_api toneBlue
class node_operations_api,node_issuance,node_acme_activities,node_dns_activities toneAmber
class node_acme_client,node_account_factory,node_acme_state,node_webhook_endpoint toneMint
class node_dns_provider,node_key_vault,node_certificates,node_zone_query toneRose
class node_renewal_scheduler,node_renewal_eval,node_renewal_timer,node_webhook_activity,node_webhook_invoker,node_operator,node_acme_ca toneIndigo
```

## Components

### Operator interfaces

- [Management dashboard](https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/ClientApp/src/App.vue): `src/Acmebot.App/ClientApp/src/App.vue`
- [CLI commands](https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.Cli/CliApplication.cs): `src/Acmebot.Cli/CliApplication.cs`
- [CLI API client](https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.Cli/AcmebotApiClient.cs): `src/Acmebot.Cli/AcmebotApiClient.cs`
- [HTTP API](https://github.com/polymind-inc/acmebot/tree/master/src/Acmebot.App/Functions/Http): `src/Acmebot.App/Functions/Http`

### Certificate workflows

- [Certificate operations](https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Services/CertificateOperationService.cs): `src/Acmebot.App/Services/CertificateOperationService.cs`
- [Issuance orchestrator](https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Functions/Orchestration/CertificateIssuanceOrchestrator.cs): `src/Acmebot.App/Functions/Orchestration/CertificateIssuanceOrchestrator.cs`
- [ACME order activities](https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Functions/Orchestration/AcmeOrderActivities.cs): `src/Acmebot.App/Functions/Orchestration/AcmeOrderActivities.cs`
- [DNS challenge activities](https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Functions/Orchestration/DnsChallengeActivities.cs): `src/Acmebot.App/Functions/Orchestration/DnsChallengeActivities.cs`

### ACME protocol

- [ACME client](https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.Acme/AcmeClient.cs): `src/Acmebot.Acme/AcmeClient.cs`
- [Account client factory](https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Acme/AcmeClientFactory.cs): `src/Acmebot.App/Acme/AcmeClientFactory.cs`
- [ACME account state](https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Acme/BlobAcmeStateStore.cs): `src/Acmebot.App/Acme/BlobAcmeStateStore.cs`

### Azure and DNS integrations

- [DNS providers](https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Providers/IDnsProvider.cs): `src/Acmebot.App/Providers/IDnsProvider.cs`
- **Azure Key Vault**
- [Certificate query](https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Services/CertificateQueryService.cs): `src/Acmebot.App/Services/CertificateQueryService.cs`
- [DNS zone query](https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Services/DnsZoneQueryService.cs): `src/Acmebot.App/Services/DnsZoneQueryService.cs`

### Renewal and monitoring

- [Renewal scheduler](https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Functions/Orchestration/CertificateRenewalSchedulerOrchestrator.cs): `src/Acmebot.App/Functions/Orchestration/CertificateRenewalSchedulerOrchestrator.cs`
- [Renewal evaluation](https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Services/CertificateRenewalScheduleEvaluator.cs): `src/Acmebot.App/Services/CertificateRenewalScheduleEvaluator.cs`
- [Renewal timer](https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Functions/Timer/RenewCertificates.cs): `src/Acmebot.App/Functions/Timer/RenewCertificates.cs`
- [Webhook activity](https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Functions/Orchestration/WebhookActivities.cs): `src/Acmebot.App/Functions/Orchestration/WebhookActivities.cs`
- [Webhook delivery](https://github.com/polymind-inc/acmebot/blob/master/src/Acmebot.App/Notifications/WebhookInvoker.cs): `src/Acmebot.App/Notifications/WebhookInvoker.cs`

### Other components

- **Operator**
- **Webhook endpoint**
- **ACME authority**

## Connections

- Operator → Management dashboard: uses (evidence: `README.md`)
- Operator → CLI commands: runs (evidence: `README.md`)
- Management dashboard → HTTP API: requests
- CLI commands → CLI API client: calls (evidence: `src/Acmebot.Cli/CliApplication.cs`)
- CLI API client → HTTP API: sends requests (evidence: `src/Acmebot.Cli/AcmebotApiClient.cs`)
- HTTP API → Certificate operations: delegates
- Certificate operations → Issuance orchestrator: starts
- Issuance orchestrator → ACME order activities: dispatches
- Issuance orchestrator → DNS challenge activities: dispatches
- ACME order activities → ACME client: uses
- Account client factory → ACME client: creates (evidence: `src/Acmebot.App/Acme/AcmeClientFactory.cs`)
- Account client factory → ACME account state: loads and saves (evidence: `src/Acmebot.App/Acme/AcmeClientFactory.cs`)
- ACME client → ACME authority: ACME requests (evidence: `src/Acmebot.Acme/AcmeClient.cs`)
- DNS challenge activities → DNS providers: updates challenge DNS
- ACME order activities → Azure Key Vault: stores certificate (evidence: `README.md`)
- Certificate query → Azure Key Vault: reads certificates (evidence: `src/Acmebot.App/Services/CertificateQueryService.cs`)
- DNS zone query → DNS providers: lists zones (evidence: `src/Acmebot.App/Services/DnsZoneQueryService.cs`)
- Renewal timer → Renewal scheduler: triggers
- Renewal scheduler → Renewal evaluation: evaluates timing
- Renewal scheduler → Certificate query: gets targets
- Renewal scheduler → Issuance orchestrator: starts renewals
- Issuance orchestrator → Webhook activity: reports outcome
- Webhook activity → Webhook delivery: invokes (evidence: `src/Acmebot.App/Functions/Orchestration/WebhookActivities.cs`)
- Webhook delivery → Webhook endpoint: sends notification (evidence: `src/Acmebot.App/Notifications/WebhookInvoker.cs`)
