Industry review: кросс-арендные инсайты

Раздел /manage/ak/industry-review — это очередь одобрения для отраслевых инсайтов, которые industry_aggregator находит, читая факты разных продавцов одновременно.

Что такое industry-insight

Обычный чанк живёт внутри одного магазина — visibility=per_shop. Никакой другой магазин его не видит.

Industry-insight — это факт, который повторился у нескольких независимых продавцов, и потому интересен всему рынку:

«Категория Электроника на Ozon — стабильный спад маржи: средняя комиссия выросла, при этом цена не двигалась» (наблюдалось у 7 продавцов)

«Возвраты в WB в категории Одежда летом сильно зависят от веса нити в описании» (наблюдалось у 5 продавцов)

Эти знания пишутся с visibility=industry, company_id=NULL и доступны всем компаниям, у которых не отключён feature flag.

k-anonymity — обязательный гейт

Industry-aggregator не публикует инсайт, если меньше 5 разных продавцов (k ≥ 5) показывают тот же паттерн. Это закреплено константой K_MIN в коде. Для редких категорий гейт может быть жёстче (K_MIN_RARE_CATEGORIES).

Зачем: чтобы из отраслевого insight нельзя было обратно вычислить конкретного продавца. Если паттерн «есть только у 1–2 компаний» — это уже не отраслевой инсайт, это утечка их данных.

Что показывает страница

Карточки — по одной на industry-insight. Каждая показывает:

Действия

• ✓ Одобрить → tier='confirmed'. Чанк становится виден агенту, может цитироваться всем компаниям.
• ✗ В архив → tier='archived'. Чанк больше не показывается. История остаётся в ak_chunk_audit.

После approve/archive страница перезагружается; одобренные insights остаются доступны через переключатель «Одобренные» для аудита.

Что проверять перед approve

1. Размер выборки. k=5 — минимум. Если категория узкая (редкая), агрессивно поднимайте порог.
2. Полезность. Это новое знание или просто перепев известного правила? Если последнее — лучше архив.
3. Privacy-смысл. «У продавцов в категории X средняя комиссия 12%» — нормально. «У 5 продавцов Москвы в категории Y оборот падает» — может выдавать конкретных, архив.
4. Источники. Раскройте «Источники» и пробегите глазами. Если все 5 на тему «5 поставщиков перешли на UPS», а insight «возвраты растут» — Gemini галлюцинирует, архив.

Кто видит эту страницу

• В /manage/ak/* авто-гард пускает только is_superuser=true. Для остальных раздел не появляется в навигации.
• Технически endpoint /admin/ak/industry-review доступен любому admin'у, но архитектурно этот surface предназначен для одного-двух superadmin'ов организации.

Включение / отключение модуля

• Aggregator работает только если установлен env AK_INDUSTRY_AGGREGATOR=1 (per-environment opt-in)
• Per-company opt-out из получения industry-insight'ов планируется в V2.1 через cf_industry_optout (см. spec §7.3 P4)

Связанные страницы

• Insights (Reflector) — отличается scope'ом: per_shop, не cross-tenant
• Chunks — ?visibility=industry покажет все industry chunks включая archived
• Lineage — для одобренного insight: какие source-чанки дали жизнь