scan-flow: geolocation scan, location-aware SMS throttle (log sender), finder contact, sms_enabled toggle, branding — 19/19 phase-2 scenarios pass

README.md

@@ -1,11 +1,12 @@
-# WhereWoof — Local Pet Location Tracker
+# Where Woof — Return-Tag Platform
 
-Find your woof. A local pet location tracker with a front-facing website for pet owners (GOAT stack: Go + HTMX + Alpine.js + Tailwind CSS + SQLite).
+Find your woof. A return-item tag platform (PetHub/ReturnMe style) — *"Where Woof !"* (a play on *werewolf*). Pre-coded QR/NFC tags on your dog, baggage, skis, etc. A finder scans the tag and sees exactly how to return it — call, text, or leave their number; location is shared with the owner when the finder allows.
 
 ## Status
 
-Early design/development phase.
+GOAT front-end (Phase 1) built and verified — see `where_woof.md` for the full plan and roadmap.
 
-- Design docs: [where_woof.md](where_woof.md), [awesome-design.md](awesome-design.md)
+- Plan: [where_woof.md](where_woof.md), [awesome-design.md](awesome-design.md)
+- Specs & changes: `openspec/` (frontend-foundation ✅, scan-flow 🚧)
+- Front-end: `frontend/` (Go + HTMX + Alpine + Tailwind + Postgres)
 - Mockups: `mockups/`
-- Admin & frontend prototypes: `admin/`, `frontend/`