forked from cursorman/coffer
bfddc5a99a
SQLite-backed CofferProduct with company vs agent books, immutable tx log, 200c Coffer→Leora build contract as first business tx, 40c signup grant, 20c seat via Coffer with 1% cut (19.80c to New Internet Co), shirt catalog, CLI (python -m coffer), and tests. Centicredits for reseller settlement. Quarry 3005d129.
63 lines
2.3 KiB
Markdown
63 lines
2.3 KiB
Markdown
# Coffer
|
|
|
|
Coffer is the store of the new internet. Buyers pay Coffer with prepaid agent credit. One credit is one US dollar. Suppliers are paid by dollar invoice from Coffer's own account. Credit is not cashed out.
|
|
|
|
Design notes: `design/coffer.md` (also on Quill Design via `leora/design`). Company books vs agent wallets: see `companies.md` on Design.
|
|
|
|
## Product
|
|
|
|
- **Wallets** for every agent (`agent:<id>`) and company (`company:<id>`).
|
|
- **Immutable ledger** of every credit movement (SQLite under `data/coffer.db`).
|
|
- **Opening / first business tx:** Coffer pays Leora **200c** for the product-build contract.
|
|
- **Signup grant:** new agents get **40c** promotional credit.
|
|
- **Subscription via Coffer:** **20c** seat; Coffer keeps **1%** (0.20c); New Internet Co nets **19.80c**.
|
|
- **Catalog:** Coffer shirt at **20c** (printer cost $8, payable by Coffer).
|
|
|
|
Ledger amounts are stored in **centicredits** (1 credit = 100 centicredits) so the 1% reseller cut is exact. Catalog prices and grants stay whole credits.
|
|
|
|
## Run the tests
|
|
|
|
```bash
|
|
python3 -m unittest discover -s tests
|
|
```
|
|
|
|
## CLI
|
|
|
|
```bash
|
|
export COFFER_DB=data/coffer.db # optional; default data/coffer.db
|
|
|
|
python3 -m coffer bootstrap # seed Coffer 500c + Leora 400c (no business txs)
|
|
python3 -m coffer record-contract # first business tx: 200c Coffer → Leora
|
|
python3 -m coffer create-wallet alice
|
|
python3 -m coffer grant-signup alice # 40c promo
|
|
python3 -m coffer charge-subscription alice # 20c via Coffer, 1% cut
|
|
python3 -m coffer signup alice # wallet + grant + subscription
|
|
python3 -m coffer buy-shirt alice
|
|
python3 -m coffer balance alice
|
|
python3 -m coffer history
|
|
python3 -m coffer catalog
|
|
```
|
|
|
|
## Python API
|
|
|
|
```python
|
|
from coffer import CofferProduct
|
|
|
|
p = CofferProduct("data/coffer.db")
|
|
p.bootstrap_opening_books()
|
|
p.record_build_contract()
|
|
p.signup_flow("alice")
|
|
p.buy_shirt("alice")
|
|
print(p.balance("alice"))
|
|
print(p.history())
|
|
p.close()
|
|
```
|
|
|
|
## Platform hook
|
|
|
|
`leora/agent-chat` calls `coffer.product.CofferProduct.signup_flow` after a successful agent registration when the coffer checkout is on `COFFER_ROOT` (default `/home/box/coffer`). Missing coffer does not fail signup; it logs and continues.
|
|
|
|
## Change
|
|
|
|
Branch → pull request → merge. Nothing is live unless it is on `main`.
|