Sprint-0-Spezifikationen ergaenzen, AP0.1-Setup-Luecken schliessen (Health, CI, ADR-Vorlage).
Test Suite / playwright-tests (push) Waiting to run
Deploy Development / deploy (push) Failing after 0s
Test Suite / pytest-backend (push) Failing after 5m1s
Test Suite / lint-backend (push) Failing after 0s
Test Suite / build-frontend (push) Successful in 0s
Test Suite / k6 /api/health Baseline (push) Has been cancelled

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
LarsandCursor committed 2026-07-04 19:08:55 +02:00
1 parent 0e2b938fbd
commit 1ce20d8bdb
18 files changed
+1651 -47

No files matched your search

@@ -0,0 +1,38 @@
# Architecture Decision Proposal
Status: Entwurf
Stand: YYYY-MM-DD
Autor:
---
## Problem
Was ist die konkrete Entscheidungssituation?
## Betroffene Regel
Welches verbindliche Dokument oder Prinzip (Gate, Foundation, Spec) ist betroffen?
## Optionen
| Option | Kurzbeschreibung | Pro | Contra |
|--------|------------------|-----|--------|
| A | | | |
| B | | | |
## Empfehlung
Welche Option und warum?
## Risiko
Was kann schiefgehen?
## Rückbaubarkeit
Wie lässt sich die Entscheidung rückgängig machen oder später verfeinern?
## Auswirkung auf Sprint 0
Betrifft das den Sprint-0-Scope oder nur spätere Arbeitspakete?
@@ -0,0 +1,200 @@
# Jinkendo Foundation
## Minimum Viable Foundation v0.2
Status: Arbeitsfassung
Stand: 2026-07-04
Zweck: Minimale produktübergreifende Grundlage, soweit sie für Jinkendo Kairo Sprint 0 zwingend relevant ist.
---
## 1. Zweck
Diese Minimum Viable Foundation beschreibt nur die produktübergreifenden Prinzipien, die Kairo von Anfang an korrekt berücksichtigen muss.
Sie ist keine vollständige Zielarchitektur der Jinkendo-Produktfamilie.
Sie erzwingt keine Konvergenz von Mitai und Shinkan.
Sie verhindert nur, dass Kairo grundlegende Plattformkonzepte falsch oder isoliert implementiert.
---
## 2. Geltungsbereich
Gilt für Kairo Sprint 0 und spätere neue Jinkendo-Produkte, soweit dieselben Prinzipien relevant sind.
Nicht Gegenstand:
- Umbau von Mitai
- Umbau von Shinkan
- zentrale Familienarchitektur
- Billing
- SSO
- vollständige Shared Packages
---
## 3. Drift-Schutz
Ein Prinzip wird nur Sprint-0-verbindlich, wenn alle drei Fragen mit „Ja“ beantwortet werden:
1. Verhindert es später teures strukturelles Refactoring in Kairo?
2. Ist es für Sprint 0 zwingend erforderlich?
3. Kann es minimal umgesetzt werden, ohne Kairo zu überladen?
Alles andere kommt ins Architektur-Backlog.
---
## 4. Verbindliche Foundation-Prinzipien für Kairo Sprint 0
### F-01 Tenant-first
Kairo ist mandantenfähig zu modellieren.
Alle fachlichen Objekte benötigen Tenant-Bezug oder einen expliziten globalen Scope.
### F-02 Actor-first
Operative Verantwortung wird Actors zugeordnet.
Actors können Menschen, KI-Agenten, Arbeitsgruppen oder externe Systeme sein.
### F-03 TenantContext pro Request
Jeder geschützte Request muss einen aufgelösten Kontext besitzen:
- User
- Tenant
- Actor
- Rollen
- Capabilities
### F-04 Auth, Capability, Feature und Governance trennen
Kairo vermischt nicht:
- Auth: Wer ist eingeloggt?
- Capability: Darf diese Funktion genutzt werden?
- Feature: Welche Produktfunktion ist betroffen?
- Governance: Darf dieses Objekt gesehen oder verändert werden?
Feature-Limits und Billing werden nur vorbereitet, nicht in Sprint 0 vollständig gebaut.
### F-05 Registry-first
Neue steuerungsrelevante Funktionen registrieren sich an zentralen Registries.
Mindestens:
- Rights / Capability Registry
- Feature Registry
- Prompt Registry
- Configuration Registry
### F-06 Prompts nicht hardcoden
Produktive interne Prompts liegen nicht hart im Code.
Sprint 0 benötigt:
- Prompt Template
- Prompt Version
- Placeholder
- Kontextart
- Admin-Scope
### F-07 Platzhalter kontrollieren
Platzhalter sind typisiert, dokumentiert und werden validiert.
Fehlende Pflichtplatzhalter führen zu kontrollierten Fehlern.
### F-08 Keine hardcodierte fachliche Konfiguration
Nicht hardcodieren:
- Rollen
- Rechte
- Prompts
- fachliche Statuslisten
- Feature-Flags mit fachlicher Bedeutung
- Workflowparameter
- AI-Modellzuordnung
Technische Defaults sind erlaubt, müssen aber dokumentiert und später überschreibbar sein.
### F-09 Audit für Admin- und Agentenaktionen
Administrative und agentenbezogene Aktionen müssen auditierbar sein.
Sprint 0 benötigt ein einfaches AuditLog-Modell.
### F-10 Nummerierte Migrationen und Fail-Fast-Startup
Schemaänderungen laufen über nummerierte Migrationen.
Fehlgeschlagene Migrationen dürfen den App-Start blockieren.
---
## 5. Bewusst nicht Sprint-0-verbindlich
Nicht in Sprint 0:
- vollständige Entitlement-/Billing-Engine
- Usage-Zähler
- Tiers
- Pläne
- Coupons
- SSO
- vollständige Mitai Prompt Engine
- Shinkan Access Layer mit Vereinslogik
- Widget Dashboard
- Data Layer nach Mitai-Vorbild
- Import-Framework
- Media Assets
- Content Reports
- Maturity Models
---
## 6. Referenzprinzipien
### Aus Mitai relevant
- Prompt Templates nicht hardcoden
- zentrale Prompt-Ausführung als Zielbild
- Registry-Muster
- Feature-Registry als Konzept
- Migration/Deploy-Standard
- Auth-Session-Basis
### Aus Shinkan relevant
- TenantContext
- Trennung von Portalrolle und fachlicher Rolle
- Rights Registry
- Capabilities vs. Features
- Entitlements-Snapshot als API-Idee
- schmale AI Prompt Runtime als Sprint-0-kompatibles Vorbild
---
## 7. Kairo-spezifische Entscheidung
Kairo übernimmt keine allgemeine Familienarchitektur.
Kairo übernimmt nur:
```text
Tenant + Actor + TenantContext
Capability Registry
Feature Registry minimal
Prompt Registry minimal
Placeholder validiert
Audit
Migration/Deploy
```
Alles andere ist späteres Architektur-Backlog.
@@ -12,6 +12,12 @@ Stand: 2026-07-04
5. `docs/sprints/Sprint0_Vibe_Coder_Handover_v0.1.md`
6. `CLAUDE.md`
7. `.cursor/rules/kairo-architecture.mdc`
8. `docs/sprints/Sprint0_AP0_1_Project_Setup_Assignment_v0.1.md`
## Hilfsdokumente
- `docs/architecture/ARCHITECTURE_DECISION_PROPOSAL_TEMPLATE.md`
- `infra/README.md` — Platzhalter für serverseitige Infra-Ergänzungen
## Referenzdokumente
@@ -0,0 +1,105 @@
# Jinkendo Kairo
## Sprint-0 Principle Gate v0.1
Status: verbindlicher Scope-Filter für Sprint 0
Stand: 2026-07-04
---
## 1. Zweck
Dieses Dokument verhindert Drift.
Es legt fest, welche Prinzipien aus Mitai/Shinkan/Family-Alignment für Kairo Sprint 0 verbindlich sind und welche ausdrücklich nicht umgesetzt werden.
---
## 2. Entscheidungsregel
Ein Prinzip ist nur dann Sprint-0-verbindlich, wenn alle drei Fragen mit Ja beantwortet werden:
1. Verhindert es später teures strukturelles Refactoring?
2. Ist es für Sprint 0 zwingend erforderlich?
3. Kann es minimal umgesetzt werden, ohne Kairo zu überladen?
---
## 3. Sprint-0-verbindliche Prinzipien
| ID | Prinzip | Sprint-0-Konsequenz |
|---|---|---|
| G-01 | Tenant-first | Tenant ist Kernobjekt; keine Single-User-Architektur |
| G-02 | Actor-first | Assignments gehen an Actors, nicht direkt an User |
| G-03 | TenantContext pro Request | Auth-Kontext wird zentral aufgelöst |
| G-04 | Auth / Capability / Feature / Governance trennen | Keine Vermischung von Login, Rollen, Limits und Objektzugriff |
| G-05 | Rights Registry | Rechte/Capabilities werden registriert, nicht verstreut hardcodiert |
| G-06 | Feature Registry minimal | Features sind bekannt und benannt, auch wenn Limits später kommen |
| G-07 | Prompt Registry minimal | Prompts sind administrierbare Templates, nicht Code-Strings |
| G-08 | Platzhalter validieren | Pflichtplatzhalter dürfen nicht stillschweigend fehlen |
| G-09 | Config statt Hardcoding | Fachliche Konfiguration nicht im Code verdrahten |
| G-10 | Audit | Admin- und Agentenaktionen werden protokolliert |
| G-11 | Migration Standard | Nummerierte SQL-Migrationen + Tracking |
| G-12 | Fail-Fast Startup | App startet nicht mit fehlerhaftem Schema |
---
## 4. Nur vorbereiten, nicht vollständig bauen
| Thema | Sprint-0-Umfang |
|---|---|
| Entitlements | Minimaler `/me/entitlements` Snapshot: tenant, actor, roles, capabilities |
| Feature Limits | Datenmodell optional vorbereiten; keine Usage-Zähler |
| Prompt Engine | Templates, Versionen, Platzhalter; keine Workflows/Pipelines |
| Admin UI | Minimal prüfbar; keine ausgereifte Oberfläche |
| MCP | Schnittstellen später; keine MCP-Implementierung in Sprint 0 |
| AI Agenten | Actor Type Agent vorbereiten; keine vollständige Agentensteuerung |
---
## 5. Explizit nicht Sprint 0
- Billing
- Tiers
- Pläne
- Coupons
- Usage-Zähler
- SSO
- Mitai Data Layer
- Mitai Widget Dashboard
- Universal Import
- Shinkan Exercise Catalog
- Shinkan Training Planning
- Shinkan Media Assets
- Shinkan Content Reports
- Shinkan Maturity Models
- vollständige Familien-Konvergenz
- Lebensmanager-/Seichō-Fachlogik
---
## 6. Review-Regel
Jeder neue Vorschlag im Sprint wird mit einer Kategorie versehen:
```text
A – Sprint-0-verbindlich
B – Architektur-Backlog
C – Produktspezifisch / ignorieren
```
Nur Kategorie A darf in Sprint 0 umgesetzt werden.
---
## 7. Abweichungsregel
Ein Coding-Agent darf nicht eigenmächtig von diesem Gate abweichen.
Bei notwendiger Abweichung erstellt er ein Architecture Decision Proposal mit:
- Problem
- betroffene Regel
- vorgeschlagene Änderung
- Risiko
- Alternative
- Empfehlung