🍇 Açaiteria CRM — Combina Açaí

Sistema de Gestão de Relacionamento com o Cliente

🎓 Projeto Integrador — UNIVESP

Universidade Virtual do Estado de São Paulo

Eixo Computação · Grupo 22 · Polo Lorena/SP

Desenvolvimento de um software com framework web que utilize noções de banco de dados, acessível pela internet, para resolver um problema real da comunidade.

50+
Endpoints API
320+
Testes Automatizados
20+
Páginas HTML
18
Modelos de Dados

🎯 Objetivos do Projeto

  • Automatizar o cadastro e gestão de clientes
  • Controlar vendas, estoque e faturamento
  • Gerar relatórios e indicadores (KPIs)
  • Implementar programa de fidelidade com pontos
  • Garantir conformidade com a LGPD
  • Oferecer interface acessível via dispositivo móvel
  • Disponibilizar vitrine pública para clientes

⚡ Funcionalidades Principais

  • Dashboard com gráficos e KPIs em tempo real
  • Registro de vendas com complementos e cupons
  • Gestão de clientes com programa de fidelidade
  • Controle de produtos, estoque e fornecedores
  • Fechamento de caixa diário
  • Relatórios em PDF e exportação CSV
  • Sistema de suporte com tickets
  • Vitrine pública com carrinho e Pix QR Code
  • Modo escuro (dark mode)
  • PWA — Instalável como aplicativo

🛠️ Tecnologias Utilizadas

Python 3.13 Flask 2.3 SQLAlchemy Flask-RESTX Pydantic Gunicorn HTML5 CSS3 JavaScript ES6+ Chart.js Service Worker PostgreSQL Docker Render.com GitHub Actions CI

🏗️ Arquitetura

  • Backend: API RESTful com Flask + flask-restx (Swagger)
  • Frontend: HTML/CSS/JS puro (sem framework SPA)
  • Banco de Dados: PostgreSQL (produção) / SQLite (testes)
  • Deploy: Docker no Render.com (PaaS)
  • CI/CD: GitHub Actions — Lint + Testes automáticos
  • Segurança: CSP, CSRF, Rate Limiting, LGPD
  • PWA: Service Worker para funcionamento offline

🔒 Segurança & LGPD

  • Autenticação: Login com senha hash (Werkzeug)
  • CSRF: Proteção contra Cross-Site Request Forgery
  • CSP: Content Security Policy em todas as respostas
  • Rate Limiting: Proteção contra abuso de requisições
  • LGPD: Consentimento explícito, direito ao esquecimento, exportação de dados
  • HTTPS: HSTS em produção com certificado TLS

📚 O que é o Projeto Integrador?

O Projeto Integrador (PI) é uma disciplina prática da UNIVESP que desafia os alunos a desenvolverem uma solução tecnológica real para um problema identificado na comunidade local. O projeto integra conhecimentos de diversas disciplinas do curso, promovendo a aplicação prática da teoria em um contexto de desenvolvimento colaborativo de software.