🚗 AutoParts System

Sistema completo de gestão para lojas de autopeças, com foco em controle de estoque, organização de produtos e visão gerencial do negócio.

[](https://github.com/RFernandes10/autoparts-system) [](LICENSE)
[](https://reactjs.org/) [](https://www.typescriptlang.org/) [](https://nodejs.org/) [](https://www.postgresql.org/) [](https://www.prisma.io/)

---

✨ Funcionalidades Principais

📦 Gestão de Produtos

• Cadastro Completo: Custo, preço de venda, estoque mínimo e atual
• Categorias Específicas: Pneus, baterias e autopeças
• Especificações Técnicas: Detalhes por tipo de produto
• Compatibilidade: Associação com veículos (modelo/marca/ano)
• Busca Avançada: Filtros por categoria, marca e disponibilidade

👥 Gestão de Clientes e Fornecedores

• CRUD Completo: Cadastro, edição e inativação
• Dados de Contato: Telefone, email, endereço
• Identificação: CPF/CNPJ com validação
• Histórico: Compras e vendas por cliente

💰 Vendas

• Registro de Vendas: Itens, quantidade e forma de pagamento
• Atualização Automática: Estoque baixa automaticamente na venda
• Múltiplos Itens: Carrinho de compras integrado
• Notas Fiscais: Suporte a numeração e série (em desenvolvimento)

📊 Dashboard Gerencial

• Resumo de Produtos: Total cadastrado e valor em estoque
• Estoque Baixo: Alertas de produtos abaixo do mínimo
• Distribuição por Categoria: Gráficos visuais
• Itens Críticos: Lista dos produtos mais caros e com estoque crítico
• Movimentação: Histórico de entradas e saídas

---

📸 Screenshots

Dashboard

Painel de controle com estatísticas e visão geral

Listagem de Produtos

Tela de produtos com cards responsivos

---

🛠 Tecnologias Utilizadas

Backend

Tecnologia	Descrição
Node.js	Runtime JavaScript
TypeScript	Superset tipado do JavaScript
Express.js	Framework web minimalista
Prisma ORM	Object-Relational Mapping moderno
PostgreSQL	Banco de dados relacional robusto
Dotenv	Gerenciamento de variáveis de ambiente

Frontend

Tecnologia	Descrição
React 18	Biblioteca para construção de interfaces
TypeScript	Tipagem estática para JavaScript
Vite	Build tool moderna e rápida
React Router	Navegação SPA (Single Page Application)
Axios	Cliente HTTP para requisições
CSS3	Estilização com Flexbox/Grid

---

🚀 Como Executar o Projeto

Pré-requisitos

• Node.js (versão 18 ou superior)
• PostgreSQL (versão 14 ou superior)
• Git
• npm ou yarn

1. Clone o repositório

git clone https://github.com/RFernandes10/autoparts-system.git
cd autoparts-system

2. Configurar o Backend

cd backend
npm install

Crie um arquivo .env na pasta backend:

DATABASE_URL="postgresql://usuario:senha@localhost:5432/autoparts?schema=public"
PORT=3000

Execute as migrations do banco de dados:

npx prisma migrate dev
npx prisma generate

Inicie o servidor:

npm run dev

✅ O backend estará rodando em http://localhost:3000

3. Configurar o Frontend

Abra um novo terminal:

cd frontend
npm install
npm run dev

✅ O frontend estará rodando em http://localhost:5173

4. Acessar a aplicação

Abra seu navegador e acesse: http://localhost:5173

---

📂 Estrutura do Projeto

autoparts-system/
├── backend/              # API REST (Node.js/Express)
│   ├── src/
│   │   ├── controllers/  # Controladores
│   │   ├── services/     # Lógica de negócio
│   │   ├── routes/       # Rotas da API
│   │   └── config/      # Configurações
│   ├── prisma/
│   │   └── schema.prisma # Modelo do banco
│   └── package.json
│
└── frontend/             # Interface web (React)
    ├── src/
    │   ├── components/   # Componentes React
    │   ├── pages/        # Páginas da aplicação
    │   ├── contexts/     # Context API
    │   ├── hooks/        # Custom hooks
    │   ├── services/     # Integração com API
    │   └── types/       # Tipos TypeScript
    ├── public/           # Imagens e estáticos
    └── package.json

---

🗄️ Modelo de Dados (Principal)

Tabela	Descrição
produtos	Catálogo de produtos com especificações
clientes	Cadastro de clientes
fornecedores	Cadastro de fornecedores
vendas	Registro de vendas
itens_venda	Itens de cada venda
movimentacoes_estoque	Histórico de entrada e saída

---

🎯 Status do Projeto

• ✅ Módulo de produtos com layout premium e responsivo
• ✅ Gestão de clientes e fornecedores
• ✅ Dashboard com estatísticas de estoque e categorias
• ✅ Módulo de vendas básico
• 🚧 Relatórios gerenciais (em desenvolvimento)
• 🚧 Autenticação e controle de acessos
• 🚧 PDV (Ponto de Venda) otimizado para balcão

---

🎯 Diferenciais

• Controle de Estoque Inteligente: Alertas automáticos de reposição
• Compatibilidade Veicular: Busca por modelo/marca/ano
• Categorias Específicas: Pneus, baterias e autopeças
• Dashboard Gerencial: Visão completa do negócio
• Full-Stack TypeScript: Tipagem em todo o stack
• Código Limpo: Separação de responsabilidades

---

📫 Contato

---

⭐ Se este projeto foi útil, considere dar uma estrela!

Feito com ❤️ e ☕ por Roberto Fernandes

Projeto focado em aprendizado com boas práticas de front-end, back-end e versionamento