
Projeto
Vinho em Casa
O Vinho em Casa é uma plataforma de e-commerce e assinaturas desenvolvida para proporcionar uma experiência premium na compra de vinhos online. O sistema permite a venda de vinhos avulsos, gestão de assinaturas recorrentes, integração completa com Stripe e uma área administrativa para gerenciamento de produtos, pedidos e clientes.
Informações sobre o projeto
O desenvolvimento do Vinho em Casa foi conduzido utilizando uma abordagem moderna baseada em engenharia de contexto aplicada com IA, utilizando inteligência artificial como parte ativa do processo arquitetural e técnico da plataforma.
Durante o desenvolvimento, foram definidos contextos, skills e prompts especializados para orientar a construção da aplicação, garantindo consistência visual, organização estrutural e separação correta de responsabilidades entre frontend, backend e regras de negócio.
A IA foi utilizada como apoio em:- definição arquitetural
- estruturação de features
- padronização de código
- organização de fluxo SaaS
- integração Stripe
- e-commerce de vinhos
- clube de assinatura
- UX/UI premium
- componentização
- design system
- SEO técnico
- refatorações
- validação de arquitetura
Além disso, foram aplicadas skills especializadas para frontend, backend, UX, UI, performance, SEO e arquitetura, permitindo acelerar o desenvolvimento mantendo uma estrutura próxima de aplicações reais de mercado.
Regras arquiteturais aplicadas:- Prisma nunca acessado diretamente no frontend
- Server Actions sempre que possível
- Server Components por padrão
- Separação entre leitura e escrita
- Componentização reutilizável
- Organização modular por features
- Escalabilidade estrutural
- Tipagem forte com TypeScript
- Stripe como fonte da verdade para billing
🧠 TECNOLOGIAS UTILIZADAS
O Vinho em Casa foi desenvolvido utilizando tecnologias modernas do ecossistema web, com foco em performance, escalabilidade e experiência premium do usuário.
🚀 Frontend
- Next.js (App Router) — estrutura fullstack moderna
- React + TypeScript — componentização e tipagem forte
- Tailwind CSS — estilização moderna e consistente
- Zustand — gerenciamento de estado client-side
- Zod — validação de dados
- Lucide Icons — ícones modernos e leves
⚙️ Backend
- Next.js Server Actions — lógica server-side integrada
- Prisma ORM — manipulação segura do banco de dados
- PostgreSQL (Neon) — banco relacional serverless
- Arquitetura baseada em Services e Repositories
🔐 Autenticação e controle
Sistema de autenticação com níveis de acesso:
- ADMIN
- USER
- Controle de acesso baseado em permissões (RBAC)
- Proteção de rotas privadas
- Sessão persistente
- Middleware de autenticação
💳 Pagamentos
Integração completa com Stripe para vendas avulsas e assinaturas recorrentes:
- criação automática de customer
- checkout hospedado pela Stripe
- compra de vinhos avulsos
- assinaturas recorrentes
- customer portal
- billing recorrente
- webhooks
- cancelamento de assinatura
- sincronização automática de status
- sincronização de planos Stripe
🍷 Funcionalidades principais
Catálogo de vinhos
- Listagem de vinhos
- Página individual de produto
- Informações técnicas e sensoriais
- Produtos relacionados
- Avaliações de clientes
Carrinho e checkout
- Mini Cart global
- Carrinho persistente
- Controle de quantidade
- Resumo do pedido
- Checkout integrado com Stripe
Clube de assinatura
- Planos recorrentes
- Integração Stripe Billing
- Portal de gerenciamento
- Upgrade e downgrade de plano
- Cancelamento de assinatura
- Sincronização automática com Stripe
Dashboard
- Dashboard do assinante
- Dashboard administrativa
- Histórico de pedidos
- Gestão de assinaturas
- Gestão de avaliações
- Métricas operacionais
🎨 UX/UI
O sistema foi desenvolvido com foco em experiência moderna e aparência premium:
- Landing Page premium
- Dashboard estilo SaaS
- Sidebar moderna
- Design inspirado no universo do vinho
- Dark mode elegante
- Design system customizado
- Microinterações
- Hover effects
- Motion suave
- Layout responsivo
- UX refinada
⚡ SEO e Performance
- Metadata dinâmica
- Open Graph
- JSON-LD estruturado
- Server Components
- Otimização de imagens com next/image
- Code Splitting
- Lazy Loading
- HTML renderizado no servidor
📱 Responsividade
O sistema foi projetado para:
- Desktop
- Tablet
- Mobile
Com adaptação inteligente dos layouts, dashboard e componentes para diferentes tamanhos de tela.
🛠️ DevOps
- Deploy com Vercel
- Banco de dados via Neon
- Variáveis de ambiente seguras
- Build otimizado
- Integração contínua com GitHub
- Health Checks
- Observabilidade e monitoramento
📌 Objetivo do Projeto
O Vinho em Casa foi desenvolvido como um projeto de estudo avançado voltado para:
- arquitetura fullstack moderna
- e-commerce
- clube de assinatura
- billing recorrente
- integração Stripe
- UX/UI premium
- engenharia de prompt
- desenvolvimento assistido por IA
- aplicações escaláveis com Next.js
O objetivo foi simular o desenvolvimento de um produto digital profissional combinando e-commerce, assinaturas recorrentes e experiência premium, com características próximas de plataformas reais utilizadas no mercado.
Acessar o sistema- Email do ADMIN: admin@vinhoemcasa.com.br
- Senha: Admin123
- Email do USER: usuario@vinhoemcasa.com.br
- Senha: User123