Compare commits

..

No commits in common. "b26ffc10ef000b82198577bf7a7c9430d6d8ff74" and "22100f94cf88459077b61707e860544ab9d256d6" have entirely different histories.

2 changed files with 42 additions and 114 deletions

View file

@ -2,10 +2,8 @@
**Created:** 2026-07-10 **Created:** 2026-07-10
**Workplan:** `CUST-WP-0058` **Workplan:** `CUST-WP-0058`
**Status:** All three decisions **resolved** by Bernd on 2026-07-10 (hub **Status:** All three decisions **pending** — Bernd's to resolve; this document
decision records `d85cd185…`, `1f8b109e…`, `ebcf0573…`). See *Resolutions and frames options and recommendations only.
consistency refinement* at the end; the option tables below are kept as
decision history.
## Context ## Context
@ -27,7 +25,7 @@ happens via State Hub decision records (`resolve_decision`).
## DR-1 — Tenancy model for vergabe-teilnahme ## DR-1 — Tenancy model for vergabe-teilnahme
**Status:** resolved 2026-07-10 — **Option C** (hybrid) **Status:** pending
### Question ### Question
@ -61,7 +59,7 @@ German business clients.
## DR-2 — coulomb.social rebuild architecture ## DR-2 — coulomb.social rebuild architecture
**Status:** resolved 2026-07-10 — **Option B** (standalone application) **Status:** pending
### Question ### Question
@ -98,7 +96,7 @@ wins.
## DR-3 — External identity path for business clients ## DR-3 — External identity path for business clients
**Status:** resolved 2026-07-10 — **Option A** (app-local accounts), demand-gated follow-up **Status:** pending
### Question ### Question
@ -132,60 +130,11 @@ lane, because a social platform on app-local accounts is not viable.
--- ---
## Resolutions and consistency refinement (2026-07-10) ## Resolution protocol
All three decisions were resolved by Bernd in the State Hub on 2026-07-10. 1. Each DR is registered as a pending State Hub decision (custodian topic).
The resolved set was then reviewed for internal consistency; two refinements 2. Bernd resolves via `resolve_decision()` or by stating the choice in a
follow from reading the three choices together. session; the resolving agent updates this document's status lines and the
hub record together.
### Resolved set 3. `CUST-WP-0058` tasks T01–T03 track the facilitation; downstream tasks
stay `wait` until their gating DR is resolved.
| DR | Choice | Bernd's rationale (hub record) |
| --- | --- | --- |
| DR-1 | **C — hybrid** | Instance-per-client to serve early customers easily, but "move on to resource cost optimization early" |
| DR-2 | **B — standalone app** | coulomb.social is its own application, distinct in purpose and operations model; an application *of* Binky Hedgehog GmbH just as other apps are provided to clients; the fact that Binky Hedgehog provides the ecosystem (coulomb domain, Forgejo repos) is not relevant to the app itself |
| DR-3 | **A — app-local accounts** | Lightweight version now; follow up with Keycloak (NK-WP-0011) only on actual demand |
### Unifying model
**Binky Hedgehog GmbH is client #1 of its own platform.** coulomb.social is
delivered through the same standalone-app lane, service contract, and tenancy
rules as apps sold to external clients. There is exactly one app shape
(standalone service, forge→apps delivery) and one tenancy default
(instance-per-client) — no special cases.
### Refinement 1 — consolidation-readiness (DR-1 C ↔ DR-3 A)
DR-1's early cost-optimization move implies consolidating instances later,
which app-local accounts per instance would turn into an account-migration
problem. Therefore:
- The business-app service contract (CUST-WP-0058-T04) **must require
consolidation-ready design**: tenant-clean data model (all client data
keyed by a tenant identifier) even when deployed single-tenant.
- **Instance consolidation is itself a DR-3 demand trigger**: when the
cost-optimization move consolidates instances, the platform-identity
follow-up (NK-WP-0011) activates as part of that move.
### Refinement 2 — identity triggers corrected (DR-2 B ↔ DR-3 A)
The original DR-3 framing made a coulomb.social greenlight an automatic
Keycloak trigger. DR-2 B + DR-3 A overrule this: a standalone social app
owning its own user accounts is a normal, viable shape. The corrected,
purely demand-based triggers for activating NK-WP-0011 are:
1. A client requests SSO / AD federation.
2. Instance consolidation under DR-1's cost-optimization move (Refinement 1).
3. Operational toil from local account administration across >2 apps.
### Downstream actions
- T04 service contract: encode instance-per-client provisioning,
consolidation-ready data model, app-local identity baseline.
- T05 client-hub scoping: client↔instance mapping assumes 1..n instances per
client, consolidation-aware.
- NetKingdom lane notified: NK-WP-0011 stays proposed with the three triggers
above (no auto-activation).
- coulomb.social rebuild + bubble.io migration assessment: seeded as
standalone-app workplan skeletons (T08), consuming the same delivery lane
as vergabe-teilnahme.

View file

@ -4,12 +4,11 @@ type: workplan
title: "Business platform enablement — decisions, service contract, client plane" title: "Business platform enablement — decisions, service contract, client plane"
domain: infotech domain: infotech
repo: the-custodian repo: the-custodian
status: active status: proposed
owner: codex owner: codex
topic_slug: custodian topic_slug: custodian
created: "2026-07-10" created: "2026-07-10"
updated: "2026-07-10" updated: "2026-07-10"
state_hub_workstream_id: "13a991a3-6d98-4749-9639-dd4687cce55e"
--- ---
# CUST-WP-0058 — Business Platform Enablement # CUST-WP-0058 — Business Platform Enablement
@ -55,84 +54,71 @@ The Custodian owns decisions, canon, and cross-repo sequencing per ADR-001.
```task ```task
id: CUST-WP-0058-T01 id: CUST-WP-0058-T01
status: done status: todo
priority: high priority: high
state_hub_task_id: "b7130553-a3d9-4dfd-91d7-6edb503bab58"
``` ```
**Resolved 2026-07-10: Option C (hybrid)** — instance-per-client to start, Register DR-1 as a pending State Hub decision (custodian topic); present
early cost-optimization move. Hub decision `d85cd185…`; doc updated with options to Bernd; on resolution update
consistency Refinement 1 (consolidation-ready data model required by the `docs/business-platform-decision-records.md` and `resolve_decision()`.
service contract; consolidation is a DR-3 identity trigger). No Propagate the outcome into vergabe-teilnahme's SCOPE if it changes.
vergabe-teilnahme SCOPE change needed for v1 (stays single-tenant deployed).
### T02 — Facilitate and record DR-2: coulomb.social architecture ### T02 — Facilitate and record DR-2: coulomb.social architecture
```task ```task
id: CUST-WP-0058-T02 id: CUST-WP-0058-T02
status: done status: todo
priority: medium priority: medium
state_hub_task_id: "ec09753e-ecef-4368-af5d-5e295cdbda1e"
``` ```
**Resolved 2026-07-10: Option B (standalone application)** — hub decision Register DR-2 as a pending State Hub decision. If resolution is
`1f8b109e…`. coulomb.social is its own app with a distinct ops model; Binky "defer until pilot" (recommended), set the revisit condition to T07
Hedgehog GmbH acts as client #1 of its own platform, consuming the same completion and keep the decision open with that note. Include a pointer to
delivery lane and service contract as external-client apps. The bubble.io the required bubble.io data-migration assessment either way.
data-migration assessment and rebuild workplan skeletons are seeded in T08.
### T03 — Facilitate and record DR-3: external identity path ### T03 — Facilitate and record DR-3: external identity path
```task ```task
id: CUST-WP-0058-T03 id: CUST-WP-0058-T03
status: done status: todo
priority: high priority: high
state_hub_task_id: "ffead70c-2179-46ba-a70a-cf13be87eef8"
``` ```
**Resolved 2026-07-10: Option A (app-local accounts)** — hub decision Register DR-3 as a pending State Hub decision. On resolution, message the
`ebcf0573…`, demand-gated Keycloak follow-up. Refinement 2 replaces the NetKingdom lane so `NK-WP-0011` gains concrete activation triggers (or is
"coulomb.social auto-trigger" with three demand triggers (client SSO/AD activated). Record the identity mode required per app class for T04.
request; instance consolidation; local-account toil across >2 apps).
NetKingdom lane notified 2026-07-10 (message `0d238b6e…`). Identity baseline
for T04: app-local accounts, consolidation-ready.
### T04 — Author business-app service contract (canon standard) ### T04 — Author business-app service contract (canon standard)
```task ```task
id: CUST-WP-0058-T04 id: CUST-WP-0058-T04
status: todo status: wait
priority: high priority: high
state_hub_task_id: "a3cec70c-04a1-42a9-a6b0-3d2943b73968"
``` ```
Draft `canon/standards/business-app-service-contract_v0.1.md` (proposal → Draft `canon/standards/business-app-service-contract_v0.1.md` (proposal →
human review, per canon gating): obligations every client-facing app must human review, per canon gating): obligations every client-facing app must
meet — build evidence (commit-SHA images, registry), backup/restore hooks meet — build evidence (commit-SHA images, registry), backup/restore hooks
into ops-hub, incident/runbook registration, cost attribution keys for into ops-hub, incident/runbook registration, cost attribution keys for
fin-hub, **app-local identity baseline (DR-3 A)**, data-protection baseline, fin-hub, identity mode (from DR-3), data-protection baseline, and instance
**instance-per-client provisioning/upgrade duties (DR-1 C)**, and provisioning/upgrade duties (from DR-1). vergabe-teilnahme is the reference
**consolidation-ready data model** (Refinement 1: tenant-keyed data even when implementation. **Waits on:** DR-1 and DR-3 resolution (T01, T03).
deployed single-tenant). Applies equally to client apps and Binky Hedgehog's
own apps (coulomb.social — DR-2 B "client #1" model). vergabe-teilnahme is
the reference implementation. Unblocked: DR-1/DR-3 resolved 2026-07-10.
### T05 — Scope client-hub (client/commercial plane) ### T05 — Scope client-hub (client/commercial plane)
```task ```task
id: CUST-WP-0058-T05 id: CUST-WP-0058-T05
status: todo status: wait
priority: medium priority: medium
state_hub_task_id: "442b7f81-44c7-4301-9466-c99c240c4e49"
``` ```
Write a scoping note (`docs/client-hub-scoping.md`) for the missing fourth Write a scoping note (`docs/client-hub-scoping.md`) for the missing fourth
management plane: client registry, contracts/entitlements, client↔instance management plane: client registry, contracts/entitlements, client↔instance
mapping, support/SLA state. Default shape: **core-hub extension** (ops-hub mapping, support/SLA state. Default shape: **core-hub extension** (ops-hub
pattern) reusing hub-core primitives — justify any deviation. Per DR-1 C the pattern) reusing hub-core primitives — justify any deviation. Output is a
client↔instance model is 1..n instances per client, consolidation-aware; draft workplan skeleton for the owning repo, not implementation.
Binky Hedgehog GmbH itself is client #1 (DR-2 B). Output is a draft workplan **Waits on:** DR-1 resolution (T01) — tenancy determines the
skeleton for the owning repo, not implementation. Unblocked: DR-1 resolved. client↔instance model.
### T06 — fin-hub client-billing gap assessment ### T06 — fin-hub client-billing gap assessment
@ -140,7 +126,6 @@ skeleton for the owning repo, not implementation. Unblocked: DR-1 resolved.
id: CUST-WP-0058-T06 id: CUST-WP-0058-T06
status: todo status: todo
priority: medium priority: medium
state_hub_task_id: "3a63f122-2398-4149-8458-eb5a3a54627c"
``` ```
Review `FIN-WP-0000/0001` outcomes against what commercial clients need: Review `FIN-WP-0000/0001` outcomes against what commercial clients need:
@ -155,7 +140,6 @@ FIN-WP workplan skeleton posted to the fin-hub lane.
id: CUST-WP-0058-T07 id: CUST-WP-0058-T07
status: wait status: wait
priority: high priority: high
state_hub_task_id: "d07443ab-76b1-4d66-981c-e83fcb915c0d"
``` ```
Coordinate one full pass of the business delivery lane with a real (or Coordinate one full pass of the business delivery lane with a real (or
@ -164,10 +148,8 @@ pilot) client instance: vergabe-teilnahme build → immutable image in
instance → ops-hub evidence (endpoint, backup, smoke) → fin-hub cost instance → ops-hub evidence (endpoint, backup, smoke) → fin-hub cost
attribution. Implementation tasks live in the owning repos; this task tracks attribution. Implementation tasks live in the owning repos; this task tracks
sequencing and captures the evidence bundle under `docs/evidence/`. sequencing and captures the evidence bundle under `docs/evidence/`.
DR-2 is already resolved (B), so the pilot no longer feeds that decision — Feeds DR-2 resolution. **Waits on:** T01 (tenancy) and T04 (contract
it validates the standalone-app delivery lane that now has two consumers draft — may proceed in parallel once DR-1 is resolved).
(vergabe-teilnahme and the coulomb.social rebuild). **Waits on:** T04
contract draft (DR-1 resolved 2026-07-10).
### T08 — Closeout: decisions recorded, downstream workplans seeded ### T08 — Closeout: decisions recorded, downstream workplans seeded
@ -175,7 +157,6 @@ contract draft (DR-1 resolved 2026-07-10).
id: CUST-WP-0058-T08 id: CUST-WP-0058-T08
status: wait status: wait
priority: low priority: low
state_hub_task_id: "203f7afa-0162-4906-a4f2-c4789cd127bc"
``` ```
Verify all three DRs resolved (or explicitly deferred with revisit Verify all three DRs resolved (or explicitly deferred with revisit
@ -187,13 +168,11 @@ SCOPE.md Current State; archive this plan.
## Sequencing ## Sequencing
```text ```text
[DR-1 ✓, DR-2 ✓, DR-3 ✓ — resolved 2026-07-10] T01 (DR-1) ──┬──> T04 (contract) ──> T07 (pilot) ──> DR-2 evidence ──> T02 closes
└──> T05 (client-hub scope)
T03 (NetKingdom trigger message) — small, immediate T03 (DR-3) ──┘
T04 (contract) ──> T07 (delivery-lane pilot)
T05 (client-hub scope) — unblocked, parallel to T04
T06 (fin-hub gap) — independent, anytime T06 (fin-hub gap) — independent, anytime
T08 (closeout: seed coulomb.social rebuild + bubble.io migration skeletons) — last T08 — last
``` ```
## References ## References