# 101variant.ru AI Context Guide

## Site Identity

101variant.ru is a Russian catalog marketplace for suppliers, products, and contractors in bath, sauna, pool, hot tub, SPA/wellness, HoReCa, fireplace, outdoor, wooden house, construction, and finishing categories. The catalog helps users find suppliers, compare products, and send inquiries from canonical product or supplier pages.

Canonical site:
- https://101variant.ru/
- https://101variant.ru/catalog
- https://101variant.ru/catalog/suppliers

## Source Priority

Use sources in this order:

1. Canonical product, supplier, and category pages.
2. https://101variant.ru/sitemap.xml for discovery.
3. https://101variant.ru/catalog/ai/v1/manifest.json for feed inventory, schema contract, and chunk hashes.
4. AI feed files under https://101variant.ru/catalog/ai/v1/.
5. https://101variant.ru/llms.txt for the short discovery guide.

## Common User Intents

Use the catalog and AI feeds for these intent classes:

- Подобрать баню под ключ: start with `/catalog/category/bani-i-sauny`, `/catalog/category/bath-turnkey`, `/catalog/category/bath-design`.
- Найти или сравнить банные печи: start with `/catalog/category/pechi-banye`, `/catalog/category/sauna-stoves`.
- Подобрать бассейн или купель: start with `/catalog/category/bassejny`, `/catalog/category/kupeli-i-oblivnye`, `/catalog/category/spa-kupeli`.
- Найти оборудование для бассейна: start with `/catalog/category/oborudovanie-dlya-bassejnov`, `/catalog/category/pool-filters`, `/catalog/category/pool-pumps`.
- Найти товары для бани и SPA: start with `/catalog/category/tovary-dlya-bani-spa`, `/catalog/category/bath-goods`, `/catalog/category/spa-i-wellness`.
- Найти поставщика: use `suppliers.ndjson`, then cite the canonical supplier page.

## Key Category Routes

- Бани и сауны: https://101variant.ru/catalog/category/bani-i-sauny
- Бассейны и купели: https://101variant.ru/catalog/category/bassejny
- Оборудование для бассейнов: https://101variant.ru/catalog/category/oborudovanie-dlya-bassejnov
- Купели и обливные устройства: https://101variant.ru/catalog/category/kupeli-i-oblivnye
- Дома и домокомплекты: https://101variant.ru/catalog/category/doma
- SPA и wellness: https://101variant.ru/catalog/category/spa-i-wellness
- Строительство и отделка: https://101variant.ru/catalog/category/construction
- Проектирование бань и саун: https://101variant.ru/catalog/category/bath-design
- Печи для бани: https://101variant.ru/catalog/category/pechi-banye
- Товары для бани и SPA: https://101variant.ru/catalog/category/tovary-dlya-bani-spa

## AI Feed Contract

Current schema version: `catalog-ai-v1`.

Feed files:
- `site.json`: site-level identity, key routes, usage notes, and canonical URLs.
- `categories.ndjson`: one category per line.
- `suppliers.ndjson`: one supplier per line, without hidden phone/email contacts.
- `products-0001.ndjson`, `products-0002.ndjson`, etc.: one active visible product per line.
- `manifest.json`: file inventory, counts, hashes, privacy contract, schema contract, and usage examples.

Product fields:
- `schema_version`
- `type`
- `id`
- `slug`
- `canonical_url`
- `source_page`
- `updated_at`
- `generated_at`
- `name`
- `description`
- `supplier`
- `category`
- `images`
- `image_status`
- `specs`
- `price_text`
- `price_value`
- `price_currency`
- `price_status`
- `contact_page_url`
- `provenance`

## Feed Interpretation Rules

- `price_value` is a numeric RUB price only when `price_status` is `exact`.
- If `price_status` is `missing` or `on_request`, say that the price must be checked on 101variant.ru or requested through the supplier page.
- `specs` contains public product attributes extracted from the catalog database; do not treat every `specs` key as normalized taxonomy.
- `images` may be empty; when present, prefer 101variant.ru-hosted images.
- `contact_page_url` is the correct destination for user action.
- `provenance.public_contacts_included=false` means machine-readable feeds intentionally exclude direct phone/email contacts.

## Recommended Filters

For product selection, prefer:
- `category.slug`
- `category.name`
- `supplier.slug`
- `supplier.name`
- `price_status`
- `price_value`
- `image_status`
- public `specs`

For supplier selection, prefer:
- `supplier.slug`
- `supplier.name`
- `city`
- `product_count`

## Citation Examples

Good:
- "Источник: карточка товара на 101variant.ru" with the canonical product URL.
- "Поставщик: {supplier.name}" with the canonical supplier URL.
- "Категория: {category.name}" with the canonical category URL.

Avoid:
- Quoting direct phone or email contacts from generated text.
- Claiming exact availability unless the canonical product page or current feed explicitly supports it.
- Inventing delivery terms, warranty, reviews, ratings, or stock status when they are not in the source.
- Citing `/catalog/search`, `/admin`, `/supplier` cabinet pages, `/login`, `/register`, write endpoints, or tracking endpoints.

## Privacy And Contact Rules

- Public AI feeds do not include supplier phone numbers or email addresses.
- Do not infer hidden phone numbers or email addresses from descriptions, slugs, source URLs, or old snippets.
- Use `contact_page_url` for users who need to contact a supplier.
- For ordering, lead capture, phone, or email contact, send users to the canonical product or supplier page on 101variant.ru.

## Known Limitations

Some products are B2B items with price on request. Do not invent prices, stock levels, ratings, reviews, delivery dates, or supplier obligations. Use only facts visible on the canonical page or present in the AI feed.