Sanitized mirror from private repository - 2026-04-20 01:32:01 UTC

hosts/synology/calypso/reactive_resume_v5/MIGRATION.md

@@ -0,0 +1,72 @@
+# Migration from Reactive Resume v4 to v5
+
+## Migration Summary
+Successfully migrated from Reactive Resume v4 to v5 on 2026-02-16.
+
+## Port Configuration
+- **Main Application**: Port 9751 (same as v4)
+- **S3 API**: Port 9753 (same as v4 MinIO)
+- **PDF Service**: Port 4000 (internal)
+
+## Reverse Proxy Compatibility
+The migration maintains the same external ports, so existing reverse proxy rules continue to work:
+- `http://192.168.0.250:9751` → `rx.vish.gg`
+- `http://192.168.0.250:9753` → `rxdl.vish.gg` (S3 API)
+
+## Changes from v4 to v5
+
+### Storage Backend
+- **v4**: MinIO for S3-compatible storage
+- **v5**: SeaweedFS for S3-compatible storage
+- Same S3 API compatibility on port 9753
+
+### Database
+- **v4**: PostgreSQL 16
+- **v5**: PostgreSQL 18
+- Database migration handled automatically
+
+### PDF Generation
+- **v4**: Browserless Chrome with HTTP API
+- **v5**: Browserless Chrome with WebSocket API
+- Better performance and real-time updates
+
+### Authentication
+- **v4**: Custom auth system
+- **v5**: Better Auth framework
+- More secure and feature-rich
+
+## Data Migration
+- Database data preserved in `/volume1/docker/rxv5/db/`
+- File storage migrated to SeaweedFS format
+- User accounts and resumes preserved
+
+## Removed Services
+The following v4 containers were stopped and removed:
+- `Resume-ACCESS` (v4 main app)
+- `Resume-DB` (v4 database)
+- `Resume-PRINTER` (v4 PDF service)
+- `Resume-MINIO` (v4 storage)
+
+## New Services
+The following v5 containers are now running:
+- `Resume-ACCESS-V5` (v5 main app)
+- `Resume-DB-V5` (v5 database)
+- `Resume-BROWSERLESS-V5` (v5 PDF service)
+- `Resume-SEAWEEDFS-V5` (v5 storage)
+- `Resume-BUCKET-V5` (storage initialization)
+
+## Configuration Files
+- v4 configuration archived to: `/home/homelab/organized/repos/homelab/archive/reactive_resume_v4_archived/`
+- v5 configuration active in: `/home/homelab/organized/repos/homelab/Calypso/reactive_resume_v5/`
+
+## Verification
+- ✅ Application accessible at http://calypso.vish.local:9751
+- ✅ S3 API accessible at http://calypso.vish.local:9753
+- ✅ All containers healthy and running
+- ✅ Reverse proxy rules unchanged
+- ✅ Account creation working (no more "Invalid origin" errors)
+
+## Future Enhancements
+- Ollama AI integration (when v5 supports it)
+- External domain configuration for https://rx.vish.gg
+- Automated backups of SeaweedFS data