docs: expand scope to local retail alongside services

- Strategy §1a: brick-and-mortar services + local retail in scope
- Pure online e-com remains out (Shopify lane)
- ICP, NORTH_STAR, README, product docs aligned
- Add UC-03 general store (toothbrush / chicken strips case)
This commit is contained in:
VPS admin
2026-07-18 06:08:08 +00:00
parent 9478aaa22e
commit 4d04a4a65a
8 changed files with 257 additions and 100 deletions
+10 -15
View File
@@ -1,13 +1,13 @@
# Product overview
geolocal.io is **AI-readiness infrastructure** for local services. Assistants call structured endpoints. Businesses own their presence. Intermediates and partners help distribution. Booking and payments are orchestrated through specialists, not rebuilt here.
geolocal.io is **AI-readiness infrastructure** for **local businesses** with real-world presence — services **and** local retail. Assistants call structured endpoints. Businesses own their presence. Intermediates and partners help distribution. Booking, payment, and inventory systems are orchestrated through specialists where needed; we do not rebuild Shopify for pure online stores.
## Platform vs activation
| Layer | Responsibility |
|-------|----------------|
| **Platform** | Multi-tenant MCP, multi-path discovery pointers, ingestion/content sync, genre packs, telemetry, quality enforcement (including quarantine/decommission), intermediate aggregation |
| **Activation** | Self-Service Portal and assisted onboarding so ordinary operators can turn the platform on |
| **Platform** | Multi-tenant MCP, discovery attachment, ingestion/content sync, genre packs (services + retail), telemetry, quality enforcement, intermediate aggregation |
| **Activation** | Self-Service Portal and assisted onboarding |
| **Distribution** | Tourism boards, chambers, agencies |
The portal is how Model 1 scales. It is not the product definition of the company.
@@ -17,23 +17,18 @@ The portal is how Model 1 scales. It is not the product definition of the compan
| Surface | Audience | Status |
|---------|----------|--------|
| MCP gateway | AI agents | MVP in `code/` (stdio); HTTP is Priority 0 |
| Genre packs | Vertical structure for agents + owners | Specified; auto pack first via UC-01 |
| Self-Service Portal | SMB owners / delegates | Specified in strategy + [ssp.md](./ssp.md); not built |
| Intermediate MCP + board tools | Tourism boards / chambers | Specified via UC-02; not built |
| Genre packs | Vertical structure for agents + owners | Services + retail in strategy; auto pack first via UC-01; retail via UC-03 |
| Self-Service Portal | SMB owners / delegates | Specified; not built |
| Intermediate MCP + board tools | Tourism boards / chambers | UC-02; not built |
| Partner flows | Agencies / local web | Distribution; after core attach |
## Canonical use cases
- [UC-01 Endpoint — auto repair](./use-cases/uc-01-endpoint-auto-repair.md)
- [UC-02 Intermediate — tourism board](./use-cases/uc-02-intermediate-tourism-board.md)
- [UC-03 Endpoint — local retail / general store](./use-cases/uc-03-local-retail-general-store.md)
## Where we sit in the assistant journey
## Scope reminder
We barely try to own pure discovery SEO. We are primary for evaluation, selection, and complementary fulfillment, and second chair for interpretation and feedback. Detail: [Canonical Strategy §5](../strategy/CANONICAL_STRATEGY.md).
## Related
- [genre-packs.md](./genre-packs.md)
- [ssp.md](./ssp.md)
- [intermediate.md](./intermediate.md)
- Engineering priorities in the strategy, roadmap under `docs/engineering/`
In: brick-and-mortar and local presence (garage **and** general store).
Out: pure online commerce with no local footprint. Detail: [Canonical Strategy §1a](../strategy/CANONICAL_STRATEGY.md).