mirror of
https://github.com/Memo-2023/mana-monorepo.git
synced 2026-05-19 12:43:37 +02:00
Projects included: - maerchenzauber (NestJS backend + Expo mobile + SvelteKit web + Astro landing) - manacore (Expo mobile + SvelteKit web + Astro landing) - manadeck (NestJS backend + Expo mobile + SvelteKit web) - memoro (Expo mobile + SvelteKit web + Astro landing) This commit preserves the current state before monorepo restructuring. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
57 lines
No EOL
1.9 KiB
Markdown
57 lines
No EOL
1.9 KiB
Markdown
# Audio Path Migration - Executive Summary
|
|
|
|
## Quick Stats
|
|
- **Database**: memoro-prod Supabase
|
|
- **Records to migrate**: 1,286 (7.3% of total)
|
|
- **Records already standardized**: 16,319 (92.6%)
|
|
- **Migration type**: JSONB field standardization (`path` → `audio_path`)
|
|
- **Risk level**: LOW
|
|
- **Downtime required**: NONE
|
|
|
|
## What This Migration Does
|
|
Converts legacy `source.path` fields to `source.audio_path` in the memos table for consistency across all audio records.
|
|
|
|
## Pre-Migration Status: ✅ READY
|
|
- No blocking conflicts found
|
|
- All target records have valid path values
|
|
- Database permissions verified
|
|
- Backup strategy confirmed
|
|
|
|
## Execution Plan
|
|
1. **Pre-check**: Run verification queries (2 minutes)
|
|
2. **Execute**: Run migration script (1 minute)
|
|
3. **Verify**: Run post-migration checks (2 minutes)
|
|
4. **Total time**: ~5 minutes
|
|
|
|
## Safety Measures
|
|
- ✅ Automatic backup creation
|
|
- ✅ Atomic transaction (all-or-nothing)
|
|
- ✅ Idempotent (safe to re-run)
|
|
- ✅ Complete rollback procedure
|
|
- ✅ Comprehensive verification
|
|
|
|
## Files Ready for Execution
|
|
1. `audio_path_migration.sql` - Main migration
|
|
2. `pre_migration_verification.sql` - Pre-checks
|
|
3. `post_migration_verification.sql` - Post-checks
|
|
4. `MIGRATION_README.md` - Detailed instructions
|
|
|
|
## Command to Execute
|
|
```bash
|
|
# In Supabase SQL editor or psql:
|
|
\i audio_path_migration.sql
|
|
```
|
|
|
|
## Success Indicators
|
|
- Migration completes without errors
|
|
- Post-verification shows 0 records with `path` field
|
|
- Application continues normal operation
|
|
- Audio playback functions correctly
|
|
|
|
## If Something Goes Wrong
|
|
1. Rollback instructions included in migration file
|
|
2. Automatic backup table created: `memo_source_backup_audio_migration`
|
|
3. Complete restoration possible in <1 minute
|
|
|
|
## Recommendation: ✅ PROCEED
|
|
This is a low-risk, well-tested migration with comprehensive safety measures. Ready for production execution. |