# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17

ABO - управление подписками и контрактами
=========================================

ОПИСАНИЕ:
  Управляет текущими подписками и контрактами (стриминг, программное обеспечение,
  Интернет, мобильная связь и др.). Автоматически распознает подписки по статьям налога
  и рассчитывает ежемесячные/годовые затраты.

КОМАНДЫ CLI:
  bach abo help              Показать справку
  bach abo init              Создать таблицы базы данных (однократно)
  bach abo scan              Поиск статей налога для подписок
  bach abo list              Показать все распознанные подписки
  bach abo list --alle       Вкл. деактивировано
  bach abo list --bestaetigt Nur bestaetigte
  bach abo confirm <id>      Подтвердить обнаружение подписки
  bach abo dismiss <id>      Удалить обнаружение ошибок
  bach abo costs             Разбивка стоимости по категориям
  bach abo export            Экспорт CSV (data/abo_export.csv)
  bach abo patterns          Показать известные шаблоны подписок
  bach abo sync-mail         Синхронизировать подписки по электронной почте

ОПЦИИ:
  --year YYYY налоговый год для сканирования (по умолчанию: текущий год)
  --dry-run scan только симулирует

БАЗА ДАННЫХ:
  Таблицы в bach.db:

  abo_subscriptions - Обнаруженные/управляемые подписки
    идентификатор, имя, поставщик, категория, сумма_месяца,
    интервал оплаты, ссылка на отмену, признанный_вкл.,
    подтверждено (0/1), активно (0/1)

  abo_payments - Ссылки на оплату налоговых статей
    id, subscribe_id, item_id, сумма, дата

  abo_patterns - Известные шаблоны обнаружения поставщиков
    идентификатор, шаблон, поставщик, категория, ссылка на отмену

  fin_contracts - Ручное управление контрактами (параллельное)
    идентификатор, имя, категория, поставщик, номер клиента, номер контракта,
    сумма, интервал, период_дней уведомления, дата истечения срока действия, ...

РАБОЧИЙ ПРОЦЕСС:
  1. bach abo init (одноразово: таблицы + шаблоны по умолчанию)
  2. сканирование подписки bach (ищет Tax_posten)
  3. список бахабо (показывает результаты)
  4. bach abo submit <id> (подтвердить реальные подписки)
  5. bach или отклонить <id> (удалить ложные идентификаторы)
  6. Стоимость подписки на бах (обзор стоимости)
  7. bach abo sync-mail (импорт подписок по электронной почте, необязательно)

ИЗВЕСТНЫЕ ШАБЛОНЫ (выбор):
  Netflix, Spotify, Microsoft 365, Adobe, Amazon Prime, Disney+,
  Apple/iCloud, YouTube Premium, Dropbox, Google One, ChatGPT/OpenAI,
  Anthropic/Claude, GitHub, JetBrains, 1Password, NordVPN, ExpressVPN

INTERPLAY:
  - Налог Баха: элементы налога в качестве источника данных для сканирования подписки.
  - Графический интерфейс: CRUD подписок (#573, реализован Gemini)
  - fin_contracts: ручные контракты (добавляет автоматическое обнаружение)
  - Financial_emails: электронные письма, связанные с подпиской (категория = 'abo')

ПРИМЕРЫ:
  # Первоначальная настройка:
  bach abo init

  # Обнаружение подписок по налоговым данным:
  bach abo scan --jahr 2025

  # Вывести список всех подписок (включая деактивированные):
  bach abo list --alle

  # Только подтвержденные подписки:
  bach abo list --bestaetigt

  # Обзор затрат по категориям:
  bach abo costs

  # Подтверждаем подписку:
  bach abo confirm 8

  # Удалить обнаружение ошибок:
  bach abo dismiss 3

  # Импортировать подписки по электронной почте:
  bach abo sync-mail

  # Экспорт для планирования бюджета:
  bach abo export

  # Показать известные шаблоны:
  bach abo patterns
