coulomb-social/SCOPE.md

104 lines
4.3 KiB
Markdown
Raw Normal View History

# SCOPE
> This file helps you quickly understand what this repository is about,
> when it is relevant, and when it is not.
> It is intentionally lightweight and may be incomplete.
---
## One-liner
Reimplementation of the coulomb.social co-creation platform as a standalone Railiance / NetKingdom / HelixForge application, exiting the stalled bubble.io stack.
---
## Core Idea
coulomb.social connects people around shared projects and complementary capabilities. Development on bubble.io has stalled. This repo owns the full product rebuild — UI, content, data model, and migration — so the platform can evolve with the rest of the Coulomb agentic fleet under the business-app service contract.
---
## In Scope
- Product intent, scope, workplans, and ADRs for the coulomb.social rebuild
- Inventory of the existing bubble.io app (pages, workflows, data types, integrations, content)
- Data export, relational schema mapping, and migration rehearsal
- Feature-cut decisions (rebuild-as-is vs reduced v1) and acceptance criteria
- Application implementation: UI parity, domain model, app-local accounts, APIs
- Packaging for the business delivery lane (commit-SHA images, railiance-apps release values)
- Tenant-keyed data model from the first migration; member account export/delete
- Ops/runbook stubs required by the business-app service contract (§§36)
- State Hub workplans, progress events, and classification for this repo
---
## Out of Scope
- Remaining on bubble.io as the primary development platform
- Owning Railiance cluster, platform, or app-chart infrastructure code (`railiance-*`)
- Owning NetKingdom identity platform implementation (Keycloak/OpenBao) — only the app-local auth boundary and future OIDC switch point live here
- Owning HelixForge standards or capability registry implementation
- Core Hub embedding or treating coulomb.social as a hub extension
- Fleet self-improvement loops (owner: `coulomb-loop`)
- Serving paying external multi-tenant SaaS before the service-contract preconditions are met
---
## Relevant When
- Planning or implementing the bubble.io exit and product rebuild
- Mapping coulomb.social features, content, or data into code-owned artifacts
- Packaging or deploying the coulomb.social app via the business delivery lane
- Checking tenancy, identity, backup, or cost-attribution obligations for this app
---
## Not Relevant When
- You need cluster or mesh infrastructure changes → use the relevant `railiance-*` repo
- You need platform SSO/secret custody work → use `net-kingdom` / OpenBao workplans
- You need fleet kaizen loop operation → use `coulomb-loop`
- You need a reference business-app implementation pattern → start with `vergabe-teilnahme`
- You only need the historical seed note → `the-custodian/docs/coulomb-social-rebuild-seed.md` (pointer; work originates here)
---
## Current State
- Status: bootstrap / greenfield
- Implementation: orientation docs only; no application code yet
- Stability: evolving
- Usage: internal — product rebuild not yet serving members from this stack
- Prior art: rebuild seed from CUST-WP-0058-T08; topic `coulomb-social` already exists in State Hub under domain `communication`
---
## How It Fits
- **Upstream decisions:** business-app service contract; DR-1 C / DR-2 B / DR-3 A
- **Delivery lane:** `vergabe-teilnahme` (pattern) → this repo (product) → `railiance-apps` (release values) → railiance01
- **Platform peers:** `railiance-*`, `net-kingdom`, `helix-forge`, `ops-hub`, `fin-hub`
- **Coordination:** State Hub topic `coulomb-social` (domain `communication`); related engagement repo `coulomb-loop`
---
## Getting Oriented
- Start with: `INTENT.md`, `GOAL.md`, `.custodian-brief.md`
- Key paths: `workplans/`, `docs/` (as they appear), application source (once scaffolded)
- First workplan: `workplans/CSOC-WP-0001-bubble-io-exit-assessment.md`
- Contract: `the-custodian/canon/standards/business-app-service-contract_v0.1.md`
---
## Related Repositories
| Repo | Relationship |
|------|----------------|
| `vergabe-teilnahme` | Reference business-app delivery lane |
| `railiance-apps` | Helm/release values for deploy |
| `railiance-forge` / `helix-forge` | Forge and capability patterns |
| `net-kingdom` | Future OIDC / platform identity |
| `coulomb-loop` | Fleet improvement loops (same State Hub topic) |
| `the-custodian` / `state-hub` | Coordination, standards, seed history |