Sistema de Controle de Estoque

Sobre o Projeto

Este projeto consiste em um sistema de controle de estoque desenvolvido em Laravel, com o objetivo de gerenciar produtos, categorias e movimentações de entrada e saída de itens.
A aplicação busca oferecer uma solução simples, organizada e escalável para o gerenciamento de estoques, podendo ser utilizada em pequenas e médias empresas ou como base para estudos e evoluções futuras.

---

Funcionalidades

• Cadastro, edição e exclusão de produtos
• Organização de produtos em categorias
• Registro de movimentações de estoque (entradas e saídas)
• Exibição do saldo atual de cada produto

---

Tecnologias Utilizadas

• Laravel – Framework PHP para desenvolvimento backend (arquitetura MVC)
• Blade – Template engine do Laravel para renderização de views
• PHP 8.x – Linguagem utilizada no backend
• MySQL – Banco de dados relacional
• Composer – Gerenciador de dependências PHP
• Node.js + npm – Compilação de recursos front-end (quando aplicável)

---

Pré-requisitos

• PHP (>= 8.x)
• Composer
• MySQL (ou outro banco compatível)
• Node.js e npm (para gerenciamento de assets)

---

Instalação

Siga os passos abaixo para configurar e executar o sistema:

1. Clonar o repositório

git clone https://github.com/rainervitorrv/stock.git
cd stock
2. Instalar as dependências PHP

composer install
3. Criar e configurar o arquivo .env

cp .env.example .env
php artisan key:generate
4. Configurar o banco de dados no arquivo .env

5. Executar as migrations

php artisan migrate --seed
6. Instalar dependências do front-end

npm install
npm run dev
7. Iniciar o servidor local

php artisan serve

Após esses passos, o sistema estará disponível em http://127.0.0.1:8000.

---

Estrutura do Projeto

app/              → Models, Controllers e lógica da aplicação
database/         → Migrations e seeders
resources/views/  → Templates Blade
routes/web.php    → Definição de rotas web
public/           → Arquivos públicos e assets

---

Utilização

• /produtos – Gerenciamento de produtos
• /categorias – Gerenciamento de categorias
• /movimentacoes – Registro de entradas e saídas de estoque

---

Contribuição

Contribuições são bem-vindas. Para colaborar:

1. Realize um fork do repositório
2. Crie uma branch para sua feature ou correção (feature/nome-da-feature)
3. Envie seus commits de forma clara e objetiva
4. Submeta um Pull Request com a descrição da proposta

---

Licença

Este projeto está licenciado sob a licença MIT.
Sinta-se à vontade para utilizar, modificar e distribuir conforme necessário.

---

Contato

Autor: Rainer Vitor
Repositório: stock