Files
breakpilot-core/docs-src/architecture/environments.md
Sharang Parnerkar 68b7660ce3 docs: replace all Coolify references with Orca across core repo
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>
2026-04-17 10:39:47 +02:00

81 lines
2.1 KiB
Markdown

# Umgebungs-Architektur
## Uebersicht
BreakPilot verwendet zwei Umgebungen:
```
┌─────────────────┐ ┌─────────────────┐
│ Development │───── git push ────▶│ Production │
│ (Mac Mini) │ │ (Orca) │
└─────────────────┘ └─────────────────┘
Lokale Automatisch
Entwicklung via Orca
```
## Umgebungen
### Development (Lokal — Mac Mini)
**Zweck:** Lokale Entwicklung und Tests
| Eigenschaft | Wert |
|-------------|------|
| Git Branch | `main` |
| Compose File | `docker-compose.yml` |
| Database | Lokale PostgreSQL |
| Debug | Aktiviert |
| Hot-Reload | Aktiviert |
**Start:**
```bash
ssh macmini "cd ~/Projekte/breakpilot-core && /usr/local/bin/docker compose up -d"
```
### Production (Orca)
**Zweck:** Live-System
| Eigenschaft | Wert |
|-------------|------|
| Git Branch | `main` |
| Deployment | Orca (automatisch bei Push auf gitea) |
| Database | Externe PostgreSQL (TLS) |
| Debug | Deaktiviert |
**Deploy:**
```bash
git push origin main && git push gitea main
# Orca baut und deployt automatisch
```
## Docker Compose Architektur
```
docker-compose.yml ← Basis-Konfiguration (lokal, arm64)
└── docker-compose.orca.yml ← Production Override (amd64)
```
Orca verwendet automatisch beide Compose-Files fuer den Production-Build.
## Secrets Management
### Development
- `.env` enthält Entwicklungs-Credentials
- Vault optional (Dev-Token)
- Mailpit für E-Mail-Tests
### Production
- `.env` auf dem Server (nicht im Repository)
- Vault PFLICHT
- Echte SMTP-Konfiguration
Siehe auch: [Secrets Management](./secrets-management.md)
## Verwandte Dokumentation
- [Secrets Management](./secrets-management.md) - Vault & Secrets
- [DevSecOps](./devsecops.md) - CI/CD & Security
- [System-Architektur](./system-architecture.md) - Gesamtarchitektur