generated from coulomb/repo-seed
tegwick
0a38def5a5
Add file-based Bubble, Stripe, and OpenRouter importers; usage attribution, cost allocation, pricing simulator, credit wallets, and recommendations in the dashboard API. Document whynot-design UI workflow and archive the finished workplan with all ten tasks marked done.
63 lines
2.5 KiB
Markdown
63 lines
2.5 KiB
Markdown
# 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. |