From d3a2070aed2c6be76d61d3be177732d4e46018fe Mon Sep 17 00:00:00 2001 From: Sam Rolfe Date: Sun, 6 Sep 2026 18:27:35 +1000 Subject: [PATCH] README: add basic Mermaid structure map (renders on Gitea home) --- README.md | 26 ++++++++++++++++++++++++++ todo.txt | 3 ++- 2 files changed, 28 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 36c4317..89ae65e 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,32 @@ 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. +## Structure at a glance + +```mermaid +flowchart LR + subgraph public["where-woof.com — public (Go + HTMX)"] + T[Tag QR/NFC] --> P["GET /t/:code"] + P --> S["POST /t/:code/scan"] + P --> C[finder contact] + O[/order/] --> BUY[Stripe Checkout] + end + subgraph admin["admin.where-woof.com — Laravel + Filament"] + A[Staff manage users/tags/orders/plans] + W["POST /webhooks/stripe"] --> D2["orders.status + tag transitions"] + end + subgraph core["Go frontend .13:3020"] + S --> G{"shouldAlert
paid sub · SMS pool · caps"} + G -->|pass| SMS["SMSGlobal → owner phone"] + G -->|record| DB["Postgres .13:5434"] + end + BUY --> W + A --> DB + DB --> D2 +``` + +*Interactive map:* [maps.lab.audasmedia.com.au/where_woof/docs/](https://maps.lab.audasmedia.com.au/where_woof/docs/diagrams/where-woof-flow.html) · *Source:* `docs/where-woof-flow.mmd` + ## Status GOAT front-end (Phase 1) built and verified — see `where_woof.md` for the full plan and roadmap. diff --git a/todo.txt b/todo.txt index 65b58df..71e719f 100644 --- a/todo.txt +++ b/todo.txt @@ -31,4 +31,5 @@ x 2026-09-01 (A) Red promo banner on tag/about/contact/what-is-this pages +proje x 2026-09-01 (A) Get in touch page: hello@where-woof.com + contact form +project:where-woof +agent:where_woof x 2026-09-01 (C) Verify coordinates in scan/location flow +project:where-woof +agent:where_woof (A) Go live: Stripe onboarding + live keys + live payment links +project:where-woof +agent:where_woof -(B) hello@where-woof.com email routing (Cloudflare/SES) +project:where-woof +agent:where_woof +x 2026-09-03 (B) hello@where-woof.com email routing (Cloudflare/SES) +project:where-woof +agent:where_woof +(B) SES production access approval + Cloudflare Email Routing (incoming hello@) +project:where-woof +agent:where_woof