From 42e97ebce0bc8427965df858af8ccd12112b658c Mon Sep 17 00:00:00 2001 From: Agent Zero Date: Thu, 13 Aug 2026 11:43:26 +0200 Subject: [PATCH] =?UTF-8?q?docs(progress):=20PROGRESS.md=20+=20AGENTS.md?= =?UTF-8?q?=20Section=209=20=E2=80=94=20Progress-Tracking=20&=20Forgejo-Is?= =?UTF-8?q?sue-Verwaltung?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 49 +++++++++++++- PROGRESS.md | 182 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 230 insertions(+), 1 deletion(-) create mode 100644 PROGRESS.md diff --git a/AGENTS.md b/AGENTS.md index 8885d33..049456d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -143,7 +143,8 @@ Full architecture: `architecture.md` | Full task graph: `task_graph.json` | Datei | Zweck | |-------|------| | `README.md` | Projekt-Overview, Setup | -| `PLATFORM_ROADMAP.md` | Roadmap, Meilensteine | +| `PLATFORM_ROADMAP.md` | EINZIGE Planungs-Datei für zukünftige Entwicklung, Umbauten, Roadmap. Alle Phasen, Tasks und Architekturentscheidungen | +| `PROGRESS.md` | Fortschritts-Tracking — pro Task: Status, Forgejo Issue, Verifiziert. Wird vom Agent bei jedem Status-Wechsel aktualisiert | | `AGENTS.md` | Agent-Definitionen (diese Datei) | | `docs/test-strategy.md` | Test-Strategie, Konventionen, Einschränkungen | | `docs/security_kernel.md` | Security-Konzept (ABAC, RLS, Session) | @@ -185,3 +186,49 @@ Full architecture: `architecture.md` | Full task graph: `task_graph.json` 4. Dedup-Tests: Unterschiedlichen Dateiinhalt pro Upload verwenden 5. Keine zufälligen UUIDs: Echte Entity-IDs aus der DB verwenden 6. Test-Dateien: `tests/test_.py` | Fixtures: `tests/conftest.py` + +--- + +## 9. Progress-Tracking & Forgejo-Issue-Verwaltung + +### Planungs- und Fortschrittsdateien + +| Datei | Zweck | Wann aktualisieren | +|-------|------|-------------------| +| `PLATFORM_ROADMAP.md` | EINZIGE Planungs-Datei. Alle Phasen, Tasks, Architekturentscheidungen | Bei Planungsänderungen | +| `PROGRESS.md` | Fortschritts-Tracking. Pro Task: Status, Forgejo Issue, Verifiziert | Bei jedem Task-Status-Wechsel | + +### Task-Status-Verwaltung + +Jeder Task in der Roadmap hat einen Status der in `PROGRESS.md` verfolgt wird: + +- `not_started` — Task noch nicht begonnen +- `in_progress` — Task wird bearbeitet +- `blocked` — Task blockiert (Abhängigkeit fehlt, Entscheidung ausstehend) +- `review` — Task implementiert, wartet auf Review/Tests +- `done` — Task hat Definition of Done (DoD) erfüllt + +**Der Agent MUSS `PROGRESS.md` bei jedem Status-Wechsel aktualisieren.** Kein Task-Wechsel ohne PROGRESS.md-Update. + +### Forgejo Issues & Milestones + +- **Pro Phase (A-J):** Ein Forgejo Milestone (z.B. "Phase A — Stabilität", "Phase B — System-Konsolidierung") +- **Pro Task:** Ein Forgejo Issue mit Label `task` + Milestone der jeweiligen Phase +- **Pro Bug:** Ein Forgejo Issue mit Label `bug` + Priorität (`critical`, `high`, `medium`, `low`) +- **Pro Feature-Request:** Ein Forgejo Issue mit Label `enhancement` + +**Der Agent MUSS für jeden Task ein Forgejo Issue erstellen** und die Issue-Nummer in `PROGRESS.md` eintragen. + +### Commit-Messages + +- Commit-Messages enthalten die Task-ID: `feat(B-LLM): zentraler LLM Client implementiert` +- Bug-Fixes referenzieren das Issue: `fix(#123): Redis-Connection-Leak behoben` +- `fixes #123` oder `closes #123` im Commit schließt das Issue automatisch + +### Definition of Done (DoD) + +Ein Task gilt erst als **DONE** wenn alle 8 DoD-Kriterien erfüllt sind (siehe `PLATFORM_ROADMAP.md`). Ein Task ohne Test ist NICHT done. Der Agent darf keinen Task als `done` markieren ohne DoD erfüllt zu haben. + +### Phase-Gate-Review + +Eine Phase gilt erst als **ABGESCHLOSSEN** wenn alle 7 Phase-Gate-Kriterien erfüllt sind (siehe `PLATFORM_ROADMAP.md`). Der Agent darf nicht zur nächsten Phase übergehen ohne Phase-Gate-Review bestanden zu haben. diff --git a/PROGRESS.md b/PROGRESS.md new file mode 100644 index 0000000..8e8bf3f --- /dev/null +++ b/PROGRESS.md @@ -0,0 +1,182 @@ +# LeoPlatform — Fortschritts-Tracking + +> **Letztes Update:** 2026-08-13 +> **Status:** Planung abgeschlossen — bereit für Phase A + +--- + +## Übersicht + +| Phase | Status | Start | Ende | Tasks Done | Tasks Total | +|-------|-------|-------|------|------------|-------------| +| A — Stabilität verifizieren | `not_started` | — | — | 0 | 4 | +| B — System-Konsolidierung | `not_started` | — | — | 0 | ~50 | +| C — Core UI | `not_started` | — | — | 0 | ~18 | +| C.5 — Import/Export | `not_started` | — | — | 0 | 8 | +| D — Undo/Restore | `not_started` | — | — | 0 | ~12 | +| E — Search | `not_started` | — | — | 0 | ~24 | +| F — Agents | `not_started` | — | — | 0 | ~28 | +| G — Workflows | `not_started` | — | — | 0 | ~24 | +| H — Knowledge | `not_started` | — | — | 0 | ~18 | +| I — Integration & Workstream | `not_started` | — | — | 0 | ~25 | +| J — Self-Improvement | `not_started` | — | — | 0 | ~12 | + +**Gesamt:** 0 / ~223 Tasks done + +--- + +## Phase A — Stabilität verifizieren + +| Task | Status | Forgejo Issue | Verifiziert | +|------|-------|---------------|------------| +| A-VERIFY | `not_started` | — | — | +| A-TEST | `not_started` | — | — | +| A-PERF | `not_started` | — | — | +| A-DOC | `not_started` | — | — | + +--- + +## Phase B — System-Konsolidierung + +### B.1 Zentraler LLM Client + +| Task | Status | Forgejo Issue | Verifiziert | +|------|-------|---------------|------------| +| B-LLM | `not_started` | — | — | +| B-LLM-MIG | `not_started` | — | — | +| B-LLM-TEST | `not_started` | — | — | +| B-LLM-DOC | `not_started` | — | — | + +### B.2 Zentraler Redis Pool + +| Task | Status | Forgejo Issue | Verifiziert | +|------|-------|---------------|------------| +| B-RED | `not_started` | — | — | +| B-RED-TEST | `not_started` | — | — | + +### B.2b pgvector HNSW Optimierung + +| Task | Status | Forgejo Issue | Verifiziert | +|------|-------|---------------|------------| +| B-VEC | `not_started` | — | — | +| B-VEC-IVF | `not_started` | — | — | +| B-VEC-BATCH | `not_started` | — | — | +| B-VEC-TEST | `not_started` | — | — | + +### B.3 Gemeinsamer File Storage + +| Task | Status | Forgejo Issue | Verifiziert | +|------|-------|---------------|------------| +| B-STOR | `not_started` | — | — | +| B-STOR-MIG | `not_started` | — | — | +| B-STOR-TEST | `not_started` | — | — | + +### B.4 WebSocket Helpers + +| Task | Status | Forgejo Issue | Verifiziert | +|------|-------|---------------|------------| +| B-WS | `not_started` | — | — | +| B-WS-TEST | `not_started` | — | — | + +### B.5 Event-System Rollen dokumentieren + +| Task | Status | Forgejo Issue | Verifiziert | +|------|-------|---------------|------------| +| B-EVT | `not_started` | — | — | +| B-EVT-DOC | `not_started` | — | — | + +### B.6 Schema Authority definieren + +| Task | Status | Forgejo Issue | Verifiziert | +|------|-------|---------------|------------| +| B-SCHEMA | `not_started` | — | — | + +### B.7 Plugin-Guide (klein) + +| Task | Status | Forgejo Issue | Verifiziert | +|------|-------|---------------|------------| +| B-PLUGIN | `not_started` | — | — | +| B-PLUGIN-MANIFEST | `not_started` | — | — | +| B-PLUGIN-FE | `not_started` | — | — | +| B-PLUGIN-MINIAPP-WIRE | `not_started` | — | — | +| B-PLUGIN-UI-CONTRACT | `not_started` | — | — | +| B-PLUGIN-GUIDE | `not_started` | — | — | + +### B.8 Rate-Limiting Konsistenz + +| Task | Status | Forgejo Issue | Verifiziert | +|------|-------|---------------|------------| +| B-RL | `not_started` | — | — | + +### B.9 Sensitive Data Boundary + +| Task | Status | Forgejo Issue | Verifiziert | +|------|-------|---------------|------------| +| B-SENS | `not_started` | — | — | + +### B.10 Lifecycle Hooks & relevante Outbox Events + +| Task | Status | Forgejo Issue | Verifiziert | +|------|-------|---------------|------------| +| B-HOOK-CORE | `not_started` | — | — | +| B-HOOK-MAIL | `not_started` | — | — | +| B-HOOK-DMS | `not_started` | — | — | +| B-HOOK-CAL | `not_started` | — | — | +| B-HOOK-TASK | `not_started` | — | — | +| B-HOOK-COMM | `not_started` | — | — | +| B-HOOK-AI | `not_started` | — | — | +| B-HOOK-WF | `not_started` | — | — | +| B-HOOK-TAG | `not_started` | — | — | +| B-HOOK-SEARCH | `not_started` | — | — | +| B-EVT-OUTBOX | `not_started` | — | — | +| B-HOOK-TEST | `not_started` | — | — | +| B-HOOK-DOC | `not_started` | — | — | + +### B.11 Trigger-Kern konsolidieren + +| Task | Status | Forgejo Issue | Verifiziert | +|------|-------|---------------|------------| +| B-TRIG-GEN | `not_started` | — | — | +| B-TRIG-UI | `not_started` | — | — | +| B-TRIG-CRON | `not_started` | — | — | +| B-TRIG-MAN | `not_started` | — | — | +| B-TRIG-TEST | `not_started` | — | — | +| B-TRIG-DOC | `not_started` | — | — | + +### B.12 Notification → Message-System + +| Task | Status | Forgejo Issue | Verifiziert | +|------|-------|---------------|------------| +| B-NOTIF-SYS | `not_started` | — | — | +| B-NOTIF-EVT | `not_started` | — | — | +| B-NOTIF-UI | `not_started` | — | — | +| B-NOTIF-PREF | `not_started` | — | — | +| B-NOTIF-MIG | `not_started` | — | — | +| B-NOTIF-DEPREC | `not_started` | — | — | +| B-NOTIF-TEST | `not_started` | — | — | + +--- + +## Phasen C-J + +Detaillierte Task-Listen werden beim Start der jeweiligen Phase eingetragen. Siehe `PLATFORM_ROADMAP.md` für alle Tasks. + +--- + +## Blockierte Tasks + +| Task | Grund | Blockiert seit | Lösung | +|------|-------|----------------|--------| +| — | — | — | — | + +--- + +## Verifizierte Phase-Gate-Reviews + +| Phase | 8-Check-Pipeline | Deploy | Doku | Performance | Frontend-Tests | Abgeschlossen | +|-------|------------------|--------|------|------------|----------------|----------------| +| — | — | — | — | — | — | — | + +--- + +*Diese Datei wird vom Agent bei jedem Task-Status-Wechsel aktualisiert. Sie ist die schnelle Übersicht über den Fortschritt. Detaillierte Diskussion und Bug-Tracking laufen über Forgejo Issues.*