fefe
This commit is contained in:
parent
f2217722e0
commit
51f17dd6be
@ -1 +1,436 @@
|
||||
|
||||
# 🏗️ MYP - Separate Server Architektur
|
||||
|
||||
## Übersicht
|
||||
|
||||
Das MYP-System wurde in **zwei vollständig unabhängige Server** aufgeteilt:
|
||||
|
||||
- **🏭 Backend-Server** (Port 5000): Flask-API für Geschäftslogik und Datenmanagement
|
||||
- **🎨 Frontend-Server** (Port 3000): Next.js-Anwendung für Benutzeroberfläche
|
||||
|
||||
## 🔗 Server-Kommunikation
|
||||
|
||||
```
|
||||
┌─────────────────┐ HTTP/API ┌─────────────────┐
|
||||
│ Frontend │◄───────────────►│ Backend │
|
||||
│ (Next.js) │ │ (Flask) │
|
||||
│ Port: 3000 │ │ Port: 5000 │
|
||||
└─────────────────┘ └─────────────────┘
|
||||
```
|
||||
|
||||
## 🚀 Separate Server starten
|
||||
|
||||
### Backend-Server (unabhängig)
|
||||
|
||||
#### **Windows (PowerShell)**
|
||||
```powershell
|
||||
cd backend
|
||||
.\install.ps1 -Production # Installation
|
||||
.\start-backend-server.ps1 -Development # Entwicklung
|
||||
.\start-backend-server.ps1 -Production # Produktion
|
||||
.\start-backend-server.ps1 -Development -Logs # Mit Live-Logs
|
||||
```
|
||||
|
||||
#### **Linux/macOS (Bash)**
|
||||
```bash
|
||||
cd backend
|
||||
./install.sh --production # Installation
|
||||
./start-backend-server.sh --development # Entwicklung
|
||||
./start-backend-server.sh --production # Produktion
|
||||
./start-backend-server.sh --development --logs # Mit Live-Logs
|
||||
```
|
||||
|
||||
### Frontend-Server (unabhängig)
|
||||
|
||||
```bash
|
||||
cd frontend
|
||||
npm install # Dependencies installieren
|
||||
npm run dev # Entwicklungsserver
|
||||
npm run build && npm start # Produktionsserver
|
||||
```
|
||||
|
||||
## 📋 Konfiguration
|
||||
|
||||
### Backend-Konfiguration (`backend/env.backend`)
|
||||
|
||||
```bash
|
||||
# === FLASK KONFIGURATION ===
|
||||
FLASK_APP=app.py
|
||||
FLASK_ENV=production
|
||||
PYTHONUNBUFFERED=1
|
||||
|
||||
# === DATENBANK ===
|
||||
DATABASE_PATH=instance/myp.db
|
||||
|
||||
# === SICHERHEIT ===
|
||||
SECRET_KEY=7445630171969DFAC92C53CEC92E67A9CB2E00B3CB2F
|
||||
JWT_SECRET=secure-jwt-secret-backend-2024
|
||||
|
||||
# === CORS KONFIGURATION ===
|
||||
CORS_ORIGINS=http://localhost:3000,https://frontend.myp.local
|
||||
|
||||
# === DRUCKER KONFIGURATION ===
|
||||
PRINTERS={"Drucker 1": {"ip": "192.168.0.100"}, "Drucker 2": {"ip": "192.168.0.101"}}
|
||||
|
||||
# === TAPO SMART PLUG ===
|
||||
TAPO_USERNAME=your.email@company.com
|
||||
TAPO_PASSWORD=your_password
|
||||
|
||||
# === NETZWERK ===
|
||||
HOST=0.0.0.0
|
||||
PORT=5000
|
||||
BACKEND_URL=http://localhost:5000
|
||||
```
|
||||
|
||||
### Frontend-Konfiguration (`frontend/env.frontend`)
|
||||
|
||||
```bash
|
||||
# === NODE.JS KONFIGURATION ===
|
||||
NODE_ENV=production
|
||||
NEXT_TELEMETRY_DISABLED=1
|
||||
|
||||
# === FRONTEND SERVER ===
|
||||
PORT=3000
|
||||
HOSTNAME=0.0.0.0
|
||||
FRONTEND_URL=http://localhost:3000
|
||||
|
||||
# === BACKEND API KONFIGURATION ===
|
||||
BACKEND_API_URL=http://localhost:5000/api
|
||||
BACKEND_HOST=localhost:5000
|
||||
NEXT_PUBLIC_API_URL=http://localhost:5000/api
|
||||
NEXT_PUBLIC_BACKEND_HOST=localhost:5000
|
||||
|
||||
# === AUTHENTIFIZIERUNG ===
|
||||
NEXTAUTH_URL=http://localhost:3000
|
||||
NEXTAUTH_SECRET=frontend-auth-secret-2024
|
||||
```
|
||||
|
||||
## 🔧 Entwicklung
|
||||
|
||||
### Beide Server parallel starten
|
||||
|
||||
#### **Windows**
|
||||
```powershell
|
||||
# Terminal 1: Backend
|
||||
cd backend
|
||||
.\start-backend-server.ps1 -Development -Logs
|
||||
|
||||
# Terminal 2: Frontend
|
||||
cd frontend
|
||||
npm run dev
|
||||
```
|
||||
|
||||
#### **Linux/macOS**
|
||||
```bash
|
||||
# Terminal 1: Backend
|
||||
cd backend
|
||||
./start-backend-server.sh --development --logs
|
||||
|
||||
# Terminal 2: Frontend
|
||||
cd frontend
|
||||
npm run dev
|
||||
```
|
||||
|
||||
### API-Endpoints testen
|
||||
|
||||
```bash
|
||||
# Backend Health-Check
|
||||
curl http://localhost:5000/monitoring/health/simple
|
||||
|
||||
# Backend API Test
|
||||
curl http://localhost:5000/api/test
|
||||
|
||||
# Frontend Health-Check
|
||||
curl http://localhost:3000/health
|
||||
```
|
||||
|
||||
## 🏭 Produktion
|
||||
|
||||
### Docker-Deployment
|
||||
|
||||
#### **Backend-Container**
|
||||
```bash
|
||||
cd backend
|
||||
docker-compose -f docker-compose.backend.yml up -d
|
||||
```
|
||||
|
||||
#### **Frontend-Container**
|
||||
```bash
|
||||
cd frontend
|
||||
docker-compose -f docker-compose.frontend.yml up -d
|
||||
```
|
||||
|
||||
### Native Deployment
|
||||
|
||||
#### **Backend (Linux/Ubuntu)**
|
||||
```bash
|
||||
cd backend
|
||||
./install.sh --production
|
||||
|
||||
# Systemd-Service
|
||||
sudo systemctl start myp-backend
|
||||
sudo systemctl enable myp-backend
|
||||
sudo systemctl status myp-backend
|
||||
```
|
||||
|
||||
#### **Frontend (mit PM2)**
|
||||
```bash
|
||||
cd frontend
|
||||
npm install -g pm2
|
||||
npm run build
|
||||
pm2 start npm --name "myp-frontend" -- start
|
||||
pm2 save
|
||||
pm2 startup
|
||||
```
|
||||
|
||||
## 🔒 Sicherheit
|
||||
|
||||
### CORS-Konfiguration
|
||||
|
||||
Das Backend ist konfiguriert, um nur Anfragen von autorisierten Frontend-Domains zu akzeptieren:
|
||||
|
||||
```python
|
||||
# backend/app.py
|
||||
CORS(app,
|
||||
origins=['http://localhost:3000', 'https://frontend.myp.local'],
|
||||
supports_credentials=True,
|
||||
allow_headers=['Content-Type', 'Authorization', 'X-Requested-With'],
|
||||
methods=['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS'])
|
||||
```
|
||||
|
||||
### Umgebungsvariablen
|
||||
|
||||
- Verwenden Sie sichere, zufällige Secret Keys
|
||||
- Lagern Sie Passwörter nie im Code
|
||||
- Nutzen Sie unterschiedliche Secrets für verschiedene Umgebungen
|
||||
|
||||
## 📊 Monitoring
|
||||
|
||||
### Health-Checks
|
||||
|
||||
| Service | Endpoint | Port | Beschreibung |
|
||||
|----------|----------|------|--------------|
|
||||
| Backend | `/monitoring/health/simple` | 5000 | Einfacher Health-Check |
|
||||
| Backend | `/monitoring/health` | 5000 | Detaillierter Health-Check |
|
||||
| Frontend | `/health` | 3000 | Frontend-Health-Check |
|
||||
|
||||
### Logs
|
||||
|
||||
#### **Backend-Logs**
|
||||
```bash
|
||||
# Windows
|
||||
Get-Content backend\logs\myp.log -Wait
|
||||
|
||||
# Linux/macOS
|
||||
tail -f backend/logs/myp.log
|
||||
```
|
||||
|
||||
#### **Frontend-Logs**
|
||||
```bash
|
||||
# Development
|
||||
npm run dev # Logs in der Konsole
|
||||
|
||||
# Production mit PM2
|
||||
pm2 logs myp-frontend
|
||||
```
|
||||
|
||||
## 🔍 Troubleshooting
|
||||
|
||||
### Häufige Probleme
|
||||
|
||||
#### **Backend startet nicht**
|
||||
```bash
|
||||
# 1. Python-Version prüfen
|
||||
python --version # Mindestens 3.8 erforderlich
|
||||
|
||||
# 2. Dependencies prüfen
|
||||
cd backend
|
||||
pip install -r requirements.txt
|
||||
|
||||
# 3. Test-Skript ausführen
|
||||
python test-backend-setup.py
|
||||
```
|
||||
|
||||
#### **Frontend startet nicht**
|
||||
```bash
|
||||
# 1. Node-Version prüfen
|
||||
node --version # Mindestens 18 erforderlich
|
||||
|
||||
# 2. Dependencies installieren
|
||||
cd frontend
|
||||
rm -rf node_modules package-lock.json
|
||||
npm install
|
||||
|
||||
# 3. Build-Fehler beheben
|
||||
npm run build
|
||||
```
|
||||
|
||||
#### **CORS-Fehler**
|
||||
```bash
|
||||
# Backend CORS-Origins in env.backend prüfen
|
||||
CORS_ORIGINS=http://localhost:3000,https://your-frontend-domain.com
|
||||
|
||||
# Frontend API-URL in env.frontend prüfen
|
||||
NEXT_PUBLIC_API_URL=http://localhost:5000/api
|
||||
```
|
||||
|
||||
### Debug-Modus
|
||||
|
||||
#### **Backend Debug**
|
||||
```bash
|
||||
# Windows
|
||||
.\start-backend-server.ps1 -Development -Logs
|
||||
|
||||
# Linux/macOS
|
||||
./start-backend-server.sh --development --logs
|
||||
```
|
||||
|
||||
#### **Frontend Debug**
|
||||
```bash
|
||||
cd frontend
|
||||
npm run dev # Automatisches Reload bei Änderungen
|
||||
```
|
||||
|
||||
## 🌐 Reverse Proxy (Produktionsempfehlung)
|
||||
|
||||
### Nginx-Konfiguration
|
||||
|
||||
```nginx
|
||||
# /etc/nginx/sites-available/myp
|
||||
server {
|
||||
listen 80;
|
||||
server_name your-domain.com;
|
||||
|
||||
# Frontend
|
||||
location / {
|
||||
proxy_pass http://localhost:3000;
|
||||
proxy_http_version 1.1;
|
||||
proxy_set_header Upgrade $http_upgrade;
|
||||
proxy_set_header Connection 'upgrade';
|
||||
proxy_set_header Host $host;
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||
proxy_set_header X-Forwarded-Proto $scheme;
|
||||
proxy_cache_bypass $http_upgrade;
|
||||
}
|
||||
|
||||
# Backend API
|
||||
location /api {
|
||||
proxy_pass http://localhost:5000;
|
||||
proxy_set_header Host $host;
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||
proxy_set_header X-Forwarded-Proto $scheme;
|
||||
}
|
||||
|
||||
# Backend Health-Check
|
||||
location /monitoring {
|
||||
proxy_pass http://localhost:5000;
|
||||
proxy_set_header Host $host;
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||
proxy_set_header X-Forwarded-Proto $scheme;
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### SSL-Konfiguration mit Certbot
|
||||
|
||||
```bash
|
||||
# SSL-Zertifikat installieren
|
||||
sudo certbot --nginx -d your-domain.com
|
||||
|
||||
# Automatische Erneuerung
|
||||
sudo crontab -e
|
||||
# Füge hinzu: 0 12 * * * /usr/bin/certbot renew --quiet
|
||||
```
|
||||
|
||||
## 📈 Performance-Optimierung
|
||||
|
||||
### Backend-Optimierung
|
||||
|
||||
```bash
|
||||
# Gunicorn-Worker anpassen (env.backend)
|
||||
WORKERS=4 # CPU-Kerne * 2
|
||||
TIMEOUT=30 # Request-Timeout
|
||||
MAX_REQUESTS=1000 # Requests pro Worker
|
||||
```
|
||||
|
||||
### Frontend-Optimierung
|
||||
|
||||
```bash
|
||||
# Build-Optimierung
|
||||
cd frontend
|
||||
npm run build # Produktions-Build
|
||||
npm run analyze # Bundle-Analyse
|
||||
```
|
||||
|
||||
## 🔄 CI/CD Pipeline
|
||||
|
||||
### GitHub Actions Beispiel
|
||||
|
||||
```yaml
|
||||
# .github/workflows/deploy.yml
|
||||
name: Deploy MYP
|
||||
|
||||
on:
|
||||
push:
|
||||
branches: [main]
|
||||
|
||||
jobs:
|
||||
deploy-backend:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@v3
|
||||
- name: Deploy Backend
|
||||
run: |
|
||||
cd backend
|
||||
./install.sh --production
|
||||
sudo systemctl restart myp-backend
|
||||
|
||||
deploy-frontend:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@v3
|
||||
- name: Deploy Frontend
|
||||
run: |
|
||||
cd frontend
|
||||
npm install
|
||||
npm run build
|
||||
pm2 restart myp-frontend
|
||||
```
|
||||
|
||||
## 📝 Wartung
|
||||
|
||||
### Regelmäßige Aufgaben
|
||||
|
||||
```bash
|
||||
# Logs rotieren
|
||||
sudo logrotate -f /etc/logrotate.d/myp
|
||||
|
||||
# Dependencies aktualisieren
|
||||
cd backend && pip install -r requirements.txt --upgrade
|
||||
cd frontend && npm update
|
||||
|
||||
# Datenbank-Backup
|
||||
cd backend && cp instance/myp.db backups/myp-$(date +%Y%m%d).db
|
||||
|
||||
# Health-Check-Monitoring
|
||||
curl -f http://localhost:5000/monitoring/health/simple || echo "Backend down"
|
||||
curl -f http://localhost:3000/health || echo "Frontend down"
|
||||
```
|
||||
|
||||
## 📞 Support
|
||||
|
||||
### Kontakt
|
||||
- **Entwickler**: Till Tomczak
|
||||
- **E-Mail**: till.tomczak@mercedes-benz.com
|
||||
- **Repository**: https://github.com/your-org/myp
|
||||
|
||||
### Dokumentation
|
||||
- **Backend-API**: http://localhost:5000/docs (falls Swagger aktiviert)
|
||||
- **Frontend-Dokumentation**: Siehe `frontend/README.md`
|
||||
- **System-Architektur**: Siehe `docs/ARCHITECTURE.md`
|
||||
|
||||
---
|
||||
|
||||
**Hinweis**: Diese Dokumentation beschreibt die neue separate Server-Architektur. Die alte gekoppelte Architektur wird nicht mehr unterstützt.
|
||||
Loading…
x
Reference in New Issue
Block a user