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

fix(sdk): Fix ScopeDecisionTab crash — type mismatches with backend types
Some checks failed
CI/CD / go-lint (push) Has been skipped
Details
CI/CD / python-lint (push) Has been skipped
Details
CI/CD / nodejs-lint (push) Has been skipped
Details
CI/CD / test-go-ai-compliance (push) Successful in 38s
Details
CI/CD / test-python-backend-compliance (push) Successful in 37s
Details
CI/CD / test-python-document-crawler (push) Successful in 24s
Details
CI/CD / test-python-dsms-gateway (push) Successful in 20s
Details
CI/CD / deploy-hetzner (push) Failing after 5s
Details

Browse Source 
- DEPTH_LEVEL_COLORS: simple strings → objects with {bg, border, badge, text} Tailwind classes
- decision.reasoning: render as mapped array instead of direct JSX child
- trigger.X → trigger.rule.X for TriggeredHardTrigger properties
- doc.isMandatory → doc.required, doc.depthDescription → doc.depth
- doc.effortEstimate → doc.estimatedEffort, doc.triggeredByHardTrigger → doc.triggeredBy
- decision.gapAnalysis → decision.gaps (matching ScopeDecision type)
- getSeverityBadge: uppercase severity ('LOW'|'MEDIUM'|'HIGH'|'CRITICAL')
- Also includes CLAUDE.md and DEVELOPER.md CI/CD documentation updates

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Benjamin Admin
2026-03-11 09:07:41 +01:00
parent a673cb0ce4
commit 46048554cb
4 changed files with 137 additions and 80 deletions
Download Patch File Download Diff File Expand all files Collapse all files

126
.claude/CLAUDE.md
View File

@@ -2,41 +2,69 @@
## Entwicklungsumgebung (WICHTIG - IMMER ZUERST LESEN) ## Entwicklungsumgebung (WICHTIG - IMMER ZUERST LESEN)
### Zwei-Rechner-Setup ### Zwei-Rechner-Setup + Hetzner
| 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** | Server | Docker, alle Services, Tests, Builds, Deployment | | **Mac Mini** | Lokaler Server | Docker fuer lokale Dev/Tests (NICHT mehr fuer Production!) |
| **Hetzner** | Production | CI/CD Build + Deploy via Gitea Actions |
**WICHTIG:** Code wird direkt auf dem MacBook in diesem Repo bearbeitet. Docker und Services laufen auf dem Mac Mini. **WICHTIG:** Code wird auf dem MacBook bearbeitet. Production-Deployment laeuft automatisch auf Hetzner via CI/CD.
### Entwicklungsworkflow ### Entwicklungsworkflow (CI/CD — seit 2026-03-11)
```bash ```bash
# 1. Code auf MacBook bearbeiten (dieses Verzeichnis) # 1. Code auf MacBook bearbeiten (dieses Verzeichnis)
# 2. Committen und pushen: # 2. Committen und zu BEIDEN Remotes pushen:
git push origin main && git push gitea main git push origin main && git push gitea main
# 3. Auf Mac Mini pullen (WICHTIG: git -C statt cd): # 3. FERTIG! Gitea Actions auf Hetzner uebernimmt automatisch:
ssh macmini "git -C /Users/benjaminadmin/Projekte/breakpilot-compliance pull --no-rebase origin main" # Push auf main → Lint → Tests → Build → Deploy
# Pipeline: .gitea/workflows/ci.yaml
# Dauer: ca. 3 Minuten
# Status pruefen: https://gitea.meghsakha.com/Benjamin_Boenisch/breakpilot-compliance/actions
```
# 4. Container neu bauen (WICHTIG: -f statt cd, da cd in SSH nicht funktioniert!): **NICHT MEHR NOETIG:** Manuelles `ssh macmini "docker compose build"` — das macht jetzt die CI/CD Pipeline!
ssh macmini "/usr/local/bin/docker compose -f /Users/benjaminadmin/Projekte/breakpilot-compliance/docker-compose.yml build --no-cache <service> && /usr/local/bin/docker compose -f /Users/benjaminadmin/Projekte/breakpilot-compliance/docker-compose.yml up -d <service>"
### CI/CD Pipeline (Gitea Actions → Hetzner)
```
Push auf main → go-lint/python-lint/nodejs-lint (nur PRs)
→ test-go-ai-compliance
→ test-python-backend-compliance
→ test-python-document-crawler
→ test-python-dsms-gateway
→ deploy-hetzner (nur wenn ALLE Tests gruen)
```
**Dateien:**
- `.gitea/workflows/ci.yaml` — Pipeline-Definition
- `docker-compose.hetzner.yml` — Override: arm64→amd64 fuer Hetzner (x86_64)
- Deploy-Pfad auf Hetzner: `/opt/breakpilot-compliance/`
**Ablauf deploy-hetzner:**
1. `git pull` im Deploy-Dir
2. `docker compose -f docker-compose.yml -f docker-compose.hetzner.yml build --parallel`
3. `docker compose up -d --remove-orphans`
4. Health Checks
### Lokale Entwicklung (Mac Mini — optional)
```bash
# Nur fuer lokale Tests, NICHT fuer Production:
ssh macmini "git -C /Users/benjaminadmin/Projekte/breakpilot-compliance pull --no-rebase origin main"
ssh macmini "/usr/local/bin/docker compose -f /Users/benjaminadmin/Projekte/breakpilot-compliance/docker-compose.yml build --no-cache <service>"
ssh macmini "/usr/local/bin/docker compose -f /Users/benjaminadmin/Projekte/breakpilot-compliance/docker-compose.yml up -d <service>"
# Fuer schnelle Iteration ohne Commit (rsync): # Fuer schnelle Iteration ohne Commit (rsync):
rsync -avz --exclude node_modules --exclude .next --exclude .git \ rsync -avz --exclude node_modules --exclude .next --exclude .git \
admin-compliance/ macmini:~/Projekte/breakpilot-compliance/admin-compliance/ admin-compliance/ macmini:~/Projekte/breakpilot-compliance/admin-compliance/
``` ```
### SSH-Verbindung (fuer Docker/Tests) **WICHTIG:** Docker-Pfad auf Mac Mini ist `/usr/local/bin/docker` (nicht im Standard-SSH-PATH).
**WICHTIG:** `cd` funktioniert NICHT in SSH-Einzelbefehlen — immer `-f <pfad>/docker-compose.yml` verwenden!
```bash
# RICHTIG — cd funktioniert NICHT in SSH-Einzelbefehlen:
ssh macmini "git -C /Users/benjaminadmin/Projekte/breakpilot-compliance <git-cmd>"
ssh macmini "/usr/local/bin/docker compose -f /Users/benjaminadmin/Projekte/breakpilot-compliance/docker-compose.yml <compose-cmd>"
ssh macmini "/usr/local/bin/docker exec bp-compliance-<service> <cmd>"
```
--- ---
@@ -59,21 +87,25 @@ Pruefen: `curl -sf http://macmini:8099/health`
--- ---
## Haupt-URLs (Browser auf MacBook) ## Haupt-URLs
### Frontends ### Production (Hetzner — primaer)
| URL | Service | Beschreibung | | URL | Service | Beschreibung |
|-----|---------|--------------| |-----|---------|--------------|
| **https://macmini:3007/** | Admin Compliance | SDK-Dashboard, alle Compliance-Module | | **https://admin-dev.breakpilot.ai/** | Admin Compliance | SDK-Dashboard, alle Compliance-Module |
| **https://macmini:3006/** | Developer Portal | API-Dokumentation fuer Kunden | | **https://developers-dev.breakpilot.ai/** | Developer Portal | API-Dokumentation fuer Kunden |
| https://api-dev.breakpilot.ai/ | Backend Compliance | Compliance APIs (DSGVO, DSR, GDPR) |
| https://sdk-dev.breakpilot.ai/ | AI Compliance SDK | KI-konforme Compliance-Analyse |
### Backend-APIs ### Lokal (Mac Mini — nur Dev/Tests)
| URL | Service | Beschreibung | | URL | Service | Beschreibung |
|-----|---------|--------------| |-----|---------|--------------|
| https://macmini:8002/ | Backend Compliance | Compliance APIs (DSGVO, DSR, GDPR) | | https://macmini:3007/ | Admin Compliance | Lokale Entwicklung |
| https://macmini:8093/ | AI Compliance SDK | KI-konforme Compliance-Analyse | | https://macmini:3006/ | Developer Portal | Lokale Entwicklung |
| https://macmini:8002/ | Backend Compliance | Lokale Entwicklung |
| https://macmini:8093/ | AI Compliance SDK | Lokale Entwicklung |
### Admin Compliance Module (https://macmini:3007/) ### Admin Compliance Module (https://macmini:3007/)
@@ -169,50 +201,54 @@ breakpilot-compliance/
├── dsms-node/ # IPFS Node ├── dsms-node/ # IPFS Node
├── dsms-gateway/ # IPFS Gateway ├── dsms-gateway/ # IPFS Gateway
├── scripts/ # Helper Scripts ├── scripts/ # Helper Scripts
└── docker-compose.yml # Compliance Compose (~8 Services) ├── docker-compose.yml # Compliance Compose (~10 Services, platform: arm64)
├── docker-compose.hetzner.yml # Override: arm64→amd64 fuer Hetzner
└── .gitea/workflows/ci.yaml # CI/CD Pipeline (Lint → Tests → Deploy)
``` ```
--- ---
## Haeufige Befehle ## Haeufige Befehle
### Docker ### Deployment (CI/CD — Standardweg)
```bash ```bash
# Compliance-Services starten (Core muss laufen!) # Committen und pushen → CI/CD deployt automatisch auf Hetzner:
ssh macmini "/usr/local/bin/docker compose -f /Users/benjaminadmin/Projekte/breakpilot-compliance/docker-compose.yml up -d" git push origin main && git push gitea main
# Einzelnen Service neu bauen # CI-Status pruefen (im Browser):
ssh macmini "/usr/local/bin/docker compose -f /Users/benjaminadmin/Projekte/breakpilot-compliance/docker-compose.yml build --no-cache <service>" # https://gitea.meghsakha.com/Benjamin_Boenisch/breakpilot-compliance/actions
# Service neu bauen und starten # Health Checks:
ssh macmini "/usr/local/bin/docker compose -f /Users/benjaminadmin/Projekte/breakpilot-compliance/docker-compose.yml build --no-cache <service> && /usr/local/bin/docker compose -f /Users/benjaminadmin/Projekte/breakpilot-compliance/docker-compose.yml up -d <service>" curl -sf https://api-dev.breakpilot.ai/health
curl -sf https://sdk-dev.breakpilot.ai/health
# Logs
ssh macmini "/usr/local/bin/docker logs -f bp-compliance-<service>"
# Status
ssh macmini "/usr/local/bin/docker ps --filter name=bp-compliance"
``` ```
**WICHTIG:** Docker-Pfad auf Mac Mini ist `/usr/local/bin/docker` (nicht im Standard-SSH-PATH).
**WICHTIG:** `cd` funktioniert NICHT in SSH-Einzelbefehlen — immer `-f <pfad>/docker-compose.yml` verwenden!
Der CLAUDE.md-Entwicklungsworkflow und die Beispiele mit `cd ... &&` sind veraltet — nie so verwenden.
### Git ### Git
```bash ```bash
# Zu BEIDEN Remotes pushen (PFLICHT! — vom MacBook): # Zu BEIDEN Remotes pushen (PFLICHT! — vom MacBook):
git push origin main && git push gitea main git push origin main && git push gitea main
# Auf Mac Mini pullen (RICHTIG: git -C statt cd):
ssh macmini "git -C /Users/benjaminadmin/Projekte/breakpilot-compliance pull --no-rebase origin main"
# Remotes: # Remotes:
# origin: lokale Gitea (macmini:3003) # origin: lokale Gitea (macmini:3003)
# gitea: gitea.meghsakha.com:22222 # gitea: gitea.meghsakha.com:22222
``` ```
### Lokale Docker-Befehle (Mac Mini — nur fuer Dev/Tests)
```bash
# Logs
ssh macmini "/usr/local/bin/docker logs -f bp-compliance-<service>"
# Status
ssh macmini "/usr/local/bin/docker ps --filter name=bp-compliance"
# Lokaler Rebuild (nur wenn noetig):
ssh macmini "git -C /Users/benjaminadmin/Projekte/breakpilot-compliance pull --no-rebase origin main"
ssh macmini "/usr/local/bin/docker compose -f /Users/benjaminadmin/Projekte/breakpilot-compliance/docker-compose.yml build --no-cache <service> && /usr/local/bin/docker compose -f /Users/benjaminadmin/Projekte/breakpilot-compliance/docker-compose.yml up -d <service>"
```
--- ---
## Kernprinzipien ## Kernprinzipien

52
admin-compliance/components/sdk/compliance-scope/ScopeDecisionTab.tsx
View File

@@ -58,18 +58,18 @@ export function ScopeDecisionTab({
return 'from-green-500 to-green-600' return 'from-green-500 to-green-600'
} }
const getSeverityBadge = (severity: 'low' | 'medium' | 'high' | 'critical') => { const getSeverityBadge = (severity: 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL') => {
const colors = { const colors = {
low: 'bg-gray-100 text-gray-800', LOW: 'bg-gray-100 text-gray-800',
medium: 'bg-yellow-100 text-yellow-800', MEDIUM: 'bg-yellow-100 text-yellow-800',
high: 'bg-orange-100 text-orange-800', HIGH: 'bg-orange-100 text-orange-800',
critical: 'bg-red-100 text-red-800', CRITICAL: 'bg-red-100 text-red-800',
} }
const labels = { const labels = {
low: 'Niedrig', LOW: 'Niedrig',
medium: 'Mittel', MEDIUM: 'Mittel',
high: 'Hoch', HIGH: 'Hoch',
critical: 'Kritisch', CRITICAL: 'Kritisch',
} }
return ( return (
<span className={`inline-flex items-center px-2.5 py-0.5 rounded-full text-xs font-medium ${colors[severity]}`}> <span className={`inline-flex items-center px-2.5 py-0.5 rounded-full text-xs font-medium ${colors[severity]}`}>
@@ -111,8 +111,8 @@ export function ScopeDecisionTab({
{DEPTH_LEVEL_LABELS[decision.determinedLevel]} {DEPTH_LEVEL_LABELS[decision.determinedLevel]}
</h2> </h2>
<p className="text-gray-700 mb-3">{DEPTH_LEVEL_DESCRIPTIONS[decision.determinedLevel]}</p> <p className="text-gray-700 mb-3">{DEPTH_LEVEL_DESCRIPTIONS[decision.determinedLevel]}</p>
{decision.reasoning && ( {decision.reasoning && decision.reasoning.length > 0 && (
<p className="text-sm text-gray-600 italic">{decision.reasoning}</p> <p className="text-sm text-gray-600 italic">{decision.reasoning.map(r => r.description).filter(Boolean).join('. ')}</p>
)} )}
</div> </div>
</div> </div>
@@ -254,9 +254,9 @@ export function ScopeDecisionTab({
d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z" d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z"
/> />
</svg> </svg>
<span className="font-medium text-gray-900">{trigger.description}</span> <span className="font-medium text-gray-900">{trigger.rule.description}</span>
<span className="text-xs px-2 py-0.5 rounded-full bg-red-200 text-red-800 font-medium"> <span className="text-xs px-2 py-0.5 rounded-full bg-red-200 text-red-800 font-medium">
Min. {trigger.minimumLevel} Min. {trigger.rule.minimumLevel}
</span> </span>
</div> </div>
<svg <svg
@@ -272,18 +272,18 @@ export function ScopeDecisionTab({
</button> </button>
{expandedTrigger === idx && ( {expandedTrigger === idx && (
<div className="px-4 pb-4 pt-2 border-t border-gray-200"> <div className="px-4 pb-4 pt-2 border-t border-gray-200">
<p className="text-sm text-gray-700 mb-2">{trigger.description}</p> <p className="text-sm text-gray-700 mb-2">{trigger.explanation}</p>
{trigger.legalReference && ( {trigger.rule.legalReference && (
<p className="text-xs text-gray-600 mb-2"> <p className="text-xs text-gray-600 mb-2">
<span className="font-medium">Rechtsgrundlage:</span> {trigger.legalReference} <span className="font-medium">Rechtsgrundlage:</span> {trigger.rule.legalReference}
</p> </p>
)} )}
{trigger.category && ( {trigger.rule.mandatoryDocuments && trigger.rule.mandatoryDocuments.length > 0 && (
<p className="text-xs text-gray-700"> <p className="text-xs text-gray-700">
<span className="font-medium">Kategorie:</span> {trigger.category} <span className="font-medium">Pflichtdokumente:</span> {trigger.rule.mandatoryDocuments.join(', ')}
</p> </p>
)} )}
{trigger.requiresDSFA && ( {trigger.rule.dsfaRequired && (
<p className="text-xs text-orange-700 font-medium mt-1">DSFA erforderlich</p> <p className="text-xs text-orange-700 font-medium mt-1">DSFA erforderlich</p>
)} )}
</div> </div>
@@ -317,21 +317,21 @@ export function ScopeDecisionTab({
<span className="font-medium text-gray-900"> <span className="font-medium text-gray-900">
{DOCUMENT_TYPE_LABELS[doc.documentType] || doc.documentType} {DOCUMENT_TYPE_LABELS[doc.documentType] || doc.documentType}
</span> </span>
{doc.isMandatory && ( {doc.required && (
<span className="inline-flex items-center px-2 py-0.5 rounded text-xs font-medium bg-purple-100 text-purple-800"> <span className="inline-flex items-center px-2 py-0.5 rounded text-xs font-medium bg-purple-100 text-purple-800">
Pflicht Pflicht
</span> </span>
)} )}
</div> </div>
</td> </td>
<td className="py-3 px-4 text-sm text-gray-700">{doc.depthDescription}</td> <td className="py-3 px-4 text-sm text-gray-700">{doc.depth}</td>
<td className="py-3 px-4 text-sm text-gray-700"> <td className="py-3 px-4 text-sm text-gray-700">
{doc.effortEstimate ? `${doc.effortEstimate.days} Tage` : '-'} {doc.estimatedEffort || '-'}
</td> </td>
<td className="py-3 px-4"> <td className="py-3 px-4">
{doc.triggeredByHardTrigger && ( {doc.triggeredBy && doc.triggeredBy.length > 0 && (
<span className="inline-flex items-center px-2 py-0.5 rounded text-xs font-medium bg-red-100 text-red-800"> <span className="inline-flex items-center px-2 py-0.5 rounded text-xs font-medium bg-red-100 text-red-800">
Hard-Trigger {doc.triggeredBy.join(', ')}
</span> </span>
)} )}
</td> </td>
@@ -375,11 +375,11 @@ export function ScopeDecisionTab({
)} )}
{/* Gap Analysis */} {/* Gap Analysis */}
{decision.gapAnalysis && decision.gapAnalysis.length > 0 && ( {decision.gaps && decision.gaps.length > 0 && (
<div className="bg-white rounded-xl border border-gray-200 p-6"> <div className="bg-white rounded-xl border border-gray-200 p-6">
<h3 className="text-lg font-semibold text-gray-900 mb-4">Gap-Analyse</h3> <h3 className="text-lg font-semibold text-gray-900 mb-4">Gap-Analyse</h3>
<div className="space-y-4"> <div className="space-y-4">
{decision.gapAnalysis.map((gap, idx) => ( {decision.gaps.map((gap, idx) => (
<div key={idx} className="border border-gray-200 rounded-lg p-4"> <div key={idx} className="border border-gray-200 rounded-lg p-4">
<div className="flex items-start justify-between mb-2"> <div className="flex items-start justify-between mb-2">
<h4 className="font-semibold text-gray-900">{gap.title}</h4> <h4 className="font-semibold text-gray-900">{gap.title}</h4>

10
admin-compliance/lib/sdk/compliance-scope-types.ts
View File

@@ -388,11 +388,11 @@ export const DEPTH_LEVEL_DESCRIPTIONS: Record<ComplianceDepthLevel, string> = {
/** /**
* Farben für Compliance-Levels (Tailwind-kompatibel) * Farben für Compliance-Levels (Tailwind-kompatibel)
*/ */
export const DEPTH_LEVEL_COLORS: Record<ComplianceDepthLevel, string> = { export const DEPTH_LEVEL_COLORS: Record<ComplianceDepthLevel, { bg: string; border: string; badge: string; text: string }> = {
L1: 'green', L1: { bg: 'bg-green-50', border: 'border-green-300', badge: 'bg-green-100', text: 'text-green-800' },
L2: 'blue', L2: { bg: 'bg-blue-50', border: 'border-blue-300', badge: 'bg-blue-100', text: 'text-blue-800' },
L3: 'amber', L3: { bg: 'bg-amber-50', border: 'border-amber-300', badge: 'bg-amber-100', text: 'text-amber-800' },
L4: 'red', L4: { bg: 'bg-red-50', border: 'border-red-300', badge: 'bg-red-100', text: 'text-red-800' },
}; };
/** /**

29
ai-compliance-sdk/docs/DEVELOPER.md
View File

@@ -30,14 +30,19 @@
### Build & Run ### Build & Run
```bash ```bash
# Build # Build (lokal)
cd ai-compliance-sdk cd ai-compliance-sdk
go build -o server ./cmd/server go build -o server ./cmd/server
# Run # Run (lokal)
./server --config config.yaml ./server --config config.yaml
# Alternativ: mit Docker # Production: CI/CD (automatisch bei Push auf main)
git push origin main && git push gitea main
# → Gitea Actions: Tests → Build → Deploy auf Hetzner
# → Status: https://gitea.meghsakha.com/Benjamin_Boenisch/breakpilot-compliance/actions
# Alternativ: mit Docker (lokal)
docker compose up -d docker compose up -d
``` ```
@@ -445,8 +450,24 @@ metadata:
```bash ```bash
cd ai-compliance-sdk cd ai-compliance-sdk
go test -v ./... go test -v ./...
# So wie die CI es ausfuehrt (CGO_ENABLED=0):
CGO_ENABLED=0 go test -v -coverprofile=coverage.out ./...
``` ```
### CI/CD Pipeline
Tests laufen automatisch bei jedem Push via Gitea Actions (`.gitea/workflows/ci.yaml`):
| Job | Container | Was wird getestet |
|-----|-----------|-------------------|
| `test-go-ai-compliance` | `golang:1.24-alpine` | `go test -v ./...` |
| `test-python-backend-compliance` | `python:3.12-slim` | `pytest compliance/tests/` |
| `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 Hetzner (`deploy-hetzner` Job).
### Spezifische Tests ### Spezifische Tests
```bash ```bash
@@ -1008,4 +1029,4 @@ cd admin-v2 && npm test -- --testPathPattern=dsfa
--- ---
*Dokumentationsstand: 2026-02-09* *Dokumentationsstand: 2026-03-11*