Vinho em Casa

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.

Next.jsReactTypeScriptTailwind CSSPrismaPostgreSQLStripe

Informações sobre o projeto

🧠 Engenharia de desenvolvimento com IA

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