🚀 Django Base - Template Profissional com Clean Architecture¶

O template Django mais completo e profissional para iniciar seus projetos com Clean Architecture!

✨ Por que escolher o django_base como seu template?¶

Este não é apenas mais um template Django. É uma base sólida e profissional que implementa os melhores padrões de desenvolvimento, seguindo rigorosamente os princípios da Clean Architecture.

🎯 Características Principais¶

✅ 93% de cobertura de testes com testes unitários e de integração
✅ Clean Architecture implementada corretamente
✅ OpenAPI/Swagger documentação automática da API
✅ Pre-commit hooks para qualidade de código
✅ MyPy verificação de tipos estática
✅ OAuth2 completo com django-oauth-toolkit
✅ Paginação e Filtragem avançadas
✅ Logging e Tratamento de Exceções robustos
✅ Docker otimizado para dev e produção
✅ GitHub Actions CI/CD pipeline completo
✅ Documentação completa com MkDocs e MkDocstrings
✅ Makefile com 20+ comandos de automação
✅ Configurações para local, staging e produção

🏗️ Clean Architecture - Por que é importante?¶

A Clean Architecture garante que seu código seja:

🔄 Independente de Frameworks: Troque Django sem quebrar a lógica de negócio
🧪 Testável: Teste regras de negócio sem banco de dados ou UI
🎨 Independente de UI: Mude a interface sem afetar o sistema
🗄️ Independente de Banco: Troque PostgreSQL por MongoDB facilmente
🌐 Independente de Agentes Externos: Lógica de negócio isolada

🚀 Início Rápido¶

1. Use este template¶

# Clique no botão "Use this template" acima ou:
git clone https://github.com/luderibeiro/django_base.git meu-projeto
cd meu-projeto

2. Setup com Makefile (Recomendado)¶

# Instalar dependências e configurar ambiente
make setup

# Executar testes
make test

# Iniciar servidor de desenvolvimento
make run

3. Setup Manual¶

# Criar ambiente virtual
python -m venv venv
source venv/bin/activate  # Linux/Mac
# ou
venv\Scripts\activate     # Windows

# Instalar dependências
pip install -r project/requirements.txt

# Configurar banco de dados
cd project
python manage.py migrate

# Criar superusuário
python manage.py createsuperuser

# Executar testes
pytest

# Iniciar servidor
python manage.py runserver

📚 Documentação Completa¶

🏛️ Arquitetura¶

Visão Geral - Entenda a estrutura das camadas
Camada de Domínio - Entidades e regras de negócio
Camada de Aplicação - Casos de uso
Camada de Infraestrutura - Repositórios e gateways
Camada de Apresentação - APIs e interfaces

🛠️ Desenvolvimento¶

Testes Automatizados - Suíte completa de testes
Paginação e Filtragem - APIs avançadas
OAuth2 Implementation - Autenticação robusta
Logging e Tratamento de Erros - Observabilidade
Integração Frontend - Guias para React/Vue/Angular

⚙️ Setup e Deploy¶

Setup Local - Ambiente de desenvolvimento
Setup Homologação - Ambiente de testes
Setup Produção - Deploy em produção
Configuração Docker - Containers otimizados

🎯 Casos de Uso Ideais¶

Este template é perfeito para:

🏢 APIs REST profissionais e escaláveis
🛒 E-commerce com autenticação robusta
📊 Sistemas de gestão empresariais
🎓 Plataformas educacionais com múltiplos usuários
📱 Backend para mobile apps com autenticação OAuth2
🔐 Sistemas com múltiplos perfis de usuário

🤝 Contribua e Crie Forks¶

Contribuindo¶

📖 Leia nosso Guia de Contribuição
🐛 Reporte bugs ou sugira melhorias
💡 Proponha novas funcionalidades
📝 Melhore a documentação

Criando Forks Especializados¶

Este template é perfeito para criar forks especializados:

🛒 django-ecommerce-base - Template para e-commerce
🎓 django-education-base - Template para plataformas educacionais
🏥 django-healthcare-base - Template para sistemas de saúde
🏦 django-finance-base - Template para sistemas financeiros
📊 django-analytics-base - Template para dashboards e analytics

📊 Estatísticas do Projeto¶

93% de cobertura de testes com testes unitários e de integração
Clean Architecture implementada corretamente
OpenAPI/Swagger documentação automática da API
Pre-commit hooks para qualidade de código
MyPy verificação de tipos estática
Docker otimizado para dev e produção
GitHub Actions CI/CD pipeline completo
Documentação completa com MkDocs
Makefile com 20+ comandos de automação

🏆 Por que este template é diferente?¶

Clean Architecture Real: Não é apenas uma estrutura de pastas, é uma implementação real dos princípios
Qualidade de Código: Pre-commit hooks, MyPy, Black, Flake8 e Pydocstyle configurados
Documentação Automática: OpenAPI/Swagger + MkDocstrings para documentação sempre atualizada
CI/CD Completo: GitHub Actions com pipeline de testes, qualidade e deploy
93% Cobertura de Testes: Testes unitários e de integração abrangentes
Automação Avançada: Makefile com 20+ comandos para desenvolvimento
Configurações Completas: Local, staging e produção com Docker otimizado