Benjamin_Boenisch/breakpilot-core
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: replace all Coolify references with Orca across core repo

Browse Source 
CI/CD pipeline migrated from Coolify to Orca.
Updated CLAUDE.md, pre-push-checks, docs-src, and pitch-deck scripts/slides.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Sharang Parnerkar
2026-04-17 10:39:47 +02:00
parent e3b33ef596
commit 68b7660ce3
8 changed files with 46 additions and 46 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
.claude/CLAUDE.md
View File

@@ -2,17 +2,17 @@
## Entwicklungsumgebung (WICHTIG - IMMER ZUERST LESEN) ## Entwicklungsumgebung (WICHTIG - IMMER ZUERST LESEN)
### Zwei-Rechner-Setup + Coolify ### Zwei-Rechner-Setup + Orca
| Geraet | Rolle | Aufgaben | | Geraet | Rolle | Aufgaben |
|--------|-------|----------| |--------|-------|----------|
| **MacBook** | Entwicklung | Claude Terminal, Code-Entwicklung, Browser (Frontend-Tests) | | **MacBook** | Entwicklung | Claude Terminal, Code-Entwicklung, Browser (Frontend-Tests) |
| **Mac Mini** | Lokaler Server | Docker fuer lokale Dev/Tests (NICHT fuer Production!) | | **Mac Mini** | Lokaler Server | Docker fuer lokale Dev/Tests (NICHT fuer Production!) |
| **Coolify** | Production | Automatisches Build + Deploy bei Push auf gitea | | **Orca** | Production | Automatisches Build + Deploy bei Push auf gitea |
**WICHTIG:** Code wird direkt auf dem MacBook in diesem Repo bearbeitet. Production-Deployment laeuft automatisch ueber Coolify. **WICHTIG:** Code wird direkt auf dem MacBook in diesem Repo bearbeitet. Production-Deployment laeuft automatisch ueber Orca.
### Entwicklungsworkflow (CI/CD — Coolify) ### Entwicklungsworkflow (CI/CD — Orca)
```bash ```bash
# 1. Code auf MacBook bearbeiten (dieses Verzeichnis) # 1. Code auf MacBook bearbeiten (dieses Verzeichnis)
@@ -21,10 +21,10 @@ git push origin main && git push gitea main
# 3. FERTIG! Push auf gitea triggert automatisch: # 3. FERTIG! Push auf gitea triggert automatisch:
# - Gitea Actions: Tests # - Gitea Actions: Tests
# - Coolify: Build → Deploy # - Orca: Build → Deploy
``` ```
**NIEMALS** manuell in Coolify auf "Redeploy" klicken — Gitea Actions triggert Coolify automatisch. **NIEMALS** manuell in Orca auf "Redeploy" klicken — Gitea Actions triggert Orca automatisch.
**IMMER auf `main` pushen** — sowohl origin als auch gitea. **IMMER auf `main` pushen** — sowohl origin als auch gitea.
### Post-Push Deploy-Monitoring (PFLICHT nach jedem Push auf gitea) ### Post-Push Deploy-Monitoring (PFLICHT nach jedem Push auf gitea)
@@ -39,7 +39,7 @@ git push origin main && git push gitea main
``` ```
3. Sobald ALLE Endpoints healthy sind, dem User im Chat melden: 3. Sobald ALLE Endpoints healthy sind, dem User im Chat melden:
**"Deploy abgeschlossen! Du kannst jetzt testen."** **"Deploy abgeschlossen! Du kannst jetzt testen."**
4. Falls nach 5 Minuten noch nicht healthy → Fehlermeldung mit Hinweis auf Coolify-Logs. 4. Falls nach 5 Minuten noch nicht healthy → Fehlermeldung mit Hinweis auf Orca-Logs.
### Lokale Entwicklung (Mac Mini — optional, nur Dev/Tests) ### Lokale Entwicklung (Mac Mini — optional, nur Dev/Tests)
@@ -80,8 +80,8 @@ networks:
| Repo | Deployment | Trigger | | Repo | Deployment | Trigger |
|------|-----------|---------| |------|-----------|---------|
| **breakpilot-core** | Coolify (automatisch) | Push auf gitea main | | **breakpilot-core** | Orca (automatisch) | Push auf gitea main |
| **breakpilot-compliance** | Coolify (automatisch) | Push auf gitea main | | **breakpilot-compliance** | Orca (automatisch) | Push auf gitea main |
| **breakpilot-lehrer** | Mac Mini (lokal) | Manuell docker compose | | **breakpilot-lehrer** | Mac Mini (lokal) | Manuell docker compose |
--- ---
@@ -252,7 +252,7 @@ ssh macmini "/usr/local/bin/docker logs -f bp-core-control-pipeline"
### Deployment (CI/CD — Standardweg) ### Deployment (CI/CD — Standardweg)
```bash ```bash
# Committen und pushen → Coolify deployt automatisch: # Committen und pushen → Orca deployt automatisch:
git push origin main && git push gitea main git push origin main && git push gitea main
``` ```

2
.claude/rules/pre-push-checks.md
View File

@@ -58,7 +58,7 @@ Blocks on: type errors, lint violations, **build failures**.
|-------|-------|------| |-------|-------|------|
| Pre-push (local) | Claude runs | Lint + type check + unit tests + build | | Pre-push (local) | Claude runs | Lint + type check + unit tests + build |
| CI (Gitea Actions) | Automatic on push | Same + integration tests + contract tests | | CI (Gitea Actions) | Automatic on push | Same + integration tests + contract tests |
| Deploy (Coolify) | Automatic after CI | Docker build + health check | | Deploy (Orca) | Automatic after CI | Docker build + health check |
Local checks catch 90% of CI failures in seconds. CI is the safety net, not the first line of defense. Local checks catch 90% of CI failures in seconds. CI is the safety net, not the first line of defense.

14
docs-src/architecture/environments.md
View File

@@ -7,10 +7,10 @@ BreakPilot verwendet zwei Umgebungen:
``` ```
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Development │───── git push ────▶│ Production │ │ Development │───── git push ────▶│ Production │
│ (Mac Mini) │ │ (Coolify) │ │ (Mac Mini) │ │ (Orca) │
└─────────────────┘ └─────────────────┘ └─────────────────┘ └─────────────────┘
Lokale Automatisch Lokale Automatisch
Entwicklung via Coolify Entwicklung via Orca
``` ```
## Umgebungen ## Umgebungen
@@ -32,21 +32,21 @@ BreakPilot verwendet zwei Umgebungen:
ssh macmini "cd ~/Projekte/breakpilot-core && /usr/local/bin/docker compose up -d" ssh macmini "cd ~/Projekte/breakpilot-core && /usr/local/bin/docker compose up -d"
``` ```
### Production (Coolify) ### Production (Orca)
**Zweck:** Live-System **Zweck:** Live-System
| Eigenschaft | Wert | | Eigenschaft | Wert |
|-------------|------| |-------------|------|
| Git Branch | `main` | | Git Branch | `main` |
| Deployment | Coolify (automatisch bei Push auf gitea) | | Deployment | Orca (automatisch bei Push auf gitea) |
| Database | Externe PostgreSQL (TLS) | | Database | Externe PostgreSQL (TLS) |
| Debug | Deaktiviert | | Debug | Deaktiviert |
**Deploy:** **Deploy:**
```bash ```bash
git push origin main && git push gitea main git push origin main && git push gitea main
# Coolify baut und deployt automatisch # Orca baut und deployt automatisch
``` ```
## Docker Compose Architektur ## Docker Compose Architektur
@@ -54,10 +54,10 @@ git push origin main && git push gitea main
``` ```
docker-compose.yml ← Basis-Konfiguration (lokal, arm64) docker-compose.yml ← Basis-Konfiguration (lokal, arm64)
│ │
└── docker-compose.coolify.yml ← Production Override (amd64) └── docker-compose.orca.yml ← Production Override (amd64)
``` ```
Coolify verwendet automatisch beide Compose-Files fuer den Production-Build. Orca verwendet automatisch beide Compose-Files fuer den Production-Build.
## Secrets Management ## Secrets Management

40
docs-src/development/ci-cd-pipeline.md
View File

@@ -6,8 +6,8 @@ Uebersicht ueber den Deployment-Prozess fuer BreakPilot.
| Repo | Deployment | Trigger | Compose File | | Repo | Deployment | Trigger | Compose File |
|------|-----------|---------|--------------| |------|-----------|---------|--------------|
| **breakpilot-core** | Coolify (automatisch) | Push auf `coolify` Branch | `docker-compose.coolify.yml` | | **breakpilot-core** | Orca (automatisch) | Push auf `orca` Branch | `docker-compose.orca.yml` |
| **breakpilot-compliance** | Coolify (automatisch) | Push auf `main` Branch | `docker-compose.yml` + `docker-compose.coolify.yml` | | **breakpilot-compliance** | Orca (automatisch) | Push auf `main` Branch | `docker-compose.yml` + `docker-compose.orca.yml` |
| **breakpilot-lehrer** | Mac Mini (lokal) | Manuell `docker compose` | `docker-compose.yml` | | **breakpilot-lehrer** | Mac Mini (lokal) | Manuell `docker compose` | `docker-compose.yml` |
## Deployment-Architektur ## Deployment-Architektur
@@ -16,7 +16,7 @@ Uebersicht ueber den Deployment-Prozess fuer BreakPilot.
┌─────────────────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────────────────┐
│ Entwickler-MacBook │ │ Entwickler-MacBook │
│ │ │ │
│ breakpilot-core/ → git push gitea coolify │ │ breakpilot-core/ → git push gitea orca │
│ breakpilot-compliance/ → git push gitea main │ │ breakpilot-compliance/ → git push gitea main │
│ breakpilot-lehrer/ → git push + ssh macmini docker ... │ │ breakpilot-lehrer/ → git push + ssh macmini docker ... │
│ │ │ │
@@ -26,11 +26,11 @@ Uebersicht ueber den Deployment-Prozess fuer BreakPilot.
│ │ │ │
▼ ▼ ▼ ▼
┌───────────────────────────┐ ┌───────────────────────────┐ ┌───────────────────────────┐ ┌───────────────────────────┐
│ Coolify (Production) │ │ Mac Mini (Lokal/Dev) │ │ Orca (Production) │ │ Mac Mini (Lokal/Dev) │
│ │ │ │ │ │ │ │
│ Gitea Actions │ │ breakpilot-lehrer │ │ Gitea Actions │ │ breakpilot-lehrer │
│ ├── Tests │ │ ├── studio-v2 │ │ ├── Tests │ │ ├── studio-v2 │
│ └── Coolify API Deploy │ │ ├── klausur-service │ │ └── Orca API Deploy │ │ ├── klausur-service │
│ │ │ ├── backend-lehrer │ │ │ │ ├── backend-lehrer │
│ Core Services: │ │ └── voice-service │ │ Core Services: │ │ └── voice-service │
│ ├── consent-service │ │ │ │ ├── consent-service │ │ │
@@ -47,23 +47,23 @@ Uebersicht ueber den Deployment-Prozess fuer BreakPilot.
└───────────────────────────┘ └───────────────────────────┘ └───────────────────────────┘ └───────────────────────────┘
``` ```
## breakpilot-core → Coolify ## breakpilot-core → Orca
### Pipeline ### Pipeline
```yaml ```yaml
# .gitea/workflows/deploy-coolify.yml # .gitea/workflows/deploy-orca.yml
on: on:
push: push:
branches: [coolify] branches: [orca]
jobs: jobs:
deploy: deploy:
runs-on: ubuntu-latest runs-on: ubuntu-latest
steps: steps:
- name: Deploy via Coolify API - name: Deploy via Orca API
# Triggert Coolify Build + Deploy ueber API # Triggert Orca Build + Deploy ueber API
# Secrets: COOLIFY_API_TOKEN, COOLIFY_RESOURCE_UUID, COOLIFY_BASE_URL # Secrets: ORCA_API_TOKEN, ORCA_RESOURCE_UUID, ORCA_BASE_URL
``` ```
### Workflow ### Workflow
@@ -74,13 +74,13 @@ jobs:
git push origin main && git push gitea main git push origin main && git push gitea main
# 3. Fuer Production-Deploy: # 3. Fuer Production-Deploy:
git push gitea coolify git push gitea orca
# 4. Status pruefen: # 4. Status pruefen:
# https://gitea.meghsakha.com/Benjamin_Boenisch/breakpilot-core/actions # https://gitea.meghsakha.com/Benjamin_Boenisch/breakpilot-core/actions
``` ```
### Coolify-deployed Services ### Orca-deployed Services
| Service | Container | Beschreibung | | Service | Container | Beschreibung |
|---------|-----------|--------------| |---------|-----------|--------------|
@@ -91,7 +91,7 @@ git push gitea coolify
| paddleocr-service | bp-core-paddleocr | OCR Engine (x86_64) | | paddleocr-service | bp-core-paddleocr | OCR Engine (x86_64) |
| health-aggregator | bp-core-health | Health-Check Aggregator | | health-aggregator | bp-core-health | Health-Check Aggregator |
## breakpilot-compliance → Coolify ## breakpilot-compliance → Orca
### Pipeline ### Pipeline
@@ -111,7 +111,7 @@ jobs:
### Workflow ### Workflow
```bash ```bash
# Committen und pushen → Coolify deployt automatisch: # Committen und pushen → Orca deployt automatisch:
git push origin main && git push gitea main git push origin main && git push gitea main
# CI-Status pruefen: # CI-Status pruefen:
@@ -154,8 +154,8 @@ Workflows liegen in jedem Repo unter `.gitea/workflows/`:
| Repo | Workflow | Branch | Aktion | | Repo | Workflow | Branch | Aktion |
|------|----------|--------|--------| |------|----------|--------|--------|
| breakpilot-core | `deploy-coolify.yml` | `coolify` | Coolify API Deploy | | breakpilot-core | `deploy-orca.yml` | `orca` | Orca API Deploy |
| breakpilot-compliance | `ci.yaml` | `main` | Tests + Coolify Deploy | | breakpilot-compliance | `ci.yaml` | `main` | Tests + Orca Deploy |
### Runner-Token erneuern ### Runner-Token erneuern
@@ -181,7 +181,7 @@ ssh macmini "/usr/local/bin/docker logs -f bp-core-gitea-runner"
## Health Checks ## Health Checks
### Production (Coolify) ### Production (Orca)
```bash ```bash
# Core PaddleOCR # Core PaddleOCR
@@ -229,14 +229,14 @@ ssh macmini "docker compose build --no-cache <service>"
## Rollback ## Rollback
### Coolify ### Orca
Ein Redeploy mit einem aelteren Commit kann durch Zuruecksetzen des Branches ausgeloest werden: Ein Redeploy mit einem aelteren Commit kann durch Zuruecksetzen des Branches ausgeloest werden:
```bash ```bash
# Branch auf vorherigen Commit zuruecksetzen und pushen # Branch auf vorherigen Commit zuruecksetzen und pushen
git reset --hard <previous-commit> git reset --hard <previous-commit>
git push gitea coolify --force git push gitea orca --force
``` ```
### Lokal (Mac Mini) ### Lokal (Mac Mini)

4
docs-src/index.md
View File

@@ -16,8 +16,8 @@ BreakPilot besteht aus drei unabhaengigen Projekten:
| Repo | Deployment | Trigger | | Repo | Deployment | Trigger |
|------|-----------|---------| |------|-----------|---------|
| **breakpilot-core** | Coolify (automatisch) | Push auf gitea main | | **breakpilot-core** | Orca (automatisch) | Push auf gitea main |
| **breakpilot-compliance** | Coolify (automatisch) | Push auf gitea main | | **breakpilot-compliance** | Orca (automatisch) | Push auf gitea main |
| **breakpilot-lehrer** | Mac Mini (lokal) | Manuell docker compose | | **breakpilot-lehrer** | Mac Mini (lokal) | Manuell docker compose |
## Core Services ## Core Services

4
pitch-deck/components/slides/AIPipelineSlide.tsx
View File

@@ -178,8 +178,8 @@ export default function AIPipelineSlide({ lang }: AIPipelineSlideProps) {
color: 'text-purple-400', color: 'text-purple-400',
title: de ? 'CI/CD & Testing' : 'CI/CD & Testing', title: de ? 'CI/CD & Testing' : 'CI/CD & Testing',
items: de items: de
? ['Gitea Actions: Lint → Tests → Validierung bei jedem Push', 'Go-Tests (AI SDK) + Python-Tests (Backend + Pipeline)', 'Coolify Auto-Deploy mit Health-Check-Monitoring', 'arm64 → amd64 Cross-Build für Hetzner Production'] ? ['Gitea Actions: Lint → Tests → Validierung bei jedem Push', 'Go-Tests (AI SDK) + Python-Tests (Backend + Pipeline)', 'Orca Auto-Deploy mit Health-Check-Monitoring', 'arm64 → amd64 Cross-Build für Hetzner Production']
: ['Gitea Actions: Lint → Tests → Validation on every push', 'Go tests (AI SDK) + Python tests (Backend + Pipeline)', 'Coolify auto-deploy with health check monitoring', 'arm64 → amd64 cross-build for Hetzner production'], : ['Gitea Actions: Lint → Tests → Validation on every push', 'Go tests (AI SDK) + Python tests (Backend + Pipeline)', 'Orca auto-deploy with health check monitoring', 'arm64 → amd64 cross-build for Hetzner production'],
}, },
{ {
icon: Zap, icon: Zap,

4
pitch-deck/lib/presenter/presenter-faq.ts
View File

@@ -692,8 +692,8 @@ export const PRESENTER_FAQ: FAQEntry[] = [
keywords: ['syseleven', 'hetzner', 'cloud', 'hosting', 'infrastruktur', 'infrastructure', 'server', 'rechenzentrum', 'data center', 'wo laufen', 'where hosted'], keywords: ['syseleven', 'hetzner', 'cloud', 'hosting', 'infrastruktur', 'infrastructure', 'server', 'rechenzentrum', 'data center', 'wo laufen', 'where hosted'],
question_de: 'Auf welcher Infrastruktur laeuft die Plattform?', question_de: 'Auf welcher Infrastruktur laeuft die Plattform?',
question_en: 'What infrastructure does the platform run on?', question_en: 'What infrastructure does the platform run on?',
answer_de: 'Unsere Plattform laeuft zu 100 Prozent auf europaeischer Cloud-Infrastruktur — ohne einen einzigen US-Anbieter. Fuer LLM-Inferenz und KI-Workloads nutzen wir SysEleven, einen BSI-C5-zertifizierten deutschen Cloud-Provider mit GPU-Kapazitaet. Fuer Datenbanken, Vektorspeicher und Anwendungslogik setzen wir auf Hetzner — ebenfalls deutsch, ISO 27001-zertifiziert und deutlich kostenguenstiger als AWS oder Azure. Das CI/CD laeuft ueber Gitea Actions mit automatischem Deploy via Coolify auf Hetzner. Diese Kombination gibt uns einen strukturellen Kostenvorteil bei voller EU-Datensouveraenitaet.', answer_de: 'Unsere Plattform laeuft zu 100 Prozent auf europaeischer Cloud-Infrastruktur — ohne einen einzigen US-Anbieter. Fuer LLM-Inferenz und KI-Workloads nutzen wir SysEleven, einen BSI-C5-zertifizierten deutschen Cloud-Provider mit GPU-Kapazitaet. Fuer Datenbanken, Vektorspeicher und Anwendungslogik setzen wir auf Hetzner — ebenfalls deutsch, ISO 27001-zertifiziert und deutlich kostenguenstiger als AWS oder Azure. Das CI/CD laeuft ueber Gitea Actions mit automatischem Deploy via Orca auf Hetzner. Diese Kombination gibt uns einen strukturellen Kostenvorteil bei voller EU-Datensouveraenitaet.',
answer_en: 'Our platform runs 100 percent on European cloud infrastructure — without a single US provider. For LLM inference and AI workloads we use SysEleven, a BSI C5-certified German cloud provider with GPU capacity. For databases, vector storage and application logic we rely on Hetzner — also German, ISO 27001-certified and significantly more cost-effective than AWS or Azure. CI/CD runs via Gitea Actions with automatic deploy via Coolify on Hetzner. This combination gives us a structural cost advantage with full EU data sovereignty.', answer_en: 'Our platform runs 100 percent on European cloud infrastructure — without a single US provider. For LLM inference and AI workloads we use SysEleven, a BSI C5-certified German cloud provider with GPU capacity. For databases, vector storage and application logic we rely on Hetzner — also German, ISO 27001-certified and significantly more cost-effective than AWS or Azure. CI/CD runs via Gitea Actions with automatic deploy via Orca on Hetzner. This combination gives us a structural cost advantage with full EU data sovereignty.',
goto_slide: 'annex-architecture', goto_slide: 'annex-architecture',
priority: 8, priority: 8,
}, },

4
pitch-deck/lib/presenter/presenter-script.ts
View File

@@ -534,8 +534,8 @@ export const PRESENTER_SCRIPT: SlideScript[] = [
duration: 40, duration: 40,
paragraphs: [ paragraphs: [
{ {
text_de: 'Engineering Deep Dive: Über 500.000 Zeilen Code, 45 Container, 65 Compliance-Module. Tech-Stack: Go, Python, TypeScript mit Next.js. CI/CD über Gitea Actions mit automatischem Deploy via Coolify auf Hetzner.', text_de: 'Engineering Deep Dive: Über 500.000 Zeilen Code, 45 Container, 65 Compliance-Module. Tech-Stack: Go, Python, TypeScript mit Next.js. CI/CD über Gitea Actions mit automatischem Deploy via Orca auf Hetzner.',
text_en: 'Engineering deep dive: Over 500,000 lines of code, 45 containers, 65 compliance modules. Tech stack: Go, Python, TypeScript with Next.js. CI/CD via Gitea Actions with automatic deploy via Coolify on Hetzner.', text_en: 'Engineering deep dive: Over 500,000 lines of code, 45 containers, 65 compliance modules. Tech stack: Go, Python, TypeScript with Next.js. CI/CD via Gitea Actions with automatic deploy via Orca on Hetzner.',
pause_after: 2000, pause_after: 2000,
}, },
{ {