Services

mako consists of 16 independently deployable services, each built as a self-contained Docker image with:

• TOML configuration with _FILE suffix for Kubernetes secrets
• Cedar ABAC authorization
• OIDC/JWT + API-key authentication
• OpenTelemetry traces and metrics
• Built-in MCP server at /mcp (Streamable HTTP 2025-11-25)
• Structured health endpoints (/health, /health/ready)

All services are built on mako-service — the shared SDK that provides shutdown::token/serve (SIGINT+SIGTERM graceful drain), OidcConfig::build_verifier, McpAuth+McpAuthConfig, init_tracing_from_env, DatabaseConfig, HttpConfig, CedarEnforcer, EventBus, and more. This means zero copy-pasted infrastructure code across the 16 daemons.

DatabaseConfig::connect(url, service_name) is the single PostgreSQL pool builder every daemon uses: it applies the configured pool_size plus acquire_timeout_secs / idle_timeout_secs / max_lifetime_secs (so a pool never queues unboundedly or pins a connection across a failover) and tags each connection with the service name in pg_stat_activity. Tuning lives in one place rather than being re-derived per service.

Service Map

graph TB
    ext["BDEW Counterparty<br/>(NB · LF · MSB · BKV)"]

    subgraph protocol ["Protocol & Market Data"]
        makod[":8080 makod<br/>EDIFACT runtime · 67+ workflows<br/>AS4 · SlateDB · MCP"]
        marktd[":8180 marktd<br/>MaLo/MeLo/NeLo · contracts<br/>VersorgungsStatus · EventBus"]
        processd[":8580 processd<br/>Anmeldung STP ≥95%<br/>LF E_0624 auto · §14a"]
    end

    subgraph nb_billing ["Invoice & Grid Billing (NB)"]
        invoicd[":8280 invoicd<br/>INVOIC 6-check plausibility<br/>auto-settle/dispute"]
        netzbilanzd[":8680 netzbilanzd<br/>NNE/KA/MMM/MSB billing<br/>GridSettlement · CalculationTrace"]
        sperrd[":8780 sperrd<br/>Sperrung execution<br/>IFTSTA 21039 auto-dispatch"]
    end

    subgraph data ["Energy Data & Observability"]
        edmd[":8380 edmd<br/>MSCONS · iMSys direct push<br/>Hampel · V01–V10 · virtual meters"]
        obsd[":8480 obsd<br/>process projections · KPI<br/>§20 EnWG parity report"]
        mabis[":8880 mabis-syncd<br/>MaBiS Summenzeitreihe<br/>MSCONS 13003 · 10. Werktag"]
        einsd[":9180 einsd<br/>EEG/KWKG settlement<br/>10 schemes · §14 UStG Gutschrift"]
    end

    subgraph lf_billing ["Retail Billing (LF)"]
        tarifbd[":9080 tarifbd<br/>14 categories · §42d feed<br/>EPEX §41a · B2B Angebote"]
        billingd[":9280 billingd<br/>13 categories · XRechnung 3.0<br/>RLM demand · §54 exemption"]
        accountingd[":9380 accountingd<br/>Massenkontokorrent<br/>SEPA FRST/RCUR · GLN ID · Aging · §288 BGB"]
    end

    subgraph b2c ["Contract & Customer (LF)"]
        vertragd[":9780 vertragd<br/>Kunden B2C+B2B · Rahmenverträge<br/>OIDC→MaLo · 16 MCP tools"]
        portald[":9480 portald<br/>customer portal read-model<br/>SSE · §41 self-service"]
    end

    agentd[":9580 agentd<br/>28 built-in specialists (binary)<br/>sequential|parallel|race dispatch<br/>LanceDB RAG (tenant-isolated) · A2A cards<br/>OIDC · HMAC · DLQ · OpenAI/Anthropic/Bedrock"]

    ext -->|AS4 / REST| makod
    makod <-->|CloudEvents| marktd
    marktd -->|webhook fan-out| processd & invoicd & edmd & obsd & agentd
    makod -->|commands| netzbilanzd & invoicd
    mabis -->|UTILTS cmd| makod
    billingd -->|de.billing.rechnung.erstellt| accountingd
    vertragd -->|start-supply| processd
    portald -->|aggregates| billingd & accountingd & edmd & einsd & marktd

Protocol & Market Data

Invoice & Billing (NB)

Energy Data & Observability

Retail Billing (LF)

B2C & AI

Shared foundation — the mako-service SDK

Every daemon is built on the mako-service crate, so the operational surface — health, config, auth, tracing, shutdown, event delivery — is identical across all 16. A service's main is a single line:

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    mako_service::run::<Billingd>().await   // Billingd: Daemon impl
}

run::<D>() owns the whole lifecycle. A Daemon implementation supplies only what is service-specific — the config type, the migrations, and a build() that assembles the domain router and spawns background workers:

flowchart TD
    start(["main → run::<D>"]) --> check{"--check?"}
    check -->|yes| probe["GET /health/ready<br/>exit 0/1"] --> done([exit])
    check -->|no| trace["init tracing"]
    trace --> cfg["load config<br/>TOML + env + _FILE"]
    cfg --> pool["connect tuned pool<br/>DatabaseConfig::connect(url, NAME)<br/>sets application_name"]
    pool --> migrate["D::migrate<br/>sqlx::migrate! + outbox::ensure_schema"]
    migrate --> build["D::build(cfg, ctx)<br/>domain Router + spawn workers on ctx.shutdown"]
    build --> infra["mount infra routes<br/>/health/live · /health/ready · /metrics"]
    infra --> serve["serve with graceful drain<br/>SIGINT / SIGTERM"]
    serve -.->|readiness| ready["/health/ready = bounded SELECT 1 + D::ready"]

What every service gets for free from the runner:

Event-emitting services (billingd, einsd, accountingd, netzbilanzd, vertragd, invoicd) add a transactional outbox: each outbound CloudEvent is written to event_outbox in the same transaction as the business change and drained by a background OutboxWorker with retry and a status-column dead-letter queue. Because the event is committed atomically with the data that justifies it, a crash between "commit" and "deliver" can never drop or duplicate it — persist-before-dispatch. Emission always goes through one builder and one signer (CloudEvent::new + post_ce_with_retry; X-Mako-Signature: sha256=<hex>).

makod, marktd, agentd, and portald keep bespoke mains — makod/marktd for their non-standard runtimes (SlateDB event store, marktd's durable fan-out worker), agentd/portald because they hold no database. All four still use the same SDK building blocks (config, auth, tracing, shutdown, HMAC).

Deployment

All services are available as multi-stage Docker images built with cargo-chef:

# Single all-in-one daemon (makod only)
docker pull ghcr.io/hupe1980/makod:latest

# NB STP demo — UTILMD 55001 Lieferbeginn end-to-end
git clone https://github.com/hupe1980/mako
cd mako/demos/nb-stp
docker compose up

# EEG billing demo — solar plant registration + §21 EEG 2023 settlement
cd mako/demos/eeg-billing
docker compose up

See the Getting Started guide for the full deployment walkthrough.