steinhelge
198 lines
5.4 KiB
Markdown
198 lines
5.4 KiB
Markdown
# Test Guide - Digital Access and Serving System
|
|
|
|
## Quick Start
|
|
|
|
1. **Start the system** (if not already running):
|
|
```bash
|
|
# Terminal 1: Database
|
|
docker-compose up -d
|
|
|
|
# Terminal 2: Backend (will auto-seed database)
|
|
dotnet run --project src/Hospitality.Backend
|
|
|
|
# Terminal 3: Frontend
|
|
cd src/hospitality-web
|
|
npm run dev
|
|
```
|
|
|
|
2. **Access the application**: http://localhost:5173
|
|
|
|
## Sample Data Overview
|
|
|
|
The database is pre-loaded with:
|
|
|
|
### Events
|
|
1. **Summer Festival 2025** (July 1-3, Oslo)
|
|
2. **Winter Gala 2025** (December 15, Bergen)
|
|
|
|
### Groups (Summer Festival)
|
|
1. **VIP Sponsors** - 3 people
|
|
2. **Event Staff** - 2 people
|
|
3. **General Admission** - 2 people
|
|
|
|
### Products (Summer Festival)
|
|
- Beer (Drink)
|
|
- Wine (Drink)
|
|
- Lunch (Meal)
|
|
- Dinner (Meal)
|
|
- VIP Lounge Access (Access)
|
|
|
|
### Test Guests with QR Codes
|
|
|
|
**Note**: QR codes are GUIDs that change each time you seed. To get the actual QR codes:
|
|
1. Go to Admin → Summer Festival 2025 → VIP Sponsors
|
|
2. Click on a person to see their QR code
|
|
|
|
## Test Scenarios
|
|
|
|
### Scenario 1: Admin - View Existing Data
|
|
|
|
1. Go to http://localhost:5173
|
|
2. You should see 2 events: "Summer Festival 2025" and "Winter Gala 2025"
|
|
3. Click on "Summer Festival 2025"
|
|
4. You should see:
|
|
- 3 groups (VIP Sponsors, Event Staff, General Admission)
|
|
- 5 products (Beer, Wine, Lunch, Dinner, VIP Lounge Access)
|
|
|
|
### Scenario 2: Admin - View Group Details
|
|
|
|
1. From Event Detail page, click on "VIP Sponsors"
|
|
2. You should see 3 people:
|
|
- **John Doe** (john.doe@example.com)
|
|
- Beer: 8/10 remaining
|
|
- Wine: 4/5 remaining
|
|
- Lunch: 2/3 remaining
|
|
- Dinner: 3/3 remaining
|
|
- VIP Access: 1/1 remaining
|
|
|
|
- **Jane Smith** (jane.smith@example.com)
|
|
- All quotas unused (full amounts)
|
|
|
|
- **Bob Wilson** (bob.wilson@example.com)
|
|
- Beer: 9/12 remaining
|
|
- Wine: 2/4 remaining
|
|
- Lunch: 1/3 remaining
|
|
- Dinner: 2/3 remaining
|
|
- VIP Access: 0/1 (used)
|
|
|
|
### Scenario 3: Staff Scanner - Lookup Guest
|
|
|
|
1. Go to http://localhost:5173/staff
|
|
2. From Admin, get John Doe's QR code:
|
|
- Go to Summer Festival → VIP Sponsors → John Doe
|
|
- Copy the QR code (GUID under "QR: ...")
|
|
3. Paste the QR code in Staff Scanner
|
|
4. Click "Lookup Person"
|
|
5. You should see:
|
|
- Name: John Doe
|
|
- Email: john.doe@example.com
|
|
- All quotas with remaining amounts
|
|
6. Click "Use 1" on Beer
|
|
7. Verify quota decreases from 8 to 7
|
|
|
|
### Scenario 4: Guest View - Check Quotas
|
|
|
|
1. Go to http://localhost:5173/guest
|
|
2. Enter John Doe's QR code (same as above)
|
|
3. Click "Show My QR Code"
|
|
4. You should see:
|
|
- Large QR code for scanning
|
|
- All quotas with progress bars
|
|
- Updated Beer quota (7/10 if you used 1 in Scenario 3)
|
|
|
|
### Scenario 5: Admin - Add New Person
|
|
|
|
1. Go to Summer Festival → VIP Sponsors
|
|
2. Click "Add Person"
|
|
3. Fill in:
|
|
- Name: "Test User"
|
|
- Email: "test@example.com"
|
|
- Phone: "+47 999 88 777"
|
|
4. Click "Add Person"
|
|
5. Person appears in the list with a new QR code
|
|
6. Click "Assign Quota" on the new person
|
|
7. Select "Beer" and amount "5"
|
|
8. Click "Assign Quota"
|
|
9. Verify quota appears under the person
|
|
|
|
### Scenario 6: Test Different User Types
|
|
|
|
**VIP Sponsor (High Quotas)**
|
|
- Use Jane Smith's QR code
|
|
- Has full quotas: Beer (8), Wine (6), Lunch (3), Dinner (3), VIP Access (1)
|
|
|
|
**Staff Member (Limited Quotas)**
|
|
- Use Alice Staff's QR code
|
|
- Has: Beer (3/4), Lunch (1/2)
|
|
|
|
**General Guest (Basic Quotas)**
|
|
- Use Emily Guest's QR code
|
|
- Has: Beer (2/3), Lunch (1/1)
|
|
|
|
**Heavy User (Mostly Used)**
|
|
- Use Bob Wilson's QR code
|
|
- Has used most quotas, VIP Access is depleted
|
|
|
|
## Testing Checklist
|
|
|
|
- [ ] View events list
|
|
- [ ] View event details with groups and products
|
|
- [ ] View group details with people
|
|
- [ ] View person's QR code and quotas
|
|
- [ ] Add new person to group
|
|
- [ ] Assign quota to person
|
|
- [ ] Use Staff Scanner to lookup person
|
|
- [ ] Record transaction (Use 1 or Use 2)
|
|
- [ ] Verify quota decreases after transaction
|
|
- [ ] Use Guest View to see QR code
|
|
- [ ] Verify progress bars show correct status
|
|
- [ ] Test with different user types (VIP, Staff, Guest)
|
|
- [ ] Try to use more than remaining quota (should fail)
|
|
|
|
## Expected Behaviors
|
|
|
|
### Success Cases
|
|
- ✅ Quotas display correctly with remaining amounts
|
|
- ✅ Transactions record successfully when quota available
|
|
- ✅ Quota decrements after transaction
|
|
- ✅ Progress bars update in real-time
|
|
- ✅ QR codes are unique per person
|
|
|
|
### Error Cases
|
|
- ❌ Cannot use more than remaining quota
|
|
- ❌ Invalid QR code shows "Not Found"
|
|
- ❌ Empty fields in forms show validation errors
|
|
|
|
## Quick Reference - Sample QR Codes
|
|
|
|
**To get actual QR codes:**
|
|
1. Go to Admin → Summer Festival 2025
|
|
2. Click on a group (e.g., VIP Sponsors)
|
|
3. Each person's card shows their QR code (starts with "QR: ...")
|
|
4. Copy the full GUID for testing
|
|
|
|
**Sample People:**
|
|
- John Doe - Has some usage, good for testing transactions
|
|
- Jane Smith - Fresh quotas, good for first-time testing
|
|
- Bob Wilson - Heavy usage, good for testing limits
|
|
- Alice Staff - Staff member with limited quotas
|
|
- Emily Guest - Basic guest with minimal quotas
|
|
|
|
## Troubleshooting
|
|
|
|
**No data showing?**
|
|
- Restart backend: `dotnet run --project src/Hospitality.Backend`
|
|
- Database will auto-seed on startup
|
|
|
|
**QR code not working?**
|
|
- Make sure you copied the full GUID
|
|
- QR codes are case-sensitive
|
|
- Get fresh QR code from Admin interface
|
|
|
|
**Transaction fails?**
|
|
- Check remaining quota is > 0
|
|
- Verify you're using correct QR code
|
|
- Check browser console for errors
|
|
|
|
Enjoy testing! 🎉
|