← Документация SDK

Карточка решения и реальные скриншоты

В каталоге GoChain и маркетплейсе Engine у продукта есть отдельная страница: назначение, функции, галерея, зависимости, ресурсы, проверка SDK, версии и агрегированная статистика установок.

Что подготовить

1. Опишите конкретные действия пользователя и результат. Например: «Пациент выбирает услугу, врача и свободное время; занятый слот недоступен». Рекламные утверждения из GPU-генерации не заменяют описание функций.

2. Укажите сценарии применения, необходимые настройки и ограничения. Разделяйте возможности пакета и стороннего сервиса, который нужно подключать отдельно.

3. Заполните `module.version`, `module.provides`, `requirements.python`, `requirements.capabilities`, `requirements.runtimes` и `requirements.resources` в штатном манифесте SDK.

4. Запустите продукт с демонстрационными данными. Снимите реальные экраны основных сценариев, включая мобильный вид. Не публикуйте токены, переписки, контакты клиентов и медицинские данные.

5. Привяжите снимки точного релиза к версии и SHA-256 артефакта. Снимки с действующего сайта без подтверждения версии маркируются как демо, а не как доказательство работы проверенного архива.

Формат доказательства снимка

Это отдельная презентация каталога, а не дополнительные поля строгого `yeti3-module.toml`. Операторский экспорт читает `media.json`; разработчику нельзя напрямую изменять публичный каталог.

{
  "file": "booking-desktop.png",
  "title": "Выбор свободного времени",
  "source_url": "https://clinic.royalreal.ru/",
  "captured_at": "2026-10-11T10:00:00Z",
  "scope": "release",
  "version": "1.3.1",
  "artifact_sha256": "<SHA-256 опубликованного ZIP>",
  "sha256": "<SHA-256 PNG>"
}

При изменении версии, хеша артефакта или файла прежний снимок точного релиза не допускается в актуальную галерею. Старые данные не удаляются. Текущая демонстрация может отображаться отдельно с явной пометкой, что версия пакета не подтверждена.

Автоматическое обновление

Служба `gochain-catalog-evidence.timer` сверяет каталог и результаты проверок каждые 10 минут. `gochain-catalog-capture.timer` проверяет разрешённые публичные демо каждые 15 минут, снимает изменившиеся продукты и обновляет снимки раз в сутки. На перегруженном общем сервере съёмка откладывается, а статус фиксируется как `DEFERRED_CAPACITY`.

Для подтверждения точного релиза демонстрационный runtime должен отдавать `X-Yeti3-Module-Version` и `X-Yeti3-Artifact-Sha256`. Без этих данных новый снимок остаётся демонстрационным. Автоматическая съёмка обслуживает зарегистрированные оператором URL; произвольные адреса пользователя, авторизованные сессии и закрытые страницы не принимаются.

Рейтинги и использование

- Автотесты: количество и результат из протокола лицензирования.

- Надёжность установки: успешные установки / все попытки, с обязательным размером выборки.

- Использование: число подтверждённых успешных установок. Не число покупок и не просмотры страницы.

- Совместимость: заявленные требования и неразрешённые зависимости. Итог проверяется на целевом сайте.

- Пользовательские оценки: при отсутствии проверенных отзывов показывается отсутствие оценок. Звёзды и отзывы не генерируются.

Рекламный текст ИИ отображается отдельно, как черновик. Ни завершение GPU-задания, ни наличие исходного архива не подтверждают готовность решения к установке.

Каталог GoChain ↗ · Маркетплейс Engine ↗