Changelog

[0.9.32] - 2026-07-21

Added

• Adicionada separação por unidade no módulo de RH, incluindo colaboradores, folhas, holerites em lote e configurações CLT por unidade ou globais.
• Adicionado vínculo de empresa_id aos logs de auditoria, com filtro por unidade e opção explícita para logs globais.
• Adicionada exibição da unidade nas listagens e detalhes de auditoria, colaboradores, folhas e usuários.
• Adicionado filtro por unidade na listagem de usuários e popover para visualizar as unidades vinculadas a cada usuário.
• Adicionada propagação de empresa_id para pagamentos e encargos consolidados gerados pelo RH.

Changed

• Ajustada a auditoria para identificar logs exclusivos de unidade quando a entidade possui vínculo direto ou indireto com empresa, incluindo itens de cobrança de contrato.
• Ajustada a auditoria de alterações de usuários para permanecer global quando envolver múltiplas unidades, registrando na descrição as unidades anteriores e atuais.
• Melhorada a nomenclatura de logs sem empresa_id, exibindo apenas Global.
• Atualizados os filtros de RH e Auditoria para respeitar unidades permitidas do usuário.

Fixed

• Corrigida a exibição do nome da unidade na Auditoria para usar nome_fantasia ou razao_social em vez de atributo inexistente.
• Corrigido o backfill de auditoria para preencher unidade em logs antigos de contratos, recebimentos, pagamentos, contas bancárias e itens de cobrança de contrato quando possível.

[0.9.31] - 2026-07-21

Added

• Adicionado suporte a CNPJ alfanumérico nos cadastros do painel Admin e do app cliente.
• Adicionadas validações reais de CPF e CNPJ, incluindo cálculo de dígitos verificadores para CPF, CNPJ numérico e CNPJ alfanumérico.
• Adicionado helper compartilhado para normalização, formatação e validação de documentos.
• Adicionado helper compartilhado para consulta de CNPJ pela API da Invertexto.
• Adicionada configuração do token da Invertexto no painel Admin via INVERTEXTO_API_TOKEN.
• Adicionada configuração api_invertexto nas Configurações principais da tela de Integrações do app cliente.

Changed

• Removido token hardcoded da Invertexto das rotas de consulta de CNPJ do painel Admin e do app cliente.
• Centralizada a chamada à Invertexto para evitar duplicação entre as implementações do Admin e do app cliente.
• Ajustados payloads enviados ao Asaas para preservar CNPJ alfanumérico sem máscara.
• Atualizadas máscaras e validações JavaScript de CPF/CNPJ para aceitar CNPJ alfanumérico e exibir feedback visual em formulários.
• Atualizados cadastros de clientes, fornecedores, empresas, usuários e autocadastro do cliente para validar documentos antes de salvar.

Fixed

• Corrigida remoção indevida de letras do CNPJ antes de consultar a Invertexto ou enviar dados ao Asaas.
• Corrigida possibilidade de salvar CPF/CNPJ inválido em formulários do painel Admin e do app cliente.

[0.9.30] - 2026-07-18

Changed

• Separados os logs detalhados por instância, salvando cada arquivo em logs/{db_name}/app_detalhado.log.
• Mantida a rotação diária por instância para gerar app_detalhado.log.old dentro da respectiva pasta de logs.
• Ignorada a pasta logs/ no Git para evitar versionamento de arquivos gerados em execução.

[0.9.29] - 2026-07-18

Added

• Adicionado limite de armazenamento por instância no painel Admin, configurável no card Opcionais.
• Adicionado atributo storage_limit_gb para salvar o espaço disponível da instância no banco de dados.
• Adicionada propagação do limite configurado para o app cliente por meio da variável CLIENTE_STORAGE_LIMIT_GB.
• Adicionada validação de cota antes de salvar uploads e ícones PWA gerados pelo sistema.

Changed

• Centralizadas as rotas de upload de arquivos no blueprint de uploads, incluindo imagens de produtos, logo, header, favicon/PWA, pagamentos, recebimentos, contratos e arquivos de colaboradores.
• Padronizado o salvamento de arquivos em app/static/{DB_NAME}/uploads com utilitários compartilhados de armazenamento.
• Alterado o card Uso de Disco do dashboard do app cliente para exibir o total configurado para a instância, o espaço usado pela pasta da instância e o espaço livre restante.

Fixed

• Corrige empresa dos recebimentos parcelados do carrinho
• Bloqueado o envio de arquivos quando o tamanho excede o espaço livre configurado para a instância.
• Adicionada mensagem orientativa quando não há espaço suficiente para upload: Não há espaço em disco suficiente para esse arquivo. Contrate mais espaço com a Fluxar.

[0.9.28] - 2026-07-16

Added

• Adicionada separação de operações por unidade/loja no financeiro.
• Adicionada unidade aos contratos.
• Adicionado suporte a cartões adicionais por unidade.
• Adicionados formato original, conta bancária, opção de parcelamento e quantidade de parcelas no card Confirmar compra e gerar pagamentos.
• Adicionada geração de pagamentos de compras com conta bancária, formato e parcelamento mensal.

Changed

• Restringidas operações financeiras às unidades permitidas do usuário.
• Ajustado fluxo de faturas de cartão para considerar unidade, cartão principal e cartões adicionais.
• Ajustado fluxo de confirmação de compras para replicar o padrão do lançamento manual de pagamentos.
• Bloqueada a criação de múltiplas unidades matriz.
• Bloqueada a conversão de unidade matriz para filial.
• Ajustada resolução da unidade ativa para respeitar unidades permitidas do usuário.

Fixed

• Corrigida criação/ajuste de colunas de unidade no bootstrap.
• Corrigida exibição de unidades vinculadas ao usuário.
• Removido vínculo automático indevido de todos os usuários à matriz durante o bootstrap/reinício da instância.
• Corrigida exibição de cartão adicional em pagamentos de filial vinculados à fatura.

[0.9.27] - 2026-07-15

Added

• Adicionada tela administrativa de pedidos do E-Commerce.
• Adicionados filtros, detalhe, exportação CSV e ações administrativas para pedidos.
• Adicionados cards de indicadores de pedidos no dashboard.
• Adicionada seleção de produtos por modal nas telas de compras e movimentações.
• Adicionadas buscas assíncronas de variações para compras e movimentações.

Changed

• Otimizadas consultas de estoque por variação.
• Substituído select extenso de produtos/variações por modal de busca nas telas de compras e movimentações.

Fixed

• Adicionado bloqueio de seleção duplicada da mesma variação na tabela de compras e movimentações.

[0.9.26] - 2026-07-14

Added

• Preparado estoque multiunidade para próximas etapas.
• Implementado estoque por unidade na variação.
• Implementada reserva online pela matriz.
• Adicionada tela de estoque por unidade.
• Adicionada cor configurável para badges de unidades.

Changed

• Melhorado visual da tela de estoque.
• Ajustada exibição de localização no estoque.
• Simplificadas colunas da listagem de estoque.
• Consolidado estoque mínimo no status.
• Aplicadas melhorias visuais em tabelas.

Fixed

• Corrigida inicialização da empresa matriz nos índices.
• Aprimoradas validações e exclusão de variações.

[0.9.25] - 2026-07-13

Added

• Integrados atributos ao formulário de variação.
• Adicionada duplicação de variação.
• Preparada base para estoque por unidade.
• Vinculadas compras e movimentações a unidades de estoque.

Changed

• Removido botão separado de atributos das variações.
• Exibida unidade dos atributos em input group.
• Gerado nome da variação a partir dos atributos.
• Permitida escolha dos atributos usados no nome da variação.
• Removido hífen entre valor e unidade no SKU.
• Persistida ordem dos atributos no nome da variação.
• Normalizados atributos de texto por palavra.

Fixed

• Corrigida exibição de empresas no index.

[0.9.24] - 2026-07-11

Added

• Exibidos atributos do produto na vitrine.

Changed

• Ajustados filtros e ordenação de produtos.
• Normalizados valores textuais de atributos.
• Preservados filtros ao salvar atributos de produto.
• Reposicionada ficha técnica antes da descrição.
• Listadas apenas categorias principais no filtro.
• Corrigida rolagem das seções da página inicial.
• Ajustado comportamento de compensação de scroll.

Fixed

• Corrigidos tipos e formatos de atributos decimais.

[0.9.23] - 2026-07-10

Added

• Adicionado suporte administrativo ao fluxo de cancelamento/expiração central de pedidos e-commerce.

Changed

• Ajustada CLI de cancelamento/expiração de pedidos do E-Commerce.
• Evitado carregamento indevido de bootstrap/admin em tenants durante cancelamento central.
• Melhorada estabilidade do comando administrativo de cancelamento de pedidos expirados.

Fixed

• Corrigidos relacionamentos de roles usados nos fluxos administrativos.

[0.9.22] - 2026-07-10

Added

• Adicionadas máscaras no cadastro de clientes da vitrine.
• Adicionado pagamento com cartão parcelado no carrinho.
• Implementadas parcelas reais no ERP para compras Asaas.
• Adicionada recompra flexível de pedidos cancelados.
• Adicionada expiração automática de pedidos e-commerce.
• Adicionada CLI central para expiração de pedidos e-commerce.

Changed

• Padronizado cadastro do cliente da vitrine.
• Ajustada navbar mobile do produto.
• Padronizados botões da home.
• Melhorados detalhes e cancelamento do pedido.
• Melhorada tabela mobile de itens do pedido.
• Aplicados ajustes de sidebar e header preview.

Fixed

• Corrigida abertura inicial do PWA.
• Corrigido cancelamento de pedidos parcelados no ERP.
• Permitida exclusão do recebimento principal de pedido cancelado.
• Excluídos recebimentos e-commerce ao cancelar pedido.

[0.9.21] - 2026-07-08

Added

• Criada vitrine pública de produtos.
• Adicionado menu dinâmico de categorias na página inicial.
• Adicionada configuração de Google Login em integrações.
• Implantado login Google para clientes.
• Adicionado carrinho persistente na vitrine.
• Implantado fluxo de compra com cobrança Asaas.
• Reformulada área “Minha conta” com listagem e detalhes de pedidos.

Changed

• Sincronizado autocadastro da vitrine com Asaas.
• Ajustada seleção de variações e imagens no carrinho.
• Ajustada exibição do detalhe de pedido pago.
• Aplicados ajustes visuais na página inicial, imagens gerais e página de categorias.

Fixed

• Corrigida URI de retorno do login Google.
• Corrigida remarcação de item no carrinho.

[0.9.20] - 2026-06-26

Added

• Adicionado seed inicial de categorias do E-Commerce.
• Adicionados atributos iniciais de produto e variação ao E-Commerce.
• Adicionada documentação/estrutura inicial para produto e estoque.

Changed

• Separada a seleção de categorias e subcategorias no cadastro de produto.
• Vinculados atributos somente a subcategorias.
• Exigida marca e subcategoria no cadastro de produto.
• Ajustados atributos numéricos fracionários para decimal.
• Melhorada a listagem de atributos.
• Protegido o seed inicial para evitar recriações indevidas.

Fixed

• Corrigidos ajustes relacionados à organização inicial de categorias, subcategorias e atributos do E-Commerce.

[0.9.19] - 2026-06-25

Added

• Adicionado módulo inicial de E-Commerce com cadastro de produtos, categorias, subcategorias, marcas, atributos e variações.
• Adicionada estrutura inicial de vitrine temporária de produtos.
• Adicionado suporte a upload local de imagens de produtos.
• Adicionado fluxo inicial de compras de produtos.
• Adicionadas movimentações manuais de estoque.
• Adicionada auditoria para fluxos do E-Commerce.

Changed

• Simplificada a exibição dos itens de movimentação de estoque.
• Aplicadas máscaras monetárias em preços de variação e formulário de compras.
• Aplicados ajustes visuais gerais no módulo de produtos e E-Commerce.

Fixed

• Corrigido salvamento de rascunho de compra.
• Permitido cancelamento de movimentação de estoque finalizada.

[0.9.18] - 2026-04-06

Added

• Nova opção de envio de cobrança por WhatsApp na tela de recebimentos.
• Ao clicar em WhatsApp, agora é exibida uma nova janela com a mensagem pronta para envio.
• Nessa janela, é possível escolher se deseja incluir:
• o link da cobrança;
• os anexos do recebimento.

Changed

• A mensagem pode ser editada antes de abrir o WhatsApp, para facilitar ajustes de tom e contexto com cada cliente.
• O envio ficou mais flexível: você decide o que vai junto (somente texto, texto + link, texto + anexos, ou tudo).
• Quando não existir link de cobrança ou anexo, as opções correspondentes ficam indisponíveis para evitar envio incorreto.

[0.9.17] - 2026-04-01

Changed

• Chat e Suporte ficaram mais rápidos para atualizar alertas de mensagens novas.
• Melhoramos o carregamento das conversas: agora a tela abre com as mensagens mais recentes e permite carregar mensagens mais antigas aos poucos.
• Ajustamos o som de notificação para tocar de forma mais estável quando chega nova mensagem.
• Reduzimos o trabalho do sistema ao buscar mensagens não lidas, para deixar o uso mais leve no dia a dia.

Added

• Nova rotina de arquivamento de mensagens antigas do suporte, para manter o sistema mais organizado e com melhor desempenho ao longo do tempo.

[0.9.16] - 2026-03-30

Changed

• Padronização das conexões MySQL para leitura das credenciais via .env, removendo usuário/senha hardcoded dos módulos do app principal e painel admin.
• Inclusão do utilitário db_credentials.py para centralizar a resolução de host, user, password e database por ambiente (FLASK_ENV) e reutilizar a configuração em pymysql e SQLAlchemy.

[0.9.15] - 2026-03-27

Added

• Criação do canal Fluxar Suporte no chat interno do app principal, com contato fixo no topo da lista e roteamento dedicado para atendimento no painel admin.
• Nova tela de Suporte no painel admin para listar conversas por cliente/usuário, visualizar histórico e responder mensagens.
• Badge de notificações no item Suporte da navbar do admin, com alerta sonoro usando chat.mp3.

[0.9.14] - 2026-03-25

Added

• Novo status de fatura ABERTA_PARCIAL para representar ciclos abertos com pagamento acumulado, preservando a entrada de novas compras no mesmo período.
• Campos valor_pago, saldo_atual e credito_adiantado em faturas_cartao, com criação idempotente via rotina de migração automática.
• Botão Datas de pagamento no header do card Lançamentos vinculados na tela de detalhe da fatura, com popover exibindo histórico flutuante de pagamentos (data e valor) da fatura.

Changed

• Fluxo de pagamento de fatura de cartão passou a aceitar pagamentos com a fatura em status ABERTA (pagamento parcial), baixando apenas itens pendentes no momento e mantendo a fatura aberta para receber novas compras.
• Pagamento de fatura FECHADA foi ajustado para quitar apenas itens pendentes e marcar a fatura como PAGA quando não restarem lançamentos em aberto.
• Backend de pagamento passou a recalcular e persistir valor_pago/saldo_atual após cada baixa e permitir valor_pagamento informado no modal, validado contra saldo_restante, aplicando crédito antecipado quando houver.
• Tela de detalhe da fatura passou a exibir resumo financeiro com Total da fatura, Já pago, Saldo restante e Crédito antecipado.
• Filtros e badges de status nas telas de faturas/cartão foram atualizados para considerar ABERTA_PARCIAL.
• Vinculação de pagamentos em lote passou a aceitar faturas ABERTA e ABERTA_PARCIAL.
• Descrição das movimentações de pagamento/estorno de fatura passou a incluir o nome do cartão no texto (ex.: Pagamento Fatura Cartao #1 (Nubank *1234)), tornando o extrato mais intuitivo.
• Consulta de histórico de pagamentos da fatura no popover foi ajustada para aceitar o padrão de descrição com sufixo do cartão.
• Correção do fluxo de vínculo para faturas ABERTA_PARCIAL, incluindo o endpoint efetivo de /pagamentos/vincular_fatura, permitindo adicionar novos itens em faturas parcialmente pagas.
• Popover Datas de pagamento passou a inicializar com sanitize: false, exibindo corretamente o botão de Desfazer pagamento, e a listagem de parcelas antecipáveis foi liberada para faturas ABERTA_PARCIAL.
• Resumo financeiro da fatura foi redesenhado para cards com mesma altura e agrupado em um painel colapsável (padrão fechado), melhorando legibilidade visual no detalhe da fatura.
• Refino visual dos cards do resumo financeiro: novos ícones por indicador, espaçamento interno ajustado e nova grade para leitura mais equilibrada.

[0.9.13] - 2026-03-19

Changed

• A tela de DRE passou a exibir os recebíveis reais nas receitas, em vez dos tipos genéricos faturado e mensalidade, incluindo o rateio de recebimentos com múltiplos itens para refletir cada serviço vinculado.
• A visualização da DRE foi reorganizada para um formato gerencial sintético: itens iguais agora são consolidados na mesma linha com soma dos valores, reduzindo a volumetria do relatório sem alterar os totais.
• As tabelas de receitas e despesas da DRE, assim como a exportação em PDF, deixaram de exibir Cliente e Fornecedor, mantendo foco em item, conta, forma e valor.

[0.9.12] - 2026-03-18

Changed

• Formulário de contratos passou a usar autocomplete no campo de cliente, substituindo o select extenso por busca digitável com lista flutuante, sem alterar o restante da tela e mantendo o envio do mesmo cliente_id.
• Formulário de pagamentos passou a usar autocomplete no campo de fornecedor, substituindo o select por busca digitável com lista flutuante e mantendo o envio do mesmo fornecedor_id.

[0.9.11] - 2026-03-17

Added

• Novo fluxo amigável na Config. CLT: cadastro de faixas de INSS e IRRF por linhas e campos estruturados, com serialização automática para JSON oculto no submit.
• Ações de Editar, Atualizar pelo cadastro e Excluir rascunho expostas no detalhe e nas listagens de folhas do RH.

Changed

• Geração de folha por competência passou a reaproveitar o rascunho existente, em vez de apenas bloquear a operação com mensagem genérica de duplicidade.
• Aprovação de folha passou a recalcular o snapshot no backend, sincronizar o regime/cadastro atual e consolidar encargos por empresa + competência no Financeiro quando a configuração estiver habilitada.
• Aprovação de folhas CLT em BRL passou a exigir apenas Config. CLT com tabelas válidas de INSS e IRRF; a geração de encargos no Financeiro ficou opcional.
• Favorecido dos encargos consolidados passou a usar a razão social da empresa, com fallback para nome fantasia, em vez do ID interno.

Fixed

• Correção do parser de percentuais da Config. CLT, evitando que valores como 1,00 de RAT fossem tratados como 100% em vez de 1%.
• Prévia de cálculo da folha passou a usar arredondamento alinhado ao backend, eliminando divergências de centavos entre tela e aprovação.
• Recalculo de encargos consolidados agora atualiza também o favorecido dos lançamentos pendentes já existentes.

[0.9.10] - 2026-03-16

Added

• Quando o módulo Cartões & Faturas está desabilitado, pagamentos ainda vinculados a faturas PAGA agora podem abrir uma visualização em modal diretamente pela listagem de pagamentos, sem redirecionar para o dashboard.

Changed

• O badge Fatura Mmm/AAAA em pagamentos passou a abrir uma modal somente-leitura para faturas pagas quando o módulo está desabilitado, preservando o link normal para a tela completa enquanto o módulo estiver ativo.

[0.9.9] - 2026-03-16

Changed

• Ao desativar o opcional Cartões & Faturas no painel de instâncias, o admin agora desassocia automaticamente pagamentos ainda vinculados a faturas ABERTA, FUTURA e FECHADA não paga, preservando os vínculos de faturas PAGA.
• O salvamento de opcionais passou a aguardar a resposta HTTP da instância reiniciada antes de concluir o fluxo, mantendo o processo síncrono quando a instância já estava rodando e sem iniciar automaticamente instâncias já paradas.

Added

• Modal de resumo pós-desativação do módulo Cartões & Faturas, com contagem por tipo de fatura afetada e botão Copiar resumo para facilitar o envio ao cliente.
• Overlay com spinner reutilizado do fluxo de consulta de CNPJ na tela de instâncias ao salvar opcionais, reduzindo risco de duplo clique durante o processamento.

[0.9.8] - 2026-03-15

Added

• Filtros de ano e status na listagem cartoes/faturas-cartao, com ano atual selecionado por padrão e opções Todas, Abertas, Fechadas, Pagas e Futuras.

[0.9.7] - 2026-03-15

Changed

• Lista de cartoes/faturas-cartao agora exibe a coluna Valor com o total atual de cada fatura e passou a ser ordenada por vencimento em ordem crescente.
• Indicador visual de fechamento na listagem de faturas passou a diferenciar faturas futuras, abertas em janela de fechamento e fechadas/pagas por cor e ícone.

[0.9.6] - 2026-03-15

Changed

• Badge de vínculo na listagem de pagamentos passou a priorizar a competência visual da fatura, exibindo Fatura Mmm/AAAA com base no vencimento em vez de usar o ID interno como rótulo principal.

Fixed

• Limpeza automática de faturas FUTURA vazias passou a excluir apenas a última fatura cronológica do cartão, preservando faturas futuras intermediárias para manter a sequência visual na listagem.

[0.9.5] - 2026-03-15

Added

• Novo fluxo de antecipação de parcelas em fatura ABERTA, permitindo trazer parcelas de faturas FUTURA do mesmo cartão para a fatura atual com desconto informado por parcela.

Changed

• Tela de detalhe da fatura agora destaca parcelas antecipadas, mostra o desconto total de antecipação e oferece ação dedicada para Desfazer antecipação.

Fixed

• Remoção genérica de itens passou a bloquear parcelas antecipadas e direcionar o usuário para o fluxo correto de desfazer, evitando inconsistências no parcelamento.

[0.9.4] - 2026-03-15

Changed

• Corrigida a acentuação de mensagens do módulo de pagamentos e do changelog.md.

Fixed

• Exclusão de pagamento na listagem agora navega de volta para a própria tela após sucesso, exibindo as mensagens flash imediatamente sem exigir refresh manual.

[0.9.3] - 2026-03-15

Added

• Propagação automática de pagamentos parcelados para faturas futuras do mesmo cartão ao vincular a parcela inicial em uma fatura aberta.
• Criação automática de faturas com status FUTURA quando o parcelamento exige ciclos seguintes ainda não materializados.

Changed

• Fluxo de faturas do cartão passou a reconhecer o novo status FUTURA, mantendo apenas o ciclo corrente como ABERTA e promovendo/rebaixando o próximo ciclo conforme fechamento/reabertura.
• Tela de pagamentos passou a informar que parcelamentos são distribuídos automaticamente nas próximas faturas.
• Recalculo de datas do cartão agora considera faturas editáveis (ABERTA e FUTURA), preservando FECHADA e PAGA.

Fixed

• Remoção de itens de fatura agora trata parcelamentos em cascata para evitar inconsistências entre parcelas intermediárias e futuras.
• Faturas futuras não podem mais ser fechadas, reduzindo risco de quebra de sequência do parcelamento.

Este arquivo registra correções e patches do projeto, com versionamento semântico.

[0.9.2] - 2026-03-14

Added

• Rastreamento inicial de transferências para integração com ERP, incluindo confirmação de registro para auditoria operacional.

Changed

• Ajustes de comportamento em fatura de cartão de crédito para validar o fluxo após propagação de alterações de ciclo.

Fixed

• Investigação e correções relacionadas a erro e duplicidade em logs de auditoria.

Merged PRs

• #65 - codex/confirmar-funcionalidade-de-fatura-de-cartao-de-credito
• #66 - codex/confirmar-registro-de-transferencias-no-erp
• #67 - codex/investigate-audit-log-error-and-duplications

[0.9.1] - 2026-03-12

Added

• Criação do changelog.md para histórico contínuo de versões e correções.

Changed

• Edição de cartão agora oferece opção explícita para recalcular faturas ABERTAS com base nos novos fechamento_dia e vencimento_dia.
• Mantida a regra de governança: alterações sempre partem do cartão para faturas (sem edição manual de datas na fatura).

Fixed

• Corrigida discrepância entre datas do cartão e faturas abertas já existentes: ao alterar os dias do cartão, o sistema pode refletir automaticamente nas faturas abertas elegíveis.
• Tratamento de conflito de período ao recalcular faturas abertas (evita colisão com outra fatura já existente para o mesmo cartão).
• Alerta de consistência quando pagamentos já vinculados à fatura ficam fora do novo período após recalcular.