Depois de anos desenvolvendo APIs e sistemas backend em produção, organizei e liberei o template que uso como base para projetos reais.
O objetivo é simples: começar novos produtos já com arquitetura sólida, segurança, observabilidade e produtividade desde o primeiro commit.
🧩 O que este template entrega:
🔐 Identity & Security
- Users, Roles & Permissions
- JWT (access + refresh tokens)
- Redis para blacklist de tokens, cache e rate limit
- Login Activity tracking (auditoria de acessos)
- Middlewares de autenticação e autorização
🗄️ MongoDB bem estruturado
- Base model reutilizável (
base_mongo_model) - Repositórios separados (Query / Command)
- Índices, views e modelos organizados por domínio
⚙️ Configurações do sistema
- Basic Configurations
- Company Configurations
- Feature Flags nativas
📦 Storage
- MinIO (S3-compatible)
- Google Cloud Storage
- Filesystem local
- Upload/download seguro
- Gestão de user attachments
📨 Emails
- Envio de emails transacionais
- Templates HTML prontos
- Estrutura simples para novos tipos de email
📊 Observabilidade & Infra
- Docker & Docker Compose
- Logging estruturado
- Tracing com OpenTelemetry / Jaeger
- Métricas prontas para Prometheus
- Dashboards Grafana
🧰 Features enterprise
- Feature Flags por ambiente
- Rate limiting
- CORS configurável
-
Healthcheck completo
- MongoDB
- Redis
- Storage
- CPU, RAM e disco
🧱 Arquitetura limpa
- Código fácil de ler e manter
- Arquitetura direta ao ponto (sem overengineering)
- Organização por domínio (identity, configurations, files, etc.)
- Separação clara: controllers, services, repositories, schemas e models
🛠️ Produtividade
-
Makefile automatizado
- comandos Docker
- comandos Python
- setup rápido de ambiente
Boilerplate mínimo, foco no que importa
🎯 Ideal para:
- Startups que querem lançar rápido sem dívida técnica
- Empresas que precisam padronizar FastAPI
- Devs backend que trabalham com sistemas reais
- APIs, microserviços, SaaS e ERPs
🔗 Repositório (Open Source):
👉 https://github.com/ortiz-python-templates/python-mongodb-api
Feedbacks e contribuições são muito bem-vindos 🚀
🔒 Aviso (importante)
Template pensado para produção real: código legível, arquitetura objetiva e ferramentas que aceleram o dia a dia do backend.
Top comments (0)