sistema-mercadinho-felipe

---

📑 Sumário

• 📖 Sobre o Projeto
• ✨ Características
• 🗄️ Banco de Dados
  • Estrutura das Tabelas
  • Diagrama de Relacionamento
• 🚀 Tecnologias
• 📋 Pré-requisitos
• 🎯 Instalação e Configuração
• 📁 Estrutura do Projeto
• 🎯 Guia de Uso
• 📸 Screenshots
• 👨‍💻 Desenvolvedores

---

📖 Sobre o Projeto

O Sistema de Gestão - Mercadinho do Felipe é uma aplicação web completa desenvolvida em Java utilizando o padrão arquitetural MVC (Model-View-Controller) combinado com o padrão DAO (Data Access Object).

O sistema oferece uma solução robusta para gerenciamento de pequenos mercados, incluindo:

• ✅ Gerenciamento Completo de CRUD: Clientes, Fornecedores, Produtos e Vendas
• 🔄 Controle de Estoque Automático: Atualização em tempo real com cada venda
• 💾 Transações ACID: Garantia de integridade e consistência dos dados
• 🔐 Controle de Acesso: Dois níveis de usuários (Admin e Funcionário)
• 📊 Relatórios e Consultas: Buscas avançadas com múltiplos critérios
• 🎨 Interface Responsiva: Design moderno e intuitivo

🎓 Contexto Acadêmico

Este projeto foi desenvolvido como trabalho da disciplina de Análise e Implementação de Software com foco em:

• Aplicação prática do padrão MVC
• Implementação de transações em banco de dados
• Gerenciamento de sessões e autenticação
• Operações CRUD completas
• Integridade referencial e regras de negócio

---

✨ Características

🎯 Funcionalidades Principais

👥 Gerenciamento de Clientes

• ✅ Cadastro completo com validação de CPF único
• 🔍 Consulta geral e consulta por ID
• ✏️ Alteração de dados cadastrais
• 🗑️ Exclusão com verificação de vendas vinculadas
• 📋 Campos: Nome, CPF, Telefone, Email, Endereço

🏢 Gerenciamento de Fornecedores

• ✅ Cadastro com validação de CNPJ único
• 🔍 Consulta geral e por ID
• ✏️ Alteração de informações
• 🗑️ Exclusão com ajuste automático em produtos
• 📋 Campos: Nome, CNPJ, Telefone, Email, Endereço

📦 Gerenciamento de Produtos

• ✅ Cadastro com vinculação opcional a fornecedor
• 🔍 Consulta geral, por ID e busca por nome (parcial)
• 📊 Controle de estoque integrado
• ✏️ Alteração de dados, preços e estoque
• 🗑️ Exclusão com verificação de vendas
• 📋 Campos: Nome, Valor, Quantidade (estoque), Categoria, ID Fornecedor

💰 Gerenciamento de Vendas

• 🛒 Registro de vendas com validação de estoque em tempo real
• 🔄 Atualização automática do estoque ao realizar venda
• 💵 Cálculo automático de valores (unitário × quantidade)
• 🔍 Consulta geral e por ID com nomes de clientes e produtos
• ✏️ Alteração de vendas com ajuste inteligente de estoque
• ♻️ Exclusão com restauração automática do estoque
• ⏰ Registro de data/hora em timezone brasileiro
• 📋 Campos: ID Cliente, ID Produto, Quantidade, Valor Unitário, Valor Total, Data/Hora

🔐 Segurança e Controle de Acesso

Sistema de Autenticação

• 🔑 Login Seguro: Autenticação com usuário e senha
• 🛡️ Controle de Sessão: Verificação automática em todas as páginas protegidas
• 🚪 Logout Seguro: Encerramento completo da sessão

Perfis de Acesso

👑 ADMIN (Administrador)

• ✅ Acesso completo a todas as funcionalidades
• ✅ CRUD completo em todos os módulos
• ✅ Exclusão de registros
• ✅ Alteração de dados críticos

👤 FUNCIONÁRIO

• ✅ Consulta de produtos, fornecedores e clientes
• ✅ Cadastro de clientes e vendas
• ❌ Sem permissão para alterações e exclusões
• ❌ Sem acesso a dados críticos do sistema

🔒 Transações de Banco de Dados

• ACID Completo: Atomicidade, Consistência, Isolamento, Durabilidade
• Rollback Automático: Em caso de erro, todas as operações são desfeitas
• Integridade Referencial: Validação de chaves estrangeiras
• Controle de Concorrência: Gerenciamento de múltiplos acessos simultâneos

---

🗄️ Banco de Dados

Estrutura das Tabelas

👥 Tabela clientes

CREATE TABLE clientes (
    pk_id       INT AUTO_INCREMENT PRIMARY KEY,
    nome        VARCHAR(100) NOT NULL,
    cpf         VARCHAR(14) UNIQUE NOT NULL,
    telefone    VARCHAR(15),
    email       VARCHAR(100),
    endereco    VARCHAR(200)
);

🏢 Tabela fornecedores

CREATE TABLE fornecedores (
    pk_id       INT AUTO_INCREMENT PRIMARY KEY,
    nome        VARCHAR(100) NOT NULL,
    cnpj        VARCHAR(18) UNIQUE NOT NULL,
    telefone    VARCHAR(15),
    email       VARCHAR(100),
    endereco    VARCHAR(200)
);

📦 Tabela produtos

CREATE TABLE produtos (
    pk_id           INT AUTO_INCREMENT PRIMARY KEY,
    nome            VARCHAR(100) NOT NULL,
    valor           DECIMAL(10,2) NOT NULL,
    qtd             INT NOT NULL DEFAULT 0,
    categoria       VARCHAR(50),
    id_fornecedor   INT,
    FOREIGN KEY (id_fornecedor) REFERENCES fornecedores(pk_id)
        ON DELETE SET NULL
);

💰 Tabela vendas

CREATE TABLE vendas (
    pk_id           INT AUTO_INCREMENT PRIMARY KEY,
    id_cliente      INT NOT NULL,
    id_produto      INT NOT NULL,
    quantidade      INT NOT NULL,
    valor_unitario  DECIMAL(10,2) NOT NULL,
    valor_total     DECIMAL(10,2) NOT NULL,
    data_venda      DATETIME NOT NULL,
    FOREIGN KEY (id_cliente) REFERENCES clientes(pk_id)
        ON DELETE RESTRICT,
    FOREIGN KEY (id_produto) REFERENCES produtos(pk_id)
        ON DELETE RESTRICT
);

👤 Tabela funcionarios

CREATE TABLE funcionarios (
    pk_id       INT AUTO_INCREMENT PRIMARY KEY,
    nome        VARCHAR(100) NOT NULL,
    cpf         VARCHAR(14) UNIQUE NOT NULL,
    telefone    VARCHAR(15),
    email       VARCHAR(100),
    login       VARCHAR(50) UNIQUE NOT NULL,
    senha       VARCHAR(50) NOT NULL,
    tipo_acesso ENUM('ADMIN', 'FUNCIONARIO') NOT NULL
);

📊 Diagrama de Relacionamento (ER)

erDiagram
    CLIENTES ||--o{ VENDAS : "realiza"
    PRODUTOS ||--o{ VENDAS : "vendido em"
    FORNECEDORES ||--o{ PRODUTOS : "fornece"
    
    CLIENTES {
        int pk_id PK
        varchar nome
        varchar cpf UK
        varchar telefone
        varchar email
        varchar endereco
    }
    
    FORNECEDORES {
        int pk_id PK
        varchar nome
        varchar cnpj UK
        varchar telefone
        varchar email
        varchar endereco
    }
    
    PRODUTOS {
        int pk_id PK
        varchar nome
        decimal valor
        int qtd
        varchar categoria
        int id_fornecedor FK
    }
    
    VENDAS {
        int pk_id PK
        int id_cliente FK
        int id_produto FK
        int quantidade
        decimal valor_unitario
        decimal valor_total
        datetime data_venda
    }
    
    FUNCIONARIOS {
        int pk_id PK
        varchar nome
        varchar cpf UK
        varchar telefone
        varchar email
        varchar login UK
        varchar senha
        enum tipo_acesso
    }

🛡️ Regras de Integridade

Operação	Tabela	Restrição	Comportamento
DELETE	fornecedores	produtos.id_fornecedor	SET NULL - Produtos ficam sem fornecedor
DELETE	clientes	vendas.id_cliente	RESTRICT - Não permite exclusão se houver vendas
DELETE	produtos	vendas.id_produto	RESTRICT - Não permite exclusão se houver vendas
INSERT	produtos	id_fornecedor	Pode ser NULL (fornecedor opcional)
INSERT	vendas	id_cliente, id_produto	Obrigatórios e devem existir
UPDATE	vendas	quantidade	Ajusta estoque automaticamente

---

🚀 Tecnologias

Stack Completo

Padrões de Projeto Utilizados

• 🏗️ MVC (Model-View-Controller): Separação de responsabilidades
• 💾 DAO (Data Access Object): Abstração de acesso a dados
• 🔌 Factory Pattern: Criação de conexões (ConectaBanco)
• 📦 JavaBeans: Encapsulamento de dados
• 🔄 Transaction Script: Gerenciamento de transações

---

📋 Pré-requisitos

Antes de começar, certifique-se de ter instalado em sua máquina:

Software Necessário

Software	Versão Mínima	Download
☕ Java JDK	8 ou superior	Oracle JDK
🐬 MySQL Server	5.7 ou superior	MySQL Downloads
🐱 Apache Tomcat	8.5 ou superior	Tomcat Downloads
🌐 Navegador Web	Versão atual	Chrome, Firefox, Edge, Safari
💻 IDE (opcional)	-	NetBeans, Eclipse, IntelliJ

---

🎯 Instalação e Configuração

1️⃣ Clone o Repositório

git clone https://github.com/seu-usuario/sistema-mercadinho-felipe.git
cd sistema-mercadinho-felipe

2️⃣ Configure o Banco de Dados

Opção A: Via Terminal MySQL

# Entre no MySQL
mysql -u root -p

# Execute o script
source script_bancodedados.sql

# Verifique as tabelas criadas
USE mercadinho_felipe;
SHOW TABLES;

Opção B: Via MySQL Workbench

1. Abra o MySQL Workbench
2. Conecte ao servidor local
3. File → Open SQL Script → selecione script_bancodedados.sql
4. Execute o script (⚡ ícone de raio)

3️⃣ Configure a Conexão com o Banco

Edite o arquivo src/java/Config/ConectaBanco.java:

public class ConectaBanco {
    // Ajuste conforme sua configuração local
    private static