Merge branch 'main' into feat/issue-43-contract-event-indexer

Author: anoncon

.github/workflows/backend-tests.yml

@@ -4,13 +4,15 @@ on:
   pull_request:
     paths:
       - 'backend/**'
+      - 'docs/MIGRATION.md'
       - '.github/workflows/backend-tests.yml'
   push:
     branches:
       - main
       - develop
     paths:
       - 'backend/**'
+      - 'docs/MIGRATION.md'
 
 jobs:
   test:
@@ -35,13 +37,17 @@ jobs:
         working-directory: backend
         run: npm ci
 
+      - name: Verify migrations (dry-run)
+        working-directory: backend
+        run: npm run db:migrate:dry-run
+      
       - name: Run tests
         working-directory: backend
         run: npm run test
 
       - name: Upload test results
         if: always()
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: test-results-${{ matrix.node-version }}
           path: backend/coverage/

README.md

@@ -67,6 +67,8 @@ cp backend/.env.example backend/.env
 cp frontend/.env.example frontend/.env
 # Edit with contract addresses
 
+**Database migrations** (when using PostgreSQL with `DATABASE_URL`): see [docs/MIGRATION.md](docs/MIGRATION.md). Apply with `cd backend && npm run db:migrate`; use `--dry-run` to preview.
+
 Configure SMTP for Email Notifications (Optional)
 
 To enable email notifications for rebalancing events:

backend/data/portfolio.db-shm

@@ -7,6 +7,9 @@
         "build": "tsc",
         "start": "node dist/index.js",
         "db:migrate": "tsx src/db/migrate.ts",
+        "db:migrate:dry-run": "tsx src/db/migrate.ts -- --dry-run",
+        "db:migrate:rollback": "tsx src/db/migrate.ts -- --rollback",
+        "db:migrate:status": "tsx src/db/migrate.ts -- --status",
         "db:setup": "tsx src/db/migrate.ts",
         "test": "vitest run",
         "test:watch": "vitest"