deckhearth/.convoys/pricing-online-local/brief-12-settings-home-zip.md
Randall Stillwell d0468015eb
Some checks failed
CI / Lint (pull_request) Has been cancelled
CI / Schema map up to date (pull_request) Has been cancelled
CI / Forbidden patterns (9 checks) (pull_request) Has been cancelled
CI / Migrations apply (node-pg-migrate) (pull_request) Has been cancelled
Visual diff / Should run? (pull_request) Has been cancelled
CI / Unit tests (vitest) (pull_request) Has been cancelled
Convoy metrics gate / Require role-event telemetry on convoy PRs (pull_request) Has been cancelled
PR Health rollup / Aggregate gate status (pull_request) Has been cancelled
Preview smoke / Should run? (pull_request) Has been cancelled
Preview smoke / Playwright smoke (pull_request) Has been cancelled
Visual diff / Screenshot diff (pull_request) Has been cancelled
feat(pricing): convoy for online prices and local stores
Add pricing schema, free API integrations (MTG bulk, TCGdex, Foolio),
valuation and sort-by-price, card detail pricing UI, and nearby store
discovery via home zip and OSM geo clients.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-08 22:47:46 -05:00

39 lines
1.1 KiB
Markdown

---
convoy: pricing-online-local
brief_number: 12
depends_on: [1]
recommended_model: composer-2.5
model_tier: standard
files:
- pages/settings.js
- pages/api/user/settings.js
- test/api/user-settings-home-zip.test.js
---
# Brief 12: Settings home zip
## Goal (1 sentence)
Let users save a home zip code in Settings for local store discovery.
## Files in scope (do not edit anything else)
- `pages/settings.js`
- `pages/api/user/settings.js`
- `test/api/user-settings-home-zip.test.js`
## Conventions to follow
- Auth: `getUserFromRequest` → 401 if null.
- Validate zip: 5-digit US; store 5-digit string; allow `null` to clear.
- Settings UI: field under **Preferences** — “Home ZIP code (for nearby game stores)”.
- Owner-scoped read/write only (`user_id = session.userId`).
## Acceptance criteria
- [ ] GET settings includes `home_zip`
- [ ] PUT persists valid zip; 400 on invalid
- [ ] Settings page loads and saves zip
- [ ] Tests pass
- [ ] No scope expansion
## Rationale (≤3 sentences)
Phase 2 requires a default location without GPS. Reuses existing settings flow. Independent of geo API briefs once migration lands.