# Биллинг и затраты

Статус: `approved`

## Назначение
Экран учёта затрат, распределения расходов по организациям и проектам, подготовки счетов, подключения платёжных провайдеров и учёта выручки каталога пакетов.

Первая версия должна позволять owner-организации видеть расходы на вычисления, storage, внешних провайдеров, пакеты и platform jobs, распределять их по клиентам и формировать основу для выставления счетов.

## Главные сущности
- cost record
- allocation rule
- billing account
- invoice
- payment provider
- payment event
- package sale
- publisher payout
- catalog commission

## Основные блоки
- верхняя лента summary-card по расходам, сумме к выставлению, нераспределённым затратам и выручке каталога
- вкладочная поверхность расходов, счетов, провайдеров и выручки каталога
- таблица записей затрат или счетов
- инспектор выбранной записи
- блоки трендов, правил распределения, предупреждений и выплат

## Семантика вкладок
- `Расходы` — записи затрат, источник, провайдер, связанная сущность, правило распределения и черновик счёта;
- `Счета` — черновики и выставленные счета, организации, проекты, статусы оплаты и approval перед отправкой;
- `Провайдеры и платежи` — источники затрат, платёжные провайдеры, sync jobs, failed webhook events и безопасность учётных данных;
- `Выручка каталога` — продажи платных пакетов, комиссия платформы, выплаты publisher и пакеты, требующие проверки.

## Ключевые действия
- экспортировать расходы
- открыть распределение затрат
- настроить правило распределения
- открыть черновик счёта
- отправить счёт после approval
- проверить provider sync
- повернуть учётные данные провайдера
- открыть выплату publisher

## Источники данных
- платформа: cost records, allocation rules, invoice drafts, billing accounts, package sales, payout records, audit log
- внешние провайдеры: cloud/server usage, LLM usage, payment events, currency rates
- Kubernetes: usage метрики slots, storage, jobs и deployment activity
- каталог пакетов: покупки, подписки, комиссии и publisher accounts

## Что намеренно не показывается
- payment checkout как часть этого административного экрана
- card PAN, банковские секреты, provider tokens и ключи API
- бухгалтерские документы без связи с организациями, проектами и platform entities
- raw provider payload вместо нормализованных записей затрат и событий

## Макеты
- [Основной макет](screen.png) — полноэкранный экран биллинга с активной вкладкой `Расходы`.
- [Вкладка `Расходы`](tab-expenses.png) — записи затрат, правила распределения, связанные run/job/repository и нераспределённые суммы.
- [Вкладка `Счета`](tab-invoices.png) — черновики и счета, строки счёта, связанные записи затрат и approval перед отправкой.
- [Вкладка `Провайдеры и платежи`](tab-providers-payments.png) — источники затрат, платёжные провайдеры, sync jobs, webhook failures и безопасность.
- [Вкладка `Выручка каталога`](tab-catalog-revenue.png) — продажи пакетов, комиссия, выплаты publisher и верификация publisher.

## Открытые вопросы
- нет
