Files

Lukas May 34578d39c6 refactor: Restructure monorepo to apps/server/ and apps/web/ layout

Move src/ → apps/server/ and packages/web/ → apps/web/ to adopt
standard monorepo conventions (apps/ for runnable apps, packages/
for reusable libraries). Update all config files, shared package
imports, test fixtures, and documentation to reflect new paths.

Key fixes:
- Update workspace config to ["apps/*", "packages/*"]
- Update tsconfig.json rootDir/include for apps/server/
- Add apps/web/** to vitest exclude list
- Update drizzle.config.ts schema path
- Fix ensure-schema.ts migration path detection (3 levels up in dev,
  2 levels up in dist)
- Fix tests/integration/cli-server.test.ts import paths
- Update packages/shared imports to apps/server/ paths
- Update all docs/ files with new paths

2026-03-03 11:22:53 +01:00

1.9 KiB

Raw Blame History

Database Migrations

This project uses drizzle-kit for database schema management and migrations.

Overview

Schema definition: apps/server/db/schema.ts (drizzle-orm table definitions)
Migration output: drizzle/ directory (SQL files + meta journal)
Config: drizzle.config.ts
Runtime migrator: apps/server/db/ensure-schema.ts (calls drizzle-orm/better-sqlite3/migrator)

How It Works

On every server startup, ensureSchema(db) runs all pending migrations from the drizzle/ folder. Drizzle tracks applied migrations in a __drizzle_migrations table so only new migrations are applied. This is safe to call repeatedly.

Workflow

Making schema changes

Edit apps/server/db/schema.ts with your table/column changes
Generate a migration:
```
npx drizzle-kit generate
```
Review the generated SQL in drizzle/NNNN_*.sql
Commit the migration file along with your schema change

Applying migrations

Migrations are applied automatically on server startup. No manual step needed.

For tests, the same ensureSchema() function is called on in-memory SQLite databases in apps/server/db/repositories/drizzle/test-helpers.ts.

Checking migration status

# See what drizzle-kit would generate (dry run)
npx drizzle-kit generate --dry-run

# Open drizzle studio to inspect the database
npx drizzle-kit studio

Rules

Never hand-write migration SQL. Always use drizzle-kit generate from the schema.
Never use raw CREATE TABLE statements for schema initialization. The migration system handles this.
Always commit migration files. They are the source of truth for database evolution.
Migration files are immutable. Once committed, never edit them. Make a new migration instead.
Test with npx vitest run after generating migrations to verify they work with in-memory databases.

1.9 KiB Raw Blame History