# FlowerStore.ph / Potico — LLM agent orientation

> FlowerStore.ph (PH flowers) and Potico (gifting specialty; PH, SG, TH, VN) are multi-tenant, same-day flower and gift delivery storefronts in South-East Asia. Each brand/country is a separate tenant served on its own domain with its own catalogue, pricing, and delivery hubs. The links below are relative and resolve against whichever tenant domain you are on; for programmatic product discovery, prefer the search APIs and the sitemap.

The storefront is a Vue + Inertia single-page app: initial product data is embedded in the page's `application/json` Inertia prop blob on first load. Products, pricing, and stock are scoped to a fulfilment **hub** (a city / area), resolved from the visitor's city cookie, a `?hub_id=` query parameter, or the tenant's default hub — a query without a hub returns the default hub's results. Catalogue structure is Categories → Sub-categories → Products (with variants: slug, name, price, image); Collections are curated thematic groupings (e.g. "Roses", "Best Sellers") and Campaigns are time-limited promotions. Languages: PH and SG English (default), TH Thai, VN Vietnamese — each with an English fallback; non-default languages use a path prefix such as `/th/product/…` or `/vn/product/…`. Cart and checkout require CSRF authentication and are not exposed as public APIs.

## Key resources

- [Homepage](/): the current tenant's storefront.
- [Sitemap index](/sitemap.xml): authoritative indexable URLs for the current tenant — products, collections, sub-categories, campaigns, blogs, and pages.
- [Robots](/robots.txt): crawl rules; GPTBot, ClaudeBot, PerplexityBot, and Google-Extended are explicitly allowed.

## Public search APIs

No authentication; tenant- and hub-scoped; JSON `POST` bodies; each response includes a `data` array of products (id, name, slug, price, image).

- [Keyword search](/api/search/product): body `{ "query": string, "hub_id"?: number, "per_page"?: number }` → paginated products for the current tenant and hub.
- [AI / semantic search](/api/search/ai): body `{ "query": string, "hub_id"?: number }` → AI-ranked products with reasoning; rate-limited to 15 requests per minute per IP.

## Optional

- [FlowerStore.ph (PH)](https://flowerstore.ph/): Philippines flower storefront (English).
- [Potico PH](https://potico.ph/): Philippines gifting-specialty storefront (English).
- [Potico SG](https://potico.sg/): Singapore gifting storefront (English).
- [Potico TH](https://potico.th/): Thailand storefront (Thai, English fallback).
- [Potico VN](https://potico.vn/): Vietnam storefront (Vietnamese, English fallback).