RVM.ShopEngine
Motor de e-commerce com catalogo, carrinho por sessao, checkout com controle de estoque e ciclo de pagamento.
Visao geral
RVM.ShopEngine e um motor de e-commerce completo com catalogo de produtos por categorias (com slug), carrinho baseado em sessao, checkout com validacao e decremento automatico de estoque, e ciclo completo de pagamento (Pending -> Authorized -> Captured -> Failed -> Refunded). Suporta multiplos metodos de pagamento (CreditCard, DebitCard, Pix, BankSlip, Wallet) e mantem snapshots dos produtos no momento do pedido.
Funcionalidades
- Catalogo de produtos com categorias, slugs, SKU, precos e estoque
- Carrinho baseado em SessionId com calculo automatico de total
- Checkout: cria Order a partir do Cart com validacao de estoque e decremento atomico
- Geracao automatica de OrderNumber
- Snapshot de produto no momento do pedido (preco, nome salvos no OrderItem)
- Ciclo de vida do pedido: Pending -> Confirmed -> Processing -> Shipped -> Delivered / Cancelled / Refunded
- Ciclo de pagamento: Pending -> Authorized -> Captured -> Failed -> Refunded
- 5 metodos de pagamento: CreditCard, DebitCard, Pix, BankSlip, Wallet
- Busca de produtos com filtros por query, categoria e status ativo
Tecnologias
Padroes & arquitetura
Endpoints REST
| Method | Path | Descricao |
|---|---|---|
| GET | /api/products | Buscar produtos |
| GET | /api/categories | Listar categorias |
| GET | /api/cart/{sessionId} | Ver carrinho |
| POST | /api/cart/{sessionId}/items | Adicionar ao carrinho |
| POST | /api/orders | Criar pedido do carrinho |
| POST | /api/payments/{orderId}/capture | Capturar pagamento |