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)
|
|||
|
|
```
|