Skip to content

FastAPI Production API v1.1.0 - Production Operations and Developer Experience

Choose a tag to compare

@HoungDev HoungDev released this 09 Aug 03:36
· 8 commits to main since this release
19bc534

FastAPI Production API v1.1.0 — Production Operations and Developer Experience

v1.1.0 completes the first focused reliability and operability milestone. It
adds production observability foundations, strengthens failure-path testing,
reduces contributor setup friction, and documents the architecture and full API
lifecycle.

Highlights

Production observability

  • Dedicated /health/live and database-backed /health/ready probes
  • Prometheus request count, status, latency, and in-progress metrics
  • Structured JSON request logs with validated correlation IDs
  • Monitoring, alerting, multi-worker metrics, and troubleshooting guidance

Reliability and security confidence

  • 79 automated tests with 95.49% combined statement-and-branch coverage
  • A 90% coverage regression gate in CI
  • Expanded admin, CORS, error-boundary, rate-limit, refresh-token, and rollback
    coverage
  • PostgreSQL 17 migrations and tests, dependency audit, package build, and wheel
    smoke test enforced by CI

Developer experience and documentation

  • Cross-platform setup, database, migration, server, and quality-gate commands
  • Safe .env generation without overwriting existing local configuration
  • Docker engine preflight with actionable diagnostics
  • Copy-paste curl and PowerShell API examples
  • Architecture, deployment, local development, monitoring, and troubleshooting
    guides
  • Automated checks for internal documentation links and documented routes

Upgrade from v1.0.1

git fetch --tags
git checkout v1.1.0
uv sync --locked --all-groups
uv run alembic upgrade head
python scripts/dev.py check

No new database migration is introduced by v1.1.0, but running Alembic remains
the supported release procedure. Review MONITORING.md before exposing metrics
or deploying multiple workers.

Compatibility

  • Existing authentication and authorization request contracts remain
    compatible.
  • Legacy health endpoints remain available but the dedicated liveness and
    readiness endpoints are preferred.
  • /metrics is intentionally omitted from OpenAPI and should be restricted to
    trusted monitoring networks.

Known limitations

  • Rate limiting remains process local and is not shared across workers or hosts.
  • Password reset, email verification, OAuth providers, and MFA are not included.
  • The repository does not yet ship a production container image or Kubernetes
    manifest.
  • OpenTelemetry tracing remains planned work and is not claimed by this release.

Full changes: v1.0.1...v1.1.0