106 lines
3.1 KiB
Markdown
106 lines
3.1 KiB
Markdown
|
# 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
|