Files
portal/docs/adr/012-finance-tooling.md
T
Дмитрий e8a01f3d23 docs(adr): ADR-012 finance-tooling boundary C6/C7
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-20 09:40:33 +03:00

37 lines
2.6 KiB
Markdown

# 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 — контекст/выгрузки, не налоговая консультация (бухгалтерия вне репо).