# Progresso — Módulo de Vendas

Status possíveis: `planejado`, `em_andamento`, `concluido`, `bloqueado`

Atualizado em: 2025-10-30

## Visão geral
- Progresso global (aprox.): 50%
- Destaques recentes: Busca do PDV; localização de produtos; modelagem de vendas; orçamentos CRUD + conversão; faturamento de pedidos; pagamentos de pedidos.

## Tarefas principais

| Tarefa | Status | Responsável | Início | Previsto | % |
|---|---|---|---|---|---|
| Plano e cronograma do módulo Vendas | concluido | equipe | 2025-10-30 | 2025-10-30 | 100% |
| Acompanhar progresso do módulo (este arquivo) | em_andamento | equipe | 2025-10-30 | contínuo | 30% |
| PDV – Busca de produtos com relevância e localização | concluido | equipe | 2025-10-29 | 2025-10-30 | 100% |
| Modelagem de vendas (pedidos, itens, pagamentos) | concluido | equipe | 2025-10-30 | 2025-10-30 | 100% |
| Orçamentos – CRUD e conversão para pedido | concluido | equipe | 2025-10-30 | 2025-10-30 | 100% |
| Faturamento de pedidos – baixa de estoque e status | concluido | equipe | 2025-10-30 | 2025-10-30 | 100% |
| Pagamentos – endpoints e resumo por pedido | concluido | equipe | 2025-10-30 | 2025-10-30 | 100% |
| Pedidos – CRUD, cálculo, status e faturamento | planejado | equipe | 2025-11-05 | 2025-11-12 | 0% |
| Pagamentos – métodos/parcelas/PDV | planejado | equipe | 2025-11-08 | 2025-11-14 | 0% |
| Relatórios essenciais de vendas | planejado | equipe | 2025-11-12 | 2025-11-16 | 0% |
| Testes de integração dos fluxos de vendas | planejado | equipe | 2025-11-05 | 2025-11-16 | 0% |

## Registro de marcos
- 2025-10-30: Endpoint `/api/pdv/produtos/search` finalizado com parâmetros nomeados; testes de integração OK.
- 2025-10-30: Migração `016_products_location.sql` adicionada (localização física em `products`).
- 2025-10-30: Modelagem do módulo vendas criada (`sales_orders`, `sales_order_items`, `sales_payments`).
- 2025-10-30: Orçamentos implementados (tabelas `sales_quotes`, `sales_quote_items`, CRUD e conversão para pedido).
- 2025-10-30: Faturamento de pedidos implementado (`POST /api/vendas/pedidos/{id}/faturar`) com baixa de estoque e auditoria.
- 2025-10-30: Pagamentos por pedido implementados (listar/criar/excluir) com resumo e auditoria.
 - 2025-11-04: Comissões — view ajustada com cabeçalhos de autorização; endpoint `/api/vendas/comissoes/by-seller` validado com teste de integração (`tests/SalesCommissionsBySellerTest.php`).

## Próximos passos imediatos
- Ajustes de cálculo em pedidos (descontos, impostos, arredondamentos) e pontos de auditoria adicionais.
- Implementar endpoints de pagamentos (criação, cancelamento, conciliação básica) e integração com PDV.
 - Comissões: filtros por período/vendedor e exportação CSV; integração direta com cadastro de vendedores (% comissão).