Python Service Golden Path Template

The recommended way to build Python services at our organization.

What's Included

Category	Features
Core	FastAPI 0.115+, Python 3.12, Pydantic 2.0, async/await
Observability	OpenTelemetry + Grafana, Prometheus metrics, structured logging
Database	Aurora PostgreSQL/MySQL, DynamoDB, SQLAlchemy 2.0
Cache	ElastiCache Redis
Messaging	SQS, SNS+SQS
Tasks	Celery, ARQ
AI	LangChain, OpenAI, Anthropic, Bedrock
Quality	Ruff, mypy, Bandit, pytest
DevEx	uv, Makefile, pre-commit, VS Code config

Quick Start

1. Go to Backstage Software Catalog
2. Select "Python Service (Golden Path)"
3. Fill in the form
4. Click "Create"
5. Clone and start building

What You'll Get

your-service/
├── src/
│   ├── api/              # API routes
│   ├── core/             # Config, logging, middleware
│   ├── db/               # Database layer
│   ├── models/           # Database models
│   ├── schemas/          # Pydantic schemas
│   ├── services/         # Business logic
│   └── main.py           # Entry point
├── tests/                # Test suite
├── k8s/                  # Kubernetes manifests
├── .github/              # CI/CD workflows
├── docs/                 # Documentation
├── Dockerfile            # Multi-stage build
├── Makefile              # Developer commands
└── pyproject.toml        # Dependencies

Documentation

Document	Description
Decision Guide	How to choose template options
Golden Path Overview	What and why
Getting Started	First steps
Patterns Guide	Service patterns

Support

• Slack: #platform-help
• Office Hours: Thursdays 2-3pm

Version History

Version	Date	Changes
1.0.0	2025-12	Initial release

---

🤘 Platform Team