ausgaben-next/DEPLOYMENT.md

# Deployment Guide - Ausgaben-Next

## Lokale Entwicklung

### Voraussetzungen
- Node.js 22+
- MySQL 8+ (Docker container läuft bereits)
- npm oder yarn

### Setup

1. **Dependencies installieren:**
```bash
npm install
```

2. **Umgebungsvariablen konfigurieren:**
```bash
cp .env.example .env
# Bearbeiten Sie .env mit Ihren Datenbankzugangsdaten
```

3. **Development Server starten:**
```bash
npm run dev
```

Die Anwendung ist dann unter http://localhost:3000 erreichbar.

## Production Deployment

### Mit Docker (Empfohlen)

1. **Lokaler Build:**
```bash
docker-compose -f docker-compose.local.yml build
docker-compose -f docker-compose.local.yml up -d
```

Die Anwendung läuft dann auf Port 3001 (konfigurierbar in docker-compose.local.yml).

2. **Logs prüfen:**
```bash
docker logs ausgaben-next-app
```

### Ohne Docker

1. **Production Build:**
```bash
npm run build
```

2. **Production Server starten:**
```bash
npm start
```

## Datenbank

### Schema erstellen

Falls die Tabelle `Ausgaben_Tag` noch nicht existiert:

```bash
mysql -u root -p RXF < create_table.sql
```

### Datenbank-Verbindung

Die Anwendung verwendet die gleiche MySQL-Datenbank wie die alte Ausgaben-Anwendung:

- **Host:** gitea-db (oder localhost für lokale Entwicklung)
- **Database:** RXF
- **Table:** Ausgaben_Tag

Die Zugangsdaten werden über Umgebungsvariablen in `.env` konfiguriert.

## Umgebungsvariablen

Erforderliche Variablen in `.env`:

```env
DB_HOST=gitea-db          # oder localhost für lokale Entwicklung
DB_USER=root
DB_PASS=Ihr_Passwort
DB_NAME=RXF
```

## Port-Konfiguration

- **Development:** Port 3000 (npm run dev)
- **Production (lokal):** Port 3000 (npm start)
- **Docker (lokal):** Port 3001 (gemappt auf internen Port 3000)

Ändern Sie den Port in `docker-compose.local.yml` falls nötig:

```yaml
ports:
  - "0.0.0.0:DEIN_PORT:3000"
```

## Troubleshooting

### Datenbankverbindung schlägt fehl

1. Prüfen Sie die Umgebungsvariablen in `.env`
2. Stellen Sie sicher, dass der MySQL-Container läuft:
   ```bash
   docker ps | grep mysql
   ```
3. Falls Docker verwendet wird, prüfen Sie ob die Container im gleichen Netzwerk sind

### Build-Fehler

1. Löschen Sie `.next` und `node_modules`:
   ```bash
   rm -rf .next node_modules
   npm install
   npm run build
   ```

2. Prüfen Sie die Node.js Version:
   ```bash
   node --version  # Sollte >= 22.x sein
   ```

### Port bereits belegt

Ändern Sie den Port in `docker-compose.local.yml` oder verwenden Sie einen anderen Port:
```bash
PORT=3002 npm run dev
```

## Monitoring

### Logs ansehen

**Docker:**
```bash
docker logs -f ausgaben-next-app
```

**Ohne Docker:**
Logs werden in der Konsole angezeigt wo `npm start` läuft.

## Updates

1. **Code aktualisieren:**
```bash
git pull  # falls Git verwendet wird
```

2. **Dependencies aktualisieren:**
```bash
npm install
```

3. **Neu bauen und starten:**
```bash
npm run build
# Dann entweder:
npm start
# oder:
docker-compose -f docker-compose.local.yml up -d --build
```

## Backup

### Datenbank

Die Datenbank sollte regelmäßig gesichert werden:

```bash
mysqldump -u root -p RXF Ausgaben_Tag > backup_$(date +%Y%m%d).sql
```

### Application Files

Wichtige Dateien für Backup:
- `.env` (Konfiguration)
- `public/` (falls custom Dateien hinzugefügt wurden)
- Die Datenbank (siehe oben)

## Security

1. **Niemals `.env` ins Git-Repository einchecken!**
2. Verwenden Sie starke Datenbankpasswörter
3. Halten Sie Dependencies aktuell:
   ```bash
   npm audit
   npm update
   ```