# Project Config: Isar to PostgreSQL Migration

## Goal
Migrate mnemo_cards_backend from embedded Isar database to production-ready PostgreSQL with Drift ORM.

## Stack
- **Database**: PostgreSQL 16
- **ORM**: Drift 2.14.0
- **Language**: Dart 3.0+
- **Backend**: Shelf framework

## Constraints
- Must maintain backward compatibility during migration
- Zero-downtime deployment preferred
- All existing functionality must work after migration
- Follow clean architecture principles
- Write unit tests for all new code

## Commands
```bash
# Setup PostgreSQL (Docker)
cd mnemo_cards_backend
docker-compose up -d postgres

# Install dependencies
dart pub get

# Generate Drift code
dart run build_runner build --delete-conflicting-outputs

# Run tests
dart test

# Format code
dart format .

# Analyze code
dart analyze
```

## Acceptance Criteria
- ✅ PostgreSQL running and accessible
- ✅ All Drift schemas created and generated
- ✅ All DAOs implemented with CRUD operations
- ✅ All existing code refactored to use Drift
- ✅ All unit tests pass
- ✅ Integration tests pass
- ✅ Docker image builds successfully
- ✅ Backend starts and connects to PostgreSQL
- ✅ API endpoints work correctly

## Environment Variables
- DB_HOST, DB_PORT, DB_NAME, DB_USER, DB_PASSWORD
- DB_SSL_MODE (disable for dev, require for prod)
- PORT, SERVER_ADDRESS, WORK_DIR, DEBUG
- ADMIN_IDS, JWT_SECRET, JWT_REFRESH_SECRET