109 lines
6.0 KiB
Markdown
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.
|