Approval Workflow Troubleshooting & FAQs
Security & Audit Trail
Preview Token Security:
- UUID v4 tokens (128-bit entropy)
- 7-day expiration (configurable)
- Single-use validation (expires after approval/rejection)
Audit Logging:
- All approval/rejection actions logged
- Includes: admin user, timestamp, listing ID, action taken
- Searchable via: `/admin/audit-trail`
Troubleshooting
Preview Link Expired
Symptom: "This preview link has expired" error Causes:
- Token older than 7 days
- Listing already approved/rejected
- Token manually invalidated
Solution:
- Navigate to customer detail page
- Click "Regenerate Preview Link"
- New 7-day token created
Email Not Received
Symptom: Customer reports no approval/rejection email
Troubleshooting Steps:
- Check spam/junk folder
- Verify customer email in database (typos?)
- Check SMTP logs: `/admin/monitoring/email-logs`
- Verify SMTP configuration in `.env`
- Resend email: Customer detail → "Resend Notification"
Approval Button Disabled
Symptom: "Approve" button is grayed out
Causes:
- User lacks `customers:write` permission
- Listing already approved
- Preview token expired
Solution:
- Verify RBAC permissions: `/admin/users/[id]`
- Regenerate preview link if expired
- Contact super admin for permission escalation
FAQs
Q: Can I approve multiple listings at once?
A: No. Each listing requires individual review for quality assurance.
Q: Can a rejected listing be re-approved without resubmission?
A: No. Customer must edit and resubmit for new admin review.
Q: What happens to expired preview links?
A: Token becomes invalid. Regenerate link to resume review.
Q: Can customers see rejection reasons?
A: Yes, via email notification and customer portal (`/customer/listings`).