Assist_Design/docs/MIGRATION-PROGRESS.md

Domain Migration Progress

✅ Completed

Infrastructure

• ✅ Created complete domain structure with all 8 domains
• ✅ Added provider index files with clean exports
• ✅ Moved Freebit request schemas to /domain/sim/providers/freebit/requests.ts
• ✅ Built domain package successfully
• ✅ Created provider namespace pattern (Providers.Whmcs.*, Providers.Freebit.*)

BFF Integration Services (6/12 files migrated)

• ✅ freebit-operations.service.ts - Updated to use @customer-portal/domain/sim
• ✅ freebit-mapper.service.ts - Using Providers.Freebit.* mappers
• ✅ invoice-transformer.service.ts - Using Providers.Whmcs.transformWhmcsInvoice
• ✅ payment-transformer.service.ts - Using Providers.Whmcs.transformWhmcsPayment*
• ✅ subscription-transformer.service.ts - Using Providers.Whmcs.transformWhmcsSubscription
• ✅ Domain package exports configured with wildcard paths

🚧 In Progress

BFF Services (6 remaining)

• ⏳ whmcs-order.service.ts - Needs @customer-portal/domain/orders updates
• ⏳ order-whmcs-mapper.service.ts - Needs Providers.Whmcs mapper updates
• ⏳ sim-orchestrator.service.ts - May need SIM domain imports
• ⏳ sim-details.service.ts - May need SIM domain imports
• ⏳ sim-usage.service.ts - May need SIM domain imports
• ⏳ sim-management.service.ts - May need SIM domain imports

Portal (not started)

• ⏳ Controllers importing from old packages
• ⏳ React components importing from old packages
• ⏳ Hooks and services importing from old packages

📋 Remaining Tasks

1. Complete BFF Migration

• Update remaining 6 BFF service files
• Migrate any catalog-related services
• Update test files that import old packages

2. Portal Migration

• Scan Portal for old package imports
• Update React components systematically
• Update hooks and custom services
• Update form validation schemas

3. Legacy Cleanup

• Move remaining utilities from packages/domain/src/** to toolkit
• Delete packages/domain/src/** folder
• Archive old packages: contracts, schemas, integrations-*

4. Governance

• Update ESLint rules to ban old packages
• Update documentation to reference new structure
• Add pre-commit hooks to prevent old imports

5. Verification

• Run full type-check across workspace
• Run all tests
• Fix any remaining compilation errors
• Clean up unused dependencies

📊 Statistics

• Domains Created: 8/8 (100%)
• Provider Mappers: 7 providers across 6 domains
• BFF Files Migrated: 6/12 (50%)
• Portal Files Migrated: 0/? (0%)
• Old Packages Retired: 0/3 (0%)

🎯 Next Steps

1. ✅ Finish migrating remaining BFF services
2. Create Portal migration checklist
3. Execute Portal migration
4. Clean up legacy packages
5. Update ESLint configuration