Tags Financeiras

Visão Geral

As Tags Financeiras substituem o conceito clássico e engessado de “Categorias”. Elas oferecem liberdade para classificar transações ou itens de transação sob múltiplas perspectivas sem a necessidade de árvores complexas de “Categoria > Subcategoria”.

Tabela: financial_tags

Tabela Auxiliar: taggables (Polimórfica)

Para garantir flexibilidade, a relação é polimórfica através da tabela taggables. Isso permite vincular tags a entidades diversas:

• Diretamente em uma Transação Completa (financial_transactions)
• Apenas em um Item da Transação (financial_transaction_items), ideal para separar impostos, juros e produtos de uma única Nota Fiscal.

Diagrama Relacional (ER)

    erDiagram
    FINANCIAL_TAGS {
        bigint id PK
        bigint tenant_id FK
        string name
        string icon
        string color_hex
        boolean is_protected
    }
    TAGGABLES {
        bigint financial_tag_id FK
        bigint taggable_id FK
        string taggable_type
    }
    FINANCIAL_TRANSACTIONS {
        bigint id PK
    }
    FINANCIAL_TRANSACTION_ITEMS {
        bigint id PK
    }

    FINANCIAL_TAGS ||--o{ TAGGABLES : "possui"
    FINANCIAL_TRANSACTIONS ||--o{ TAGGABLES : "morphToMany"
    FINANCIAL_TRANSACTION_ITEMS ||--o{ TAGGABLES : "morphToMany"
  

Regras de Negócio e Comportamento

• Exclusão Definitiva (Hard Deletes): Tags não possuem Lixeira (soft deletes). Porém, a exclusão é estritamente bloqueada na aplicação e via banco de dados caso a tag já esteja associada a alguma transação ou item. Se ela estiver limpa, é deletada definitivamente.
• Tags de Sistema Protegidas: As tags estruturais (ex: Reembolso, Juros, Saldo Inicial) são semeadas pelo sistema com a flag is_protected = true. O usuário não pode deletar nem editar seu nome ou cor.
• Validação Dinâmica de Ícones: O sistema não salva apenas strings estáticas; a criação e edição usam a regra global ValidIcon, que se comunica diretamente com o mecanismo do Blade UI Kit para garantir que o ícone informado realmente existe no projeto.
• Seeder Flexível: Quando um novo ambiente é configurado,tags padrão sugeridas (como Alimentação, Mercado, Lazer) são inseridas desprotegidas no banco através do FinancialTagSeeder. O usuário já encontra uma interface amigável, mas mantém o poder de apagá-las ou editá-las livremente.
• Seleção Avançada na Interface: A criação de tags disponibiliza um seletor customizado de cores (<x-ui.color-picker>) e uma interface de grid de ícones em tempo real com excelente usabilidade via teclado e mouse.