181186 - Criar PDV Android para rodar em maquinas P.O.S.
This commit is contained in:
commit
c9983cbad5
204 files changed
+11453
No files matched your search
@@ -0,0 +1,108 @@
|
||||
# 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.
|
||||
Reference in new issue
Block a user