Files
Pdv-Pos/pdv/docs/DECISIONS.md
T

109 lines
6.0 KiB
Markdown

# 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.