docs: replace all Coolify references with Orca across compliance repo
All checks were successful
Build + Deploy / build-ai-sdk (push) Successful in 31s
Build + Deploy / build-developer-portal (push) Successful in 7s
CI/CD / python-lint (push) Has been skipped
CI/CD / nodejs-lint (push) Has been skipped
CI/CD / test-python-backend-compliance (push) Successful in 35s
CI/CD / test-python-dsms-gateway (push) Successful in 19s
Build + Deploy / build-admin-compliance (push) Successful in 8s
Build + Deploy / build-backend-compliance (push) Successful in 8s
Build + Deploy / build-tts (push) Successful in 7s
Build + Deploy / build-document-crawler (push) Successful in 7s
Build + Deploy / build-dsms-gateway (push) Successful in 7s
CI/CD / go-lint (push) Has been skipped
CI/CD / test-go-ai-compliance (push) Successful in 34s
CI/CD / test-python-document-crawler (push) Successful in 23s
CI/CD / validate-canonical-controls (push) Successful in 12s
Build + Deploy / trigger-orca (push) Successful in 2m11s

CI/CD pipeline now uses Orca (build-push-deploy.yml) not Coolify.
Updated CLAUDE.md, workflow comments, docs-src, and hetzner compose.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Sharang Parnerkar
2026-04-17 10:39:45 +02:00
parent 20fbfc197e
commit 11f13b3f74
8 changed files with 39 additions and 39 deletions

View File

@@ -2,17 +2,17 @@
## Entwicklungsumgebung (WICHTIG - IMMER ZUERST LESEN)
### Zwei-Rechner-Setup + Coolify
### Zwei-Rechner-Setup + Orca
| Geraet | Rolle | Aufgaben |
|--------|-------|----------|
| **MacBook** | Entwicklung | Claude Terminal, Code-Entwicklung, Browser (Frontend-Tests) |
| **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 auf dem MacBook bearbeitet. Production-Deployment laeuft automatisch ueber Coolify.
**WICHTIG:** Code wird auf dem MacBook bearbeitet. Production-Deployment laeuft automatisch ueber Orca.
### Entwicklungsworkflow (CI/CD — Coolify)
### Entwicklungsworkflow (CI/CD — Orca)
```bash
# 1. Code auf MacBook bearbeiten (dieses Verzeichnis)
@@ -21,13 +21,13 @@ git push origin main && git push gitea main
# 3. FERTIG! Push auf gitea triggert automatisch:
# - Gitea Actions: Lint → Tests → Validierung
# - Coolify: Build → Deploy
# - Orca: Build → Deploy
# Dauer: ca. 3 Minuten
# Status pruefen: https://gitea.meghsakha.com/Benjamin_Boenisch/breakpilot-compliance/actions
```
**NICHT MEHR NOETIG:** Manuelles `ssh macmini "docker compose build"` fuer Production.
**NIEMALS** manuell in Coolify auf "Redeploy" klicken — Gitea Actions triggert Coolify automatisch.
**NIEMALS** manuell in Orca auf "Redeploy" klicken — Gitea Actions triggert Orca automatisch.
### Post-Push Deploy-Monitoring (PFLICHT nach jedem Push auf gitea)
@@ -42,7 +42,7 @@ git push origin main && git push gitea main
```
3. Sobald ALLE Endpoints healthy sind, dem User im Chat melden:
**"Deploy abgeschlossen! Du kannst jetzt testen: https://admin-dev.breakpilot.ai"**
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.
**Ablauf im Terminal:**
```
@@ -52,7 +52,7 @@ git push origin main && git push gitea main
> "Deploy abgeschlossen! Alle Services healthy. Du kannst jetzt testen."
```
### CI/CD Pipeline (Gitea Actions → Coolify)
### CI/CD Pipeline (Gitea Actions → Orca)
```
Push auf gitea main → go-lint/python-lint/nodejs-lint (nur PRs)
@@ -61,13 +61,13 @@ Push auf gitea main → go-lint/python-lint/nodejs-lint (nur PRs)
→ test-python-document-crawler
→ test-python-dsms-gateway
→ validate-canonical-controls
Coolify: Build + Deploy (automatisch bei Push)
Orca: Build + Deploy (automatisch bei Push)
```
**Dateien:**
- `.gitea/workflows/ci.yaml` — Pipeline-Definition (Tests + Validierung)
- `docker-compose.yml` — Haupt-Compose
- `docker-compose.hetzner.yml` — Override: arm64→amd64 fuer Coolify Production (x86_64)
- `docker-compose.hetzner.yml` — Override: arm64→amd64 fuer Orca Production (x86_64)
### Lokale Entwicklung (Mac Mini — optional)
@@ -106,7 +106,7 @@ Config via `.env` (nicht im Repo): `COMPLIANCE_DATABASE_URL`, `QDRANT_URL`, `QDR
## Haupt-URLs
### Production (Coolify-deployed)
### Production (Orca-deployed)
| URL | Service | Beschreibung |
|-----|---------|--------------|
@@ -207,7 +207,7 @@ breakpilot-compliance/
├── dsms-gateway/ # IPFS Gateway
├── scripts/ # Helper Scripts
├── docker-compose.yml # Compliance Compose (~10 Services, platform: arm64)
├── docker-compose.hetzner.yml # Override: arm64→amd64 fuer Coolify Production
├── docker-compose.hetzner.yml # Override: arm64→amd64 fuer Orca Production
└── .gitea/workflows/ci.yaml # CI/CD Pipeline (Lint → Tests → Validierung)
```
@@ -218,7 +218,7 @@ breakpilot-compliance/
### Deployment (CI/CD — Standardweg)
```bash
# Committen und pushen → Coolify deployt automatisch:
# Committen und pushen → Orca deployt automatisch:
git push origin main && git push gitea main
# CI-Status pruefen (im Browser):

View File

@@ -7,7 +7,7 @@
# Node.js: admin-compliance, developer-portal
#
# Workflow:
# Push auf main → Tests → Deploy (Coolify)
# Push auf main → Tests → Deploy (Orca)
# Pull Request → Lint + Tests (kein Deploy)
name: CI/CD

View File

@@ -5,8 +5,8 @@
#
# Phasen: gesetze, eu, templates, datenschutz, verbraucherschutz, verify, version, all
#
# Voraussetzung: RAG-Service und Qdrant muessen auf Coolify laufen.
# Die BreakPilot-Services muessen deployed sein (ci.yaml deploy-coolify).
# Voraussetzung: RAG-Service und Qdrant muessen auf Orca laufen.
# Die BreakPilot-Services muessen deployed sein (ci.yaml deploy-orca).
name: RAG Ingestion

View File

@@ -39,7 +39,7 @@ go build -o server ./cmd/server
# Production: CI/CD (automatisch bei Push auf main)
git push origin main && git push gitea main
# → Gitea Actions: Tests → Build → Deploy auf Coolify
# → Gitea Actions: Tests → Build → Deploy auf Orca
# → Status: https://gitea.meghsakha.com/Benjamin_Boenisch/breakpilot-compliance/actions
# Alternativ: mit Docker (lokal)
@@ -466,7 +466,7 @@ Tests laufen automatisch bei jedem Push via Gitea Actions (`.gitea/workflows/ci.
| `test-python-document-crawler` | `python:3.12-slim` | `pytest tests/` |
| `test-python-dsms-gateway` | `python:3.12-slim` | `pytest test_main.py` |
Nach erfolgreichen Tests: automatisches Deploy auf Coolify (`deploy-coolify` Job).
Nach erfolgreichen Tests: automatisches Deploy auf Orca (`deploy-orca` Job).
### Spezifische Tests

View File

@@ -1,16 +1,16 @@
# =========================================================
# BreakPilot Compliance — Coolify Production Override
# BreakPilot Compliance — Orca Production Override
# =========================================================
# Verwendung: docker compose -f docker-compose.yml -f docker-compose.hetzner.yml up -d
#
# Aenderungen gegenueber docker-compose.yml:
# - Platform: arm64 → amd64 (Coolify = x86_64)
# - Network: external → auto-create (kein breakpilot-core auf Coolify)
# - depends_on: core-health-check entfernt (kein Core auf Coolify)
# - API URLs: auf Coolify-interne Adressen angepasst
# - Platform: arm64 → amd64 (Orca = x86_64)
# - Network: external → auto-create (kein breakpilot-core auf Orca)
# - depends_on: core-health-check entfernt (kein Core auf Orca)
# - API URLs: auf Orca-interne Adressen angepasst
# =========================================================
# Auf Coolify laeuft kein breakpilot-core, daher Network selbst erstellen
# Auf Orca laeuft kein breakpilot-core, daher Network selbst erstellen
networks:
breakpilot-network:
external: false
@@ -18,9 +18,9 @@ networks:
services:
# Core-Health-Check deaktivieren (Core laeuft nicht auf Coolify)
# Core-Health-Check deaktivieren (Core laeuft nicht auf Orca)
core-health-check:
entrypoint: ["sh", "-c", "echo 'Core health check skipped on Coolify' && exit 0"]
entrypoint: ["sh", "-c", "echo 'Core health check skipped on Orca' && exit 0"]
restart: "no"
admin-compliance:

View File

@@ -6,9 +6,9 @@ Uebersicht ueber den Deployment-Prozess fuer BreakPilot Compliance.
| Komponente | Build-Tool | Deployment |
|------------|------------|------------|
| Frontend (Next.js) | Docker | Coolify (automatisch) |
| Backend (FastAPI) | Docker | Coolify (automatisch) |
| Go Services | Docker (Multi-stage) | Coolify (automatisch) |
| Frontend (Next.js) | Docker | Orca (automatisch) |
| Backend (FastAPI) | Docker | Orca (automatisch) |
| Go Services | Docker (Multi-stage) | Orca (automatisch) |
| Documentation | MkDocs | Docker (Nginx, lokal) |
## Deployment-Architektur
@@ -40,14 +40,14 @@ Uebersicht ueber den Deployment-Prozess fuer BreakPilot Compliance.
│ ├── test-python-dsms-gateway │
│ └── validate-canonical-controls │
│ │
Coolify Webhook → Build + Deploy (automatisch) │
Orca Webhook → Build + Deploy (automatisch) │
└─────────────────────────────────────────────────────────────────┘
│ auto-deploy
┌─────────────────────────────────────────────────────────────────┐
│ Production (Coolify) │
│ Production (Orca) │
│ │
│ ├── admin-dev.breakpilot.ai (Admin Compliance) │
│ ├── api-dev.breakpilot.ai (Backend API) │
@@ -75,11 +75,11 @@ Push auf gitea triggert automatisch die CI-Pipeline:
- **Validierung:** Canonical Controls JSON-Validierung
- **Lint:** Go, Python, Node.js (nur bei PRs)
### 3. Automatisches Deployment (Coolify)
### 3. Automatisches Deployment (Orca)
Nach erfolgreichem Push baut Coolify automatisch alle Services und deployt sie.
Nach erfolgreichem Push baut Orca automatisch alle Services und deployt sie.
**WICHTIG:** Niemals manuell in Coolify auf "Redeploy" klicken!
**WICHTIG:** Niemals manuell in Orca auf "Redeploy" klicken!
### 4. Health Checks
@@ -113,7 +113,7 @@ jobs:
## Lokale Entwicklung (Mac Mini)
Fuer lokale Tests ohne Coolify:
Fuer lokale Tests ohne Orca:
```bash
# Auf Mac Mini pullen und bauen

View File

@@ -207,7 +207,7 @@ Runtime-Betrieb: Qdrant-RAG für semantische Suche, Chat, Scope-Analyse
2. Mac Mini: Control-Generierung → PostgreSQL (shared, 46.225.100.82:54321)
3. QA: PDF-Match, Dedup, Source-Normalisierung
4. Qdrant Migration: macmini:6333 → qdrant-dev.breakpilot.ai (scripts/migrate-qdrant.py)
5. Deploy: git push gitea → Coolify Build + Deploy
5. Deploy: git push gitea → Orca Build + Deploy
```
**WICHTIG:** PostgreSQL ist SHARED — Änderungen auf Mac Mini sind sofort in Production sichtbar. Qdrant hat getrennte Instanzen (lokal + production) und muss manuell synchronisiert werden.

View File

@@ -68,7 +68,7 @@ Module die Compliance-Kunden im SDK sehen und nutzen:
## URLs
### Production (Coolify-deployed)
### Production (Orca-deployed)
| URL | Service | Beschreibung |
|-----|---------|--------------|
@@ -91,9 +91,9 @@ Module die Compliance-Kunden im SDK sehen und nutzen:
## Deployment
```bash
# Production (Coolify — Standardweg):
# Production (Orca — Standardweg):
git push origin main && git push gitea main
# Coolify baut und deployt automatisch.
# Orca baut und deployt automatisch.
# Lokal (Mac Mini — nur Dev/Tests):
docker compose -f breakpilot-compliance/docker-compose.yml up -d