Files

6.0 KiB

Decisões e pendências

Implementado

  • O app mantém Flutter 3.16.5 e Dart 3.2.3; esses SDKs não foram atualizados.
  • O compileSdkVersion Android foi definido como 34, exigido pelo plugin shared_preferences_android; min/target SDK permanecem gerenciados pelo Flutter.
  • A navegação inicial usa rotas nomeadas do Flutter, sem biblioteca extra.
  • As rotas de venda, carrinho, pagamento e histórico são protegidas e exigem sessão. Nenhum login bem-sucedido é simulado.
  • A URL e o identificador da empresa são persistidos com shared_preferences; senhas não são persistidas e o cookie de sessão é guardado via flutter_secure_storage.
  • O formulário aceita até 14 caracteres alfanuméricos para o identificador.
  • HTTPS é obrigatório fora do modo debug. HTTP é aceito apenas em debug para permitir desenvolvimento em ambientes locais.
  • Ao alterar servidor/empresa, a sessão local é invalidada. Cache de dados ainda não existe.
  • Login e teste de conexão usam contratos internos e adaptadores Odoo 7; a homologação real ainda está pendente.
  • A sessão em memória mantém o usuário e o company_id padrão retornados no login, como contexto inicial para o catálogo.
  • Foi selecionada uma API de negócio dedicada no módulo pdv_pos. O primeiro endpoint definido é GET /pdv_pos/health, sem autenticação e sem dados sensíveis; login e catálogo serão definidos separadamente.
  • O botão Testar conexão usa o endpoint de health, exige HTTP 200 e o JSON esperado, aplica timeout e não segue redirecionamentos.
  • O login Odoo 7 combina seleção de database por CNPJ via app_pdv_pos.config, validação da licença do dispositivo e autenticação de res.users em POST /pdv_pos/logar.
  • A sessão Odoo 7 usa o cookie HTTP sid e o session_id interno, ambos armazenados com flutter_secure_storage; a senha não é persistida.
  • Em execução desktop de desenvolvimento (por exemplo, Linux), o cookie de sessão fica somente em memória para não depender do plugin nativo seguro.
  • O tipo de licença 3 foi reservado ao PDV, sem reutilizar os tipos de Coletor ou Comanda.
  • O app pula a leitura/licença do dispositivo fora do Android para permitir testes desktop; o login Odoo continua obrigatório. O valor de plataforma é declarativo e não deve ser tratado como controle de segurança em produção.
  • A permissão de câmera está declarada para uso futuro, mas não é solicitada em tempo de execução nesta fase.

Fase 1 parcialmente concluída

  • Tela de login com usuário, senha (ocultável), validação, carregamento e botão de saída, integrada à sessão web Odoo e checagem da licença do POS.
  • Tela de configuração com carregamento, validação, salvar/cancelar e teste de conexão com health check dedicado.
  • Persistência local das configurações não sensíveis.
  • A permissão de câmera está declarada para uso futuro, mas não é solicitada em tempo de execução nesta fase.

Fase 2 iniciada

  • Departamentos carregam todos os registros, ordenados alfabeticamente; a UI exibe apenas o nome e mantém o ID para consultar produtos.
  • Produtos são carregados por departamento pelo método existente de Vendas Externas, usando a empresa padrão do usuário e todas as páginas/registros.
  • Não há paginação por decisão inicial; medir o catálogo POS real e rever caso o carregamento seja pesado.
  • A visualização Kanban usa três produtos por linha. A preferência Lista/Kanban é persistida localmente por ID do usuário Odoo.

Fase 3 parcialmente concluída

  • Carrinho compartilhado entre Venda e Carrinho durante a sessão do app.
  • Quantidade pode ser aumentada; o botão Menos não reduz abaixo de 1. A lixeira remove explicitamente o item e Limpar carrinho exige confirmação.
  • Total é uma prévia calculada em unidades mínimas inteiras; se algum preço estiver indisponível, o total também é indicado como indisponível.

Fase 4 parcialmente concluída

  • Consulta de clientes por nome ou documento usa financeiro.cliente, filtra pela empresa padrão e só retorna documento mascarado.
  • Opções dinâmicas vêm de combinações ativas em adm.condicao.forma.
  • A tela agrupa as formas em Dinheiro, PIX, Cartão de Crédito e Cartão de Débito conforme os códigos Odoo; combinações múltiplas do mesmo grupo pedem escolha da condição.
  • É possível lançar várias parcelas e distribuir o valor da venda entre formas diferentes, sem exceder o total. Dinheiro fica registrado como recebido; PIX/cartões ficam pendentes de confirmação pela API do POS.
  • Finalização NFC-e aceita, por enquanto, somente pagamentos totalmente em dinheiro. O endpoint cria/valida o pedido e aguarda pedcap_button_faturar_pedido_nfce; se a nota estiver vinculada, retorna número/série/estado mesmo quando a autorização falhar. A tela bloqueia ações durante a espera e exibe o erro; sem nota, libera uma nova tentativa.
  • Cliente continua opcional. Se a configuração do Odoo exigir CPF/CNPJ para NFC-e, o app pergunta antes de repetir a finalização.
  • A tela final exibe número/série da nota e permite iniciar outra venda. O botão de impressão aguarda o contrato da API/SDK da impressora do POS.

Pendências

  • Homologar GET /pdv_pos/health no servidor Odoo 7 alvo.
  • Homologar login, cookie de sessão e tipo de licença 3 no serviço central.
  • Validar se DeviceInfo.id é uma identidade estável/exclusiva nos POS alvo.
  • Reavaliar paginação e cache persistente após medir o catálogo nos POS alvo.
  • Definir versão/descoberta do Odoo e o uso do identificador enviado pelo app.
  • Significado do identificador exibido como CNPJ.
  • Modelo POS, versão mínima do Android e orientação alvo.
  • Contrato da API oficial do POS para confirmar PIX/cartão e imprimir NFC-e, inclusive reimpressão a partir do histórico de vendas.
  • Exibir no histórico o número e a série da NFC-e vinculada a cada pedido.
  • Homologar leitura por câmera e os demais requisitos de documento fiscal/ impressora no modelo de POS escolhido.
  • Regras para operação sem conexão.