# Coulomb Pricing (MVP)

Project-specific material for the Coulomb Social Economic Observatory MVP.

Generic adaptive-pricing framework concepts belong in the repository root
(`INTENT.md`, `docs/`, `research/`, `registry/`). Execution tracking:
`workplans/ADAPTIVE-WP-0002-economic-observatory-mvp.md`.

Liquidity and cost requirements: `REQUIREMENTS.md`.

## Sprint 1 — Economic Foundations

The `observatory/` package reads **expense and payment record ledgers** and
computes all totals programmatically (`ledger.py` → `economics.py`).

| Ledger | File |
|--------|------|
| Budget (€1,000 start) | `data/budget.json` |
| Expense records | `data/expense_records.json` |
| Payment records | `data/payment_records.json` |
| Product model | `data/product.json` |
| Pricing models | `data/pricing-models.json` |
| Membership | `data/membership.json` |

**Current reality:** infrastructure from January 2025 — domains **€6.75/mo**,
coulombcore hosting **€13.99/mo** (from Jan 2025), railiance01 hosting
**€8.99/mo** (from Mar 2026). Member **tegwick** pays **€8.99/mo** (Stripe fee
**€0.44**, net payout **€8.55** to binky-hedgehog) from November 2025. Customer
cost-pass-through billing is not active.

### Commands

```bash
cd projects/coulomb-pricing
python3 -m pytest -q
python3 -m observatory --period 2026-06
python3 -m observatory --period 2026-06 --output reports/economics-2026-06.md
./scripts/sync-whynot-design.sh          # pull whynot-design tokens/CSS/components
python3 -m observatory.server
```

Open **http://127.0.0.1:8765/** for the Economic Observatory UI (served from
`ui/`, data via `/api/dashboard`). The UI consumes **whynot-design** (Layer 1 CSS
+ Layer 2 `<wn-*>` components) from `ui/vendor/whynot-design/` — re-run the sync
script after bumping the pinned ref in `.whynot-design-ref`. Claude atelier mock
(reference only): https://claude.ai/design/p/fb2eef8c-c1fc-4c75-bff4-3782552e5511

Manual ledgers will be replaced by Bubble (Sprint 2), Stripe (Sprint 3), and
OpenRouter (Sprint 4) importers.