History

Lars ca8cee990b All checks were successful Deploy Development / deploy (push) Successful in 1m1s Details Build Test / pytest-backend (push) Successful in 4s Details Build Test / lint-backend (push) Successful in 0s Details Build Test / build-frontend (push) Successful in 16s Details feat: Enhance activity metrics handling and documentation - Updated the README to include new activity production architecture and phases, improving clarity on the development roadmap. - Enhanced the `ACTIVITY_SESSION_METRICS_EAV_AGENT_GUIDE` with details on the target architecture and phase plan for production readiness. - Introduced a new function `merge_column_backed_and_eav_metrics` to streamline the merging of metrics from column-backed and EAV sources, ensuring data integrity and reducing duplication. - Refactored session metrics handling to eliminate deprecated synchronization methods, improving the overall efficiency of data processing. - Added unit tests for the new merging logic, ensuring robust validation of metrics handling.		2026-04-15 16:59:11 +02:00
..
commands	docs: Struktur .claude/docs versionieren, working/, Gitea-Index, Regeln	2026-04-08 13:01:49 +02:00
docs	feat: Enhance activity metrics handling and documentation	2026-04-15 16:59:11 +02:00
rules	feat(universal-csv-import): Introduce Universal CSV Import module and related documentation	2026-04-11 08:14:20 +02:00
README.md	feat(universal-csv-import): Introduce Universal CSV Import module and related documentation	2026-04-11 08:14:20 +02:00

README.md

Mitai Jinkendo – Claude-Arbeitsumgebung

Dieser Ordner ist der primäre Orientierungspunkt für Claude Code / Cursor-Agenten. Dauerhafte Spezifikationen liegen unter .claude/docs/ (functional/, technical/ …). Das Repository docs/ (Projektroot) ist u. a. für docs/issues/ – nicht verwechseln.

Pflichtlektüre (vor größeren Änderungen)

Reihenfolge	Datei
1	`../CLAUDE.md`
2	`rules/DOCUMENTATION.md` – Ablage- und Dokumentationsregeln
3	`rules/ARCHITECTURE.md`, `rules/CODING_RULES.md`, `rules/LESSONS_LEARNED.md`
4	Issue-Landkarte: `.claude/docs/GITEA_ISSUES_INDEX.md`
5	Universal CSV Import (Modul/Executor/Vorlagen): `docs/technical/UNIVERSAL_CSV_IMPORT_AGENT_GUIDE.md` (unter `.claude/`)

Themen mit UI/Nav/PWA: siehe ../docs/issues/GUI_IA_ADMIN_NAV_2026-04-05.md (im Projekt-docs/, nicht hier).

Verzeichnisbaum (Kurz)

.claude/
├── README.md              ← Diese Datei
├── rules/                 ← Verbindliche Regeln (versioniert, wenn konfiguriert)
├── docs/                  ← Spezifikationen + Arbeitspapiere
│   ├── functional/        ← Fachlich (WAS)
│   ├── technical/         ← Technisch (WIE)
│   ├── architecture/      ← Querschnitt
│   ├── working/           ← Zwischenstände, Analysen (nicht allein „Wahrheit“)
│   ├── audit/             ← Audits, Matrizen
│   ├── README.md          ← Katalog aller Spec-Dateien
│   └── GITEA_ISSUES_INDEX.md
├── commands/              ← Slash-Befehle (optional versioniert)
├── task/                  ← Lokale Arbeitspakete (meist nur lokal)
├── handover/              ← Session-Notizen (meist nur lokal)
├── skills/                ← Skills (lokal)
└── settings.json          ← Editor-Konfiguration (lokal)
.settings.local.json       ← Nicht committen

Wo neue Inhalte ablegen

Siehe rules/DOCUMENTATION.md (Tabelle „Ablagepflicht“). Kurz:

Langfristige fachliche Spec → docs/functional/ (innerhalb von .claude, siehe Baum oben).
Langfristige technische Spec → docs/technical/.
Session-Analyse / grobe Notizen → docs/working/.
Epic/Issue lang → ../docs/issues/ im Repository.

Projekt-`docs/` (Repository)

../docs/issues/ enthält issue-nummerierte Markdown-Dateien und Abnahme-Dokumente – parallel zu diesem Ordner, für alle sichtbar die das Repo klonen.

Stand: 2026-04-08