6.0 KiB
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
compileSdkVersionAndroid foi definido como 34, exigido pelo pluginshared_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 viaflutter_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_idpadrã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 deres.usersemPOST /pdv_pos/logar. - A sessão Odoo 7 usa o cookie HTTP
side osession_idinterno, ambos armazenados comflutter_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
3foi 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/healthno servidor Odoo 7 alvo. - Homologar login, cookie de sessão e tipo de licença
3no 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.