Projeto Integrador SGE

Sistema web de gestão de estoque desenvolvido para controle de produtos, usuários e auditoria de movimentações internas.

O projeto foi construído com Python e Flask no back-end, MySQL no banco de dados e HTML, CSS e JavaScript no front-end. A aplicação foi pensada para centralizar o gerenciamento de estoque, melhorar a rastreabilidade das operações e organizar o fluxo de acesso e movimentação dentro do sistema.

Objetivo

O objetivo deste projeto é oferecer uma base funcional para controle de estoque em ambiente web, permitindo:

• cadastro e gerenciamento de produtos
• controle de usuários e permissões
• registro de movimentações
• rastreabilidade e apoio à auditoria
• organização das operações do sistema

Funcionalidades

• cadastro, edição e consulta de produtos
• controle de acesso por usuários
• histórico de movimentações
• estrutura preparada para testes automatizados
• integração com pipeline de validação contínua

Tecnologias Utilizadas

• Python
• Flask
• MySQL
• HTML
• CSS
• JavaScript
• Git
• GitHub Actions

Qualidade e Automação

O repositório utiliza validações automatizadas para manter consistência no código, incluindo:

• formatação com Black
• análise estática com Ruff
• testes com Pytest
• execução automática via GitHub Actions

Estrutura do Projeto

Projeto-Integrador-SGE/
├── docs/
├── tests/
├── .github/
├── requirements.txt
├── pyproject.toml
└── README.md

Como Executar Localmente

1. Clone o repositório:

   git clone https://github.com/schaedler6/Projeto-Integrador-SGE.git

2. Acesse a pasta do projeto:

   cd Projeto-Integrador-SGE

3. Instale as dependências:

   pip install -r requirements.txt

4. Execute a aplicação conforme a configuração do projeto.

Testes e Validação

Para rodar as verificações principais localmente:

python -m black --check .
python -m ruff check .
python -m pytest -q

Contexto do Projeto

Este projeto representa uma aplicação prática de desenvolvimento web com foco em organização de dados, controle de acesso, versionamento e validação automatizada. Além do contexto acadêmico, ele também funciona como peça de portfólio para demonstrar conhecimentos em back-end, banco de dados, testes e fluxo de qualidade de código.

Próximas Melhorias

• adicionar capturas de tela do sistema
• documentar fluxo de autenticação
• expandir a cobertura de testes
• detalhar regras de negócio do estoque
• publicar instruções completas de configuração do ambiente

Licença

Este projeto está distribuído sob a licença MIT.