coulomb-social/README.md
tegwick a1989f19db
Some checks failed
Use-case regression gate / usecase-regressions (push) Failing after 6m2s
Establish use-case regression collection and real browser gate
Assistant: codex
Assistant-Model: gpt-6.1-sol
Assistant-Session: 01a10e2d-a5ef-7e92-b03d-b1694e915680
2026-10-06 14:02:01 +02:00

56 lines
2 KiB
Markdown

# 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`. **Stage-1 cut** (productive transfer): onboarding +
spaces/pages with Title/Abstract/Visual + page copy/transfer —
`docs/capability/`. Operator runbook: `docs/deploy.md`.
## Quick start
```bash
uv sync
uv run manage.py migrate
make run # http://127.0.0.1:8008
make test # fast tests
make setup-usecases
make check # required full regression gate, including browser use cases
```
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).
## Established use cases
[Use-case collection and test infrastructure](docs/usecases/README.md) protects
user-confirmed workflows from regression, starting with ReichelAg weekly calls.
Run `make check` before accepting changes; automated success and productive
transfer acceptance remain separate.