Documentação do Projeto
Quinta do Cota Website & Loja Online / E-commerce

1. Visão Geral

O projeto Quinta do Cota é uma plataforma digital bilingue (🇵🇹 / 🇬🇧) composta por um website institucional e uma loja online totalmente integrada. O objetivo é promover os vinhos da Quinta do Cota, apresentar a história e o enoturismo da propriedade, e permitir a compra direta e segura através de uma experiência moderna e responsiva.

2. Tecnologias Utilizadas

3. Funcionalidades Principais

🏠 Website Institucional

• Website bilingue (PT/EN) com layout responsivo
• Páginas principais:
  • Início
  • A Nossa História
  • Região
  • Castas
  • Vinhos
  • Contacto
  • Enoturismo em desenvolvimento
  • Detalhes da Casa em desenvolvimento
• Verificação de idade, aviso de cookies, imagens em parallax e transições suaves

🛒 Loja Online (E-commerce)

• Páginas principais:
  • Loja / Lista de Vinhos
  • Loja / Detalhe do Vinho
  • Loja / Carrinho
  • Loja / Checkout em desenvolvimento
  • Loja / Página de Agradecimento
• Catálogo de vinhos, gestão de stock, carrinho e checkout
• Pagamentos com Stripe (modo de teste neste momento)
• Cálculo automático de portes por país/região e regras de envio gratuito
• Emails automáticos de confirmação de encomenda (PT/EN)
• Notificação automática ao administrador do site aquando de uma nova encomenda

📬 Formulário de Contacto

• Formulário em React integrado ao backend Django (API REST)
• Campos: Nome, Email, Assunto e Mensagem, com validação front e backend
• As mensagens submetidas são gravadas na base de dados e ficam visíveis no Painel de Administração (Django Admin)
• Notificação automática por email ao administrador com todos os detalhes da mensagem

📰 Newsletter

• Subscrição por Email com confirmação (double opt-in)
• Mensagem de boas-vindas após confirmação (PT/EN)
• Notificação automática ao administrador e gestão de subscritores no painel

👤 Área de Utilizador

• Registo e login (email / Google)
• Moradas guardadas ou edição das mesmas (por opção do utilizador) e histórico de encomendas
• Eliminação da conta, caso o utilizador assim o deseje

🧾 Painel de Administração (Django)

Visão geral do painel de administração:

• Gestão de produtos, preços, stock, regiões de envio e subscritores
• Gestão de encomendas com identificação do pagamento (Stripe ID)
• Gestão completa de portes de envio, incluindo cálculo automático de custos de entrega por país e região, com opções de envio gratuito conforme regras definidas
• Receção e gestão de mensagens de contacto (base de dados + email ao administrador)
• Envio e edição de newsletters personalizadas diretamente a partir do painel administrativo
• Definição de visibilidade da loja online — opção para mostrar ou ocultar a loja conforme o estado de desenvolvimento ou manutenção

4. Testar Pagamentos Stripe

Nota: Em modo de teste, pode simular compras sem custos. Use qualquer data de expiração futura (ex.: 12/34) e qualquer CVC (ex.: 123).

Após um pagamento bem-sucedido, a encomenda surge no painel de administração e é enviado um email de confirmação ao utilizador.

No exemplo abaixo pode ver como fazer uma compra em modo de teste usando o Stripe Payments.