a304476645
Reframed from backend-only to three layers (Lighthouse measures speed, not records-features): A Discovery (clickable genre/artist/style/label, audio samples, find-in-store), B In-store ops (item location, store map, A-Z refile/crate-reorg — the deepest moat, nothing else does it), C Market intel (value/underpricing/scarcity/arbitrage — mostly Have today). Added per-feature matrix (layer / today / RecordGod / Shopify+Discogs-sync can't / build effort) + Jackson as co-design partner for the ops layer, not just a reference. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> |
||
|---|---|---|
| app | ||
| site | ||
| webstore | ||
| .dockerignore | ||
| .gitignore | ||
| build_disc_cache.py | ||
| Dockerfile | ||
| migrate_virtual.py | ||
| migrate.py | ||
| README.md | ||
| RECORDGOD_PLAN.md | ||
| refresh.sh | ||
| requirements-migrate.txt | ||
| requirements.txt | ||
| schema.sql | ||
| test_smoke.py | ||
| WAXMUSEUM_DEEPDIVE.md | ||
RecordGod
The records back-office engine — the best of WowPlatter, reborn on Postgres, outside WordPress.
RecordGod ingests WowPlatter's job (inventory, import, enrichment, labels, copy, queries) but not WowPlatter's code. It runs as its own service on the VPS, calls DealGod for market value, and feeds WordPress the tidy data it likes for the storefront.
WowPlatter is the ancestral founder — still running the live shop floor, and the reference spec RecordGod matches before it retires anything. Honour the founder: don't redesign what already works, copy it.
Start here
- RECORDGOD_PLAN.md — the plan, the map, the keep/drop triage, build order, and the open decisions. Read this first.
The family (sibling repos on this machine)
| Repo | What it is | Talks to RecordGod via |
|---|---|---|
../dealgod |
The market brain — cross-store value, arbitrage. Its own product. | RecordGod calls it (X-API-Key) for value |
../PRICEGOD |
The seller extension (Discogs cockpit). Successor to pliceclogs. | Calls RecordGod's wowplatter/v1 contract |
../wowplatter |
The founder — WP/WooCommerce plugin running the live store. | RecordGod publishes tidy data to it |
Briefs that define the contracts already live in ../PRICEGOD/DEALGOD_BRIEF.md and
../PRICEGOD/WOWPLATTER_BRIEF.md. All three still hold; RecordGod is who fulfils the
WowPlatter side of them.
Run it (dev)
python3 -m venv .venv && ./.venv/bin/pip install -r requirements.txt
RECORDGOD_TOKEN=dev-tok ./.venv/bin/uvicorn app.main:app --reload --port 8010
./.venv/bin/python test_smoke.py # self-check — no DB/infra needed
Postgres schema: psql recordgod < schema.sql.
Live now: GET /wowplatter/v1/ping, GET /wowplatter/v1/inventory/lookup?release_id=.
Routes 3–5 (price / labels / intake) are intentionally 404 — PRICEGOD reads that as
"pending" and degrades gracefully, so an undefined route is the correct "not built yet" signal.
Layout
app/
main.py FastAPI app + /healthz
db.py async SQLAlchemy over asyncpg (twin of DealGod's db.py)
auth.py require_token — Bearer; the one place the auth scheme lives
wowplatter_v1.py the contract router (ping + lookup live)
schema.sql minimal inventory table, release_id-keyed, store_id seam
test_smoke.py infra-free self-check
Status: founding — scaffold runs, smoke test green. 2026-06-19.