# JR Madeiras App

> Documentation workflows built for focused technical teams.

## Public pages

- [Home](https://example.com/): App workspace overview.
- [CRUD workspace](https://example.com/crud): Manage typed documentation items.
- [Inventory search](https://example.com/search): Sign-in required. Semantic product search in Portuguese, ranked by confidence percentage. Grounding ids: `inventory-search-input`, `inventory-search-results`, `inventory-result` (with `data-sku`), `inventory-result-confidence`, `inventory-search-empty`, `inventory-search-error`, `inventory-search-loading`, `inventory-search-retry`.

## Machine-readable endpoints

- [API items endpoint](https://example.com/api/items): Read and manage item records.
- [Inventory search endpoint](https://example.com/api/inventory/search?q=deck&limit=10): `GET`, sign-in required. `q` is 2 to 200 characters, `limit` is 1 to 20 (default 10). Answers `{ success, data, meta: { count, minConfidencePercent } }`; each hit carries `sku`, `name`, `description`, `category`, `species`, `dimensions`, `unit`, `priceCents`, `stock`, `typicalUses`, `confidencePercent`. `confidencePercent` estimates the share of hits at that score judged relevant. No match is `200` with `data: []`; `401` means sign in again; `502` and `503` mean search is down, never that nothing matched. The tenant comes from the session, never from the query.
- [Sitemap](https://example.com/sitemap.xml)
- [Robots policy](https://example.com/robots.txt)