Blog post Leaderboard MCP Deploy agents
Back to all reviewers

Comprehensive migration planning

appwrite/appwrite
Based on 8 comments
PHP

When changing identifier systems (e.g., from using `getInternalId()` to `getSequence()`), implement comprehensive migration strategies to preserve data integrity and backward compatibility. For each change:

Migrations PHP

Reviewer Prompt

When changing identifier systems (e.g., from using getInternalId() to getSequence()), implement comprehensive migration strategies to preserve data integrity and backward compatibility. For each change:

  1. Create explicit migration scripts to update or rename existing resources
  2. Implement fallback mechanisms for transitional periods
  3. Update all related queries, metrics, and references consistently
  4. Test thoroughly with real data before deploying
// Example migration for collection renaming:
public function migrateCollections(): void
{
    $buckets = $this->dbForProject->find('buckets');
    
    foreach ($buckets as $bucket) {
        $oldName = 'bucket_' . $bucket->getInternalId();
        $newName = 'bucket_' . $bucket->getSequence();
        
        if ($this->dbForProject->hasCollection($oldName) && !$this->dbForProject->hasCollection($newName)) {
            // Rename collection to preserve existing data
            $this->dbForProject->renameCollection($oldName, $newName);
            Console::success("Migrated collection {$oldName} → {$newName}");
        }
    }
}

Without proper migration planning, changes to identifier systems often result in orphaned data, broken queries, and critical production issues.

8
Comments Analyzed
PHP
Primary Language
Migrations
Category

Source Discussions