# Edge Cases: Маркетплейс готовых ИИ-агентов > **Дата:** 2026-08-26 | **Источник:** PRD + User Stories + Acceptance Criteria > **Ревизия:** 2026-08-27 | **Основание:** `product/00-research-evidence-base.md` (27.08.2026, ~70 источников, ~60 карточек T1/T2) | **Версия:** 1.1 > **Ревизия 2026-08-27 — что изменилось и почему:** > - Добавлены EC-21 autoupdate без отката (ZIP 2.1.243 SIGSEGV) — silent-update запрещён, npx-first + веб-фолбэк, rollback, `doctor --check`. > - Добавлен EC-22 миграция модели Polza DeepSeek V4 (Находка 9, H: Масленников 3000ч, «экосистема быстрее человека») — пин моделей, регресс 15 сборок, блок публикации при красном. > - Добавлен EC-23 терминал-страх: отказ от терминала у не-программистов (Находка 3, H/T1: Симаков, Меркушев, QualCoder — барьер №1; но Кузнецов/Xcom-shop/Mасленников доказывают: способен с installer+doctor+бот-коуч). > - Добавлен EC-24 1С без REST / отсутствие API в РФ (Находка 11, H: VPN + оплата Claude Pro $20, chmv посредники, Воронин/MTS WS — MCP незрелая) — честная карточка «что НЕ делает». > - Связанные правки PRD: `product/13-deliver-prd.md` Rev 2026-08-27 (FR-18…FR-24, NFR-6…NFR-8); Stories: `product/14-deliver-user-stories.md` Rev 2026-08-27 (US-13…US-15); AC: `product/15-deliver-acceptance-criteria.md` Rev 2026-08-27 (AC-32…AC-52). --- ## 1. Пользовательский путь | # | Edge Case | Ожидаемое поведение | Приоритет | |---|---|---|---| | EC-1 | Пользователь нажимает «Купить» без выбора платформы | Система предлагает выбрать платформу перед переходом в Telegram | High | | EC-2 | Пользователь переходит в Telegram, но не подтверждает покупку | Заявка остаётся в статусе «new»; администратор может связаться через 24 часа | Medium | | EC-3 | Пользователь покупает агента, но не устанавливает | Через 3 дня бот отправляет вопрос: «Удалось ли установить?» | Medium | | EC-4 | Пользователь пытается купить бесплатного агента | Кнопка «Купить» не отображается для бесплатных; только «Получить бесплатно» | High | | EC-5 | Пользователь запрашивает агента, которого нет в каталоге | Бот отвечает: «Этот агент пока не доступен» + ссылка на каталог | Low | --- ## 2. Telegram-бот | # | Edge Case | Ожидаемое поведение | Приоритет | |---|---|---|---| | EC-6 | Бот не может отправить архив (размер >50 МБ) | Бот сообщает об ошибке; администратор получает уведомление | High | | EC-7 | Пользователь отправляет сообщение, не начиная с команды | Бот распознаёт контекст или предлагает начать с /start | Medium | | EC-8 | Два пользователя одновременно запрашивают один архив | Бот обрабатывает параллельно; каждый получает свой архив | Medium | | EC-9 | Администратор не подтверждает оплату >24 часа | Пользователь получает напоминание; заявка помечается как «ожидание» | Medium | | EC-10 | Пользователь блокирует бота после покупки | Заявка сохраняется; администратор может связаться через Telegram | Low | --- ## 3. Оплата | # | Edge Case | Ожидаемое поведение | Приоритет | |---|---|---|---| | EC-11 | Пользователь оплатил, но администратор не подтвердил | Через 24 часа → напоминание администратору; через 48 часов → уведомление владельцу | High | | EC-12 | Пользователь требует возврат | Администратор обрабатывает вручную; статус «refund» | Medium | | EC-13 | Пользователь оплатил дважды | Администратор видит дублирующие заявки; возвращает излишек | Medium | --- ## 4. Установка | # | Edge Case | Ожидаемое поведение | Приоритет | |---|---|---|---| | EC-14 | Установка завершается ошибкой | Пользователь получает: описание ошибки, список требований, неуспешный шаг, рекомендацию, ссылку на поддержку | High | | EC-15 | Пользователь устанавливает на неподдерживаемую ОС | Инструкция содержит требования; при ошибке — рекомендация по альтернативе | Medium | | EC-16 | Пользователь устанавливает старую версию | Бот предлагает обновление через 7 дней | Low | --- ## 5. Технические | # | Edge Case | Ожидаемое поведение | Приоритет | |---|---|---|---| | EC-17 | Сайт недоступен | Страница ошибки с контактами | High | | EC-18 | Бот недоступен | Сообщение: «Бот временно недоступен. Попробуйте позже.» | High | | EC-19 | База данных повреждена | Бэкап + восстановление; уведомление администратору | High | | EC-20 | Архив повреждён при отправке | Пользователь получает ошибку; администратор отправляет повторно | Medium | --- ## 6. Обновления, миграции, рантайм (Rev 2026-08-27) > Уроки: ZIP 2.1.243 SIGSEGV + Polza DeepSeek V4; Находки 9 (H), 3 (H/T1), 5 (H). PRD NFR-7/NFR-8, FR-23/FR-24; AC-45…AC-52; Stories US-15. | # | Edge Case | Ожидаемое поведение | Приоритет | |---|---|---|---| | EC-21 | Autoupdate без отката (кейс ZIP 2.1.243: SIGSEGV при старте после silent-обновления) | Запрет silent autoupdate — обновление только по явной команде `upgrade` с подтверждением; при SIGSEGV/crash `doctor --check` показывает `E_RUNTIME` + предлагает `rollback` на `previous_version` + веб-фолбэк (npx-first + веб-фолбэк); все краши логируются в `install_result`; 100% 15 сборок зелёные на чистой среде — гейт релиза (PRD NFR-7) | High | | EC-22 | Миграция модели ломает сценарии (кейс Polza.ai DeepSeek V4: «встали сценарии, вырос счёт») | Пин `pinned_model` в Kit'е; новая модель — новая `kit_version` + регресс 15 сборок (`dry-run` smoke) перед публикацией; при красном — публикация блокируется, покупатели получают уведомление «оставайтесь на — чиним»; инструкция миграции — одна строка `npx @smarket/agent-kit upgrade ` | High | --- ## 7. Установка, интеграции, барьеры РФ (Rev 2026-08-27) > Находки 3 (H/T1), 8 (M-H), 11 (H); Stories US-13/US-14; AC-32…AC-44. | # | Edge Case | Ожидаемое поведение | Приоритет | |---|---|---|---| | EC-23 | Терминал-страх: предприниматель отказывается открывать терминал («туплю в командную строку», QualCoder копирует ошибки, Меркушев гуглит термины) — бросает установку на первом шаге | One-command `npx @smarket/agent-kit install` без `npm install -g`/`pip install`/`git clone`; `doctor --check` даёт «зелёную галочку» или явный код `E_NODE`/`E_TOKEN`/`E_PERM`/`E_NETWORK` с «что делать»; Telegram-бот как AI-коуч — «пришли скриншот/вставку — подскажем» (`/doctor`); метрика — `time-to-first-successful-task <15 мин`, а не «скачал ZIP»; карточка честно пишет «Что подготовить» до покупки (P1-5/6) | High | | EC-24 | 1С без REST / отсутствие публичного API; MCP-инфраструктура в РФ незрелая (Воронин, МТС WS); Claude Pro $20/мес + VPN + оплата через посредников 10–34% (chmv), клиент уже устал до первого прогона | Карточка агента честно раскрывает: «Что НЕ делает» (напр., «не пишет напрямую в 1С без REST — только через выгрузку CSV/обработку»), «Какие доступы запрашивает», «Что подготовить» (VPN, оплата Claude Pro, ключ) — отсутствие блока блокирует публикацию (AC-37); guardrails по умолчанию — `dry-run` + локальное хранение токенов; онбординг «Claude Code из РФ» (P1-7) идёт перед установкой; Telegram control-plane — на будущее, не обещать «агент сам закажет/купит» в MVP | High |