CLAUDE.md: Dokumentation auf aktuellen Stand gebracht

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

CLAUDE.md

@@ -69,6 +69,7 @@ api/
   analysis.php              — POST-Endpunkt: Spieler + AoE-Events + Mitigations → JSON
   abilities.php             — POST-Endpunkt: Ability- + Spielerliste für Event Explorer Dropdowns
   debug-events.php          — POST-Endpunkt: Raw Events für Event Explorer (mit Filterung)
+  players.php               — POST-Endpunkt: Spieler + maxHp aus einem beliebigen Fight (für Namen+Job-Import im Planer)
 assets/
   icons/mitigation/         — Lokal gespeicherte Ability-Icons (PNG, von XIVAPI)
 data/
@@ -108,7 +109,7 @@ Getrackte party-wide Buffs + Schilde + Boss-Debuffs (definiert in `MITIGATION_AB
 Drei `buffType`-Kategorien:
 - **`buff`**: Damage Reduction — Passage of Arms (15%), Troubadour/Tactician/Shield Samba (15%), Dark Missionary/Heart of Light/Temperance/Sacred Soil/Expedient/Collective Unconscious/Holos/Kerachole/Magick Barrier (10%), Fey Illumination (5%)
 - **`shield`**: Barrieren — Divine Veil, Guardian, Shake It Off, Bloodwhetting, Divine Benison, Divine Caress, Intersection, Neutral Sect, the Spire, Panhaima, Holosakos, Eukrasian Prognosis, Eukrasian Diagnosis, Differential Diagnosis, Haima, Galvanize, Seraphic Veil, Catalyze, Radiant Aegis, Tempera Coat, Tempera Grassa, Improvised Finish
-- **`debuff`**: Boss-Debuffs — Reprisal, Feint, Addle (je 10%)
+- **`debuff`**: Boss-Debuffs — Reprisal (10%), Feint (10% phys / 5% magic), Addle (10%)
 
 **Statische Status-IDs (`statusId`-Feld):** Jeder Eintrag in `MITIGATION_ABILITIES` trägt ein `statusId`-Feld (FFLogs Status-ID = XIVAPI Status row_id + 1.000.000). Diese IDs werden als Fallback in `$mitigIdMap` eingetragen wenn masterData den Eintrag nicht enthält. Löst das Pre-Pull-Problem und Name-Mismatches (z.B. FFLogs "Guardian's Will" vs. Key 'Guardian', "Desperate Measures" vs. 'Expedient').
 
@@ -160,6 +161,14 @@ Konsistentes Healer → DPS → Tank-Ordering überall: im Spieler-Grid, in jede
 - Schaden-Delta pro Spieler: grün wenn besser (`aoe-delta-better`), rot wenn schlechter (`aoe-delta-worse`)
 - Gesamt-Delta + Ref-Debuff-Icons in der REF-Headerzeile (`aoe-ref-label`)
 
+### Plan als Referenz (Analyse-Tab)
+- Button "+ Plan als Referenz" (`#ref-plan-toggle`) öffnet Dropdown mit gespeicherten Plänen
+- Bei Auswahl: Plan-Mechaniken werden zu `refEvents[]` konvertiert (`isPlanRef: true` Flag)
+- `planToRefEvents(plan)`: wandelt Plan-Assignments in `refEvents` um — nur Abilities mit bekanntem `buffType`
+- In `renderTimeline()`: `isPlanRef` steuert Darstellung — kein Schaden-Delta, kein Dead-State, "Schild"-Text statt absorbed-Wert, Label "PLAN" statt "REF"
+- Spieler des Plans werden im Spieler-Grid angezeigt wenn sie sich vom aktuellen Fight unterscheiden (via `refPlayers`)
+- Same-Report, Cross-Report und Plan-Ref schließen sich gegenseitig aus
+
 ### Cross-Report-Vergleich
 - Button "+ Anderer Report" (`#ref-ext-toggle`) öffnet Panel mit Eingabefeld + Laden-Button
 - `api/fight.php` wird mit dem externen Report-Code aufgerufen → Fight-Dropdown befüllt
@@ -243,6 +252,11 @@ Raid-Cooldown-Planer: Welche Mitigation-Ability wird für welche Mechanik einges
   "mitigationNames": { "Reprisal": "Vergeltung" },
   "folderId": null,
   "jobComposition": ["PLD", "WAR", "WHM", "SCH", "MNK", "DRG", "BRD", "SMN"],
+  "playerRoster": [
+    { "name": "Xziino", "maxHp": 82340 },
+    { "name": "Healer1", "maxHp": 75000 }
+  ],
+  "shieldK": 30,
   "mechanics": [
     {
       "id": "uuid",
@@ -261,6 +275,9 @@ Raid-Cooldown-Planer: Welche Mitigation-Ability wird für welche Mechanik einges
 }
 ```
 
+- `playerRoster`: Array[8] mit `{name, maxHp}` — wird via "Namen + Job Import" befüllt (aus `api/players.php`)
+- `shieldK`: SGE/SCH-Schildwert in k (×1000) — wird in der DR-Simulation als Flat-Abzug verwendet; im Info-Panel editierbar
+
 Mehrere Pläne gespeichert in `localStorage` unter `ff14-planner-plans` als Array.
 Ordner gespeichert unter `ff14-planner-folders`. Pläne referenzieren Ordner per `folderId`.
 Aktiver Plan per `ff14-planner-active-plan` (ID) — wird beim Tab-Öffnen wiederhergestellt.
@@ -289,37 +306,35 @@ Der Haupteinstieg ist der Analyse-Tab — der Nutzer hat die Daten bereits gelad
 | 1 | ✅ | **Datenfundament** — Plan-Datenmodell + localStorage CRUD |
 | 2 | ✅ | **Tab-Grundgerüst** — Plan-Liste, Ordner, Mechanik-Timeline |
 | 3 | ✅ | **Import aus Analyse-Tab** — Export-Button + Dialog + Merge |
-| 4 | ✅ | **Jobaufstellung** — 8 Slots mit Job-Dropdown + Rollenfärbung |
+| 4 | ✅ | **Jobaufstellung** — 8 Slots mit Job-Dropdown + Rollenfärbung + Namen+Job-Import |
 | 5 | ✅ | **Ability-Zuweisung** — Modal-Picker + Rechtsklick-Remove + Äquivalenz-Hints |
-| 6 | 🔜 | **Gantt-Chart** — Recast-Konflikte + DR%-Anzeige (s. unten) |
+| 6 | ✅ | **DR-Simulation + Gantt-Chart** — mitigierter Schaden in Mechanik-Cards, Gantt mit Ability-Zeilen |
 | 7 | 🔜 | **Analyse-Overlay** — geplante vs. tatsächlich genutzte CDs |
 
-### Gantt-Chart — Design-Entscheidungen (Schritt 6)
+### DR-Simulation (implementiert)
 
-**Konzept:** Ergänzende Ansicht zur Mechaniken-Übersicht, nicht Ersatz. Umschaltbar per Toggle/Tab.
+- `ABILITY_DR` in `planner.js`: Map Ability-Name → DR-Wert (0–1). Feint = 0.05 (5% magical, konservativ).
+- `simulateDrMultiplier(mechanic)`: multipliziert `∏(1 − dr_i)` über alle Buff/Debuff-Assignments (keine Schilde)
+- In `renderMechanicListHtml`:
+  - `→ XX mitigiert` (DR-only, farbig gegen ∅ HP): grün wenn ≤ avgHp, rot wenn darüber
+  - `Mitigation mit Schild XX` (DR + shieldK×1000, daneben): nur wenn `plan.shieldK > 0`
+  - `∅ XX HP` (Durchschnitt maxHp ohne Tanks): aus `avgNonTankMaxHp(plan)`, neben unmitigiertem Wert
+- Quell-DR-Werte spiegeln `MITIGATION_ABILITIES[*]['dr']` aus `api/analysis.php` — beide Stellen müssen bei Änderungen synchron gehalten werden
 
-**Layout:**
+### Gantt-Chart (implementiert)
-- X-Achse: Kampfzeit (0 bis Kampfende aus `source.fightEnd - source.fightStart`)
-- Linke Spalte: Ability-Icons (eine Zeile pro eingesetzter Ability im Plan) — Zeilengranularität TBD
-- Vertikale Linien: Mechaniken-Timestamps
-- Farbige Balken: Ability aktiv (Dauer) + Cooldown-Bereich danach (gedimmt)
-- Konflikte: wenn ein Balken eine Mechaniken-Linie überlappt = visuell hervorgehoben
 
-**Drag & Drop:**
+**Aktueller Stand:**
-- Ability-Icons aus Palette auf Timeline ziehen → Icon am Startpunkt, Balken zeigt Dauer
+- X-Achse: Kampfzeit aus `source.fightEnd - source.fightStart`
-- Freies Ziehen ohne Snapping — Timestamp wird aus X-Position berechnet
+- **Eine Zeile pro (Job, Ability)** — nicht pro Job. `timelinePlayerRows(plan)` expandiert `JOB_ABILITIES` pro Job.
-- Bestehende Balken sind ebenfalls verschiebbar
+- Schilde in Gantt ausgeblendet, außer **Panhaima** (SGE)
+- Erste Zeile jedes Jobs hat eine visuelle Trennlinie (`.timeline-player-row--job-start`)
+- Balken: linker Teil (aktive Dauer, opak) + rechter Teil (Cooldown-Rest, transparent) via CSS `linear-gradient` auf `--active-width` / `--cd-width`
+- Klick auf leere Zeile → fügt diese Ability direkt der nächsten Mechanik hinzu (kein Menü)
+- Drag & Drop: nur zwischen Zeilen derselben Ability
+- Bestehende Balken per Drag verschiebbar; Rechtsklick zum Entfernen
 
-**Update-Button:**
+**Noch offen:**
-- Gleicht Gantt-Positionen mit Mechaniken ab
+- Konflikte visuell hervorheben wenn Balken eine Mechaniken-Linie überlappt
-- Matching-Logik: TBD (Overlap oder nächste Mechanik) — noch zu klären
-- Aktualisiert Plan-Assignments entsprechend
-
-**DR-Simulation:**
-- Pro Mechanik: `simulierter Schaden = unmitigiert × ∏(1 − dr_i)` für alle zugewiesenen Buffs/Debuffs
-- Wird in der **Mechaniken-Übersicht** unter dem unmitigierten Schadenswert angezeigt
-- Schilde werden **nicht** simuliert (Schildwerte nicht verlässlich aus Log ableitbar)
-- Kein Pass/Fail-Urteil — nur der errechnete Zahlenwert, User entscheidet selbst
 
 **Recast-Daten:** `data/recast-times.json` — noch zu befüllen. Enthält Cooldown-Dauer (s) und Aktiv-Dauer (s) pro Ability:
 ```json
@@ -345,7 +360,7 @@ Jobaufstellung → verfügbare Abilities (Subset von `MITIGATION_ABILITIES`):
 | WHM | Temperance, Divine Benison, Divine Caress |
 | SCH | Sacred Soil, Expedient, Fey Illumination, Galvanize, Seraphic Veil, Catalyze, Addle |
 | AST | Collective Unconscious, Neutral Sect, Intersection, the Spire |
-| SGE | Kerachole, Holos, Holosakos, Panhaima, Eukrasian Prognosis, Eukrasian Diagnosis, Haima, Addle |
+| SGE | Kerachole, Holos, Holosakos, Panhaima, Eukrasian Prognosis, Eukrasian Diagnosis, Differential Diagnosis, Haima |
 | BRD | Troubadour |
 | MCH | Tactician |
 | DNC | Shield Samba, Improvised Finish |
@@ -391,7 +406,7 @@ Bekannte Werte (Beispiele):
 - **Persistenz:** `localStorage` — kein Backend nötig
 - **IDs:** `crypto.randomUUID()` für Plan-, Mechanik- und Ordner-IDs
 - **Eindeutige Namen:** `uniquePlanName()` verhindert Duplikate beim Erstellen und Importieren
-- **Keine Spielernamen:** Assignments sind Job-basiert (`{ ability, job }`), damit Pläne übertragbar sind
+- **Spielernamen in `playerRoster`:** Assignments bleiben Job-basiert (`{ ability, job }`). Namen + maxHp werden separat in `playerRoster[8]` gespeichert — für ∅-HP-Anzeige und Analyse-Tab-Vergleich, nicht für Assignments
 - **Kein Ability-Stacking:** FFXIV erlaubt keine doppelte Anwendung derselben Ability pro Mechanik
 - **Shield-Attribution:** Nicht simulierbar — `absorbed` ist Gesamtwert ohne Aufschlüsselung. Bewusst weggelassen.
 - **DR-Simulation:** Nur Buffs/Debuffs mit bekanntem `dr`-Wert aus `MITIGATION_ABILITIES`. Ergebnis als Zahlenwert, kein Pass/Fail.