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
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:
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
|
||||
Reference in new issue
Block a user