ss-tools/specs/022-sync-id-cross-filters/quickstart.md

Quickstart: ID Synchronization

Getting Started

1. Service Initialization: Ensure the IdMappingService scheduler is started when the backend application boots up.

   # In app.py or similar startup logic
   from core.mapping_service import IdMappingService
   
   mapping_service = IdMappingService()
   mapping_service.start_scheduler(interval_minutes=30)
   

2. Running Migrations with Cross-Filter Sync: When calling the migration endpoint, set fix_cross_filters=True. The engine will automatically pause, do a technical import, sync IDs, patch the manifest, and do a final import.

   (No additional quickstart steps required as this logic is embedded directly into the migration engine).