CRM-LeadRadar/docs/BILLING.md

Биллинг

Как считаются счета и подписка. Код: apps/api/src/billing/, тесты: apps/api/src/billing.int.test.ts. Все даты считаются по времени Еревана.

Две модели

	Фикс	% от комиссии
Когда платят	вперёд, за следующий месяц	после, за прошлый календарный месяц
Когда выставляется счёт	за 7 дней до окончания подписки	1-го числа
Срок оплаты	дата окончания подписки	8-е число
Что даёт оплата	подписка продлевается на месяц	подписка действует до 8-го числа следующего месяца

Месяц без сделок на модели «%»: счёт на 0 закрывается сам, подписка продлевается. Минимального платежа нет — это открытый вопрос ТЗ.

Плата за установку (Team 500 , Agency 750 ) начисляется один раз отдельным счётом. Её оплата дату подписки не двигает; исключение — новая компания на модели «%», у которой первого месячного счёта нет: её подписка стартует с оплаты установки.

Комиссия в разных валютах

Комиссию по сделке агент вводит в любой валюте, счёт выставляется в долларах. Курсы задаёт суперадмин: «Счета» → «Курсы валют». В счёте сохраняется курс на момент выставления и расшифровка по сделкам — клиент видит её в разделе «Подписка».

Смена тарифа

• Клиент меняет тариф и модель в разделе «Подписка». Изменение вступает в силу со следующего расчётного месяца: на фиксе — на следующий день после окончания оплаченного периода, на «%» — с 1-го числа. До этого в кабинете видно «Запланировано с такой-то даты», смену можно отменить.
• Если оплаченного периода нет (подписка ещё не начиналась или уже закончилась), тариф меняется сразу.
• Суперадмин меняет тариф в карточке компании сразу.
• Переход на тариф меньше, чем участников в компании, запрещён.
• При переходе с фикса на «%» сделки, закрытые до перехода, в счёт не попадают. При уходе с «%» посреди месяца сделки с начала месяца закрываются отдельным счётом.

Просрочка и напоминания

Напоминания уходят руководителю в бот не раньше 10:00: за 7, 3 и 1 день до окончания; после окончания — каждый день с числом оставшихся дней; при ограничении доступа — один раз. Через 15 дней (срок меняет суперадмин) уведомления о лидах останавливаются, CRM работает только на чтение. Раздел «Подписка» открыт всегда. После отметки оплаты доступ возвращается сразу.

Оплата

Сейчас работает ручной режим: суперадмин в разделе «Счета» нажимает «Отметить оплату».

Онлайн-оплата подключается без переделки биллинга. Нужно написать класс по контракту apps/api/src/billing/provider.ts (создать платёж → ссылка на страницу оплаты; разобрать и проверить уведомление провайдера) и передать его в buildApp({ payments }) в apps/api/src/main.ts. После этого у клиента в счёте появится кнопка «Оплатить», а провайдер будет присылать уведомления на /api/payments/webhook/<имя провайдера>.

Что не решено

• Провайдер эквайринга и валюта списания.
• Минимальный платёж на модели «%».
• Откуда брать курс: сейчас его вручную задаёт суперадмин.