diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md index bea2162..3924e74 100644 --- a/.claude/CLAUDE.md +++ b/.claude/CLAUDE.md @@ -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): diff --git a/.gitea/workflows/ci.yaml b/.gitea/workflows/ci.yaml index 5e780ff..d1532fb 100644 --- a/.gitea/workflows/ci.yaml +++ b/.gitea/workflows/ci.yaml @@ -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 diff --git a/.gitea/workflows/rag-ingest.yaml b/.gitea/workflows/rag-ingest.yaml index 0bfde96..e148653 100644 --- a/.gitea/workflows/rag-ingest.yaml +++ b/.gitea/workflows/rag-ingest.yaml @@ -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 diff --git a/ai-compliance-sdk/docs/DEVELOPER.md b/ai-compliance-sdk/docs/DEVELOPER.md index db4ee59..7d65394 100644 --- a/ai-compliance-sdk/docs/DEVELOPER.md +++ b/ai-compliance-sdk/docs/DEVELOPER.md @@ -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 diff --git a/docker-compose.hetzner.yml b/docker-compose.hetzner.yml index 9878668..2c0402e 100644 --- a/docker-compose.hetzner.yml +++ b/docker-compose.hetzner.yml @@ -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: diff --git a/docs-src/development/ci-cd-pipeline.md b/docs-src/development/ci-cd-pipeline.md index 43973a3..5d7e4c6 100644 --- a/docs-src/development/ci-cd-pipeline.md +++ b/docs-src/development/ci-cd-pipeline.md @@ -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 diff --git a/docs-src/development/rag-pipeline-lessons-learned.md b/docs-src/development/rag-pipeline-lessons-learned.md index d74dcd7..25aaf7e 100644 --- a/docs-src/development/rag-pipeline-lessons-learned.md +++ b/docs-src/development/rag-pipeline-lessons-learned.md @@ -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. diff --git a/docs-src/index.md b/docs-src/index.md index fab4d0c..1e97b7c 100644 --- a/docs-src/index.md +++ b/docs-src/index.md @@ -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