# Doku (Predictalytics / PolyTraderSharp)

Zentrale Ablage für Roadmap, Leitfäden, Fach- und Business-Dokumente. Code-gekoppelte Pläne
bleiben bewusst in **diesem** Repo (statt in einem separaten Docs-Repo), damit
„Plan → umsetzende Commits" nachvollziehbar bleibt.

## Wo anfangen?

| | |
|---|---|
| **[ROADMAP.md](./ROADMAP.md)** | **Das Steuerungsdokument.** Alle Vorhaben, Status, Reihenfolge — was als Nächstes zu tun ist und was bewusst liegen bleibt |
| **[PROJEKTSTAND.md](./PROJEKTSTAND.md)** | Der Ist-Zustand: Architektur, Kennzahlen, Modul-Stand |

Kurzformel: **PROJEKTSTAND = was ist. ROADMAP = was kommt.**

## Leitfäden (vor der Arbeit lesen)

- **[LEITFADEN-Avalonia-Portierung.md](./LEITFADEN-Avalonia-Portierung.md)** — Arbeitsregeln für
  die Oberfläche. **Vor jeder UI-Arbeit lesen**: Layout ist deklarativ, keine festen Farben,
  Module bleiben frei von Avalonia.
- **[LEITFADEN-CI.md](./LEITFADEN-CI.md)** — was die CI prüft und wie der Gitea-Runner
  eingerichtet wird.
- **[`.agents/rules/clob.md`](../.agents/rules/clob.md)** — verbindlich für alles, was Geld bewegt.

## Struktur

- **[`archiv/`](./archiv/)** — die Umsetzungspläne und Konzepte, aus denen die Roadmap
  zusammengeführt wurde. **Nicht tot:** weiterhin die Bauanleitungen mit Code-Bezügen,
  Akzeptanzkriterien und Begründungen. Nur der *Status* darin ist eingefroren — dafür gilt
  ausschließlich die Roadmap. Details in [`archiv/README.md`](./archiv/README.md).
- **[`sicherheit/`](./sicherheit/)** — Sicherheitskonzept und die wiederkehrende
  Audit-Checkliste. Die offenen Kästchen in Abschnitt 6 sind eine **Vorlage für jedes Release**,
  kein Rückstand.
- **[`steuer/`](./steuer/)** — Steuer-/Buchhaltungs-Fachdokumente und Vorlagen, auch zum
  Weitergeben an Berater.
  - `Accounting-US-Tax-Questionnaire.md` — Fragebogen (EN) für die US-Steuerberaterin (Florida LLC).
- **[`pruefplaene/`](./pruefplaene/)** — Prüf-/Validierungspläne.
  - `PREDICTALYTICS-PRUEFPLAN-Master-Auswahl.md` — Master-Trader-Auswahl (separates
    Predictalytics-Projekt).
- **`ideen/`** — frühe Ideen, bevor sie zu einem Konzept reifen.
- **[UI-SPEZIFIKATION-WinForms.md](./UI-SPEZIFIKATION-WinForms.md)** — Beschreibung der
  abgelösten Oberfläche. Vergleichsvorlage für die Abnahme A5.
- **[IDEENSAMMLUNG-Feldtest-2026-08.md](./IDEENSAMMLUNG-Feldtest-2026-08.md)** — Beobachtungen
  aus dem laufenden Einsatz. Nur sammeln, Umsetzung später.

## Konventionen

- **Eine Statusquelle.** Fortschritt wird ausschließlich in der Roadmap gepflegt, nirgends sonst.
  Bis zum 22.08.2026 stand der Status in einem Dutzend Dokumenten — mehrere davon waren
  wochenlang falsch.
- **Plandokument und Code wandern im selben Commit.** Wer etwas abhakt, committet die Roadmap mit.
- Neue Detailpläne: `UMSETZUNGSPLAN-*.md` → `archiv/umsetzungsplaene/`, und in der Roadmap
  verlinken. Neue Konzepte analog nach `archiv/konzepte/`.
- Übergreifende, an Externe weitergebbare Dokumente können später in ein eigenes
  `Predictalytics-Docs`-Repo ausgelagert werden (Ordner rausziehen genügt) — für jetzt bewusst
  hier gebündelt.