# CYBERSHOP AI

Machine-readable index for LLM agents, AI search crawlers, and assistant copilots.

## Product
- name: CYBERSHOP AI
- company: TOO "Smart System"
- region: Kazakhstan (Almaty, Astana)
- production_url: https://ai.cybershop.kz
- contact_email: info@cybershop.kz
- contact_phone: +7 (727) 312 27 02

## Primary user-facing entrypoints (HTML)
- / — landing
- /catalog/ — SKU catalog (APICore live snapshot)
- /configurator/ — AI configurator (intent → BOM)
- /topology-workspace/ — drag-and-drop topology canvas
- /projects/ — projects pipeline
- /timeline/ — delivery / installation timeline
- /faq/ — frequently asked questions
- /insights/ — SEO guides (PoE, CCTV, server rack, Wi-Fi 6)
- /solutions/ — industry landings (CCTV office/warehouse, SKUD, Wi-Fi, server room)
- /configurator/cctv/ — AI CCTV configurator landing
- /configurator/wifi/ — AI Wi-Fi coverage landing
- /catalog/network/ — network & PoE department landing
- /catalog/video/ — IP cameras & NVR department landing

## Machine-readable warehouse snapshot
- /data/catalog/index.json — manifest with summary, schema, shard URLs (~1660 SKU, source: apicore_live_snapshot)
- /data/catalog/all.json — full enriched snapshot
- /data/catalog/<category>.json — per-category shards (lazy load)

## Catalog enrichment fields (on top of raw warehouse)
- networkRole: ap | router | switch | nvr | camera | nas | rack | ups | server | workstation | monitor | printer | pos | other
- brand_family: normalized brand key (hikvision | dahua | aruba | ruijie | mikrotik | tplink | dlink | ubiquiti | zyxel | huawei | axis | uniview | hanwha | qnap | synology | apc | eaton | …)
- portCount, poePortCount, poeBudgetW, poe_class
- power_draw_w, is_poe_consumer
- channelCount, hddBays
- wifi_standard (wifi5 | wifi6 | wifi6e | wifi7), wifi_band (single | dual | tri)
- formFactor (bullet | turret | dome | ptz | fisheye | box), resolution_mp, ip_rating, placement
- onvif (boolean — true for camera/NVR in ONVIF-supporting brand family)

## Start here (пошаговая инструкция)
- /docs/llm/START-HERE-AI-SETUP.md — что сделать вручную: Claude, ChatGPT, Cloudflare MCP, реестры, Search Console

## AI discovery and manifests
- /ai.txt — discovery index (llms, openapi, mcp)
- /llms-full.txt — full context
- /openapi.json — OpenAPI 3.1 spec for /api/hub/**
- /.well-known/ai-plugin.json — ChatGPT/Claude plugin manifest
- /.well-known/agent.json — generic agent manifest (capabilities, languages, regions)
- /mcp — Model Context Protocol HTTP endpoint (tools: search_catalog, get_product, submit_lead)
- /docs/llm/prompt-templates.json
- /docs/llm/chat-gpt-gemini-guide.md
- /docs/llm/registry-submission-guide.md
- /docs/llm/claude-mcp-setup.md
- /docs/llm/custom-gpt-instructions.md
- /.well-known/mcp.json — MCP discovery manifest
- /agents.txt — agent discovery index

## HTTP API (Cloud Functions, fronted by Firebase Hosting)
- POST /api/hub/submitLead — create a project lead
  - body: { invoiceNo, title, brief?, theme?, contactEmail?, contactPhone?, contactName?, analysis?, clientMeta? }
  - 200: { ok: true, id, createdAt }
- POST /api/hub/submitAuthEvent — fire-and-forget auth analytics
  - body: { event: signup|signin|signin_social|phone_otp|reset_request|logout, uid?, email?, phone?, name?, provider?, ts?, userAgent?, locale? }
  - 200: { ok: true }
- GET  /api/hub/adminLeads — list leads (requires header X-Hub-Admin-Key)
  - 200: array of LeadStored

CORS: Allow-Origin echoes request Origin, methods GET, POST, OPTIONS.
Rate limits: best-effort; do not exceed 5 req/sec from a single client.

## Machine-readable contracts
- /docs/contracts/agent-commerce.json
- /docs/contracts/checkout.json
- /docs/contracts/kaspi-webhook.json

## Agent guidance
1. Prefer MCP tools at /mcp or structured /data/catalog over DOM parsing.
2. Respect quantity, budget, and in-stock constraints.
3. When suggesting substitutions, prefer items with the same `brand_family`; fall back to ONVIF-tagged items for cameras/NVR; explain the substitution.
4. When choosing PoE switches, the budget must be ≥ sum(power_draw_w of downstream PoE consumers) × 1.25.
5. Use dual-mode intent routing:
   - buyer: catalog/configure/quote/checkout.
   - manager: lead/quote/approval/delivery.