# 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/archived/260622-ADAPTIVE-WP-0002-economic-observatory-mvp.md`
(finished 2026-06-22).

Liquidity and cost requirements: `REQUIREMENTS.md`.  
UI workflow (whynot-design): `docs/UI-WORKFLOW.md`.

## Economic Observatory

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` |
| AI usage | `data/usage_records.json` |
| Credit wallets | `data/credit_wallets.json` |
| Value range hypotheses | `data/value_range.json` |
| Market signals | `data/market_signals.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
make test
make design                             # pull whynot-design tokens/CSS/components
make design REF=v0.2.1                  # bump to a tag or commit
python3 -m observatory --period 2026-06
python3 -m observatory --period 2026-06 --output reports/economics-2026-06.md
make serve
```

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/`. See
`docs/UI-WORKFLOW.md` for the implementation process.

### Importers (file-based sync)

```bash
python3 -m observatory.importers.bubble --input data/imports/bubble-export.sample.json
python3 -m observatory.importers.stripe --input data/imports/stripe-export.sample.json
python3 -m observatory.importers.openrouter --input data/imports/openrouter-export.sample.json
```

Sample exports live under `data/imports/`. Live API sync can replace these
file-based importers in a follow-on workplan.