coulomb-social/README.md
tegwick edfdd79208 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

47 lines
1.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# coulomb-social
Reimplementation of **coulomb.social** on Railiance / NetKingdom / HelixForge —
exiting the stalled bubble.io product.
**Hosts:** rebuild at [`app.coulomb.social`](https://app.coulomb.social);
apex [`coulomb.social`](https://coulomb.social) remains Bubble until cutover.
**Current state:** identity + app shell + Forgejo-backed spaces on
`app.coulomb.social` (`CSOC-WP-0002``0004` finished). Operator runbook:
`docs/deploy.md`. Bulk Bubble migration deferred (`CSOC-WP-0001`); public
registration Case B waits on NetKingdom (`docs/intakes/csoc-residuals.md`).
## Quick start
```bash
uv sync
uv run manage.py migrate
make run # http://127.0.0.1:8008
make test
```
With `DEBUG` and `OIDC_ENABLED=false` (defaults), **Sign in** uses a local
dev-claims form. Platform OIDC: set env vars in `docs/dev.md`.
## Orientation
| Doc | Role |
|-----|------|
| [`INTENT.md`](INTENT.md) | Why this repo exists |
| [`SCOPE.md`](SCOPE.md) | In/out boundaries |
| [`docs/adr/ADR-0001-netkingdom-identity.md`](docs/adr/ADR-0001-netkingdom-identity.md) | Identity architecture |
| [`docs/dev.md`](docs/dev.md) | Local development |
| [`docs/identity/`](docs/identity/) | OIDC / user-engine bindings |
| [`workplans/`](workplans/) | `CSOC-WP-*` |
| [`docs/design-extract/`](docs/design-extract/) | Captured visual language |
## Stack
- Python 3.12 · Django 5.2 · SQLite (dev) / Postgres (prod URL)
- Auth boundary: `coulomb_social.apps.identity` (OIDC/PKCE + session)
- Members: tenant-keyed, no password columns
- Design tokens reference: primary `#d08728` (from live extract)
## License
Target Revenue Source License (TRSL V1C1). See [`LICENSE`](LICENSE).