63 lines
3.2 KiB
Markdown
63 lines
3.2 KiB
Markdown
# Where Woof — Return-Tag Platform
|
|
|
|
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
|
|
|
|
GOAT front-end (Phase 1) built and verified — see `where_woof.md` for the full plan and roadmap.
|
|
|
|
- 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/`
|
|
|
|
## Testing the site (dev)
|
|
|
|
Everything runs from this repo on `.27`. SMS is in **log mode** by default — no real SMS is sent until SMSGlobal credentials are set; instead you'll see `SMS to …` lines in the server log.
|
|
|
|
### 1. Start it
|
|
|
|
```bash
|
|
make db-up # apply schema (idempotent — safe to re-run)
|
|
make seed # insert 25 test tags: TEST000001 .. TEST000025
|
|
make run # http://localhost:3020
|
|
```
|
|
|
|
### 2. Create an account (fill in the form)
|
|
|
|
Click **Register** (top right) → name, email, password (≥ 8 characters). You're logged in automatically and land on **My Tags**.
|
|
|
|
### 3. Claim a tag (owner side — the form)
|
|
|
|
- On **My Tags**, enter a code like `TEST000001` → **Add tag**. It appears as *Unset*.
|
|
- Click **Edit** and fill the form: item type (Dog), description (e.g. Shadow), photo URL, **phone number (e.g. +61432374487)**, address, notes, and the *Send me SMS alerts* checkbox. Save → status becomes *Active*.
|
|
|
|
### 4. The finder experience (the URL that works)
|
|
|
|
Open **http://localhost:3020/t/TEST000001** in a **private/incognito window** (that's the finder — no login):
|
|
|
|
- It asks for your location → **Allow**. Watch the server log — an `SMS to` line appears with the map link.
|
|
- Deny instead → the page still works, and a **“Re-check my location”** button appears; click it and allow to send the location after all.
|
|
- **Send an SMS** link → opens your phone's SMS app with the owner's number prefilled.
|
|
- **Leave your number** → submit a mobile → the owner gets an SMS with the finder's number (also stored on the scan).
|
|
|
|
### 5. Throttle behaviour (repeat scans)
|
|
|
|
- Scan the same tag at the same location twice within 10 minutes → only **one** SMS.
|
|
- Scan again from > 250 m away within the window → a **second** SMS (it moved).
|
|
- Wait 10+ minutes → the next scan alerts again.
|
|
|
|
### 6. Info-only tag
|
|
|
|
Uncheck *Send me SMS alerts* on the edit form → scans are recorded but no SMS is sent.
|
|
|
|
### 7. Watching the SMS
|
|
|
|
In log mode: `tail -f /tmp/ww-server.log` and look for `SMS to`. With real SMSGlobal credentials (`SMS_API_KEY` / `SMS_API_SECRET` env vars), the owner's phone receives the text.
|
|
|
|
### Notes
|
|
|
|
- **Geolocation requires HTTPS** except on `localhost` — testing on a phone over the LAN needs the Caddy/TLS deployment (Phase 7) or `localhost`.
|
|
- Reset the database any time: `make db-up` re-applies the schema (idempotent); drop the `wherewoof-db` container volume for a truly fresh start.
|
|
- Automated suites live in `/tmp/verify.sh` (Phase 1, 22 checks) and `/tmp/verify2.sh` (Phase 2, 19 checks) — they reset the DB themselves.
|