Lars
2b96518a52
Some checks failed
Test Suite / playwright-smoke (push) Waiting to run
Deploy Development / deploy (push) Successful in 34s
Test Suite / pytest-backend (push) Successful in 4s
Test Suite / lint-backend (push) Successful in 2s
Test Suite / build-frontend (push) Successful in 44s
Test Suite / compose-smoke (push) Has been skipped
Test Suite / k6 /api/health Baseline (push) Has been cancelled
Co-authored-by: Cursor <cursoragent@cursor.com>
112 lines
3.1 KiB
Markdown
112 lines
3.1 KiB
Markdown
# Jinkendo Kairo
|
||
|
||
Operativer Program Director der Jinkendo-Produktfamilie.
|
||
|
||
Kairo steuert Vorhaben, Programme, Projekte, Meilensteine, Maßnahmen, Backlogs, Reviews, Nachweise und die Zusammenarbeit von Menschen, Arbeitsgruppen und KI-Agenten.
|
||
|
||
## Leitfrage
|
||
|
||
> Welcher nächste Schritt bringt ein Vorhaben aktuell am wirkungsvollsten voran?
|
||
|
||
## Startzustand
|
||
|
||
Dieses Repository startet mit einem reinen Spezifikations- und Sprint-0-Handover-Paket.
|
||
|
||
Noch nicht enthalten:
|
||
|
||
- produktiver Anwendungscode
|
||
- endgültiger Technologie-Stack
|
||
- vollständige Jinkendo-Foundation
|
||
- Mitai- oder Shinkan-Code
|
||
- Billing / SSO / zentrale Produktfamilien-Konvergenz
|
||
|
||
## Verbindliche Dokumente für Sprint 0
|
||
|
||
1. `docs/product/Jinkendo_Kairo_Product_Spec_v0.2.md`
|
||
2. `docs/architecture/Jinkendo_Foundation_Minimum_Viable_Foundation_v0.2.md`
|
||
3. `docs/architecture/Kairo_Sprint0_Principle_Gate_v0.1.md`
|
||
4. `docs/sprints/Jinkendo_Kairo_04_Sprint0_Foundation_v0.3.md`
|
||
5. `docs/sprints/Sprint0_Vibe_Coder_Handover_v0.1.md`
|
||
6. `docs/sprints/Sprint0_AP0_1_Project_Setup_Assignment_v0.1.md`
|
||
7. `CLAUDE.md`
|
||
8. `.cursor/rules/kairo-architecture.mdc`
|
||
|
||
## Arbeitsmodus
|
||
|
||
Kairo wird iterativ entwickelt.
|
||
|
||
Sprint 0 baut nur das Fundament:
|
||
|
||
- Tenant
|
||
- User
|
||
- Actor
|
||
- TenantContext
|
||
- Auth-Gates
|
||
- Capability/Rights Registry
|
||
- minimale Feature Registry
|
||
- minimale Prompt Registry
|
||
- Platzhaltermodell
|
||
- Audit
|
||
- Migration/Deploy-Grundlage
|
||
|
||
Vorhaben, Projekte, Meilensteine und Maßnahmen kommen erst nach Sprint 0.
|
||
|
||
|
||
## Designprinzipien-Referenzen
|
||
|
||
Die extrahierten Designprinzipien aus Mitai und Shinkan liegen im Repository unter:
|
||
|
||
```text
|
||
docs/reference/design-principles/
|
||
```
|
||
|
||
Diese Dokumente sind Referenzen, kein direkter Sprint-Scope.
|
||
|
||
Verbindlich ist nur, was über das Kairo Sprint-0 Principle Gate oder eine Architecture Decision übernommen wurde.
|
||
|
||
## Deployment & CI
|
||
|
||
Zwei getrennte Gitea-Workflows (wie Shinkan):
|
||
|
||
| Workflow | Branch |
|
||
|----------|--------|
|
||
| **Deploy Development** | `develop` |
|
||
| **Deploy Production** | `main` |
|
||
| **Test Suite** | nach Deploy + bei Push/PR `develop` |
|
||
|
||
Details: [docs/DEPLOYMENT.md](docs/DEPLOYMENT.md)
|
||
|
||
## Local Development
|
||
|
||
Voraussetzungen: Docker + Docker Compose.
|
||
|
||
```bash
|
||
git clone http://192.168.2.144:3000/Lars/Kairo-Jinkendo.git
|
||
cd Kairo-Jinkendo
|
||
git checkout develop
|
||
|
||
# Dev-Stack (PostgreSQL + Backend + Frontend)
|
||
docker compose -f docker-compose.dev-env.yml up --build
|
||
|
||
# Health prüfen
|
||
curl http://localhost:8097/api/health
|
||
curl http://localhost:3097/api/health
|
||
|
||
# Tests im Backend-Container
|
||
docker compose -f docker-compose.dev-env.yml exec backend pip install -r requirements-dev.txt
|
||
docker compose -f docker-compose.dev-env.yml exec backend python -m pytest tests -ra -vv
|
||
```
|
||
|
||
UI: http://localhost:3097 · API: http://localhost:8097
|
||
|
||
## AP0.1 – Stand Projektgrundlage
|
||
|
||
| Bereich | Status |
|
||
|---------|--------|
|
||
| Git + Gitea (`develop` / `main`) | erledigt |
|
||
| Docker Compose (Prod + Dev) | erledigt |
|
||
| Backend (FastAPI, Migrationen, `/api/health`) | erledigt |
|
||
| Frontend minimal (React + nginx Proxy) | erledigt |
|
||
| pytest (Health + Migrationen) | erledigt |
|
||
| Gitea Actions (Deploy + Test) | erledigt |
|