Cursor rule

1---
2description: Genesis Battle Lab — visual dashboard UX, not text reports
3globs:
4  - templates/combat_simulator.html
5  - static/js/combat_simulator.js
6  - static/style.css
7  - game/combat_simulator.py
8  - tests/test_combat_simulator.py
9---
10 
11# Genesis Battle Lab — Visual First
12 
13> **Genesis Battle Lab ist ein visuelles Werkzeug, kein Bericht.**
14 
15## Principle
16 
17Prefer symbols, resource images, ship icons, status chips, and compact numbers over text lists and paragraphs. Long text is secondary only (tooltips, collapsed admin, i18n keys for hover).
18 
19**Goal:** A player grasps a simulation result in **2–3 seconds** without reading prose.
20 
21## Required patterns
22 
23- **Loot / debris:** single horizontal strip with resource icons + values (`gbl-resource-strip`), not `<dl>` lists.
24- **Losses:** unit icon chips with quantity (`gbl-unit-chips`), not name/value tables.
25- **Combat values:** per-unit stat cards with ⚔ 🛡 ❤ icons (`gbl-stat-card`), not label:value rows.
26- **Analysis:** traffic-light signal chips (`gbl-signal-row`), not bullet lists.
27- **Why / advice:** short chips with hover title for full explanation (`gbl-why-chip`, `gbl-advice-chip`).
28- **Result header:** compact tile bar (icons + numbers), details collapsed by default.
29 
30## Forbidden in player-facing Battle Lab UI
31 
32- Resource name + number vertical lists in the details panel
33- Unit loss tables with ship names as primary display
34- Long narrative paragraphs as the default view
35- Analysis as `<ul>` bullet text without visual signals
36 
37## When adding new result data
38 
391. Add a compact visual representation first (icon, chip, ampel, tile).
402. Put explanatory text in `title` / tooltip or admin-only sections.
413. Add i18n keys in **all** `locales/` files (`de`, `en`, `es`, `fr`, `pl`, `pt`, `ru`, `tr`).
424. Extend `tests/test_combat_simulator.py` for new `data-sim-*` markers and render helpers.
43 
44## Server authority
45 
46Display numbers come from `game/combat_simulator.py` payloads. Frontend formats and renders only — no combat math in JS.
47