Kairo-Jinkendo/CLAUDE.md
Lars 848452f837
Some checks failed
Test Suite / lint-backend (push) Waiting to run
Test Suite / build-frontend (push) Waiting to run
Test Suite / k6 /health Baseline (push) Waiting to run
Test Suite / playwright-tests (push) Waiting to run
Deploy Development / deploy (push) Failing after 1s
Test Suite / pytest-backend (push) Has been cancelled
Infrastruktur-Grundgeruest fuer Kairo Jinkendo: Docker, Gitea Actions, Deployment-Doku (ohne App-Code).
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-04 18:15:24 +02:00

1.8 KiB
Raw Blame History

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)