Skip to content

ADR-047 — akko-demo-sources : périmètre 3 (sources simulées client)

  • Status : Accepted
  • Date : 2026-04-30
  • Sprint : 61.3
  • Drivers : besoin d'un périmètre démo représentatif des sources clientes (banking OLTP, IoT capteurs, registre public, ESG flood risk) sans contaminer le namespace akko plateforme.
  • Related : ADR-045 (3 perimeters demo cluster), ADR-046 (catalog naming), Sprint 62 data master plan

Context

Le périmètre 1 (akko) héberge la plateforme. Le périmètre 2 (akko-demo-ad, akko-demo-cloudera) simule un parc on-prem entreprise (LDAP/AD + Hadoop kerberisé). Manquait le périmètre 3 — les bases métier qu'un client externe brancherait sur AKKO via Trino : OLTP Postgres, PostGIS, futurs Oracle XE / MSSQL / MongoDB.

Decision

Namespace dédié akko-demo-sources contenant 4 instances PostgreSQL :

DB Domaine Catalog Trino (ADR-046)
oltp_banking PaySim transactions + AML postgres_oltp_banking
postgis_iot NOAA stations + relevés postgres_postgis_iot
oltp_publicsector INSEE 96 départements postgres_oltp_publicsector
postgis_esg DPE + flood risk + climat postgres_postgis_esg

Les 4 catalogs Trino sont créés par helm/akko/charts/akko-init/templates/trino-catalog-bootstrap-job.yaml, gated sur global.demo.sources.enabled. OPA RBAC autorise les rôles akko-analyst / akko-engineer / akko-scientist en read-only sur les 4 catalogs.

Consequences

  • + Démo réaliste : prospects voient un Trino fédérant leurs type de sources, pas juste les datasets bundlés iceberg.
  • + Isolation fault → un crash demo-sources n'impacte pas la plateforme akko.
  • − Coût RAM + 1.5 GB sur Netcup (4 Postgres 14-alpine).
  • − Repo séparé AKKO-p/akko-demo-sources (Sprint 61) à maintenir.

Implementation pointers

  • Repo : https://github.com/AKKO-p/akko-demo-sources (private).
  • Helm umbrella akko-demo-sources chart, déployé séparément.
  • services/demo-sources.md (EN) + services/demo-sources.fr.md (FR).
  • helm/akko/charts/akko-init/values.yaml → demoCatalogs block.