docs(badges): comprehensive module documentation
COMPLETE DOCUMENTATION:
- Override fields pattern (*_override) and sync behavior
- External system integration (iMIS, Zoom, Novi, Impexium, Confex, Cvent)
- Cron sync safety rules (override fields NEVER overwritten)
- Access level permissions (Authenticated → Super)
- Search/filter capabilities (fulltext, badge type, print status, affiliations)
- Quick edit implementation details
- Database schema and API functions
- Component architecture
- Testing status and known issues
- Development guidelines
KEY CONCEPTS DOCUMENTED:
1. Override fields protect staff/attendee edits from automated syncs
2. Data flow is pull-only (read from external systems, never push back)
3. Display priority: override field → regular field → fallback
4. Access-based editing (currently placeholder, future JSON config)
5. All 7 override fields explained with examples
SYNC BEHAVIOR CLARIFIED:
- Cron jobs CAN update regular fields
- Cron jobs CANNOT touch override fields
- Manual staff edits CAN update any field
- Attendee self-service limited to specific overrides per event config
ed7542b5dc