☕ Hub do Café

Projeto Acadêmico / Portfólio - Sistema de Gestão e E-commerce para Cafeteria Gourmet.

Projeto Integrador Transdisciplinar - Sistemas de Informação II

Autor: Renan Douglas de Souza • RGM: 31228348
Universidade: Cruzeiro do Sul Virtual • Data: Novembro 2025

---

📖 Sobre o Projeto

O Hub do Café é uma plataforma completa que une um e-commerce moderno para clientes e um sistema de gestão (ERP) robusto para administradores.

O objetivo é oferecer uma experiência fluida de pedido online ("Just-in-time") e fornecer ferramentas poderosas para a gestão de cardápio, pedidos e entregas em tempo real.

🚀 Diferenciais Técnicos & DevOps

Este projeto vai além do código, implementando uma esteira de DevOps completa:

• Infraestrutura Cloud: Hospedado em AWS EC2 com IP Elástico.
• CI/CD Pipeline: Deploy automatizado via GitHub Actions. Todo push na branch main aciona um workflow que atualiza o servidor, instala dependências e roda migrations automaticamente.
• Servidor Web: Alta performance com Nginx e PHP-FPM.
• Banco de Dados: Escalabilidade com PostgreSQL self-hosted.
• Segurança: Tráfego protegido por Cloudflare (SSL Full Strict) e firewall configurado.
• Frontend Moderno: Build de assets em produção otimizado com Vite.

---

🛠️ Tecnologias Utilizadas

Backend & Infraestrutura & DevOps

• PHP 8.3+ & Laravel 12
• Redis (Cache, Session, Queue)
• PostgreSQL (Database self-hosted)
• AWS EC2 (Compute/Linux Ubuntu 24.04)
• Nginx (Web Server)
• GitHub Actions (CI/CD)
• Cloudflare (DNS & Security)

Frontend

• Blade Templates: Uso avançado de Componentes (x-components) para modularização e reutilização de interface.
• Tailwind CSS (Estilização Utility-First)
• Alpine.js (Interatividade JavaScript)
• Vite (Asset Bundling)
• TailAdmin (Base de UI para Dashboard)
• ApexCharts (Dashboards Visuais)

🔄 Fluxo de Deploy Automatizado

graph LR
  A[Dev Push] -- git push --> B(GitHub Repo)
  B -- Webhook --> C{GitHub Actions}
  C -- SSH --> D[AWS EC2]
  D -- git pull --> E[Atualiza Código]
  D -- npm build --> F[Compila Assets]
  D -- migrate --> G[Atualiza Banco]

Loading

---

✨ Funcionalidades

👤 Para o Cliente

• Visualização de Cardápio Gourmet.
• Adição de itens ao carrinho.
• Checkout simplificado (Cadastro "Just-in-Time" no primeiro pedido).
• Gestão de Endereços de Entrega.
• Histórico de Pedidos.

🛡️ Para o Administrador (ERP)

• Dashboard: Métricas de vendas e pedidos em tempo real.
• Gestão de Produtos: CRUD completo com upload de imagens.
• Gestão de Pedidos: Alteração de status (Recebido, Em Preparo, Saiu para Entrega).
• Controle de Usuários: Gerenciamento de clientes e funcionários (RBAC).

---

⚙️ Como Rodar Localmente

Siga os passos abaixo para rodar o projeto na sua máquina:

Pré-requisitos

• PHP 8.3+
• Composer
• Node.js 20+ (LTS)
• Git

Instalação

1. Clone o repositório

   git clone [https://github.com/seu-usuario/hub-do-cafe.git](https://github.com/seu-usuario/hub-do-cafe.git)
   cd hub-do-cafe

2. Instale as dependências do Backend

   composer install

3. Instale as dependências do Frontend

   npm install

4. Configure o Ambiente

   cp .env.example .env
   php artisan key:generate

   Configure suas credenciais de banco de dados (SQLite ou Postgres) no arquivo .env.

5. Rode as Migrations e Seeders

   php artisan migrate:fresh --seed

   Isso criará o Admin (admin@hubdocafe.com) e Cliente de teste.

6. Inicie o Servidor

   compose run dev

7. Acesse: http://localhost:8000

---

👏 Créditos e Agradecimentos

• Interface Admin: O layout do painel administrativo utiliza como base o TailAdmin (Free Version), adaptado e componentizado para Laravel Blade.
• Ícones: Material Icons.

---

📄 Licença

Este projeto está sob a licença MIT. Desenvolvido para fins acadêmicos.

---

Feito com ☕ e 💻 por Renan Douglas