DealGod's ScanGod POSTs camera-captured + bench-measured items; RecordGod resolves barcode→release_id (local disc_release_identifier 'Barcode' → Discogs fallback), enriches, stores MEASURED weight_g (overrides the 280g default → real AusPost quotes), dims_mm + scan_id → inventory.attributes, est_market_value, base64 condition photos → DISC_IMAGE_DIR/items/<sku>/ served at /img/item/<sku>/<n>. Lands staged (non-destructive review queue). Per-store-token auth (require_token). Smoke-tested live (barcode→release 782254, 312g measured, photo served). Contract answered in SCANGOD_BRIDGE_REPLY.md. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> |
||
|---|---|---|
| .claude | ||
| app | ||
| site | ||
| webstore | ||
| wp-bridge | ||
| .dockerignore | ||
| .gitignore | ||
| audio_sync.py | ||
| build_disc_cache.py | ||
| customer_woo_sync.py | ||
| disc_images_backfill.py | ||
| disc_sync.py | ||
| Dockerfile | ||
| migrate_virtual.py | ||
| migrate.py | ||
| README.md | ||
| RECORDGOD_AI_AGENT_BUILD.md | ||
| RECORDGOD_AI_AGENT_PLAN.md | ||
| RECORDGOD_NAVIGATOR_PLAN.md | ||
| RECORDGOD_PLAN.md | ||
| RECORDGOD_STOREFRONT_PLAN.md | ||
| refresh.sh | ||
| requirements-migrate.txt | ||
| requirements.txt | ||
| SCANGOD_BRIDGE_BRIEF.md | ||
| SCANGOD_BRIDGE_REPLY.md | ||
| schema.sql | ||
| shipping_sync.py | ||
| test_smoke.py | ||
| WAXMUSEUM_DEEPDIVE.md | ||
| WOWPLATTER_DEEPDIVE.md | ||
| WOWPLATTER_MIGRATION_AUDIT.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.