feat(database): add TypeORM migration support

[cre8]

Summary

Add TypeORM migration support to enable safe database schema upgrades for existing installations.

Breaking Change

Schema synchronization (synchronize: true) is now disabled by default. Use migrations instead for production safety.

Changes

New Files

• apps/backend/src/database/data-source.ts - TypeORM CLI datasource configuration
• apps/backend/src/database/migrations/1740000000000-BaselineMigration.ts - Baseline migration capturing current schema
• apps/backend/src/database/migrations/README.md - Migration workflow documentation

Modified Files

• apps/backend/src/database/database.module.ts - Added migration configuration and startup warning for pending migrations
• apps/backend/src/database/database-validation.schema.ts - Added DB_SYNCHRONIZE and DB_MIGRATIONS_RUN options
• apps/backend/package.json - Added migration CLI scripts
• .env.example and deployment env files - Documented new configuration options
• docs/architecture/database.md - Added migrations documentation section

New Configuration Options

Variable	Default	Description
DB_MIGRATIONS_RUN	true	Run pending migrations automatically on startup
DB_SYNCHRONIZE	false	Enable TypeORM schema sync (⚠️ dev only)

Migration Commands

# From apps/backend directory
pnpm migration:generate --name=AddNewFeature  # Generate migration from entity changes
pnpm migration:run                             # Run pending migrations
pnpm migration:revert                          # Revert last migration
pnpm migration:show                            # Show migration status

Upgrade Path

Existing installations will work automatically:

1. The baseline migration detects if tables already exist
2. If tables exist (from previous synchronize: true mode), creation is skipped
3. All data is preserved, and the migration history starts fresh

No manual intervention required — just upgrade and restart.

[codecov-commenter]

Codecov Report

❌ Patch coverage is 50.00000% with 9 lines in your changes missing coverage. Please review.
✅ Project coverage is 55.77%. Comparing base (7ec61cc) to head (d43810f).

Files with missing lines	Patch %	Lines
...base/migrations/1740000000000-BaselineMigration.ts	10.00%	8 Missing and 1 partial ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #469      +/-   ##
==========================================
- Coverage   55.79%   55.77%   -0.02%     
==========================================
  Files         164      165       +1     
  Lines        6010     6028      +18     
  Branches     1359     1358       -1     
==========================================
+ Hits         3353     3362       +9     
- Misses       2281     2289       +8     
- Partials      376      377       +1     

Flag	Coverage Δ
e2e-test	55.77% <50.00%> (-0.02%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines	Coverage Δ
...backend/src/database/database-validation.schema.ts	100.00% <ø> (ø)
apps/backend/src/database/database.module.ts	100.00% <100.00%> (ø)
...base/migrations/1740000000000-BaselineMigration.ts	10.00% <10.00%> (ø)

🚀 New features to boost your workflow:

• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud