Skip to content

Unipuka Platform Docs

Welcome to the Unipuka platform operational documentation.

What's here

Section Description
Runbooks Step-by-step operator procedures for common + emergency tasks
ADRs Architecture Decision Records - why we built things the way we did
Audit Secrets audit, cutover precondition checklists
Reference Backend deploy preparation plan

Platform overview

flowchart LR
  subgraph soa [soa repo]
    BuildWf["do-build.yml"]
    DeployWf["do-deploy.yml"]
  end
  subgraph DOCR
    Img["api:<tag>"]
  end
  subgraph InfraOps [unipuka-infra-ops]
    Platform["platform/"]
    AppsLaravel["apps/laravel/"]
    Root["bootstrap/"]
  end
  subgraph DOKS [oep-prd-cluster]
    Argo[ArgoCD]
    ESO[ESO]
    Gateway["Gateway :443/:6001"]
    Mon["Prometheus+Loki+OpenCost"]
    subgraph Tenants
      OepStg["oep-stg"]
      ManPrd["mansety-prd"]
      UsPrd["us-prd"]
    end
  end
  Doppler[(Doppler oep)]
  BuildWf --> Img
  DeployWf -->|commit| InfraOps
  Argo -->|watches| InfraOps
  ESO -->|sync| Doppler
  ESO -->|writes Secret| Tenants
  Gateway -->|HTTPRoute| Tenants