# Kairo Jinkendo (回廊)

**Produktfamilie Jinkendo (人拳道) — Schwesterprodukt zu Shinkan und Mitai**

> Infrastruktur-Setup: Deployment, Docker und Gitea Actions sind vorbereitet.  
> Anwendungscode (Backend/Frontend) folgt in einem separaten Schritt.

## Deployment-Übersicht

| Umgebung | Branch | Server-Pfad | Host-Ports (UI/API) | Domain |
|----------|--------|-------------|---------------------|--------|
| **Development** | `develop` | `/home/lars/docker/kairo-dev` | 3097 / 8097 | https://dev.kairo.jinkendo.de |
| **Production** | `main` | `/home/lars/docker/kairo` | 3004 / 8004 | https://kairo.jinkendo.de |

Auto-Deploy via Gitea Actions auf dem Raspberry Pi (gleicher Runner wie Shinkan/Mitai).

**Gitea:** http://192.168.2.144:3000/Lars/Kairo-Jinkendo

## Tech-Stack (geplant)

- **Frontend:** React 18 + Vite + PWA
- **Backend:** FastAPI (Python 3.12)
- **Datenbank:** PostgreSQL 16
- **Container:** Docker + Docker Compose

## Lokales Setup (wenn App-Code vorhanden)

```bash
git clone http://192.168.2.144:3000/Lars/Kairo-Jinkendo.git
cd Kairo-Jinkendo
cp .env.example .env
# .env anpassen

# Development
docker compose -f docker-compose.dev-env.yml up --build

# Production (lokal)
docker compose up --build
```

Frontend (Dev): http://localhost:3097  
Backend (Dev): http://localhost:8097

## Server-Einrichtung

Siehe [docs/DEPLOYMENT.md](docs/DEPLOYMENT.md) für Verzeichnisse, `.env`-Dateien und Reverse-Proxy-Hinweise auf dem Pi.

## Git-Workflow

```
develop  →  Auto-Deploy  →  kairo-dev  (Dev)
main     →  Auto-Deploy  →  kairo      (Prod)
```

## Dokumentation

- **Deployment:** [docs/DEPLOYMENT.md](docs/DEPLOYMENT.md)
- **Entwickler-Kontext:** [CLAUDE.md](CLAUDE.md)
- **Schwesterprojekt (Referenz):** [shinkan-jinkendo](http://192.168.2.144:3000/Lars/shinkan-jinkendo)

## Lizenz

Proprietary – Lars Stommer