diff --git a/templates/backend/database.md b/templates/backend/database.md index c5a17e49..bf78e105 100644 --- a/templates/backend/database.md +++ b/templates/backend/database.md @@ -44,8 +44,9 @@ - Use a connection pool — never open a new connection per request - Inject the database session/connection as a dependency — no global DB handles -- Set explicit pool size limits appropriate to the deployment - (e.g. `pool_size=10`, `max_overflow=5` for a single-instance service) +- Set explicit pool size limits from the instance count and the + database's connection cap (e.g. `pool_size=10`, `max_overflow=5` for one + instance) - Monitor pool exhaustion — alert when pool wait time exceeds threshold ## Soft deletes @@ -54,7 +55,7 @@ required; otherwise use hard deletes - If using soft deletes, add a partial index on `deleted_at IS NULL` and filter all queries by default — never return deleted rows to callers -- Consider an append-only audit log table as an alternative to soft deletes +- Keep an append-only audit log table instead of soft deletes (MAY) ## Testing [EXTEND: base-testing] diff --git a/tests/baselines/template-quality.txt b/tests/baselines/template-quality.txt index c8e79c56..4bc8b39c 100644 --- a/tests/baselines/template-quality.txt +++ b/tests/baselines/template-quality.txt @@ -6,7 +6,7 @@ templates/backend/api.md 94.9 templates/backend/auth.md 98.4 templates/backend/caching.md 100.0 templates/backend/concurrency.md 94.8 -templates/backend/database.md 92.0 +templates/backend/database.md 100.0 templates/backend/edge.md 97.9 templates/backend/errors.md 98.3 templates/backend/features.md 92.2