Initial commit

2026-04-23 21:38:24 -04:00
commit 63e12a9636
1762 changed files with 1672620 additions and 0 deletions
@@ -0,0 +1,142 @@
+# Quick Testing Guide - Lookup Management Feature
+
+## Prerequisites
+1. Database migration applied: `ConvertEnumsToLookupTables`
+2. Application built successfully
+3. Seed data loaded (via Platform Management > Seed Data)
+
+## 5-Minute Quick Test
+
+### Test 1: View Existing Lookups (2 minutes)
+1. Start the application: `cd src/PowderCoating.Web && dotnet run`
+2. Navigate to: `https://localhost:58461`
+3. Login as SuperAdmin: `superadmin@powdercoating.com` / `SuperAdmin123!`
+4. Click: **Company Settings** (in left sidebar)
+5. Click: **Data Lookups** tab
+6. **Expected**: See 3 sub-tabs: Job Statuses, Job Priorities, Quote Statuses
+7. **Verify**: Job Statuses shows 16 default statuses with color badges
+8. **Verify**: Usage counts display (e.g., "5 jobs")
+
+### Test 2: Create Custom Lookup (1 minute)
+1. On Job Statuses sub-tab, click: **Add Job Status**
+2. Enter code: `TEST_STATUS`
+3. Enter display name: `Test Status`
+4. **Expected**: Success toast notification
+5. **Verify**: New status appears in table at bottom
+
+### Test 3: Edit Custom Lookup (1 minute)
+1. Find the "Test Status" row
+2. Click: **Edit** button (pencil icon)
+3. Change display name to: `My Custom Status`
+4. **Expected**: Success toast notification
+5. **Verify**: Table refreshes with new name
+
+### Test 4: Delete Custom Lookup (1 minute)
+1. Find the "My Custom Status" row
+2. Click: **Delete** button (trash icon)
+3. Confirm deletion
+4. **Expected**: Success toast notification
+5. **Verify**: Status removed from table
+
+### Test 5: Verify Jobs Use Lookups (30 seconds)
+1. Navigate to: **Jobs** > **Create New Job**
+2. **Verify**: Status dropdown shows all statuses (including any custom ones)
+3. **Verify**: Priority dropdown shows all priorities
+4. Create a job and **verify** it saves successfully
+
+## System Protection Tests
+
+### Test 6: Try to Delete System-Defined Status
+1. Go to: Company Settings > Data Lookups > Job Statuses
+2. Find "Pending" status (marked with [System] badge)
+3. **Verify**: Delete button is DISABLED with tooltip "System-defined"
+
+### Test 7: Try to Delete In-Use Status
+1. Create a job with status "In Preparation"
+2. Go to: Company Settings > Data Lookups > Job Statuses
+3. Try to delete "In Preparation" status
+4. **Expected**: Error message "Status is in use and cannot be deleted"
+
+## Visual Verification
+
+### Color Badges
+- ✅ Statuses display with colored badges (primary, success, warning, danger, etc.)
+- ✅ Badge colors match across Jobs Index and Company Settings
+
+### Usage Counts
+- ✅ Each lookup shows accurate count (e.g., "12 jobs")
+- ✅ Counts update after creating/deleting jobs
+
+### Responsive Design
+- ✅ Tables display correctly on desktop
+- ✅ Tables scroll horizontally on mobile if needed
+
+## Troubleshooting
+
+### Issue: "No job statuses found"
+**Solution**: Run seed data via Platform Management > Seed Data
+
+### Issue: Dropdowns empty in Jobs/Quotes
+**Solution**: Check browser console for errors; verify migration applied
+
+### Issue: Delete button not working
+**Solution**: Check browser console; verify status is not in use
+
+### Issue: Changes not saving
+**Solution**: Check browser console for AJAX errors; verify anti-forgery token
+
+## Success Indicators
+- ✅ All 16 default job statuses visible
+- ✅ All 5 default priorities visible
+- ✅ All 7 default quote statuses visible
+- ✅ Can add custom lookups
+- ✅ Can edit custom lookups (display name only)
+- ✅ Can delete unused custom lookups
+- ✅ System-defined lookups protected
+- ✅ In-use lookups protected
+- ✅ Usage counts accurate
+- ✅ Jobs/Quotes can be created with new lookups
+- ✅ Color badges display correctly
+
+## Next Steps After Testing
+
+If all tests pass:
+- ✅ Mark feature as production-ready
+- ✅ Document for users in help guide
+- ✅ Train users on lookup customization
+
+If issues found:
+- 📝 Document the issue with screenshots
+- 🐛 Report to development team
+- 🔄 Apply fixes and re-test
+
+## Advanced Testing (Optional)
+
+### Multi-Tenancy Test
+1. Login as Company Admin: `admin@demo.com` / `CompanyAdmin123!`
+2. Go to: Company Settings > Data Lookups
+3. **Verify**: Only see lookups for YOUR company (not other companies)
+4. Create a custom status for Demo Company
+5. Login as different company admin
+6. **Verify**: Custom status NOT visible to other company
+
+### Performance Test
+1. Create 1,000 test jobs via seed data
+2. Navigate to: Jobs > Index
+3. **Verify**: Page loads in < 2 seconds
+4. Filter by status
+5. **Verify**: Filtering is instant
+
+### Quote Conversion Test
+1. Create a quote with status "Draft"
+2. Try to convert to job
+3. **Expected**: Error "Only approved quotes can be converted"
+4. Change quote status to "Approved"
+5. Convert to job
+6. **Verify**: Conversion succeeds
+7. **Verify**: Quote status changes to "Converted"
+
+---
+
+**Testing Duration**: 5-15 minutes
+**Last Updated**: February 13, 2026