Commit History

РОЛЬ Ты — Chief Product & Tech Architect с сильной экспертизой в NLP/LLM и поведенческом дизайне. Спроектируй, опиши и частично сгенерируй MVP «Должанская GO» — локальный «суперсервис отдыха» (ст-ца Должанская, Азовское море). Формат: PWA (offline-first) + упаковка в Google Play и App Store (без двойной разработки). NORTH STAR и МЕТРИКИ Северная звезда: лиды/сутки (гость→владелец). Вторичные: конверсия заявки→лид, оплата поднятий/PRO, WAU/DAU, Retention хозяев (М1/М2), % офлайн-сессий, точность модерации «Честной карты». 1) АУДИТОРИЯ, БОЛИ, ЦЕННОСТЬ Гости: быстро найти нормальное жильё; где чисто/без медуз; как доехать на косу; где поесть/аптека/банкомат; что сегодня происходит; офлайн-режим. Местные/владельцы: простой канал заявок без сложных кабинетов; быстрый запуск с телефона; честные отзывы; «умные цены» по сезону; продвижение. Карта болей → фичи Медузы/грязь/шторм → «Честная карта пляжей» (крауд-репорты с фото, модерация, бейдж «Проверено»). Долгая коса → «Режим Коса» (покрытие, парковки, лайв-репорты). Отключения → «Статус-центр» (электричество/вода/связь) + офлайн чек-листы. Ветер/споты → «Ветро-дашборд» (напр./скорость, кайт/сап-школы, аренда). Еда/быт → карта столовых/кафе/аптек/банкоматов (фильтры «детское меню/туалет/коляска»). Онбординг хозяев → подача объявления через Телеграм-бот/голос/текст за 3–5 минут + модерация в 1 клик. 2) НЛП-ИНТЕРФЕЙСЫ (ФРОНТ) 2.1 Естественно-языковой поиск (NL-Search) Запросы вида: «до 3к ₽, 10 мин до пляжа, кухня, парковка, можно с коляской». Требования: гибридный поиск (BM25 + векторы/pgvector), опечатки/синонимы/морфология RU, транслит ru↔en, числовые/относительные параметры («поближе», «дешевле»). Отдавай и список, и объяснимость («почему в выдаче»). 2.2 Диалоговый ассистент «Гид Должанской» (чат) Инструменты (function calling): find_listings, get_beach_status, get_wind_spots, route_to_spot, create_lead, owner_onboard, report_beach, list_events. Сценарии: бриф → уточнения → 3–5 вариантов → сбор лида → «что ещё подсказать?». 2.3 Голос STT для запросов, TTS для навигации/алертов. Режим «Еду на косу» — голосовые предупреждения. 2.4 NL-онбординг хозяина Свободный текст/голос → парсинг в поля: адрес/цена/удобства/дистанция/контакты → геокодинг и автогенерация описаний (2 тона, 3 заголовка A/B). 3) НЛП-ЯДРО (БЭКЭНД/ДАННЫЕ) Поиск: гибрид (BM25 + sentence-transformers эмбеддинги) + лемматизация/орфо/транслит; pgvector. Рекомендации: контент-бейз + популярность + гео + погода/ветер + сегмент. Дедуп: сим-поиск по названию/телефону/адресу/фото (pHash) + правила склейки. Модерация: токсичность/спам/NSFW, политика фото/текста, LLM-верификация + human-in-the-loop; строгий JSON-вердикт. RAG-FAQ: база локальных правил/советов (шторм/медузы/ожоги/парковки/коса). Ответы строго по JSON-контракту. Сентимент/темы: из отзывов/репортов → приоритизация ленты и карт. 4) ОСНОВНОЙ ФУНКЦИОНАЛ MVP Каталог жилья: карточки с фото, ценами, занятостью, фильтрами; быстрый контакт/заявка в 1–2 клика (телега/звонок/форма). Карта (MapLibre/OSM): офлайн-тайлы/POI; поиск пляжей/остановок/кафе/аптек/банкоматов; маршруты. «Честная карта пляжей»: крауд-репорты (медузы/водоросли/чисто/шторм) + модерация + рейтинг доверия репортёра. «Режим Коса»: подсказки по дороге/парковкам, предупреждения о покрытии. Ветро-дашборд: ветер/волна/споты, аренда/школы. Афиша «Сегодня»: события/акции/шторм-алерты, офлайн-кеш дайджеста. ONBOARD хозяина: через бота/веб; модерация, предпросмотр, запуск. Избранное/шаринг и мультиязык (RU в MVP; EN заложить). 5) ТЕХСТЕК И ИНФРА Клиент: Next.js (App Router) + React, PWA (Service Worker: кеш тайлов/POI/карточек/избранного/черновиков; SWR). MapLibre GL JS. Бэкенд/БД: Postgres + pgvector (или Supabase: Auth/DB/Storage/Edge). Интеграции: n8n — импорт погоды/ивентов, модерация, антиспам, публикации в телеграм. Telegram-бот — лиды/уведомления, NL-онбординг хозяев. Платежи — поднятия/закрепления/PRO/лиды (песочница). Деплой: Docker на VPS, CDN для статики/тайлов, CI/CD (GitHub Actions). Нефункциональные: LCP ≤ 2.5s (4G), WCAG AA, приватность/куки, логирование (server-side события). 6) СХЕМЫ/КОНТРАКТЫ (вставь в ответ полностью) 6.1 JSONSchema для NL-поиска (парсер запроса) { "$schema":"http://json-schema.org/draft-07/schema#", "title":"NLQuery", "type":"object", "properties":{ "price_max":{"type":"number"}, "guests":{"type":"number"}, "distance_to_beach_max":{"type":"number"}, "amenities":{"type":"array","items":{"type":"string"}}, "suitable_for":{"type":"array","items":{"type":"string"}}, "parking":{"type":"boolean"}, "with_kitchen_nearby":{"type":"boolean"}, "geo_bbox":{"type":"array","items":{"type":"number"}, "minItems":4, "maxItems":4}, "sort":{"type":"string","enum":["relevance","price_asc","distance","rating"]}, "constraints":{"type":"array","items":{"type":"string"}} }, "required":[] } 6.2 Функции ассистента (function calling) — сигнатуры [ {"name":"find_listings","params":{"nl_query":"NLQuery"}}, {"name":"get_beach_status","params":{"lat":"number","lon":"number"}}, {"name":"get_wind_spots","params":{"date":"string"}}, {"name":"route_to_spot","params":{"from":{"lat":"number","lon":"number"},"to":{"lat":"number","lon":"number"}}}, {"name":"create_lead","params":{"listing_id":"string","contact":{"phone":"string","tg":"string"},"note":"string"}}, {"name":"owner_onboard","params":{"free_text":"string","photos":["string"],"contact":{"phone":"string","tg":"string"}}}, {"name":"report_beach","params":{"free_text":"string","photo":"string","geo":{"lat":"number","lon":"number"}}}, {"name":"list_events","params":{"date":"string","bbox":[0,0,0,0]}} ] 6.3 Модерация — строгий JSON-вердикт { "approve": true, "reasons": [], "flags": {"nsfw":false,"spam":false,"scam":false,"dup_suspect":false}, "suggested_fixes": ["перефразировать заголовок без криков", "уточнить расстояние до пляжа"], "risk_score": 0.12 } 6.4 RAG-FAQ — контракт ответа { "answer":"string", "sources":[{"title":"string","url":"string"}], "confidence":0.0 } 7) ДАННЫЕ/БД (Postgres + pgvector) — требуемые сущности users, hosts, listings, leads, poi, beach_reports, events, weather, news, favorites, payments, abuse_reports, embeddings. Требуй DDL с индексами: гео (GIN), полнотекст (tsvector), векторы (vector). Триггеры: нормализация телефонов, транслитерация, актуализация tsvector. 8) ОФФЛАЙН-FIRST (обязательно) Что кешируем: тайлы, POI, последние листинги/карточки, избранное, черновики заявок/объявлений, дайджест «Сегодня». Стратегии: Stale-While-Revalidate, фоновые обновления, очереди отправки заявок при потере сети, graceful-degradation. 9) МОНЕТИЗАЦИЯ Размещение — бесплатно. Поднятия/закрепления: 99–299 ₽/нед (динамика по спросу/сезону). Платные лиды: 39–99 ₽/подтв. контакт (анти-фрод). PRO-подписка: 499–999 ₽/мес (приоритет, аналитика спроса, «умные цены», бейдж). Партнёрки: 10–20% (прокат/экскурсии/еда). Натив-объявления в ленте «Сегодня». НЛП-подсказки цен хозяевам и адаптивный paywall по сегменту/намерению. 10) АНАЛИТИКА, A/B События: NL-запрос → парсинг → просмотр/клик → лид → оплата; репорт пляжа; офлайн-сессии. KPI: заявки/визит, лид-конверсия, точность NL-парсинга, % высокодоверительных RAG-ответов, NPS. A/B: микрокопия/CTA/порядок фильтров/варианты paywall; бандиты (ε-greedy/Thompson). 11) ГОТОВЫЕ АРТЕФАКТЫ (СГЕНЕРИРУЙ СЕЙЧАС, В ОДНОМ ПАКЕТЕ) Одностраничный обзор продукта (1–2 абзаца). User Stories + CJM (Гость/Хозяин) с NL-вводом/чатом/голосом. Сайт-мап и текстовые вайрфреймы (Каталог, Карточка, Карта, Честная карта, Режим Коса, Заявка, Чат-гид, NL-поиск, Голос, Онбординг хозяина, PRO/Paywall, Профиль, Оффлайн). Архитектурная схема (PWA, API, БД, векторный поиск, n8n, бот, очереди, кеш). Полный SQL-DDL (включая vector-столбцы и индексы). REST/GraphQL спека + контракты из раздела 6 (JSONSchema/вердикт модерации/RAG). NLP-пайплайны (поиск/дедуп/модерация/рекомендации/RAG) с псевдокодом и параметрами. Микрокопия (5 сегментов × 3 варианта CTA/экран), офлайн/ошибки/FAQ. Монетизация: тарифы, сценарии выручки (песс/база/опт), юнит-экономика (таблица). A/B-план (5 гипотез, метрики, критерии победы). Риск-реестр (сезонность/контент/фрод/сеть) + план снижения. Репозиторий-скелет и структура: /app (Next.js PWA) /server (Edge/Nest) /packages/shared /infrastructure/docker /docs (specs, wireframes) /n8n (flows) /telegram-bot docker-compose.yml (web, db, storage/edge, n8n, bot) и .env.example. Сиды БД (10 листингов, 20 POI, 8 beach-репортов, 5 событий) — реалистичные/локальные. Тест-критерии: e2e сценарии NL-поиска, чат-гида, голосового ввода, онбординга хозяина, офлайн-очередей. 12) КРИТЕРИИ ПРИЁМКИ (QUALITY GATES) PWA: Installable, офлайн-режим для каталога/карты/избранного/черновиков/репортов; Lighthouse PWA-аудит проходит. NL-поиск корректно парсит ≥90% тест-запросов (intent+slots), есть fallback к ручным фильтрам. Чат-гид закрывает сценарии «подбери жильё→оформи лид», «как доехать на косу», «есть ли медузы сегодня?». Онбординг хозяина из свободного текста создаёт валидную карточку (адрес/цена), генерит 2–3 описания. Модерация отдаёт строгий JSON, покрывая токсичность/спам/NSFW/дубли. Монетизация активна: поднятия/PRO/лиды (песочница), paywall адаптивен. Настроены события/дашборды; доступен A/B. KPI пилота, 30 дней: ≥300 WAU, ≥3% заявки/визит, ≥60% подтверждённых лидов, ≥10 платящих хозяев. - давай сделаем под ключ! - Initial Deployment
00dc017
verified

Demom commited on

initial commit
dce0d0d
verified

Demom commited on