Operations

Deployments

• Build from services/interface/Dockerfile.
• The container runs granian against services.interface.main:app.
• Default listen port is 8080 and honors the PORT environment variable.

Startup and shutdown behavior

• Loads INTERFACE_API_KEY and optional INTERFACE_SENTRY_DSN from Secret Manager.
• Initializes and warms the Spanner connection pool.
• Clears the Spanner pool on shutdown.

Monitoring and alerts

• Sentry is enabled when INTERFACE_SENTRY_DSN is available.
• Logs are written to stdout with INFO-level defaults.

SLOs and SLIs

• TBD. Define latency and error targets that reflect Bubble usage patterns.

Scaling and performance

• granian is configured with a single worker by default.
• Query performance depends on Spanner indexes used by each endpoint.
• Avoid breaking response shapes or pagination semantics (legacy clients).