# Карта возможностей и источников

## Продукт

- **Market:** публичный каталог Chrome Web Store без аккаунта; поиск по словам и по смыслу, конкуренты, история аудитории, рейтинга и листинга. Market помогает исследовать идею, но его публичные данные не являются аналитикой собственного расширения.
- **Листинг:** черновик до публикации, название, описания, изображения, целевые слова и аудит карточки Chrome Web Store.
- **Hosted-страницы:** главная страница, welcome, uninstall-опрос, Rate Us с отдельной формой после выбора звезды, политика конфиденциальности. Стандартные ссылки на extpage.app; свой домен и субдомен доступны через настройки. Индексация зависит от адреса и настроек публикации.
- **События и аналитика:** установки, удаления, возвраты, причины ухода, feedback, страны и сравнение с публичными данными магазина. Панель показывает портфель нескольких проектов.
- **CRM обратной связи (Indie, Studio, Fleet; триал не открывает):** сообщения виджета от опознанных пользователей группируются в людей (подтверждённые и неподтверждённые отдельно, анонимные остаются в ленте), лента человека со статусом «Открыто / Решено» и личной заметкой, ответы из панели и «Ответить из почты», раздел «Обращения» веб-приложения по всем проектам, переписка в виджете для подтверждённых людей, карточка клиента и хранение переписки без срока. Удаление человека работает на любом тарифе.
- **Карточка клиента (часть CRM обратной связи):** рядом с перепиской подтверждённого человека панель показывает карточку, которую по подписанному запросу отдаёт HTTPS-эндпоинт владельца: план, платежи, счётчики продукта, ссылки в админку владельца, действия копирования и prompt. Настраивается в «Настройке» проекта, секция «Виджет обратной связи», подраздел «Карточка клиента»: адрес, секрет (`ccs_…`, только для сервера), «Проверить»; вкладка «Обратная связь» карточку только показывает. Карточку мы не храним; для неподтверждённых людей карточки нет.
- **Баннеры и знак подтверждённого автора:** у каждого расширения и плагина из каталога есть баннер, который любой вставляет без аккаунта («Listed on Ext Ops Panel»); знаку подтверждённого автора нужен аккаунт, на всех тарифах, включая Free. Автор Chrome-расширения доказывает контроль доменом сайта из карточки магазина (DNS TXT или файл well-known), доменом, уже подтверждённым для веб-сервиса, или разовой строкой в описании листинга; мейнтейнер плагина ИИ: файлом в репозитории, файлом well-known, DNS TXT или подтверждённым доменом. Один переключатель на продукт, «Публиковать меня как автора», включает знак «Verified author on Ext Ops Panel» на публичной карточке и на баннерах продукта. Баннеры: четыре стиля, пять форматов, темы light, dark, brand и auto, SVG и PNG, с живыми публичными фактами каталога и ссылкой на карточку продукта. Сниппеты и статистика в разделе «Баннер» проекта.
- **Дополнения:** встраиваемый feedback-виджет, уведомления в приложении, Web Push/Telegram, кастом-метрики, активные проверки URL и push heartbeat. Доступность зависит от тарифа и конфигурации.

## Точные контракты

| Задача | Руководство | OpenAPI / код |
| --- | --- | --- |
| Базовое подключение | https://extops.dev/ru/docs | В панели: «Настройка» → «Проверка подключения» |
| Кастом-метрики: панель вызывает GET вашего сервиса | https://extops.dev/ru/docs/custom-metrics | https://extops.dev/custom-metrics-openapi.yaml |
| Мониторинг регистрации Chrome-расширения: ваш агент отправляет report | https://extops.dev/ru/docs/monitoring | https://extops.dev/monitoring-openapi.yaml; `/api/v1/monitoring/report` |
| Мониторинг окружения веб-проекта | Текущие настройки проекта в приложении | `/api/v1/heartbeat/report`; в репозитории: `services/api/internal/handler/heartbeat.go` и `services/api/internal/heartbeat/service.go` |
| Feedback-виджет и прямой API | https://extops.dev/ru/docs/feedback | https://extops.dev/feedback-openapi.yaml |
| Карточка клиента: наш сервер шлёт подписанный POST на ваш эндпоинт | https://extops.dev/ru/docs/customer-card | https://extops.dev/customer-card-openapi.yaml (эндпоинт описан в `webhooks`) |
| Баннер Ext Ops Panel (и знак подтверждённого автора) на сайте или в README | https://extops.dev/ru/docs/author-banners | Публичные адреса картинок `/extensions/<id>/banner/<style>/<format>-<theme>.<svg\|png>` и `/plugins/<family>/<key>/banner/…`; в репозитории: `services/api/internal/authorbanner`, `services/api/internal/handler/authorbanner.go`, `packages/domain/src/authorBanner.ts` |

Если работа идёт в репозитории Ext Ops Panel, проверяй также `apps/product-web/src/features/SetupEditor.tsx`, `services/api/cmd/server/main.go` и соответствующие обработчики; для карточки клиента `docs/customer-card-contract.md`, `services/api/internal/customercard` и `packages/ui-dashboard/src/feedback/CustomerCardSettings.tsx`. Публичные OpenAPI описывают контракты, но не заменяют проверку текущей конфигурации аккаунта.