# Lookup Table Migration Verification Checklist

## Automated Verification

### ✅ Build Verification
- **Status**: PASSED
- **Details**: Solution builds with 0 errors, 44 pre-existing warnings
- **Verified**: All code compiles successfully after enum-to-lookup conversion

### ✅ Application Startup
- **Status**: PASSED
- **Details**: Application starts without errors
- **Verified**: Web application initializes and runs successfully

### ✅ Migration File
- **Status**: PASSED
- **File**: `20260213183913_ConvertEnumsToLookupTables.cs`
- **Details**:
  - Created 3 new lookup tables
  - Seeded 28 lookup records per company (16+5+7)
  - Preserved all existing job/quote data via temp columns
  - Added foreign key relationships with Restrict delete behavior
  - Created unique composite indexes (CompanyId + StatusCode/PriorityCode)

## Manual Verification Steps

### Database Verification

Run the SQL verification script:
```bash
sqlcmd -S .\SQLEXPRESS -d PowderCoatingDb -i scripts\VerifyLookupMigration.sql
```

**Expected Results**:
- ✓ 3 lookup tables exist
- ✓ Each company has 16 job statuses, 5 priorities, 7 quote statuses
- ✓ All foreign key relationships exist
- ✓ No orphaned records (all Jobs/Quotes reference valid lookup IDs)
- ✓ No duplicate status codes per company
- ✓ Each company has exactly one "Approved" quote status
- ✓ System-defined statuses exist (PENDING, COMPLETED, CANCELLED)

### UI Verification

1. **Jobs Management**
   - [ ] Navigate to Jobs > Create New Job
   - [ ] Verify status dropdown shows all 16 statuses
   - [ ] Verify priority dropdown shows all 5 priorities
   - [ ] Create a test job - verify it saves successfully
   - [ ] Edit the job - verify status/priority can be changed
   - [ ] Navigate to Jobs > Index
   - [ ] Verify status badges display with correct colors
   - [ ] Verify priority badges display with correct colors
   - [ ] Verify sorting by status/priority works
   - [ ] Verify filtering by status works

2. **Quotes Management**
   - [ ] Navigate to Quotes > Create New Quote
   - [ ] Create a test quote - verify it saves successfully
   - [ ] Navigate to Quotes > Index
   - [ ] Verify status filter dropdown shows all 7 statuses
   - [ ] Verify status badges display with correct colors
   - [ ] Try converting an approved quote to job - verify it works

3. **Company Settings - Data Lookups**
   - [ ] Navigate to Company Settings > Data Lookups tab
   - [ ] Verify Job Statuses sub-tab loads successfully
   - [ ] Verify all 16 default statuses are displayed
   - [ ] Verify usage counts are accurate
   - [ ] Click "Add Job Status" - verify prompt appears
   - [ ] Try creating a custom status (e.g., "CUSTOM_STATUS")
   - [ ] Verify new status appears in table
   - [ ] Try editing a custom status - verify it updates
   - [ ] Try deleting an unused custom status - verify it's removed
   - [ ] Try deleting a system-defined status - verify it's blocked
   - [ ] Try deleting a status in use - verify it's blocked
   - [ ] Switch to Job Priorities sub-tab - verify it loads
   - [ ] Switch to Quote Statuses sub-tab - verify it loads

4. **Dashboard**
   - [ ] Navigate to Dashboard
   - [ ] Verify job status statistics display correctly
   - [ ] Verify status badges use correct colors from lookup table

5. **Reports**
   - [ ] Navigate to Reports
   - [ ] Verify reports display correctly with new lookup-based statuses

## Data Integrity Checks

### Jobs Table
- [ ] All existing jobs maintained their status/priority
- [ ] No jobs have NULL JobStatusId
- [ ] No jobs have NULL JobPriorityId
- [ ] Status/priority display names match lookup table values

### Quotes Table
- [ ] All existing quotes maintained their status
- [ ] No quotes have NULL QuoteStatusId
- [ ] Status display names match lookup table values
- [ ] Quote-to-job conversion still requires "Approved" status

### JobStatusHistory Table
- [ ] All status transitions preserved
- [ ] FromStatusId and ToStatusId reference valid lookup IDs

## Performance Verification

### Query Performance
- [ ] Jobs Index page loads quickly with 100+ jobs
- [ ] Quotes Index page loads quickly with 100+ quotes
- [ ] Status dropdown loads instantly
- [ ] No N+1 query issues (use `.Include()` for eager loading)

### Scalability
- [ ] Test with 1,000+ jobs - verify performance is acceptable
- [ ] Test with 10,000+ jobs - verify no timeouts
- [ ] Verify indexes are being used (check execution plans)

## Rollback Plan

If any critical issues are found:

1. **Database Rollback**:
   ```bash
   cd src/PowderCoating.Web
   dotnet ef database update AddProfilePictureFilePath --project ../PowderCoating.Infrastructure --context ApplicationDbContext
   ```
   This rolls back to the previous migration before the lookup conversion.

2. **Code Rollback**:
   ```bash
   git revert <commit-hash>
   ```
   Revert the commits that implemented the lookup conversion.

## Known Limitations

1. **Drag-and-Drop Reordering**: Not yet implemented (future enhancement)
2. **Modal Forms**: Currently using simple prompts (can be enhanced with Bootstrap modals)
3. **Remaining Enums**: EquipmentStatus, MaintenanceStatus, JobPhotoType not converted (by design)

## Success Criteria

Migration is considered successful if:
- ✅ Zero compilation errors
- ✅ Application starts without errors
- ✅ All existing data preserved (no data loss)
- ✅ Jobs/Quotes can be created/edited/deleted
- ✅ Status/Priority dropdowns work correctly
- ✅ Color-coded badges display properly
- ✅ Company Settings lookup management works
- ✅ Multi-tenancy isolation maintained (companies see only their lookups)
- ✅ Business rules enforced (e.g., only one "Approved" quote status)

## Sign-Off

- [ ] Developer Verification Complete: _______________ Date: _______________
- [ ] QA Testing Complete: _______________ Date: _______________
- [ ] User Acceptance Complete: _______________ Date: _______________

---

**Migration Date**: February 13, 2026
**Migration File**: `20260213183913_ConvertEnumsToLookupTables.cs`
**Enums Converted**: JobStatus (16), JobPriority (5), QuoteStatus (7)
**Total Lookup Records Created**: 28 per company