Files
PowderCoatingLogix/QUICK_TEST_GUIDE.md
T
2026-04-23 21:38:24 -04:00

143 lines
4.7 KiB
Markdown

# 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