Ty_Tech/geolocal-io
6
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add salon and bakery genre pack shells

Browse Source 
Layer A/B/C surfacing direction plus Core 3 coverage notes.
This commit is contained in:
porbot
2026-09-15 17:44:37 +00:00
parent 05f3a88bc3
commit f0e0ef0131
4 changed files with 127 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/product/genre-packs.md
+24 -13
View File
@@ -1,23 +1,34 @@
# Genre packs
Generic business fields are scaffolding. Durable differentiation is **genre-specific primitives**.
**Structural direction (working):** three layers when surfacing work to owners — not one giant schema dump.
## Planned packs
| Layer | What | Owner hears |
| :--- | :--- | :--- |
| **A — Universal** | Discovery foundation: NAP + Core 3 claimed + hours + website + description + service-area mode + no duplicates/contradictions | Everyone’s first punch list |
| **B — Genre pack** | Thin ranked list for that vertical (secondaries, high-value attributes, services/menu shape, booking/links, maybe one vertical directory) | “For salons like yours, next is X” — never “schema” |
| **C — Known-for** | From the owner’s own words | Extra attributes/photos/proof + later AI-readiness queries |
- Auto repair (see [UC-01](./use-cases/uc-01-endpoint-auto-repair.md))
- Beauty
- Home services
- Tourism activity ([UC-02](./use-cases/uc-02-intermediate-tourism-board.md) context)
- **Local retail / general store** (see [UC-03](./use-cases/uc-03-local-retail-general-store.md)) — assortment signals, house specialties, hours, visit path
**Surface rule:** scorecard ladder first (exist → know what you do → would recommend), then **3–7 actions max**, sorted by impact. Genre pack ranks the backlog.
**Core 3 coverage rule:** **GBP** is richest; Apple Business Connect mid; Bing Places thinnest. Pack actions: set on GBP; mirror on Apple/Bing where the field exists.
## Deep example packs (planning-rev2)
- [Salon](./genre-packs/salon.md)
- [Bakery](./genre-packs/bakery.md)
## Earlier planned packs (from main / prior docs)
- Auto repair (see [UC-01](./use-cases/uc-01-endpoint-auto-repair.md))
- Beauty (overlaps salon — reconcile later)
- Home services
- Tourism activity ([UC-02](./use-cases/uc-02-intermediate-tourism-board.md))
- Local retail / general store ([UC-03](./use-cases/uc-03-local-retail-general-store.md))
## Why this matters
Assistants evaluate helpfulness by whether the business answers the *right* questions for its category. “Do you work on Korean transmissions?” is not the same shape as “Do you have a toothbrush?” or “Are the chicken strips still a thing?”
## Sequencing
Services packs may ship first for pilot speed. Retail is **in scope**, not a strategy exception.
Assistants evaluate helpfulness by whether the business answers the *right* questions for its category. Salon booking ≠ bakery known-for products.
## Detail source
[Canonical Strategy](../strategy/CANONICAL_STRATEGY.md) §1a and genre primitives.
Conversation checkpoint on `planning-rev2`; [BUSINESS_PLAN.md](../strategy/BUSINESS_PLAN.md); [Canonical Strategy](../strategy/CANONICAL_STRATEGY.md) §1a.
docs/product/genre-packs/bakery.md
+48
View File
@@ -0,0 +1,48 @@
# Genre pack — Bakery (deep example)
**Status:** working shell from planning conversation (not locked)
**Vertical:** local retail / food — products & known-for more than “book a slot”
**Assumes Layer A** (Discovery foundation) already ranked or clean.
**Core 3 rule:** set on **GBP** first; mirror on Apple Business Connect / Bing Places where the field exists. GBP = richest; Apple = mid; Bing = thinnest.
---
## Must address (beyond Layer A)
| Action (owner language) | Placeholder example | GBP | Apple Business Connect | Bing Places |
| :--- | :--- | :---: | :---: | :---: |
| Primary category (+ secondary if real) | Bakery; Cafe / Coffee shop if true | ✓ | ✓ | ✓ |
| Known-for in description | “sourdough & muffins” | ✓ | ✓ | ✓ |
| Hours accuracy | Weekends / early open correct | ✓ | ✓ | ✓ |
| Service options | dine-in / takeout / delivery | ✓ attributes | partial | partial |
| Ordering or menu URL | online order or PDF menu | ✓ (+ website) | link fields if present | link fields if present |
---
## High-value recommended
| Action | Placeholder / note | Core 3 coverage |
| :--- | :--- | :--- |
| Attributes (*only if true*) | outdoor seating, wheelchair accessible, wifi, kid-friendly, pet-friendly | **GBP-heavy**; Apple/Bing partial — mirror where fields exist |
| Products / proof for known-for | “homemade muffins” → products, photos, description + later AI-readiness queries | **Not** a Core-3 checkbox — don’t force fake attributes |
| Peak / holiday hours | Thanksgiving week, summer weekend rush | ✓ Core 3 when seasonal |
---
## Example ranked punch list (3–7)
If Layer A is clean, a bakery might see:
1. Set category Bakery (+ Coffee shop if true) on Core 3
2. Put “sourdough & muffins” in the short description everywhere
3. Confirm weekend / early-open hours on Core 3
4. Set dine-in + takeout on GBP; mirror where Apple/Bing allow
5. Add menu or order URL on GBP + website
6. Add 5 product photos (muffins, sourdough) on GBP
---
## Out of scope for this pack shell
Full Google food schema, delivery-marketplace integrations, MCP/endpoints.
docs/product/genre-packs/salon.md
+48
View File
@@ -0,0 +1,48 @@
# Genre pack — Salon (deep example)
**Status:** working shell from planning conversation (not locked)
**Vertical:** appointment-based beauty / hair
**Assumes Layer A** (Discovery foundation) already ranked or clean.
**Core 3 rule:** set on **GBP** first; mirror on Apple Business Connect / Bing Places where the field exists. GBP = richest; Apple = mid; Bing = thinnest.
---
## Must address (beyond Layer A)
| Action (owner language) | Placeholder example | GBP | Apple Business Connect | Bing Places |
| :--- | :--- | :---: | :---: | :---: |
| Primary category + 1–2 secondaries | Hair salon; Nail salon; Beauty salon | ✓ | ✓ | ✓ |
| Services list | Haircut, Color, Balayage, Blowout | ✓ strong | thinner — fold detail into description if no services field | thinner — same |
| Booking URL | Mindbody / Square / Booksy link | ✓ (+ website) | website / appointment link if present | link fields if present |
| Accessibility | Wheelchair accessible entrance | ✓ where offered | ✓ where offered | ✓ where offered |
---
## High-value recommended
| Action | Placeholder / note | Core 3 coverage |
| :--- | :--- | :--- |
| Attributes that match real ask patterns | women-led, LGBTQ+ friendly, wifi, parking — *only if true* | **Mostly GBP**; not all exist on Apple/Bing — don’t invent checkboxes there |
| Known-for specialties | “bridal hair,” “curly specialists” | description + photos + services on all Core 3 — **not** fake attribute checkboxes |
| 5–10 real work photos | before/after, salon floor (real, not stock) | **GBP / Apple** strong; Bing weaker |
| Staff / credentials | only if true | platform-specific; skip if none |
---
## Example ranked punch list (3–7)
If Layer A is clean, a salon might see:
1. Fix primary category (Hair salon) on Core 3
2. Add booking link on GBP + website
3. List top 4 services (Haircut, Color, Balayage, Blowout)
4. Add “curly specialists” to description (known-for)
5. Upload 5 real work photos on GBP
6. Mirror hours + booking URL on Apple Business Connect
---
## Out of scope for this pack shell
Full Google attribute schema, review response playbooks, MCP/endpoints.
docs/strategy/BUSINESS_PLAN.md
+7
View File
@@ -115,6 +115,12 @@ Checked *on* the Core 3 (and the site). Prerequisite for 2027 work **when flaws
**Foundation sync (P1)** across Core 3: NAP + primary category + hours + website URL + short description + service-area/address mode. Phone lives in NAP but must match. P2 (attributes, photos, menus, booking, secondary categories) is genre/known-for gated — not universal min-bar.
### Surfacing work to owners (working direction — essence)
Three layers (not one giant schema): **A** universal Discovery foundation → **B** thin genre pack → **C** known-for overlay. Scorecard first, then 3–7 actions max by impact.
Deep example packs: [`docs/product/genre-packs/salon.md`](../product/genre-packs/salon.md), [`docs/product/genre-packs/bakery.md`](../product/genre-packs/bakery.md). Index: [`docs/product/genre-packs.md`](../product/genre-packs.md).
### Validation gate (working direction — essence)
Anyone using GeoLocal tools must pass a **business-representation check** first (e.g. prove control of a contact channel tied to that business). Mechanism details and free/silver/gold allotments stay open until COGS is real — only the gate itself is directional essence so far.
@@ -174,6 +180,7 @@ If something here conflicts with `CANONICAL_STRATEGY.md`, resolve on purpose in
| 2026-09-15 | Essence: owner vocab Core listings / Core 3; 2017 foundation six-point bar checked on Core 3 + site |
| 2026-09-15 | Essence: two tiers — Discovery foundation → AI readiness (owner names); measure both early, fix foundation first when broken |
| 2026-09-15 | Essence: P1 foundation sync = NAP + category + hours + website + description + service-area mode; P2 genre/known-for gated |
| 2026-09-15 | Essence: Layer A/B/C surfacing; deep pack shells for salon + bakery under docs/product/genre-packs/ |
---