financial-operations

What problem does it solve?

This Skill prevents duplicate charges, lost balances, and unauditable financial inconsistencies by enforcing safe patterns for every financial operation in the Super Cartola Manager.

Core Features & Use Cases

• Idempotency by Design: Ensures every money-related action uses a deterministic idempotency key (and unique index) to block duplicate inserts.
• Audit Trail (Follow the Money): Requires all financial movements to be recorded with traceable context fields suitable for cross-checking and investigation.
• Atomicity & Safety: Guides MongoDB updates toward atomic operators ($inc / $set) or transactions for multi-collection operations, with strict session validation and multi-tenant isolation.
• Correct Balance & Points Handling: Centralizes saldo calculation usage and forbids rounding points, requiring truncation via truncarPontosNum().

Quick Start

Use the financial-operations skill to design or review a financial controller that creates adjustments, acertos, extrato entries, or inscription payments with idempotency keys, audit-trail records, atomic/transaction-safe MongoDB writes, and extrato cache invalidation.