gateway/modules/migrations/_archive/README.md

Archived one-off migrations

migrate_folders_to_groups.py copies FileFolder + FileItem.folderId into TableGrouping (files/list). It was used during an experimental UI path; product choice is to keep physical folders (FileFolder, folderId) and recover FormGeneratorTree (see wiki/c-work/1-plan/2026-05-formgenerator-tree-and-folder-recovery.md).

Run only if you need a historical data rescue:

cd gateway
python -m modules.migrations._archive.migrate_folders_to_groups --verbose
python -m modules.migrations._archive.migrate_folders_to_groups --execute --verbose