Sistema de Gestão de Estoque

Um sistema completo de gestão de inventário focado em rastreabilidade de produtos, fornecedores e movimentações financeiras.

🚀 Tecnologias

• Backend: Python 3.13, Django 5.2.7, Django Rest Framework
• Banco de Dados: PostgreSQL
• Cache & Filas: Redis, Celery
• Infraestrutura: Docker, Docker Compose
• Qualidade: Pytest, Ruff, MyPy, Pre-commit
• Documentação: MkDocs, Drf-spectacular (Swagger/ReDoc)

📚 Documentação

• Documentação Completa
• API Swagger: /api/v1/docs/
• ReDoc: /api/v1/redoc/

🛠️ Instalação Rápida

Opção 1: Docker (Recomendado)

1. Clone o repositório:

   git clone https://github.com/seurepositorio/inventory-management.git
   cd inventory-management-django-system

2. Crie o arquivo .env:

   cp .env.example .env

3. Suba os containers:

   docker-compose up -d --build

O sistema estará disponível em: http://localhost:8000

Opção 2: Desenvolvimento Local

1. Instale o uv:

   pip install uv

2. Instale as dependências:

   uv sync

3. Ative o ambiente virtual:

   source .venv/bin/activate  # Linux/Mac
   .venv\Scripts\activate     # Windows

4. Configure o banco de dados e rode as migrações:

   python manage.py migrate

5. Inicie o servidor:

   python manage.py runserver

🧪 Rodando os Testes

Para garantir a integridade do sistema, execute os testes com pytest:

uv run pytest

Para gerar cobertura de testes:

uv run pytest --cov=app --cov-report=html

🤝 Contribuição

Consulte o Guia de Contribuição para detalhes sobre nosso fluxo de desenvolvimento.

Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para mais detalhes.

Autores / Contato

• Nattam Pereira - Portfólio - GitHub - Copyright (c) 2026