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
Co-authored-by: Cursor <cursoragent@cursor.com>
60 lines
1.8 KiB
Markdown
60 lines
1.8 KiB
Markdown
# 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)
|
||
```
|