api-lucinete-loja
🛍️ API para E-commerce — Lojinha da Lucinete
Esta API RESTful oferece os recursos essenciais para um e-commerce completo da Lojinha da Lucinete, incluindo gerenciamento de usuários, produtos, categorias, carrinho e vendas. Possui autenticação via JWT, documentação Swagger e configuração simples com Docker.
✨Funcionalidades
Funcionalidades Públicas
- 👀 Listagem e busca de produtos:
Consultar catálogo com filtros por categoria, nome e ordenação por preço/data. - 📂 Visualização de categorias:
Obter categorias para facilitar a navegação do catálogo. - 🧾 Detalhes do produto:
Acessar informações completas como nome, descrição, preço e disponibilidade. - 📚 Documentação interativa:
Explorar e testar endpoints via Swagger em /docs.
⚠️ Nota: A navegação é pública, porém ações sensíveis como gerenciar carrinho, criar venda ou administrar catálogo exigem autenticação.
Funcionalidades Restritas
- 🔐 Autenticação & Perfil:
Registro e login (JWT). Acesso a dados do usuário e operações autenticadas. - 🛒 Carrinho de Compras:
- ➕ Adicionar/atualizar/remover itens do carrinho
- 🧮 Cálculo de totais
- 💳 Vendas/Checkout:
Registrar venda a partir do carrinho e consultar históricos do usuário. - 📦 Catálogo (Admin):
- CRUD de produtos e categorias
- Controle de estoque/preço
- 📊 Relatórios (Admin):
Consultas agregadas de vendas e itens, auxiliando na gestão.
🛠️Aspectos Técnicos
- Framework ⚙️:Node.js com Express, CORS e Swagger para documentação.
- Banco de Dados 🗄️:MySQL (mysql2) com repositórios dedicados.
- Autenticação 🔐:JWT (jsonwebtoken) e senhas com bcryptjs.
- Infra 🐳:Dockerfile para conteinerização; variáveis via dotenv.
- E-mails ✉️:Suporte com Nodemailer (SMTP).
- Docs 📚:Swagger UI disponível em /docs.