# Kairo Jinkendo – Entwickler-Kontext

## Projekt-Übersicht

**Kairo Jinkendo** (回廊 Jinkendo) — Schwesterprodukt in der **Jinkendo**-App-Familie (人拳道).  
Domains: kairo.jinkendo.de · dev.kairo.jinkendo.de

**Status:** Infrastruktur (Docker, Gitea Actions, Deployment-Doku) ist eingerichtet. Anwendungscode folgt.

## Tech-Stack (geplant)

| Komponente | Technologie |
|-----------|-------------|
| Frontend  | React 18 + Vite + PWA (Node 20) |
| Backend   | FastAPI Python 3.12 |
| Datenbank | PostgreSQL 16 Alpine |
| Container | Docker + Docker Compose |
| Auth      | Token-basiert + bcrypt (Familien-Standard) |

**Ports:** Prod 3004/8004 · Dev 3097/8097 — nicht ändern ohne explizite Freigabe (Reverse Proxy/Fritz!Box).

## Deployment

```
Internet → Fritz!Box (privat.stommer.com) → Synology NAS → Raspberry Pi 5 (192.168.2.49)

Git Workflow:
  develop → Auto-Deploy → dev.kairo.jinkendo.de  (kairo-dev/, Port 3097/8097)
  main    → Auto-Deploy → kairo.jinkendo.de        (kairo/,     Port 3004/8004)

Gitea: http://192.168.2.144:3000/Lars/Kairo-Jinkendo
Runner: Raspberry Pi (/home/lars/gitea-runner/) — gemeinsam mit Shinkan/Mitai

Manuell:
  cd /home/lars/docker/kairo[-dev]
  docker compose -f docker-compose[.dev-env].yml build --no-cache && up -d
```

## Verzeichnisstruktur (Zielbild)

```
backend/           # FastAPI — noch anzulegen
frontend/          # React + Vite — noch anzulegen
.gitea/workflows/  # CI/CD (deploy + test)
docs/              # Deployment-Doku
scripts/load/      # k6 Health-Baseline
```

## Referenz

Deployment-Muster und Familien-Standards: Schwesterprojekt **shinkan-jinkendo** (`c:\Dev\shinkan-jinkendo`).

## Jinkendo-Familie

```
mitai.jinkendo.de    → Körper-Tracker (身体)
shinkan.jinkendo.de  → Trainingsplanung (真観)
kairo.jinkendo.de    → (回廊 — Produktdefinition folgt)
```