chg: usr: add extended data to battle reports and sharing image to make viewable bonus points #5

docs/game-mechanics/BONUS_POINTS_SYSTEM.md

@@ -124,10 +124,45 @@ The Mine-Seeker game includes a bonus points system that rewards skilled play. B
 
 ---
 
+## Battle Report Display Components
+
+**IMPORTANT**: The Bonus Statistics display appears in **two places** that must be kept in sync:
+
+### 1. Public Battle Share Page
+**File**: `/templates/Game/battle_share.html.twig`
+- Displays via `bshare-bonus` CSS classes
+- Backend data passed from `ProfileController::battleShare()`
+- Shows bonus stats as HTML table format
+
+### 2. Profile Dialog (BattleDialog component)
+**File**: `/assets/js/components/BattleDialog.jsx`
+- React component using Material-UI Dialog
+- Displays inside the match details modal on profile page
+- Shows bonus stats using `StatRow` components in side-by-side boxes
+
+### Synchronization Requirements
+
+When making changes to the bonus statistics display, update **BOTH** files:
+
+1. **Update logic/data** → Edit both template and component
+2. **Change stat names** → Update both BONUS_LABELS and both display files
+3. **Modify formatting** → Keep visual consistency between both displays
+4. **Add new stats** → Add to both the `.twig` template AND the `.jsx` component
+
+**Checklist for changes**:
+- [ ] Update `/src/Util/TopicManager.php` if bonus calculation changes
+- [ ] Update `/templates/Game/battle_share.html.twig` for public display
+- [ ] Update `/assets/js/components/BattleDialog.jsx` for profile dialog
+- [ ] Update `/assets/js/mine-seeker/utils/constants.jsx` if adding new stats
+- [ ] Test both displays show identical data
+
+---
+
 ## Quick Checklist for Changes
 - [ ] Code changes implemented
 - [ ] This documentation updated
 - [ ] `/docs/README.md` Quick Reference table updated
 - [ ] Code comments added/updated
 - [ ] Examples updated to match new behavior
+- [ ] Both battle report displays tested