portal/docs/adr/012-finance-tooling.md

ADR-012: Finance-tooling — наполнение разделов карты C6 + C7

Status: Accepted Date: 2026-05-20 Контекст: эпик finance-tooling (объединённые C6+C7), spec docs/superpowers/specs/2026-05-20-finance-tooling-c6-c7-design.md.

Context

Разделы карты C6 «Финансы — биллинг и тарификация» и C7 «Финансы — бухгалтерия и налоги» были пусты. Биллинг-подсистема (Plan 4) велика в коде, но dedicated dev-tooling скуден. Заказчик решил объединить C6+C7 в один эпик и покрыть полностью.

Decision

1. finance plugin (#61) (knowledge-work-plugins) — homed C7 (primary), cross-ref C6.
   • ✅ C6: reconciliation, variance-analysis.
   • ⚠️ C7 частично (US-GAAP): financial-statements, close-management, journal-entry, journal-entry-prep.
   • ❌ not-applicable РФ: sox-testing, audit-support (нет SOX у частной РФ-компании).
   • DEFERRED: warehouse-MCP (snowflake/databricks/bigquery) — не стек проекта (PG+Redis).
2. billing-audit (#62) — self-authored project-скил, C6. Денежные инварианты Лидерры.
3. ru-tax-accounting (#63) — self-authored project-скил, C7. РСБУ/НК РФ. Закрывает gap US-плагина.
4. Граница C6 ↔ C7: C6 = начисление денег клиенту за лиды; C7 = учёт и налоги компании. Точка стыка: billing-выручка (lead_charges/LedgerService) — выход C6 и вход C7.
5. Reuse существующих узлов в C6/C7 через NODE_SECTION_SECONDARY (см. spec §6).

Boundaries (конфликт-аудит)

• FIN1 warehouse-MCP → DEFERRED. FIN2 SOX → not-applicable РФ. FIN3 finance vs operations.
• FIN4 finance reconciliation (инструмент) vs CsvReconcileJob (код). FIN5 billing-audit vs process-*/D3.
• FIN6 ru-tax vs finance plugin vs D1/D2. FIN7 граница C6↔C7. FIN8 self-authored скилы линтуются.

Consequences

• C6/C7 карты непусты. Новая off-phase подкатегория finance-tooling (15-я).
• Реальный платёжный провайдер и warehouse-аналитика — DEFERRED (Б-1 / вне стека).
• ru-tax-accounting — контекст/выгрузки, не налоговая консультация (бухгалтерия вне репо).