tegwick
0da8d36a73
Prepare the greenfield rebuild of coulomb.social (bubble.io exit) with orientation docs, TRSL license, Claude/Codex agent integration, and repo classification under domain communication / topic coulomb-social. Workplan CSOC-WP-0001 (exit assessment) is already registered via fix-consistency.
103 lines
4.3 KiB
Markdown
103 lines
4.3 KiB
Markdown
# 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 (§§3–6)
|
||
- 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 |
|