coulomb/coulomb-social
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
coulomb-social/INTENT.md

92 lines
6.1 KiB
Markdown
Raw Normal View History

Bootstrap coulomb-social: INTENT, SCOPE, TRSL, agent files, State Hub 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.
2026-08-09 00:35:12 +02:00
---
repo: coulomb-social
Plan product path: app shell and Forgejo markdown spaces Mark CSOC-WP-0002 identity done on app.coulomb.social. Defer bulk Bubble migration until product foundation exists. Open CSOC-WP-0004 for post-login entry and space content as markdown bound to Forgejo.
2026-08-10 09:40:25 +02:00
updated: "2026-08-10"
status: active
Bootstrap coulomb-social: INTENT, SCOPE, TRSL, agent files, State Hub 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.
2026-08-09 00:35:12 +02:00
---
# INTENT — coulomb-social
## Project Name
`coulomb-social`
## One-Line Intent
`coulomb-social` reimplements the **coulomb.social** co-creation platform — currently stuck on bubble.io — as a first-class application on the Railiance / NetKingdom / HelixForge stack, so product evolution can move at agentic coding speed instead of low-code stall.
## Purpose
coulomb.social is Coulomb's co-creation marketplace: people and teams find each other around shared projects and complementary capabilities. The live product still runs on bubble.io. That path is **stalled**: low-code velocity no longer matches the rest of the Coulomb fleet, content and UI are hard to evolve with agents, and the platform cannot meet the business-app service contract (tenancy, backup, cost attribution, image provenance).
This repository is the **owning home** for the rebuild:
1. **Parity capture** — inventory and export everything that matters in the bubble.io app (UI surfaces, workflows, data types, content, integrations).
2. **Cut decisions** — decide rebuild-as-is vs reduced v1 with an explicit human gate.
3. **Implementation** — deliver a standalone service on the proven business delivery lane (`vergabe-teilnahme` evidence), under the business-app service contract.
Serve the rebuild on app.coulomb.social; defer apex Bubble cutover Document parallel-host strategy: Railiance on app.*, Bubble remains on coulomb.social until data and self-registration are ready.
2026-08-09 23:20:30 +02:00
4. **Cutover** — serve the rebuild on **`app.coulomb.social`** in parallel with Bubble on apex `coulomb.social`; retire Bubble only when data, self-registration, and content parity are ready.
Bootstrap coulomb-social: INTENT, SCOPE, TRSL, agent files, State Hub 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.
2026-08-09 00:35:12 +02:00
Binky Hedgehog GmbH is **client #1** of its own platform (DR-2 B). The app is not a Core Hub extension; it is a normal client-facing business application.
## Core Idea
> Exit bubble.io by duplicating the product surface into an agentic, code-owned stack — not by bolting more low-code onto a stalled base.
The rebuild is deliberately **product-faithful first**: UI and content parity matter so the community does not experience a feature cliff at cutover. Scope reductions, if any, are explicit decisions (CSOC-WP-0001-T03), not accidental omissions.
## Platform Shape (decided)
| Concern | Decision |
|---------|----------|
| Shape | Standalone service — own repo, own DB, own release values (DR-2 B) |
| Tenancy | Instance-per-client deployment; tenant-keyed data model from migration one (DR-1 C) |
Plan product path: app shell and Forgejo markdown spaces Mark CSOC-WP-0002 identity done on app.coulomb.social. Defer bulk Bubble migration until product foundation exists. Open CSOC-WP-0004 for post-login entry and space content as markdown bound to Forgejo.
2026-08-10 09:40:25 +02:00
| Identity | NetKingdom OIDC (KeyCape) + user-engine (ADR-0001); proven on app host |
| Public hosts | **`app.coulomb.social`** = rebuild; **`coulomb.social`** = Bubble until cutover |
| Delivery lane | commit-SHA images → `forgejo.coulomb.social/coulomb/coulomb-social` → `railiance-apps` → railiance01 |
| Content direction | Space content as **markdown**, versioned with **Forgejo** (CSOC-WP-0004); bulk Bubble migration later |
Bootstrap coulomb-social: INTENT, SCOPE, TRSL, agent files, State Hub 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.
2026-08-09 00:35:12 +02:00
| Contract | `the-custodian` `canon/standards/business-app-service-contract_v0.1.md` §§1–6 |
## What Success Looks Like
1. Full inventory of the bubble.io product (pages, workflows, data, integrations) is recorded in this repo.
2. Exportable data is mapped to a relational, tenant-keyed model and rehearsal-imported at least once.
3. A human-gated feature cut (rebuild-as-is vs reduced v1) is decided and recorded.
4. v1 implementation satisfies the business-app service contract before serving members.
5. Members and content can cut over from bubble.io without relying on the low-code platform for further development.
## Design Principles
1. **Own the product in code** — UI, domain model, and content pipelines live in git so agents can change them safely.
2. **Parity before cleverness** — match the existing product surface before inventing net-new platform features.
3. **Contract first** — tenancy keying, backup/restore path, ops-hub registration, and cost attribution keys are not afterthoughts.
4. **Reuse the delivery lane** — follow `vergabe-teilnahme` patterns for build, image, and railiance-apps release; do not invent a second path.
5. **Stack boundaries** — Railiance owns runtime hosting, NetKingdom owns platform identity/secrets direction, HelixForge owns capability vocabulary; this repo owns the coulomb.social product.
## Scope Summary
**In:** product rebuild, bubble exit assessment, data migration, UI/content parity, app-local auth, railiance delivery packaging.
**Out:** owning Railiance/NetKingdom/HelixForge platform code; remaining on bubble.io as the long-term development surface; Core Hub embedding.
## Related Documents
- `GOAL.md` — operator bootstrap note for this repo
- `SCOPE.md` — in/out boundaries and orientation
Finish CSOC-WP-0003 and CSOC-WP-0004; residual intakes for Case B Close self-registration workplan with Case A proven and Create account entry implemented; park public registration enablement and identity negatives as CSOC-IN-0001/0002. Complete app-shell workplan with T06 operator runbook (seed, bind, webhook, smoke) and smoke doc updates.
2026-08-12 10:59:25 +02:00
- `workplans/CSOC-WP-0002-netkingdom-user-management-reestablish.md` — **finished**: identity shell on app.coulomb.social
- `workplans/CSOC-WP-0003-self-registration-and-assurance.md` — **finished**: Case A + Create account entry; Case B residuals `CSOC-IN-0001`/`0002`
- `workplans/CSOC-WP-0004-app-shell-and-space-content.md` — **finished**: app home, spaces, Forgejo markdown, operator runbook
Implement NetKingdom identity shell for coulomb.social (CSOC-WP-0002) Django scaffold aligned with the business delivery lane: tenant-keyed Member model without passwords, identity app as sole OIDC/session boundary, dev-claims login, authenticated /app/ shell, ADR-0001, and tests. T01/T02/T05/T06 done; OIDC registration, real user-engine HTTP, flex-auth, and packaging remain open.
2026-08-09 01:45:05 +02:00
- `docs/adr/ADR-0001-netkingdom-identity.md` — accepted identity decision
Add Space metadata model and provisional Forgejo content ADR Introduce tenant-scoped Space/SpaceMembership with list and detail views. Document markdown-in-Forgejo as content SoR (ADR-0002). Run migrations on container start so app.coulomb.social picks up the new tables.
2026-08-12 01:30:05 +02:00
- `docs/adr/ADR-0002-space-content-forgejo-markdown.md` — space content as markdown in Forgejo
Finish CSOC-WP-0003 and CSOC-WP-0004; residual intakes for Case B Close self-registration workplan with Case A proven and Create account entry implemented; park public registration enablement and identity negatives as CSOC-IN-0001/0002. Complete app-shell workplan with T06 operator runbook (seed, bind, webhook, smoke) and smoke doc updates.
2026-08-12 10:59:25 +02:00
- `docs/deploy.md` — deploy + spaces operator runbook
Plan product path: app shell and Forgejo markdown spaces Mark CSOC-WP-0002 identity done on app.coulomb.social. Defer bulk Bubble migration until product foundation exists. Open CSOC-WP-0004 for post-login entry and space content as markdown bound to Forgejo.
2026-08-10 09:40:25 +02:00
- `workplans/CSOC-WP-0001-bubble-io-exit-assessment.md` — Bubble inventory/migration **after** product foundation
Publish CSOC-WP-0005 resource demand and cost evidence Add low/base/high demand forecasts, service objectives with timestamped observations, and workload operations labor for resource:tenant:coulomb:coulomb-social.
2026-08-12 11:07:03 +02:00
- `workplans/CSOC-WP-0005-resource-demand-and-cost-evidence.md` — **finished**: demand/SLO/labor evidence for resource-control
- `docs/resource-evidence/` — workload demand forecasts, observations, labor
Adopt stage-1 capability cut and product capability model Persist capability/feature vocabulary, v0 model, and founder stage-1 must set (onboarding, spaces/pages with Title/Abstract/Visual, page copy and transfer). Mark CSOC-WP-0001-T03 done; add CSOC-WP-0006 for implementation.
2026-08-12 13:09:09 +02:00
- `docs/capability/` — product capability/feature model; stage-1 cutover must set
- `docs/decisions/2026-08-12-feature-cut-stage-1.md` — partial rebuild for productive transfer
Add ArchitectureBlueprint and content-plane spike checklist Document coulomb layering (NetKingdom, Railiance, PageOps, markitect-tool), compare thin store vs shard-wiki vs kontextual-engine, and outline asset-store extraction from kontextual BlobStorage. Include executable spike checklist.
2026-08-12 18:38:27 +02:00
- `docs/architecture/ArchitectureBlueprint.md` — content plane, NetKingdom, assets (discussion)
- `docs/architecture/spike-checklist.md` — evaluation spikes for store choice
Document content substrate: markdown SoR, markitect-tool, shard-wiki Capture preferred layering (NetKingdom, Railiance, coulomb UI, markitect-tool as markdown lib, DB as cache). Treat markitect-main as legacy; evaluate shard-wiki as thin-slice content plane candidate.
2026-08-12 18:29:29 +02:00
- `docs/architecture/2026-08-12-content-substrate-exploration.md` — markdown SoR, markitect-tool, shard-wiki eval
Bootstrap coulomb-social: INTENT, SCOPE, TRSL, agent files, State Hub 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.
2026-08-09 00:35:12 +02:00
- `the-custodian/docs/coulomb-social-rebuild-seed.md` — original workplan seed (CUST-WP-0058-T08)
- `the-custodian/canon/standards/business-app-service-contract_v0.1.md`
Point intent/scope at NetKingdom user-management path (CSOC-WP-0002) Register CSOC-WP-0002 for identity-first reestablish; defer Bubble content claim behind the authenticated shell. CSOC-WP-0001 notes the priority shift.
2026-08-09 01:36:28 +02:00
- NetKingdom: IAM Profile, user-engine boundary, KeyCape/Keycloak modes
Bootstrap coulomb-social: INTENT, SCOPE, TRSL, agent files, State Hub 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.
2026-08-09 00:35:12 +02:00
- Reference delivery lane: `vergabe-teilnahme`
Reference in a new issue Copy permalink