Finance Auvp Extensão

# Finance AUVP Extensão - Gerenciamento Completo de Transações Financeiras

## Visão Geral

A Finance AUVP Extensão é uma poderosa ferramenta desenvolvida para otimizar e automatizar o gerenciamento de transações financeiras no sistema Finance AUVP. Esta extensão do Chrome foi projetada para usuários que precisam de funcionalidades avançadas de criação, organização, filtragem, exportação e importação de transações financeiras, oferecendo uma experiência completa e intuitiva diretamente do navegador.

## Funcionalidades Principais

### 1. Criação de Transações Parceladas

Uma das funcionalidades mais poderosas da extensão é a capacidade de criar transações parceladas de forma automática e inteligente. Com esta ferramenta, você pode:

- **Divisão Automática de Valores**: A extensão calcula automaticamente o valor de cada parcela, dividindo o valor total pelo número de parcelas desejado. O sistema é inteligente o suficiente para lidar com centavos, garantindo que o valor total seja distribuído corretamente, com eventuais diferenças sendo aplicadas na última parcela.

- **Nomenclatura Automática**: Cada transação criada recebe automaticamente uma nomenclatura padronizada no formato "Descrição (X/Y)", onde X é o número da parcela atual e Y é o total de parcelas. Por exemplo, se você criar uma compra parcelada em 10 vezes chamada "Notebook", as transações serão nomeadas como "Notebook (1/10)", "Notebook (2/10)", e assim por diante.

- **Incremento Automático de Datas**: As datas são incrementadas automaticamente mês a mês a partir da data inicial informada. A extensão calcula corretamente o primeiro dia de cada mês subsequente, garantindo que todas as parcelas sejam criadas nas datas corretas.

- **Preview Antes da Criação**: Antes de criar as transações, a extensão exibe um preview completo mostrando todas as parcelas que serão geradas, incluindo a data de cada uma, o dia da semana correspondente e o valor exato que será aplicado. Isso permite que você revise e confirme todas as informações antes de prosseguir.

- **Campos Completos**: Cada parcela mantém todas as informações da transação original, incluindo conta, meta (budget), tags, observações e tipo (receita ou despesa). Você pode personalizar todos esses campos antes de gerar as parcelas.

### 2. Criação de Transações Recorrentes

A funcionalidade de transações recorrentes permite automatizar a criação de transações que se repetem periodicamente, oferecendo flexibilidade total para diferentes necessidades:

- **Múltiplos Tipos de Recorrência**: A extensão suporta quatro tipos diferentes de recorrência:
- **A cada X dias**: Configure transações que se repetem a cada número específico de dias (ex: a cada 15 dias, a cada 30 dias).
- **A cada X semanas**: Defina recorrências semanais com intervalos personalizados (ex: a cada 2 semanas, a cada 4 semanas).
- **A cada X meses**: Crie transações mensais com intervalos customizados (ex: a cada 2 meses, a cada 3 meses).
- **Dia da semana específico**: Configure transações que ocorrem sempre em um determinado dia da semana (ex: toda segunda-feira, toda primeira sexta-feira do mês), com opção de intervalo em semanas.

- **Critérios de Término Flexíveis**: Você pode definir quando a recorrência deve parar de duas formas:
- **Por data final**: Especifique uma data limite, e a extensão criará todas as transações até essa data.
- **Por número de ocorrências**: Defina quantas vezes a transação deve ser repetida, e a extensão criará exatamente esse número de transações.

- **Preview Detalhado**: Assim como nas parcelas, você recebe um preview completo de todas as transações recorrentes que serão criadas, mostrando datas, dias da semana e valores, permitindo revisão antes da confirmação.

- **Cálculo Inteligente de Datas**: A extensão calcula automaticamente as próximas datas baseadas no tipo de recorrência escolhido, considerando corretamente os meses com diferentes números de dias e ajustando para o próximo dia válido quando necessário.

### 3. Sistema de Filtros Avançados

O sistema de filtros da extensão é extremamente robusto e permite encontrar transações específicas com precisão cirúrgica:

- **Filtro por Período**: Selecione um intervalo de datas específico para buscar transações. O sistema permite definir data inicial e data final, e sempre mantém um período padrão (mês atual) quando nenhum período é especificado, garantindo que você sempre tenha resultados relevantes.

- **Filtro por Faixa de Valor**: Defina valores mínimos e máximos para filtrar transações por valor monetário. Os campos são opcionais e suportam formatação em Real brasileiro (R$), facilitando a entrada de dados.

- **Filtro por Mês de Referência**: Busque transações específicas de um mês de referência particular, útil para análises mensais e relatórios periódicos.

- **Filtro por Tipo de Transação**: Filtre por receitas (CREDIT) ou despesas (DEBIT), ou visualize todas as transações sem distinção de tipo.

- **Filtro por Metas (Budgets)**: Selecione uma ou múltiplas metas para filtrar transações associadas a objetivos financeiros específicos. A interface permite seleção múltipla com visualização clara das metas selecionadas.

- **Filtro por Tags**: Utilize tags personalizadas para categorizar e filtrar transações. O sistema suporta seleção múltipla de tags e exibe indicadores visuais com as cores associadas a cada tag, facilitando a identificação.

- **Filtro por Contas**: Filtre transações por uma ou múltiplas contas bancárias, cartões de crédito ou outras contas financeiras. A seleção múltipla permite análises comparativas entre diferentes contas.

- **Filtro de Ocultação**: Controle quais transações aparecem nos relatórios, podendo filtrar por transações que devem ser ocultadas, mostradas, ou todas independentemente da configuração.

- **Paginação Configurável**: Defina quantos itens deseja visualizar por página (10, 20, 30, 40, 50, 100 ou todos), permitindo otimizar a visualização conforme sua necessidade.

- **Persistência de Filtros**: Todos os filtros aplicados são salvos automaticamente no navegador, permitindo que você retome suas buscas exatamente de onde parou, mesmo após fechar e reabrir a extensão.

- **Visualização de Totais**: A lista de transações filtradas exibe totais consolidados, incluindo total de receitas, total de despesas e saldo resultante, facilitando análises financeiras rápidas.

### 4. Exportação para Excel/CSV

A funcionalidade de exportação é extremamente poderosa e foi desenvolvida para facilitar análises externas e relatórios:

- **Exportação com Filtros**: Aplique todos os filtros avançados disponíveis e exporte apenas as transações que correspondem aos seus critérios, garantindo que você trabalhe apenas com dados relevantes.

- **Substituição Automática de IDs**: A extensão automaticamente substitui todos os IDs por valores legíveis. Contas, metas e tags são convertidas de seus identificadores numéricos para seus nomes reais, tornando o arquivo exportado imediatamente utilizável sem necessidade de consultas adicionais.

- **Formatação Completa**: Os dados exportados são formatados de forma otimizada para Excel, incluindo:
- Valores monetários formatados corretamente
- Datas no formato brasileiro (DD/MM/YYYY)
- Tipos de transação traduzidos (Receita/Despesa)
- Mês de referência formatado
- Status de ocultação traduzido (Sim/Não)
- Tags múltiplas separadas por vírgula

- **Encoding UTF-8**: O arquivo é gerado com encoding UTF-8 e inclui BOM (Byte Order Mark) para garantir compatibilidade perfeita com Excel e outros programas de planilhas, preservando caracteres especiais e acentuação.

- **Download Automático**: O arquivo é baixado automaticamente com um nome descritivo que inclui data e hora da exportação, facilitando a organização de múltiplos arquivos exportados.

### 5. Importação em Lote via CSV

A funcionalidade de importação permite adicionar múltiplas transações de uma só vez, economizando tempo significativo:

- **Template de Importação**: A extensão oferece um template pré-formatado que você pode baixar, preencher e usar para importação. O template inclui exemplos válidos baseados nas suas contas, metas e tags reais, facilitando o preenchimento correto.

- **Preview Antes da Importação**: Antes de importar qualquer transação, a extensão exibe um preview completo mostrando:
- Total de linhas processadas
- Quantas transações são válidas
- Quantas linhas contêm erros
- Lista detalhada de todos os erros encontrados, com indicação da linha e descrição específica do problema
- Preview visual de cada transação válida que será importada, mostrando todos os campos preenchidos

- **Validação Robusta**: O sistema valida rigorosamente todos os dados antes da importação:
- Verifica se descrições estão preenchidas
- Valida formatos de valores monetários
- Confirma que tipos são "Receita" ou "Despesa"
- Valida formatos de data (DD/MM/YYYY)
- Verifica se contas existem no sistema
- Confirma que metas são válidas
- Valida tags e verifica se existem
- Valida formato de mês de referência (MM/YYYY)
- Verifica formato de campo "Ignorar" (Sim/Não)

- **Tratamento de Erros Inteligente**: Quando erros são encontrados, a extensão fornece mensagens descritivas e específicas, indicando exatamente qual campo está incorreto e qual é o problema, facilitando a correção do arquivo CSV.

- **Importação Seletiva**: Apenas transações válidas são importadas. Transações com erros são ignoradas, mas você recebe um relatório completo dos problemas encontrados, permitindo corrigir o arquivo e tentar novamente apenas com as linhas problemáticas.

- **Feedback de Resultado**: Após a importação, você recebe um relatório detalhado mostrando quantas transações foram importadas com sucesso e quantas falharam, com informações específicas sobre cada falha.

## Suporte e Atualizações

A extensão é mantida ativamente e recebe atualizações regulares com melhorias e novas funcionalidades. Em caso de problemas ou dúvidas, verifique a documentação ou entre em contato com o suporte.

## Conclusão

A Finance AUVP Extensão é uma ferramenta essencial para qualquer pessoa ou empresa que utiliza o sistema Finance AUVP e precisa de funcionalidades avançadas de gerenciamento de transações. Com sua interface intuitiva, funcionalidades poderosas e foco em segurança, a extensão transforma a experiência de gerenciamento financeiro, tornando operações co