Merge branch 'feature/telegram-notifications'
This commit is contained in:
commit
46198ddfdd
5
.gitignore
vendored
5
.gitignore
vendored
|
|
@ -9,6 +9,11 @@ node_modules/
|
||||||
.env
|
.env
|
||||||
.env.local
|
.env.local
|
||||||
|
|
||||||
|
# Telegram credentials
|
||||||
|
scripts/.env.telegram
|
||||||
|
scripts/node_modules/
|
||||||
|
scripts/package-lock.json
|
||||||
|
|
||||||
# IDE
|
# IDE
|
||||||
.vscode/
|
.vscode/
|
||||||
.idea/
|
.idea/
|
||||||
|
|
|
||||||
385
FeatureRequests/FEATURE_PLAN-telegram.md
Normal file
385
FeatureRequests/FEATURE_PLAN-telegram.md
Normal file
|
|
@ -0,0 +1,385 @@
|
||||||
|
# Feature Plan: Telegram Bot Integration
|
||||||
|
|
||||||
|
## Übersicht
|
||||||
|
|
||||||
|
Implementierung eines Telegram Bots zur automatischen Benachrichtigung der Werkstatt-Gruppe über wichtige Events im Image Uploader System.
|
||||||
|
|
||||||
|
**Basis:** [FEATURE_REQUEST-telegram.md](./FEATURE_REQUEST-telegram.md)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Phasen-Aufteilung
|
||||||
|
|
||||||
|
### Phase 1: Bot Setup & Standalone-Test
|
||||||
|
**Ziel:** Telegram Bot erstellen und isoliert testen (ohne App-Integration)
|
||||||
|
|
||||||
|
**Status:** 🟢 Abgeschlossen
|
||||||
|
|
||||||
|
**Deliverables:**
|
||||||
|
- [x] Telegram Bot via BotFather erstellt
|
||||||
|
- [x] Bot zu Test-Telegram-Gruppe hinzugefügt
|
||||||
|
- [x] Chat-ID ermittelt
|
||||||
|
- [x] `scripts/telegram-test.js` - Standalone Test-Script
|
||||||
|
- [x] `scripts/README.telegram.md` - Setup-Anleitung
|
||||||
|
- [x] `.env.telegram` - Template für Bot-Credentials
|
||||||
|
- [x] Erfolgreiche Test-Nachricht versendet
|
||||||
|
|
||||||
|
**Akzeptanzkriterium:**
|
||||||
|
✅ Bot sendet erfolgreich Nachricht an Testgruppe
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Phase 2: Backend-Service Integration
|
||||||
|
**Ziel:** TelegramNotificationService in Backend integrieren
|
||||||
|
|
||||||
|
**Status:** 🟢 Abgeschlossen
|
||||||
|
|
||||||
|
**Dependencies:** Phase 1 abgeschlossen
|
||||||
|
|
||||||
|
**Deliverables:**
|
||||||
|
- [x] `backend/src/services/TelegramNotificationService.js`
|
||||||
|
- [x] ENV-Variablen in `docker/dev/backend/config/.env`
|
||||||
|
- [x] Unit-Tests für Service
|
||||||
|
- [x] Docker Dev Environment funktioniert
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Phase 3: Upload-Benachrichtigungen
|
||||||
|
**Ziel:** Automatische Benachrichtigungen bei neuem Upload
|
||||||
|
|
||||||
|
**Status:** 🟢 Abgeschlossen
|
||||||
|
|
||||||
|
**Dependencies:** Phase 2 abgeschlossen
|
||||||
|
|
||||||
|
**Deliverables:**
|
||||||
|
- [x] Integration in `routes/batchUpload.js`
|
||||||
|
- [x] `sendUploadNotification()` Methode
|
||||||
|
- [x] Formatierung mit Icons/Emojis
|
||||||
|
- [x] Integration-Tests
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Phase 4: User-Änderungs-Benachrichtigungen
|
||||||
|
**Ziel:** Benachrichtigungen bei Consent-Änderungen & Löschungen
|
||||||
|
|
||||||
|
**Status:** 🟢 Abgeschlossen
|
||||||
|
|
||||||
|
**Dependencies:** Phase 3 abgeschlossen
|
||||||
|
|
||||||
|
**Deliverables:**
|
||||||
|
- [x] Integration in `routes/management.js` (PUT/DELETE)
|
||||||
|
- [x] `sendConsentChangeNotification()` Methode
|
||||||
|
- [x] `sendGroupDeletedNotification()` Methode
|
||||||
|
- [x] Integration-Tests
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Phase 5: Tägliche Lösch-Warnungen
|
||||||
|
**Ziel:** Cron-Job für bevorstehende Löschungen
|
||||||
|
|
||||||
|
**Status:** 🟢 Abgeschlossen
|
||||||
|
|
||||||
|
**Dependencies:** Phase 4 abgeschlossen
|
||||||
|
|
||||||
|
**Deliverables:**
|
||||||
|
- [x] Cron-Job Setup (node-cron)
|
||||||
|
- [x] `sendDeletionWarning()` Methode
|
||||||
|
- [x] Admin-Route für manuellen Trigger (`POST /api/admin/telegram/warning`)
|
||||||
|
- [x] SchedulerService Integration (09:00 daily)
|
||||||
|
- [x] Docker ENV-Variablen konfiguriert
|
||||||
|
- [x] README.md Update
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Phase 6: Production Deployment
|
||||||
|
**Ziel:** Rollout in Production-Umgebung + ENV-Vereinfachung
|
||||||
|
|
||||||
|
**Status:** 🟢 Abgeschlossen
|
||||||
|
|
||||||
|
**Dependencies:** Phase 1-5 abgeschlossen + getestet
|
||||||
|
|
||||||
|
**Deliverables:**
|
||||||
|
- [x] ENV-Struktur vereinfachen (zu viele .env-Dateien!)
|
||||||
|
- [x] Production ENV-Variablen in docker/prod/.env konfigurieren
|
||||||
|
- [x] docker/prod/docker-compose.yml mit Telegram-ENV erweitern
|
||||||
|
- [x] Consent-Änderung Bug Fix (platform_name statt name)
|
||||||
|
- [x] README.md Update mit ENV-Struktur Dokumentation
|
||||||
|
- ⏭️ Bot in echte Werkstatt-Gruppe einfügen (optional, bei Bedarf)
|
||||||
|
- ⏭️ Production Testing (optional, bei Bedarf)
|
||||||
|
|
||||||
|
**ENV-Vereinfachung (Abgeschlossen):**
|
||||||
|
```
|
||||||
|
Vorher: 16 .env-Dateien mit redundanter Konfiguration
|
||||||
|
Nachher: 2 zentrale .env-Dateien
|
||||||
|
✅ docker/dev/.env (alle dev secrets)
|
||||||
|
✅ docker/prod/.env (alle prod secrets)
|
||||||
|
✅ docker-compose.yml nutzt ${VAR} Platzhalter
|
||||||
|
✅ Gemountete .env-Dateien entfernt (wurden überschrieben)
|
||||||
|
✅ Alle ENV-Variablen in docker-compose environment
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Phase 1 - Detaillierter Plan
|
||||||
|
|
||||||
|
### 1. Vorbereitung (5 min)
|
||||||
|
|
||||||
|
**Auf Windows 11 Host-System:**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Node.js Version prüfen
|
||||||
|
node --version # Sollte >= 18.x sein
|
||||||
|
|
||||||
|
# Projektverzeichnis öffnen
|
||||||
|
cd /home/lotzm/gitea.hobbyhimmel/Project-Image-Uploader/scripts
|
||||||
|
|
||||||
|
# Dependencies installieren (lokal)
|
||||||
|
npm init -y # Falls noch keine package.json
|
||||||
|
npm install node-telegram-bot-api dotenv
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. Telegram Bot erstellen (10 min)
|
||||||
|
|
||||||
|
**Anleitung:** Siehe `scripts/README.telegram.md`
|
||||||
|
|
||||||
|
**Schritte:**
|
||||||
|
1. Telegram öffnen (Windows 11 App)
|
||||||
|
2. [@BotFather](https://t.me/botfather) suchen
|
||||||
|
3. `/newbot` Command
|
||||||
|
4. Bot-Name: "Werkstatt Image Uploader Bot"
|
||||||
|
5. Username: `werkstatt_uploader_bot` (oder verfügbar)
|
||||||
|
6. **Token kopieren** → `.env.telegram`
|
||||||
|
|
||||||
|
### 3. Test-Gruppe erstellen & Bot hinzufügen (5 min)
|
||||||
|
|
||||||
|
**Schritte:**
|
||||||
|
1. Neue Telegram-Gruppe erstellen: "Werkstatt Upload Bot Test"
|
||||||
|
2. Bot zur Gruppe hinzufügen: @werkstatt_uploader_bot
|
||||||
|
3. **Chat-ID ermitteln** (siehe README.telegram.md)
|
||||||
|
4. Chat-ID speichern → `.env.telegram`
|
||||||
|
|
||||||
|
### 4. Test-Script erstellen (10 min)
|
||||||
|
|
||||||
|
**Datei:** `scripts/telegram-test.js`
|
||||||
|
|
||||||
|
**Features:**
|
||||||
|
- Lädt `.env.telegram`
|
||||||
|
- Validiert Bot-Token
|
||||||
|
- Sendet Test-Nachricht
|
||||||
|
- Error-Handling
|
||||||
|
|
||||||
|
### 5. Erste Nachricht senden (2 min)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd scripts
|
||||||
|
node telegram-test.js
|
||||||
|
```
|
||||||
|
|
||||||
|
**Erwartete Ausgabe:**
|
||||||
|
```
|
||||||
|
✅ Telegram Bot erfolgreich verbunden!
|
||||||
|
Bot-Name: Werkstatt Image Uploader Bot
|
||||||
|
Bot-Username: @werkstatt_uploader_bot
|
||||||
|
|
||||||
|
📤 Sende Test-Nachricht an Chat -1001234567890...
|
||||||
|
✅ Nachricht erfolgreich gesendet!
|
||||||
|
```
|
||||||
|
|
||||||
|
**In Telegram-Gruppe:**
|
||||||
|
```
|
||||||
|
🤖 Telegram Bot Test
|
||||||
|
|
||||||
|
Dies ist eine Test-Nachricht vom Werkstatt Image Uploader Bot.
|
||||||
|
|
||||||
|
Status: ✅ Erfolgreich verbunden!
|
||||||
|
Zeitstempel: 2025-11-29 14:23:45
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Dateistruktur (Phase 1)
|
||||||
|
|
||||||
|
```
|
||||||
|
scripts/
|
||||||
|
├── README.telegram.md # Setup-Anleitung (NEU)
|
||||||
|
├── telegram-test.js # Test-Script (NEU)
|
||||||
|
├── .env.telegram.example # ENV-Template (NEU)
|
||||||
|
├── .env.telegram # Echte Credentials (gitignored, NEU)
|
||||||
|
├── package.json # Lokale Dependencies (NEU)
|
||||||
|
└── node_modules/ # npm packages (gitignored)
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Environment Variables (Phase 1)
|
||||||
|
|
||||||
|
**Datei:** `scripts/.env.telegram`
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Telegram Bot Configuration
|
||||||
|
TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrsTUVwxyz
|
||||||
|
TELEGRAM_CHAT_ID=-1001234567890
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Dependencies (Phase 1)
|
||||||
|
|
||||||
|
**Package:** `scripts/package.json`
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"name": "telegram-test-scripts",
|
||||||
|
"version": "1.0.0",
|
||||||
|
"description": "Standalone Telegram Bot Testing",
|
||||||
|
"main": "telegram-test.js",
|
||||||
|
"scripts": {
|
||||||
|
"test": "node telegram-test.js"
|
||||||
|
},
|
||||||
|
"dependencies": {
|
||||||
|
"node-telegram-bot-api": "^0.66.0",
|
||||||
|
"dotenv": "^16.3.1"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Sicherheit (Phase 1)
|
||||||
|
|
||||||
|
**`.gitignore` ergänzen:**
|
||||||
|
|
||||||
|
```
|
||||||
|
# Telegram Credentials
|
||||||
|
scripts/.env.telegram
|
||||||
|
scripts/node_modules/
|
||||||
|
scripts/package-lock.json
|
||||||
|
```
|
||||||
|
|
||||||
|
**Wichtig:**
|
||||||
|
- ❌ Niemals `.env.telegram` committen!
|
||||||
|
- ✅ Nur `.env.telegram.example` (ohne echte Tokens) committen
|
||||||
|
- ✅ Bot-Token regenerieren, falls versehentlich exposed
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Testing Checklist (Phase 1)
|
||||||
|
|
||||||
|
- [x] Node.js Version >= 18.x
|
||||||
|
- [x] Telegram App installiert (Windows 11)
|
||||||
|
- [x] Bot via BotFather erstellt
|
||||||
|
- [x] Bot-Token gespeichert in `.env.telegram`
|
||||||
|
- [x] Test-Gruppe erstellt
|
||||||
|
- [x] Bot zur Gruppe hinzugefügt
|
||||||
|
- [x] Chat-ID ermittelt
|
||||||
|
- [x] Chat-ID gespeichert in `.env.telegram`
|
||||||
|
- [x] Privacy Mode deaktiviert
|
||||||
|
- [x] Test-Nachricht erfolgreich gesendet
|
||||||
|
- [ ] `npm install` erfolgreich
|
||||||
|
- [ ] `node telegram-test.js` läuft ohne Fehler
|
||||||
|
- [ ] Test-Nachricht in Telegram-Gruppe empfangen
|
||||||
|
- [ ] Formatierung (Emojis, Zeilenumbrüche) korrekt
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Troubleshooting (Phase 1)
|
||||||
|
|
||||||
|
### Problem: "Unauthorized (401)"
|
||||||
|
**Lösung:** Bot-Token falsch → BotFather prüfen, `.env.telegram` korrigieren
|
||||||
|
|
||||||
|
### Problem: "Bad Request: chat not found"
|
||||||
|
**Lösung:** Chat-ID falsch → Neue Nachricht in Gruppe senden, Chat-ID neu ermitteln
|
||||||
|
|
||||||
|
### Problem: "ETELEGRAM: 403 Forbidden"
|
||||||
|
**Lösung:** Bot wurde aus Gruppe entfernt → Bot erneut zur Gruppe hinzufügen
|
||||||
|
|
||||||
|
### Problem: "Module not found: node-telegram-bot-api"
|
||||||
|
**Lösung:**
|
||||||
|
```bash
|
||||||
|
cd scripts
|
||||||
|
npm install
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Nächste Schritte (nach Phase 1)
|
||||||
|
|
||||||
|
1. **Code-Review:** `scripts/telegram-test.js`
|
||||||
|
2. **Dokumentation Review:** `scripts/README.telegram.md`
|
||||||
|
3. **Commit:**
|
||||||
|
```bash
|
||||||
|
git add scripts/
|
||||||
|
git commit -m "feat: Add Telegram Bot standalone test (Phase 1)"
|
||||||
|
```
|
||||||
|
4. **Phase 2 starten:** Backend-Integration planen
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Zeitschätzung
|
||||||
|
|
||||||
|
| Phase | Aufwand | Beschreibung |
|
||||||
|
|-------|---------|--------------|
|
||||||
|
| **Phase 1** | **~45 min** | Bot Setup + Standalone-Test |
|
||||||
|
| Phase 2 | ~2h | Backend-Service |
|
||||||
|
| Phase 3 | ~2h | Upload-Benachrichtigungen |
|
||||||
|
| Phase 4 | ~2h | Änderungs-Benachrichtigungen |
|
||||||
|
| Phase 5 | ~2h | Cron-Job |
|
||||||
|
| Phase 6 | ~1h | Production Deployment |
|
||||||
|
| **Gesamt** | **~9-10h** | Vollständige Integration |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Conventional Commits (ab Phase 1)
|
||||||
|
|
||||||
|
**Phase 1:**
|
||||||
|
```bash
|
||||||
|
git commit -m "feat: Add Telegram Bot test script"
|
||||||
|
git commit -m "docs: Add Telegram Bot setup guide"
|
||||||
|
git commit -m "chore: Add node-telegram-bot-api dependency to scripts"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Phase 2:**
|
||||||
|
```bash
|
||||||
|
git commit -m "feat: Add TelegramNotificationService"
|
||||||
|
git commit -m "test: Add TelegramNotificationService unit tests"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Phase 3-6:**
|
||||||
|
```bash
|
||||||
|
git commit -m "feat: Add upload notification to Telegram"
|
||||||
|
git commit -m "feat: Add consent change notifications"
|
||||||
|
git commit -m "feat: Add daily deletion warnings cron job"
|
||||||
|
git commit -m "docs: Update README with Telegram features"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Release-Planung
|
||||||
|
|
||||||
|
**Phase 1:** Kein Release (interne Tests)
|
||||||
|
|
||||||
|
**Phase 6 (Final):**
|
||||||
|
- **Version:** `2.0.0` (Major Release)
|
||||||
|
- **Branch:** `feature/telegram-notifications`
|
||||||
|
- **Release-Command:** `npm run release:major`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Status-Tracking
|
||||||
|
|
||||||
|
**Letzte Aktualisierung:** 2025-11-30
|
||||||
|
|
||||||
|
| Phase | Status | Datum |
|
||||||
|
|-------|--------|-------|
|
||||||
|
| Phase 1 | 🟢 Abgeschlossen | 2025-11-29 |
|
||||||
|
| Phase 2 | 🟢 Abgeschlossen | 2025-11-29 |
|
||||||
|
| Phase 3 | 🟢 Abgeschlossen | 2025-11-29 |
|
||||||
|
| Phase 4 | 🟢 Abgeschlossen | 2025-11-30 |
|
||||||
|
| Phase 5 | 🟢 Abgeschlossen | 2025-11-30 |
|
||||||
|
| Phase 6 | 🟡 ENV vereinfacht | 2025-11-30 |
|
||||||
|
|
||||||
|
**Legende:**
|
||||||
|
- 🟢 Abgeschlossen
|
||||||
|
- 🟡 In Arbeit
|
||||||
|
- 🔴 Blockiert
|
||||||
|
- ⚪ Ausstehend
|
||||||
|
|
@ -302,6 +302,35 @@ describe('Example API', () => {
|
||||||
# 5. Log prüfen: GET http://localhost:5001/api/admin/deletion-log
|
# 5. Log prüfen: GET http://localhost:5001/api/admin/deletion-log
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Telegram-Benachrichtigungen testen
|
||||||
|
|
||||||
|
**Voraussetzung:** Bot-Setup abgeschlossen (siehe `scripts/README.telegram.md`)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 1. ENV-Variablen in docker/dev/backend/config/.env konfigurieren:
|
||||||
|
TELEGRAM_ENABLED=true
|
||||||
|
TELEGRAM_BOT_TOKEN=<dein-bot-token>
|
||||||
|
TELEGRAM_CHAT_ID=<deine-chat-id>
|
||||||
|
|
||||||
|
# 2. Backend neu starten (lädt neue ENV-Variablen):
|
||||||
|
docker compose -f docker/dev/docker-compose.yml restart backend-dev
|
||||||
|
|
||||||
|
# 3. Test-Nachricht wird automatisch beim Server-Start gesendet
|
||||||
|
docker compose -f docker/dev/docker-compose.yml logs -f backend-dev
|
||||||
|
|
||||||
|
# 4. Upload-Benachrichtigung testen (Phase 3+):
|
||||||
|
curl -X POST http://localhost:5001/api/upload-batch \
|
||||||
|
-F "images=@test.jpg" \
|
||||||
|
-F "year=2024" \
|
||||||
|
-F "title=Test Upload" \
|
||||||
|
-F "name=Test User" \
|
||||||
|
-F 'consents={"workshopConsent":true,"socialMediaConsents":[]}'
|
||||||
|
# → Prüfe Telegram-Gruppe auf Benachrichtigung
|
||||||
|
|
||||||
|
# 5. Service manuell deaktivieren:
|
||||||
|
TELEGRAM_ENABLED=false
|
||||||
|
```
|
||||||
|
|
||||||
### API-Tests
|
### API-Tests
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
|
|
|
||||||
78
README.md
78
README.md
|
|
@ -5,6 +5,7 @@ A self-hosted image uploader with multi-image upload capabilities and automatic
|
||||||
## Features
|
## Features
|
||||||
|
|
||||||
**Multi-Image Upload**: Upload multiple images at once with batch processing
|
**Multi-Image Upload**: Upload multiple images at once with batch processing
|
||||||
|
**Telegram Notifications**: 🆕 Real-time notifications for uploads, consent changes, deletions, and daily warnings
|
||||||
**Social Media Consent Management**: 🆕 GDPR-compliant consent system for workshop display and social media publishing
|
**Social Media Consent Management**: 🆕 GDPR-compliant consent system for workshop display and social media publishing
|
||||||
**Automatic Cleanup**: 🆕 Unapproved groups are automatically deleted after 7 days
|
**Automatic Cleanup**: 🆕 Unapproved groups are automatically deleted after 7 days
|
||||||
**Deletion Log**: 🆕 Complete audit trail of automatically deleted content
|
**Deletion Log**: 🆕 Complete audit trail of automatically deleted content
|
||||||
|
|
@ -22,6 +23,18 @@ This project extends the original [Image-Uploader by vallezw](https://github.com
|
||||||
|
|
||||||
### 🆕 Latest Features (November 2025)
|
### 🆕 Latest Features (November 2025)
|
||||||
|
|
||||||
|
- **📱 Telegram Bot Notifications** (Nov 30):
|
||||||
|
- Real-time notifications for all critical events
|
||||||
|
- 4 notification types: Upload, Consent Changes, Group Deletion, Daily Warnings
|
||||||
|
- Upload notifications with name, year, title, image count, and consent status
|
||||||
|
- Consent change tracking (workshop display + social media platforms)
|
||||||
|
- Group deletion confirmations with uploader and statistics
|
||||||
|
- Daily deletion warnings (09:00) for groups pending auto-cleanup (24h notice)
|
||||||
|
- Cron-scheduled automation via node-cron
|
||||||
|
- Admin endpoint for manual trigger: `POST /api/admin/telegram/warning`
|
||||||
|
- Optional feature via `TELEGRAM_ENABLED` environment variable
|
||||||
|
- Complete setup guide in `scripts/README.telegram.md`
|
||||||
|
|
||||||
- **🌐 Public/Internal Host Separation** (Nov 25):
|
- **🌐 Public/Internal Host Separation** (Nov 25):
|
||||||
- Subdomain-based feature separation for production deployment
|
- Subdomain-based feature separation for production deployment
|
||||||
- Public host (`deinprojekt.hobbyhimmel.de`): Upload + UUID Management only
|
- Public host (`deinprojekt.hobbyhimmel.de`): Upload + UUID Management only
|
||||||
|
|
@ -262,31 +275,31 @@ The application automatically generates optimized preview thumbnails for all upl
|
||||||
|
|
||||||
## Docker Structure
|
## Docker Structure
|
||||||
|
|
||||||
The application uses separate Docker configurations for development and production:
|
The application uses separate Docker configurations for development and production with **simplified environment variable management**:
|
||||||
|
|
||||||
```
|
```
|
||||||
docker/
|
docker/
|
||||||
├── .env.backend.example # Backend environment variables documentation
|
├── .env.backend.example # Backend environment variables documentation
|
||||||
├── .env.frontend.example # Frontend environment variables documentation
|
├── .env.frontend.example # Frontend environment variables documentation
|
||||||
├── dev/ # Development environment
|
├── dev/ # Development environment
|
||||||
│ ├── docker-compose.yml # Development services configuration
|
│ ├── .env # 🆕 Central dev secrets (gitignored)
|
||||||
|
│ ├── .env.example # Dev environment template
|
||||||
|
│ ├── docker-compose.yml # All ENV vars defined here
|
||||||
│ ├── backend/
|
│ ├── backend/
|
||||||
│ │ ├── config/.env # Development backend configuration
|
|
||||||
│ │ └── Dockerfile # Development backend container
|
│ │ └── Dockerfile # Development backend container
|
||||||
│ └── frontend/
|
│ └── frontend/
|
||||||
│ ├── config/.env # Development frontend configuration
|
│ ├── config/env.sh # Generates window._env_ from ENV
|
||||||
│ ├── config/env.sh # Runtime configuration script
|
|
||||||
│ ├── Dockerfile # Development frontend container
|
│ ├── Dockerfile # Development frontend container
|
||||||
│ ├── nginx.conf # Development nginx configuration
|
│ ├── nginx.conf # Development nginx configuration
|
||||||
│ └── start.sh # Development startup script
|
│ └── start.sh # Development startup script
|
||||||
└── prod/ # Production environment
|
└── prod/ # Production environment
|
||||||
├── docker-compose.yml # Production services configuration
|
├── .env # 🆕 Central prod secrets (gitignored)
|
||||||
|
├── .env.example # Production environment template
|
||||||
|
├── docker-compose.yml # All ENV vars defined here
|
||||||
├── backend/
|
├── backend/
|
||||||
│ ├── config/.env # Production backend configuration
|
|
||||||
│ └── Dockerfile # Production backend container
|
│ └── Dockerfile # Production backend container
|
||||||
└── frontend/
|
└── frontend/
|
||||||
├── config/.env # Production frontend configuration
|
├── config/env.sh # Generates window._env_ from ENV
|
||||||
├── config/env.sh # Runtime configuration script
|
|
||||||
├── config/htpasswd # HTTP Basic Auth credentials
|
├── config/htpasswd # HTTP Basic Auth credentials
|
||||||
├── Dockerfile # Production frontend container
|
├── Dockerfile # Production frontend container
|
||||||
└── nginx.conf # Production nginx configuration
|
└── nginx.conf # Production nginx configuration
|
||||||
|
|
@ -294,6 +307,20 @@ docker/
|
||||||
|
|
||||||
### Environment Configuration
|
### Environment Configuration
|
||||||
|
|
||||||
|
**🆕 Simplified ENV Structure (Nov 2025):**
|
||||||
|
- **2 central `.env` files** (down from 16 files!)
|
||||||
|
- `docker/dev/.env` - All development secrets
|
||||||
|
- `docker/prod/.env` - All production secrets
|
||||||
|
- **docker-compose.yml** - All environment variables defined in `environment:` sections
|
||||||
|
- **No .env files in Docker images** - All configuration via docker-compose
|
||||||
|
- **Frontend env.sh** - Generates `window._env_` JavaScript object from ENV variables at runtime
|
||||||
|
|
||||||
|
**How it works:**
|
||||||
|
1. Docker Compose automatically reads `.env` from the same directory
|
||||||
|
2. Variables are injected into containers via `environment:` sections using `${VAR}` placeholders
|
||||||
|
3. Frontend `env.sh` script reads ENV variables and generates JavaScript config at container startup
|
||||||
|
4. Secrets stay in gitignored `.env` files, never in code or images
|
||||||
|
|
||||||
- **Development**: Uses `docker/dev/` configuration with live reloading
|
- **Development**: Uses `docker/dev/` configuration with live reloading
|
||||||
- **Production**: Uses `docker/prod/` configuration with optimized builds
|
- **Production**: Uses `docker/prod/` configuration with optimized builds
|
||||||
- **Scripts**: Use `./dev.sh` or `./prod.sh` for easy deployment
|
- **Scripts**: Use `./dev.sh` or `./prod.sh` for easy deployment
|
||||||
|
|
@ -591,12 +618,41 @@ The application includes comprehensive testing tools for the automatic cleanup f
|
||||||
For detailed testing instructions, see: [`tests/TESTING-CLEANUP.md`](tests/TESTING-CLEANUP.md)
|
For detailed testing instructions, see: [`tests/TESTING-CLEANUP.md`](tests/TESTING-CLEANUP.md)
|
||||||
|
|
||||||
## Configuration
|
## Configuration
|
||||||
|
|
||||||
### Environment Variables
|
### Environment Variables
|
||||||
|
|
||||||
|
**Simplified ENV Management (Nov 2025):**
|
||||||
|
All environment variables are now managed through **2 central `.env` files** and `docker-compose.yml`:
|
||||||
|
|
||||||
|
**Core Variables:**
|
||||||
| Variable | Default | Description |
|
| Variable | Default | Description |
|
||||||
|----------|---------|-------------|
|
|----------|---------|-------------|
|
||||||
| `API_URL` | `http://localhost:5001` | Backend API endpoint |
|
| `API_URL` | `http://localhost:5001` | Backend API endpoint (frontend → backend) |
|
||||||
| `CLIENT_URL` | `http://localhost` | Frontend application URL |
|
| `PUBLIC_HOST` | `public.test.local` | Public upload subdomain (no admin access) |
|
||||||
|
| `INTERNAL_HOST` | `internal.test.local` | Internal admin subdomain (full access) |
|
||||||
|
| `ADMIN_SESSION_SECRET` | - | Secret for admin session cookies (required) |
|
||||||
|
|
||||||
|
**Telegram Notifications (Optional):**
|
||||||
|
| Variable | Default | Description |
|
||||||
|
|----------|---------|-------------|
|
||||||
|
| `TELEGRAM_ENABLED` | `false` | Enable/disable Telegram notifications |
|
||||||
|
| `TELEGRAM_BOT_TOKEN` | - | Telegram Bot API token (from @BotFather) |
|
||||||
|
| `TELEGRAM_CHAT_ID` | - | Telegram chat/group ID for notifications |
|
||||||
|
| `TELEGRAM_SEND_TEST_ON_START` | `false` | Send test message on service startup (dev only) |
|
||||||
|
|
||||||
|
**Configuration Files:**
|
||||||
|
- `docker/dev/.env` - Development secrets (gitignored)
|
||||||
|
- `docker/prod/.env` - Production secrets (gitignored)
|
||||||
|
- `docker/dev/.env.example` - Development template (committed)
|
||||||
|
- `docker/prod/.env.example` - Production template (committed)
|
||||||
|
|
||||||
|
**How to configure:**
|
||||||
|
1. Copy `.env.example` to `.env` in the respective environment folder
|
||||||
|
2. Edit `.env` and set your secrets (ADMIN_SESSION_SECRET, Telegram tokens, etc.)
|
||||||
|
3. Docker Compose automatically reads `.env` and injects variables into containers
|
||||||
|
4. Never commit `.env` files (already in `.gitignore`)
|
||||||
|
|
||||||
|
**Telegram Setup:** See `scripts/README.telegram.md` for complete configuration guide.
|
||||||
|
|
||||||
### Volume Configuration
|
### Volume Configuration
|
||||||
- **Upload Limits**: 100MB maximum file size for batch uploads
|
- **Upload Limits**: 100MB maximum file size for batch uploads
|
||||||
|
|
|
||||||
|
|
@ -39,6 +39,9 @@
|
||||||
{
|
{
|
||||||
"name": "Admin - Cleanup"
|
"name": "Admin - Cleanup"
|
||||||
},
|
},
|
||||||
|
{
|
||||||
|
"name": "Admin - Telegram"
|
||||||
|
},
|
||||||
{
|
{
|
||||||
"name": "Admin - Monitoring"
|
"name": "Admin - Monitoring"
|
||||||
},
|
},
|
||||||
|
|
@ -385,6 +388,15 @@
|
||||||
},
|
},
|
||||||
"description": {
|
"description": {
|
||||||
"example": "any"
|
"example": "any"
|
||||||
|
},
|
||||||
|
"year": {
|
||||||
|
"example": "any"
|
||||||
|
},
|
||||||
|
"title": {
|
||||||
|
"example": "any"
|
||||||
|
},
|
||||||
|
"name": {
|
||||||
|
"example": "any"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
@ -1058,22 +1070,38 @@
|
||||||
},
|
},
|
||||||
"/api/manage/{token}/reorder": {
|
"/api/manage/{token}/reorder": {
|
||||||
"put": {
|
"put": {
|
||||||
"description": "",
|
"tags": [
|
||||||
|
"Management Portal"
|
||||||
|
],
|
||||||
|
"summary": "Reorder images in group",
|
||||||
|
"description": "Reorder images within the managed group (token-based access)",
|
||||||
"parameters": [
|
"parameters": [
|
||||||
{
|
{
|
||||||
"name": "token",
|
"name": "token",
|
||||||
"in": "path",
|
"in": "path",
|
||||||
"required": true,
|
"required": true,
|
||||||
"type": "string"
|
"type": "string",
|
||||||
|
"description": "Management token (UUID v4)",
|
||||||
|
"example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
"name": "body",
|
"name": "body",
|
||||||
"in": "body",
|
"in": "body",
|
||||||
|
"required": true,
|
||||||
"schema": {
|
"schema": {
|
||||||
"type": "object",
|
"type": "object",
|
||||||
"properties": {
|
"properties": {
|
||||||
"imageIds": {
|
"imageIds": {
|
||||||
"example": "any"
|
"type": "array",
|
||||||
|
"example": [
|
||||||
|
1,
|
||||||
|
3,
|
||||||
|
2,
|
||||||
|
4
|
||||||
|
],
|
||||||
|
"items": {
|
||||||
|
"type": "number"
|
||||||
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
@ -1081,13 +1109,29 @@
|
||||||
],
|
],
|
||||||
"responses": {
|
"responses": {
|
||||||
"200": {
|
"200": {
|
||||||
"description": "OK"
|
"description": "Images reordered successfully",
|
||||||
|
"schema": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"success": {
|
||||||
|
"type": "boolean",
|
||||||
|
"example": true
|
||||||
|
},
|
||||||
|
"updatedCount": {
|
||||||
|
"type": "number",
|
||||||
|
"example": 4
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"xml": {
|
||||||
|
"name": "main"
|
||||||
|
}
|
||||||
|
}
|
||||||
},
|
},
|
||||||
"400": {
|
"400": {
|
||||||
"description": "Bad Request"
|
"description": "Invalid token format or imageIds"
|
||||||
},
|
},
|
||||||
"404": {
|
"404": {
|
||||||
"description": "Not Found"
|
"description": "Token not found or group deleted"
|
||||||
},
|
},
|
||||||
"429": {
|
"429": {
|
||||||
"description": "Too Many Requests"
|
"description": "Too Many Requests"
|
||||||
|
|
@ -1151,25 +1195,46 @@
|
||||||
},
|
},
|
||||||
"/api/admin/groups/{groupId}/consents": {
|
"/api/admin/groups/{groupId}/consents": {
|
||||||
"post": {
|
"post": {
|
||||||
"description": "",
|
"tags": [
|
||||||
|
"Consent Management"
|
||||||
|
],
|
||||||
|
"summary": "Save or update consents for a group",
|
||||||
|
"description": "Store workshop consent and social media consents for a specific group",
|
||||||
"parameters": [
|
"parameters": [
|
||||||
{
|
{
|
||||||
"name": "groupId",
|
"name": "groupId",
|
||||||
"in": "path",
|
"in": "path",
|
||||||
"required": true,
|
"required": true,
|
||||||
"type": "string"
|
"type": "string",
|
||||||
|
"description": "Group ID",
|
||||||
|
"example": "abc123def456"
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
"name": "body",
|
"name": "body",
|
||||||
"in": "body",
|
"in": "body",
|
||||||
|
"required": true,
|
||||||
"schema": {
|
"schema": {
|
||||||
"type": "object",
|
"type": "object",
|
||||||
"properties": {
|
"properties": {
|
||||||
"workshopConsent": {
|
"workshopConsent": {
|
||||||
"example": "any"
|
"type": "boolean",
|
||||||
|
"example": true
|
||||||
},
|
},
|
||||||
"socialMediaConsents": {
|
"socialMediaConsents": {
|
||||||
"example": "any"
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"platformId": {
|
||||||
|
"type": "number",
|
||||||
|
"example": 2
|
||||||
|
},
|
||||||
|
"consented": {
|
||||||
|
"type": "boolean",
|
||||||
|
"example": false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
@ -1177,10 +1242,26 @@
|
||||||
],
|
],
|
||||||
"responses": {
|
"responses": {
|
||||||
"200": {
|
"200": {
|
||||||
"description": "OK"
|
"description": "Consents saved successfully",
|
||||||
|
"schema": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"success": {
|
||||||
|
"type": "boolean",
|
||||||
|
"example": true
|
||||||
|
},
|
||||||
|
"message": {
|
||||||
|
"type": "string",
|
||||||
|
"example": "Consents saved successfully"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"xml": {
|
||||||
|
"name": "main"
|
||||||
|
}
|
||||||
|
}
|
||||||
},
|
},
|
||||||
"400": {
|
"400": {
|
||||||
"description": "Bad Request"
|
"description": "Invalid request data"
|
||||||
},
|
},
|
||||||
"403": {
|
"403": {
|
||||||
"description": "Forbidden"
|
"description": "Forbidden"
|
||||||
|
|
@ -1717,6 +1798,46 @@
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
|
"/api/admin/telegram/warning": {
|
||||||
|
"post": {
|
||||||
|
"tags": [
|
||||||
|
"Admin - Telegram"
|
||||||
|
],
|
||||||
|
"summary": "Manually trigger Telegram deletion warning",
|
||||||
|
"description": "Sends deletion warning to Telegram for testing (normally runs daily at 09:00)",
|
||||||
|
"responses": {
|
||||||
|
"200": {
|
||||||
|
"description": "Warning sent successfully",
|
||||||
|
"schema": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"success": {
|
||||||
|
"type": "boolean",
|
||||||
|
"example": true
|
||||||
|
},
|
||||||
|
"groupsWarned": {
|
||||||
|
"type": "number",
|
||||||
|
"example": 2
|
||||||
|
},
|
||||||
|
"message": {
|
||||||
|
"type": "string",
|
||||||
|
"example": "Deletion warning sent for 2 groups"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"xml": {
|
||||||
|
"name": "main"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"403": {
|
||||||
|
"description": "Forbidden"
|
||||||
|
},
|
||||||
|
"500": {
|
||||||
|
"description": "Internal Server Error"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
"/api/admin/cleanup/preview": {
|
"/api/admin/cleanup/preview": {
|
||||||
"get": {
|
"get": {
|
||||||
"tags": [
|
"tags": [
|
||||||
|
|
|
||||||
|
|
@ -26,5 +26,9 @@ module.exports = {
|
||||||
// Run tests serially to avoid DB conflicts
|
// Run tests serially to avoid DB conflicts
|
||||||
maxWorkers: 1,
|
maxWorkers: 1,
|
||||||
// Force exit after tests complete
|
// Force exit after tests complete
|
||||||
forceExit: true
|
forceExit: true,
|
||||||
|
// Transform ESM modules in node_modules
|
||||||
|
transformIgnorePatterns: [
|
||||||
|
'node_modules/(?!(uuid)/)'
|
||||||
|
]
|
||||||
};
|
};
|
||||||
|
|
|
||||||
|
|
@ -31,6 +31,7 @@
|
||||||
"find-remove": "^2.0.3",
|
"find-remove": "^2.0.3",
|
||||||
"fs": "^0.0.1-security",
|
"fs": "^0.0.1-security",
|
||||||
"node-cron": "^4.2.1",
|
"node-cron": "^4.2.1",
|
||||||
|
"node-telegram-bot-api": "^0.66.0",
|
||||||
"sharp": "^0.34.4",
|
"sharp": "^0.34.4",
|
||||||
"shortid": "^2.2.16",
|
"shortid": "^2.2.16",
|
||||||
"sqlite3": "^5.1.7",
|
"sqlite3": "^5.1.7",
|
||||||
|
|
|
||||||
|
|
@ -237,6 +237,46 @@ router.post('/cleanup/trigger', async (req, res) => {
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
|
|
||||||
|
router.post('/telegram/warning', async (req, res) => {
|
||||||
|
/*
|
||||||
|
#swagger.tags = ['Admin - Telegram']
|
||||||
|
#swagger.summary = 'Manually trigger Telegram deletion warning'
|
||||||
|
#swagger.description = 'Sends deletion warning to Telegram for testing (normally runs daily at 09:00)'
|
||||||
|
#swagger.responses[200] = {
|
||||||
|
description: 'Warning sent successfully',
|
||||||
|
schema: {
|
||||||
|
success: true,
|
||||||
|
groupsWarned: 2,
|
||||||
|
message: 'Deletion warning sent for 2 groups'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
*/
|
||||||
|
try {
|
||||||
|
const schedulerService = req.app.get('schedulerService');
|
||||||
|
|
||||||
|
if (!schedulerService) {
|
||||||
|
return res.status(500).json({
|
||||||
|
success: false,
|
||||||
|
message: 'Scheduler service not available'
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
const result = await schedulerService.triggerTelegramWarningNow();
|
||||||
|
|
||||||
|
res.json({
|
||||||
|
success: true,
|
||||||
|
groupsWarned: result.groupCount,
|
||||||
|
message: result.message
|
||||||
|
});
|
||||||
|
} catch (error) {
|
||||||
|
console.error('[Admin API] Error triggering Telegram warning:', error);
|
||||||
|
res.status(500).json({
|
||||||
|
error: 'Internal server error',
|
||||||
|
message: error.message
|
||||||
|
});
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
router.get('/cleanup/preview', async (req, res) => {
|
router.get('/cleanup/preview', async (req, res) => {
|
||||||
/*
|
/*
|
||||||
#swagger.tags = ['Admin - Cleanup']
|
#swagger.tags = ['Admin - Cleanup']
|
||||||
|
|
|
||||||
|
|
@ -6,6 +6,10 @@ const UploadGroup = require('../models/uploadGroup');
|
||||||
const groupRepository = require('../repositories/GroupRepository');
|
const groupRepository = require('../repositories/GroupRepository');
|
||||||
const dbManager = require('../database/DatabaseManager');
|
const dbManager = require('../database/DatabaseManager');
|
||||||
const ImagePreviewService = require('../services/ImagePreviewService');
|
const ImagePreviewService = require('../services/ImagePreviewService');
|
||||||
|
const TelegramNotificationService = require('../services/TelegramNotificationService');
|
||||||
|
|
||||||
|
// Singleton-Instanz des Telegram Service
|
||||||
|
const telegramService = new TelegramNotificationService();
|
||||||
|
|
||||||
const router = Router();
|
const router = Router();
|
||||||
|
|
||||||
|
|
@ -117,6 +121,12 @@ router.post('/upload/batch', async (req, res) => {
|
||||||
consents = {};
|
consents = {};
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Merge separate form fields into metadata (backwards compatibility)
|
||||||
|
if (req.body.year) metadata.year = parseInt(req.body.year);
|
||||||
|
if (req.body.title) metadata.title = req.body.title;
|
||||||
|
if (req.body.name) metadata.name = req.body.name;
|
||||||
|
if (req.body.description) metadata.description = req.body.description;
|
||||||
|
|
||||||
// Validiere Workshop Consent (Pflichtfeld)
|
// Validiere Workshop Consent (Pflichtfeld)
|
||||||
if (!consents.workshopConsent) {
|
if (!consents.workshopConsent) {
|
||||||
return res.status(400).json({
|
return res.status(400).json({
|
||||||
|
|
@ -229,6 +239,22 @@ router.post('/upload/batch', async (req, res) => {
|
||||||
|
|
||||||
console.log(`Successfully saved group ${group.groupId} with ${files.length} images to database`);
|
console.log(`Successfully saved group ${group.groupId} with ${files.length} images to database`);
|
||||||
|
|
||||||
|
// Sende Telegram-Benachrichtigung (async, non-blocking)
|
||||||
|
if (telegramService.isAvailable()) {
|
||||||
|
telegramService.sendUploadNotification({
|
||||||
|
name: group.name,
|
||||||
|
year: group.year,
|
||||||
|
title: group.title,
|
||||||
|
imageCount: files.length,
|
||||||
|
workshopConsent: consents.workshopConsent,
|
||||||
|
socialMediaConsents: consents.socialMediaConsents || [],
|
||||||
|
token: createResult.managementToken
|
||||||
|
}).catch(err => {
|
||||||
|
// Fehler loggen, aber Upload nicht fehlschlagen lassen
|
||||||
|
console.error('[Telegram] Upload notification failed:', err.message);
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
// Erfolgreiche Antwort mit Management-Token
|
// Erfolgreiche Antwort mit Management-Token
|
||||||
res.json({
|
res.json({
|
||||||
groupId: group.groupId,
|
groupId: group.groupId,
|
||||||
|
|
|
||||||
|
|
@ -58,16 +58,37 @@ router.get('/social-media/platforms', async (req, res) => {
|
||||||
// Group Consents
|
// Group Consents
|
||||||
// ============================================================================
|
// ============================================================================
|
||||||
|
|
||||||
/**
|
|
||||||
* POST /groups/:groupId/consents
|
|
||||||
* Speichere oder aktualisiere Consents für eine Gruppe
|
|
||||||
*
|
|
||||||
* Body: {
|
|
||||||
* workshopConsent: boolean,
|
|
||||||
* socialMediaConsents: [{ platformId: number, consented: boolean }]
|
|
||||||
* }
|
|
||||||
*/
|
|
||||||
router.post('/groups/:groupId/consents', async (req, res) => {
|
router.post('/groups/:groupId/consents', async (req, res) => {
|
||||||
|
/*
|
||||||
|
#swagger.tags = ['Consent Management']
|
||||||
|
#swagger.summary = 'Save or update consents for a group'
|
||||||
|
#swagger.description = 'Store workshop consent and social media consents for a specific group'
|
||||||
|
#swagger.parameters['groupId'] = {
|
||||||
|
in: 'path',
|
||||||
|
required: true,
|
||||||
|
type: 'string',
|
||||||
|
description: 'Group ID',
|
||||||
|
example: 'abc123def456'
|
||||||
|
}
|
||||||
|
#swagger.parameters['body'] = {
|
||||||
|
in: 'body',
|
||||||
|
required: true,
|
||||||
|
schema: {
|
||||||
|
workshopConsent: true,
|
||||||
|
socialMediaConsents: [
|
||||||
|
{ platformId: 1, consented: true },
|
||||||
|
{ platformId: 2, consented: false }
|
||||||
|
]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
#swagger.responses[200] = {
|
||||||
|
description: 'Consents saved successfully',
|
||||||
|
schema: { success: true, message: 'Consents saved successfully' }
|
||||||
|
}
|
||||||
|
#swagger.responses[400] = {
|
||||||
|
description: 'Invalid request data'
|
||||||
|
}
|
||||||
|
*/
|
||||||
try {
|
try {
|
||||||
const { groupId } = req.params;
|
const { groupId } = req.params;
|
||||||
const { workshopConsent, socialMediaConsents } = req.body;
|
const { workshopConsent, socialMediaConsents } = req.body;
|
||||||
|
|
|
||||||
|
|
@ -5,6 +5,10 @@ const deletionLogRepository = require('../repositories/DeletionLogRepository');
|
||||||
const dbManager = require('../database/DatabaseManager');
|
const dbManager = require('../database/DatabaseManager');
|
||||||
const { rateLimitMiddleware, recordFailedTokenValidation } = require('../middlewares/rateLimiter');
|
const { rateLimitMiddleware, recordFailedTokenValidation } = require('../middlewares/rateLimiter');
|
||||||
const auditLogMiddleware = require('../middlewares/auditLog');
|
const auditLogMiddleware = require('../middlewares/auditLog');
|
||||||
|
const TelegramNotificationService = require('../services/TelegramNotificationService');
|
||||||
|
|
||||||
|
// Singleton-Instanz des Telegram Service
|
||||||
|
const telegramService = new TelegramNotificationService();
|
||||||
|
|
||||||
// Apply middleware to all management routes
|
// Apply middleware to all management routes
|
||||||
router.use(rateLimitMiddleware);
|
router.use(rateLimitMiddleware);
|
||||||
|
|
@ -211,6 +215,20 @@ router.put('/:token/consents', async (req, res) => {
|
||||||
[newValue, groupData.groupId]
|
[newValue, groupData.groupId]
|
||||||
);
|
);
|
||||||
|
|
||||||
|
// Sende Telegram-Benachrichtigung (async, non-blocking)
|
||||||
|
if (telegramService.isAvailable()) {
|
||||||
|
telegramService.sendConsentChangeNotification({
|
||||||
|
name: groupData.name,
|
||||||
|
year: groupData.year,
|
||||||
|
title: groupData.title,
|
||||||
|
consentType: 'workshop',
|
||||||
|
action: action,
|
||||||
|
newValue: newValue === 1
|
||||||
|
}).catch(err => {
|
||||||
|
console.error('[Telegram] Consent change notification failed:', err.message);
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
return res.json({
|
return res.json({
|
||||||
success: true,
|
success: true,
|
||||||
message: `Workshop consent ${action}d successfully`,
|
message: `Workshop consent ${action}d successfully`,
|
||||||
|
|
@ -263,6 +281,26 @@ router.put('/:token/consents', async (req, res) => {
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Sende Telegram-Benachrichtigung (async, non-blocking)
|
||||||
|
if (telegramService.isAvailable()) {
|
||||||
|
// Hole Platform-Name für Benachrichtigung
|
||||||
|
const platform = await dbManager.get(
|
||||||
|
'SELECT platform_name FROM social_media_platforms WHERE id = ?',
|
||||||
|
[platformId]
|
||||||
|
);
|
||||||
|
|
||||||
|
telegramService.sendConsentChangeNotification({
|
||||||
|
name: groupData.name,
|
||||||
|
year: groupData.year,
|
||||||
|
title: groupData.title,
|
||||||
|
consentType: 'social_media',
|
||||||
|
action: action,
|
||||||
|
platform: platform ? platform.platform_name : `Platform ${platformId}`
|
||||||
|
}).catch(err => {
|
||||||
|
console.error('[Telegram] Consent change notification failed:', err.message);
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
return res.json({
|
return res.json({
|
||||||
success: true,
|
success: true,
|
||||||
message: `Social media consent ${action}d successfully`,
|
message: `Social media consent ${action}d successfully`,
|
||||||
|
|
@ -1007,6 +1045,18 @@ router.delete('/:token', async (req, res) => {
|
||||||
|
|
||||||
console.log(`✓ Group ${groupId} deleted via management token (${imageCount} images)`);
|
console.log(`✓ Group ${groupId} deleted via management token (${imageCount} images)`);
|
||||||
|
|
||||||
|
// Sende Telegram-Benachrichtigung (async, non-blocking)
|
||||||
|
if (telegramService.isAvailable()) {
|
||||||
|
telegramService.sendGroupDeletedNotification({
|
||||||
|
name: groupData.name,
|
||||||
|
year: groupData.year,
|
||||||
|
title: groupData.title,
|
||||||
|
imageCount: imageCount
|
||||||
|
}).catch(err => {
|
||||||
|
console.error('[Telegram] Group deletion notification failed:', err.message);
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
res.json({
|
res.json({
|
||||||
success: true,
|
success: true,
|
||||||
message: 'Group and all associated data deleted successfully',
|
message: 'Group and all associated data deleted successfully',
|
||||||
|
|
@ -1026,18 +1076,36 @@ router.delete('/:token', async (req, res) => {
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
|
|
||||||
/**
|
|
||||||
* PUT /api/manage/:token/reorder
|
|
||||||
* Reorder images within the managed group (token-based access)
|
|
||||||
*
|
|
||||||
* @param {string} token - Management token (UUID v4)
|
|
||||||
* @param {number[]} imageIds - Array of image IDs in new order
|
|
||||||
* @returns {Object} Success status and updated image count
|
|
||||||
* @throws {400} Invalid token format or imageIds
|
|
||||||
* @throws {404} Token not found or group deleted
|
|
||||||
* @throws {500} Server error
|
|
||||||
*/
|
|
||||||
router.put('/:token/reorder', async (req, res) => {
|
router.put('/:token/reorder', async (req, res) => {
|
||||||
|
/*
|
||||||
|
#swagger.tags = ['Management Portal']
|
||||||
|
#swagger.summary = 'Reorder images in group'
|
||||||
|
#swagger.description = 'Reorder images within the managed group (token-based access)'
|
||||||
|
#swagger.parameters['token'] = {
|
||||||
|
in: 'path',
|
||||||
|
required: true,
|
||||||
|
type: 'string',
|
||||||
|
description: 'Management token (UUID v4)',
|
||||||
|
example: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'
|
||||||
|
}
|
||||||
|
#swagger.parameters['body'] = {
|
||||||
|
in: 'body',
|
||||||
|
required: true,
|
||||||
|
schema: {
|
||||||
|
imageIds: [1, 3, 2, 4]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
#swagger.responses[200] = {
|
||||||
|
description: 'Images reordered successfully',
|
||||||
|
schema: { success: true, updatedCount: 4 }
|
||||||
|
}
|
||||||
|
#swagger.responses[400] = {
|
||||||
|
description: 'Invalid token format or imageIds'
|
||||||
|
}
|
||||||
|
#swagger.responses[404] = {
|
||||||
|
description: 'Token not found or group deleted'
|
||||||
|
}
|
||||||
|
*/
|
||||||
try {
|
try {
|
||||||
const { token } = req.params;
|
const { token } = req.params;
|
||||||
const { imageIds } = req.body;
|
const { imageIds } = req.body;
|
||||||
|
|
|
||||||
|
|
@ -4,6 +4,10 @@ const path = require('path');
|
||||||
const initiateResources = require('./utils/initiate-resources');
|
const initiateResources = require('./utils/initiate-resources');
|
||||||
const dbManager = require('./database/DatabaseManager');
|
const dbManager = require('./database/DatabaseManager');
|
||||||
const SchedulerService = require('./services/SchedulerService');
|
const SchedulerService = require('./services/SchedulerService');
|
||||||
|
const TelegramNotificationService = require('./services/TelegramNotificationService');
|
||||||
|
|
||||||
|
// Singleton-Instanz des Telegram Service
|
||||||
|
const telegramService = new TelegramNotificationService();
|
||||||
|
|
||||||
// Dev: Swagger UI (mount only in non-production) — require lazily
|
// Dev: Swagger UI (mount only in non-production) — require lazily
|
||||||
let swaggerUi = null;
|
let swaggerUi = null;
|
||||||
|
|
@ -78,8 +82,19 @@ class Server {
|
||||||
console.log(`✅ Server läuft auf Port ${this._port}`);
|
console.log(`✅ Server läuft auf Port ${this._port}`);
|
||||||
console.log(`📊 SQLite Datenbank aktiv`);
|
console.log(`📊 SQLite Datenbank aktiv`);
|
||||||
|
|
||||||
|
// Speichere SchedulerService in app für Admin-Endpoints
|
||||||
|
this._app.set('schedulerService', SchedulerService);
|
||||||
|
|
||||||
// Starte Scheduler für automatisches Cleanup
|
// Starte Scheduler für automatisches Cleanup
|
||||||
SchedulerService.start();
|
SchedulerService.start();
|
||||||
|
|
||||||
|
// Teste Telegram-Service (optional, nur in Development wenn aktiviert)
|
||||||
|
if (process.env.NODE_ENV === 'development'
|
||||||
|
&& process.env.TELEGRAM_SEND_TEST_ON_START === 'true'
|
||||||
|
&& telegramService.isAvailable()) {
|
||||||
|
telegramService.sendTestMessage()
|
||||||
|
.catch(err => console.error('[Telegram] Test message failed:', err.message));
|
||||||
|
}
|
||||||
});
|
});
|
||||||
} catch (error) {
|
} catch (error) {
|
||||||
console.error('💥 Fehler beim Serverstart:', error);
|
console.error('💥 Fehler beim Serverstart:', error);
|
||||||
|
|
|
||||||
|
|
@ -1,9 +1,11 @@
|
||||||
const cron = require('node-cron');
|
const cron = require('node-cron');
|
||||||
const GroupCleanupService = require('./GroupCleanupService');
|
const GroupCleanupService = require('./GroupCleanupService');
|
||||||
|
const TelegramNotificationService = require('./TelegramNotificationService');
|
||||||
|
|
||||||
class SchedulerService {
|
class SchedulerService {
|
||||||
constructor() {
|
constructor() {
|
||||||
this.tasks = [];
|
this.tasks = [];
|
||||||
|
this.telegramService = new TelegramNotificationService();
|
||||||
}
|
}
|
||||||
|
|
||||||
start() {
|
start() {
|
||||||
|
|
@ -30,7 +32,35 @@ class SchedulerService {
|
||||||
|
|
||||||
this.tasks.push(cleanupTask);
|
this.tasks.push(cleanupTask);
|
||||||
|
|
||||||
console.log('✓ Scheduler started - Daily cleanup at 10:00 AM (Europe/Berlin)');
|
// Telegram Warning-Job: Jeden Tag um 09:00 Uhr (1 Stunde vor Cleanup)
|
||||||
|
const telegramWarningTask = cron.schedule('0 9 * * *', async () => {
|
||||||
|
console.log('[Scheduler] Running daily Telegram deletion warning at 09:00 AM...');
|
||||||
|
try {
|
||||||
|
if (this.telegramService.isAvailable()) {
|
||||||
|
const groupsForDeletion = await GroupCleanupService.findGroupsForDeletion();
|
||||||
|
|
||||||
|
if (groupsForDeletion && groupsForDeletion.length > 0) {
|
||||||
|
await this.telegramService.sendDeletionWarning(groupsForDeletion);
|
||||||
|
console.log(`[Scheduler] Sent deletion warning for ${groupsForDeletion.length} groups`);
|
||||||
|
} else {
|
||||||
|
console.log('[Scheduler] No groups pending deletion');
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
console.log('[Scheduler] Telegram service not available, skipping warning');
|
||||||
|
}
|
||||||
|
} catch (error) {
|
||||||
|
console.error('[Scheduler] Telegram warning task failed:', error);
|
||||||
|
}
|
||||||
|
}, {
|
||||||
|
scheduled: true,
|
||||||
|
timezone: "Europe/Berlin"
|
||||||
|
});
|
||||||
|
|
||||||
|
this.tasks.push(telegramWarningTask);
|
||||||
|
|
||||||
|
console.log('✓ Scheduler started:');
|
||||||
|
console.log(' - Daily cleanup at 10:00 AM (Europe/Berlin)');
|
||||||
|
console.log(' - Daily Telegram warning at 09:00 AM (Europe/Berlin)');
|
||||||
|
|
||||||
// Für Development: Manueller Trigger
|
// Für Development: Manueller Trigger
|
||||||
if (process.env.NODE_ENV === 'development') {
|
if (process.env.NODE_ENV === 'development') {
|
||||||
|
|
@ -50,6 +80,42 @@ class SchedulerService {
|
||||||
console.log('[Scheduler] Manual cleanup triggered...');
|
console.log('[Scheduler] Manual cleanup triggered...');
|
||||||
return await GroupCleanupService.performScheduledCleanup();
|
return await GroupCleanupService.performScheduledCleanup();
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Für Development: Manueller Telegram-Warning-Trigger
|
||||||
|
async triggerTelegramWarningNow() {
|
||||||
|
console.log('[Scheduler] Manual Telegram warning triggered...');
|
||||||
|
try {
|
||||||
|
if (!this.telegramService.isAvailable()) {
|
||||||
|
console.log('[Scheduler] Telegram service not available');
|
||||||
|
return { success: false, message: 'Telegram service not available' };
|
||||||
|
}
|
||||||
|
|
||||||
|
const groupsForDeletion = await GroupCleanupService.findGroupsForDeletion();
|
||||||
|
|
||||||
|
if (!groupsForDeletion || groupsForDeletion.length === 0) {
|
||||||
|
console.log('[Scheduler] No groups pending deletion');
|
||||||
|
return { success: true, message: 'No groups pending deletion', groupCount: 0 };
|
||||||
|
}
|
||||||
|
|
||||||
|
await this.telegramService.sendDeletionWarning(groupsForDeletion);
|
||||||
|
console.log(`[Scheduler] Sent deletion warning for ${groupsForDeletion.length} groups`);
|
||||||
|
|
||||||
|
return {
|
||||||
|
success: true,
|
||||||
|
message: `Warning sent for ${groupsForDeletion.length} groups`,
|
||||||
|
groupCount: groupsForDeletion.length,
|
||||||
|
groups: groupsForDeletion.map(g => ({
|
||||||
|
groupId: g.groupId,
|
||||||
|
name: g.name,
|
||||||
|
year: g.year,
|
||||||
|
uploadDate: g.uploadDate
|
||||||
|
}))
|
||||||
|
};
|
||||||
|
} catch (error) {
|
||||||
|
console.error('[Scheduler] Manual Telegram warning failed:', error);
|
||||||
|
return { success: false, message: error.message };
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
module.exports = new SchedulerService();
|
module.exports = new SchedulerService();
|
||||||
|
|
|
||||||
312
backend/src/services/TelegramNotificationService.js
Normal file
312
backend/src/services/TelegramNotificationService.js
Normal file
|
|
@ -0,0 +1,312 @@
|
||||||
|
const TelegramBot = require('node-telegram-bot-api');
|
||||||
|
|
||||||
|
/**
|
||||||
|
* TelegramNotificationService
|
||||||
|
*
|
||||||
|
* Versendet automatische Benachrichtigungen über Telegram an die Werkstatt-Gruppe.
|
||||||
|
*
|
||||||
|
* Features:
|
||||||
|
* - Upload-Benachrichtigungen (Phase 3)
|
||||||
|
* - Consent-Änderungs-Benachrichtigungen (Phase 4)
|
||||||
|
* - Gruppen-Lösch-Benachrichtigungen (Phase 4)
|
||||||
|
* - Tägliche Lösch-Warnungen (Phase 5)
|
||||||
|
*
|
||||||
|
* Phase 2: Backend-Service Integration (Basic Setup)
|
||||||
|
*/
|
||||||
|
class TelegramNotificationService {
|
||||||
|
constructor() {
|
||||||
|
this.enabled = process.env.TELEGRAM_ENABLED === 'true';
|
||||||
|
this.botToken = process.env.TELEGRAM_BOT_TOKEN;
|
||||||
|
this.chatId = process.env.TELEGRAM_CHAT_ID;
|
||||||
|
this.bot = null;
|
||||||
|
|
||||||
|
if (this.enabled) {
|
||||||
|
this.initialize();
|
||||||
|
} else {
|
||||||
|
console.log('[Telegram] Service disabled (TELEGRAM_ENABLED=false)');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Initialisiert den Telegram Bot
|
||||||
|
*/
|
||||||
|
initialize() {
|
||||||
|
try {
|
||||||
|
if (!this.botToken) {
|
||||||
|
throw new Error('TELEGRAM_BOT_TOKEN is not defined');
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!this.chatId) {
|
||||||
|
throw new Error('TELEGRAM_CHAT_ID is not defined');
|
||||||
|
}
|
||||||
|
|
||||||
|
this.bot = new TelegramBot(this.botToken, { polling: false });
|
||||||
|
console.log('[Telegram] Service initialized successfully');
|
||||||
|
} catch (error) {
|
||||||
|
console.error('[Telegram] Initialization failed:', error.message);
|
||||||
|
this.enabled = false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Prüft, ob der Service verfügbar ist
|
||||||
|
*/
|
||||||
|
isAvailable() {
|
||||||
|
return this.enabled && this.bot !== null;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Sendet eine Test-Nachricht
|
||||||
|
*
|
||||||
|
* @returns {Promise<Object>} Telegram API Response
|
||||||
|
*/
|
||||||
|
async sendTestMessage() {
|
||||||
|
if (!this.isAvailable()) {
|
||||||
|
console.log('[Telegram] Service not available, skipping test message');
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
const timestamp = new Date().toLocaleString('de-DE', {
|
||||||
|
year: 'numeric',
|
||||||
|
month: '2-digit',
|
||||||
|
day: '2-digit',
|
||||||
|
hour: '2-digit',
|
||||||
|
minute: '2-digit',
|
||||||
|
second: '2-digit'
|
||||||
|
});
|
||||||
|
|
||||||
|
const message = `
|
||||||
|
🤖 Telegram Service Test
|
||||||
|
|
||||||
|
Service erfolgreich initialisiert!
|
||||||
|
|
||||||
|
Zeitstempel: ${timestamp}
|
||||||
|
Environment: ${process.env.NODE_ENV || 'development'}
|
||||||
|
|
||||||
|
---
|
||||||
|
ℹ️ Dieser Bot sendet automatische Benachrichtigungen für den Image Uploader.
|
||||||
|
`.trim();
|
||||||
|
|
||||||
|
const response = await this.bot.sendMessage(this.chatId, message);
|
||||||
|
console.log('[Telegram] Test message sent successfully');
|
||||||
|
return response;
|
||||||
|
} catch (error) {
|
||||||
|
console.error('[Telegram] Failed to send test message:', error.message);
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Phase 3: Sendet Benachrichtigung bei neuem Upload
|
||||||
|
*
|
||||||
|
* @param {Object} groupData - Gruppen-Informationen
|
||||||
|
* @param {string} groupData.name - Name des Uploaders
|
||||||
|
* @param {number} groupData.year - Jahr der Gruppe
|
||||||
|
* @param {string} groupData.title - Titel der Gruppe
|
||||||
|
* @param {number} groupData.imageCount - Anzahl hochgeladener Bilder
|
||||||
|
* @param {boolean} groupData.workshopConsent - Workshop-Consent Status
|
||||||
|
* @param {Array<string>} groupData.socialMediaConsents - Social Media Plattformen
|
||||||
|
* @param {string} groupData.token - Management-Token
|
||||||
|
*/
|
||||||
|
async sendUploadNotification(groupData) {
|
||||||
|
if (!this.isAvailable()) {
|
||||||
|
console.log('[Telegram] Service not available, skipping upload notification');
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
const workshopIcon = groupData.workshopConsent ? '✅' : '❌';
|
||||||
|
const socialMediaIcons = this.formatSocialMediaIcons(groupData.socialMediaConsents);
|
||||||
|
|
||||||
|
const message = `
|
||||||
|
📸 Neuer Upload!
|
||||||
|
|
||||||
|
Uploader: ${groupData.name}
|
||||||
|
Bilder: ${groupData.imageCount}
|
||||||
|
Gruppe: ${groupData.year} - ${groupData.title}
|
||||||
|
|
||||||
|
Workshop: ${workshopIcon} ${groupData.workshopConsent ? 'Ja' : 'Nein'}
|
||||||
|
Social Media: ${socialMediaIcons || '❌ Keine'}
|
||||||
|
|
||||||
|
🔗 Zur Freigabe: ${this.getAdminUrl()}
|
||||||
|
`.trim();
|
||||||
|
|
||||||
|
const response = await this.bot.sendMessage(this.chatId, message);
|
||||||
|
console.log(`[Telegram] Upload notification sent for group: ${groupData.title}`);
|
||||||
|
return response;
|
||||||
|
} catch (error) {
|
||||||
|
console.error('[Telegram] Failed to send upload notification:', error.message);
|
||||||
|
// Fehler loggen, aber nicht werfen - Upload soll nicht fehlschlagen wegen Telegram
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Phase 4: Sendet Benachrichtigung bei Consent-Änderung
|
||||||
|
*
|
||||||
|
* @param {Object} changeData - Änderungs-Informationen
|
||||||
|
* @param {string} changeData.name - Name des Uploaders
|
||||||
|
* @param {number} changeData.year - Jahr
|
||||||
|
* @param {string} changeData.title - Titel
|
||||||
|
* @param {string} changeData.consentType - 'workshop' oder 'social_media'
|
||||||
|
* @param {string} changeData.action - 'revoke' oder 'restore'
|
||||||
|
* @param {string} [changeData.platform] - Plattform-Name (nur bei social_media)
|
||||||
|
* @param {boolean} [changeData.newValue] - Neuer Wert (nur bei workshop)
|
||||||
|
*/
|
||||||
|
async sendConsentChangeNotification(changeData) {
|
||||||
|
if (!this.isAvailable()) {
|
||||||
|
console.log('[Telegram] Service not available, skipping consent change notification');
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
const { name, year, title, consentType, action, platform, newValue } = changeData;
|
||||||
|
|
||||||
|
let changeDescription;
|
||||||
|
if (consentType === 'workshop') {
|
||||||
|
const icon = newValue ? '✅' : '❌';
|
||||||
|
const status = newValue ? 'Ja' : 'Nein';
|
||||||
|
const actionText = action === 'revoke' ? 'widerrufen' : 'wiederhergestellt';
|
||||||
|
changeDescription = `Workshop-Consent ${actionText}\nNeuer Status: ${icon} ${status}`;
|
||||||
|
} else if (consentType === 'social_media') {
|
||||||
|
const actionText = action === 'revoke' ? 'widerrufen' : 'erteilt';
|
||||||
|
changeDescription = `Social Media Consent ${actionText}\nPlattform: ${platform}`;
|
||||||
|
}
|
||||||
|
|
||||||
|
const message = `
|
||||||
|
⚙️ Consent-Änderung
|
||||||
|
|
||||||
|
Gruppe: ${year} - ${title}
|
||||||
|
Uploader: ${name}
|
||||||
|
|
||||||
|
${changeDescription}
|
||||||
|
|
||||||
|
🔗 Details: ${this.getAdminUrl()}
|
||||||
|
`.trim();
|
||||||
|
|
||||||
|
const response = await this.bot.sendMessage(this.chatId, message);
|
||||||
|
console.log(`[Telegram] Consent change notification sent for: ${title}`);
|
||||||
|
return response;
|
||||||
|
} catch (error) {
|
||||||
|
console.error('[Telegram] Failed to send consent change notification:', error.message);
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Phase 4: Sendet Benachrichtigung bei Gruppen-Löschung durch User
|
||||||
|
*
|
||||||
|
* @param {Object} groupData - Gruppen-Informationen
|
||||||
|
*/
|
||||||
|
async sendGroupDeletedNotification(groupData) {
|
||||||
|
if (!this.isAvailable()) {
|
||||||
|
console.log('[Telegram] Service not available, skipping group deleted notification');
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
const message = `
|
||||||
|
⚙️ User-Änderung
|
||||||
|
|
||||||
|
Aktion: Gruppe gelöscht
|
||||||
|
Gruppe: ${groupData.year} - ${groupData.title}
|
||||||
|
Uploader: ${groupData.name}
|
||||||
|
Bilder: ${groupData.imageCount}
|
||||||
|
|
||||||
|
ℹ️ User hat Gruppe selbst über Management-Link gelöscht
|
||||||
|
`.trim();
|
||||||
|
|
||||||
|
const response = await this.bot.sendMessage(this.chatId, message);
|
||||||
|
console.log(`[Telegram] Group deleted notification sent for: ${groupData.title}`);
|
||||||
|
return response;
|
||||||
|
} catch (error) {
|
||||||
|
console.error('[Telegram] Failed to send group deleted notification:', error.message);
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Phase 5: Sendet tägliche Warnung für bevorstehende Löschungen
|
||||||
|
*
|
||||||
|
* @param {Array<Object>} groupsList - Liste der zu löschenden Gruppen
|
||||||
|
*/
|
||||||
|
async sendDeletionWarning(groupsList) {
|
||||||
|
if (!this.isAvailable()) {
|
||||||
|
console.log('[Telegram] Service not available, skipping deletion warning');
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!groupsList || groupsList.length === 0) {
|
||||||
|
console.log('[Telegram] No groups pending deletion, skipping warning');
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
let groupsText = groupsList.map((group, index) => {
|
||||||
|
const uploadDate = new Date(group.created_at).toLocaleDateString('de-DE');
|
||||||
|
return `${index + 1}. ${group.year} - ${group.title}
|
||||||
|
Uploader: ${group.name}
|
||||||
|
Bilder: ${group.imageCount}
|
||||||
|
Hochgeladen: ${uploadDate}`;
|
||||||
|
}).join('\n\n');
|
||||||
|
|
||||||
|
const message = `
|
||||||
|
⏰ Löschung in 24 Stunden!
|
||||||
|
|
||||||
|
Folgende Gruppen werden morgen automatisch gelöscht:
|
||||||
|
|
||||||
|
${groupsText}
|
||||||
|
|
||||||
|
💡 Jetzt freigeben oder Freigabe bleibt aus!
|
||||||
|
🔗 Zur Moderation: ${this.getAdminUrl()}
|
||||||
|
`.trim();
|
||||||
|
|
||||||
|
const response = await this.bot.sendMessage(this.chatId, message);
|
||||||
|
console.log(`[Telegram] Deletion warning sent for ${groupsList.length} groups`);
|
||||||
|
return response;
|
||||||
|
} catch (error) {
|
||||||
|
console.error('[Telegram] Failed to send deletion warning:', error.message);
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// =========================================================================
|
||||||
|
// Helper Methods
|
||||||
|
// =========================================================================
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Formatiert Social Media Consents als Icons
|
||||||
|
*
|
||||||
|
* @param {Array<string>} platforms - Liste der Plattformen
|
||||||
|
* @returns {string} Formatierter String mit Icons
|
||||||
|
*/
|
||||||
|
formatSocialMediaIcons(platforms) {
|
||||||
|
if (!platforms || platforms.length === 0) {
|
||||||
|
return '';
|
||||||
|
}
|
||||||
|
|
||||||
|
const iconMap = {
|
||||||
|
'facebook': '📘 Facebook',
|
||||||
|
'instagram': '📷 Instagram',
|
||||||
|
'tiktok': '🎵 TikTok'
|
||||||
|
};
|
||||||
|
|
||||||
|
return platforms.map(p => iconMap[p.toLowerCase()] || p).join(', ');
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Gibt die Admin-URL zurück
|
||||||
|
*
|
||||||
|
* @returns {string} Admin-Panel URL
|
||||||
|
*/
|
||||||
|
getAdminUrl() {
|
||||||
|
const host = process.env.INTERNAL_HOST || 'internal.hobbyhimmel.de';
|
||||||
|
const isProduction = process.env.NODE_ENV === 'production';
|
||||||
|
const protocol = isProduction ? 'https' : 'http';
|
||||||
|
const port = isProduction ? '' : ':3000';
|
||||||
|
return `${protocol}://${host}${port}/moderation`;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = TelegramNotificationService;
|
||||||
183
backend/tests/api/telegram-upload.test.js
Normal file
183
backend/tests/api/telegram-upload.test.js
Normal file
|
|
@ -0,0 +1,183 @@
|
||||||
|
/**
|
||||||
|
* Integration Tests für Telegram Upload-Benachrichtigungen
|
||||||
|
*
|
||||||
|
* Phase 3: Upload-Benachrichtigungen
|
||||||
|
*
|
||||||
|
* Diese Tests prüfen die Integration zwischen Upload-Route und Telegram-Service
|
||||||
|
*/
|
||||||
|
|
||||||
|
const path = require('path');
|
||||||
|
const fs = require('fs');
|
||||||
|
const { getRequest } = require('../testServer');
|
||||||
|
|
||||||
|
describe('Telegram Upload Notifications (Integration)', () => {
|
||||||
|
let TelegramNotificationService;
|
||||||
|
let sendUploadNotificationSpy;
|
||||||
|
|
||||||
|
beforeAll(() => {
|
||||||
|
// Spy auf TelegramNotificationService
|
||||||
|
TelegramNotificationService = require('../../src/services/TelegramNotificationService');
|
||||||
|
});
|
||||||
|
|
||||||
|
beforeEach(() => {
|
||||||
|
// Spy auf sendUploadNotification erstellen
|
||||||
|
sendUploadNotificationSpy = jest.spyOn(TelegramNotificationService.prototype, 'sendUploadNotification')
|
||||||
|
.mockResolvedValue({ message_id: 42 });
|
||||||
|
|
||||||
|
// isAvailable() immer true zurückgeben für Tests
|
||||||
|
jest.spyOn(TelegramNotificationService.prototype, 'isAvailable')
|
||||||
|
.mockReturnValue(true);
|
||||||
|
});
|
||||||
|
|
||||||
|
afterEach(() => {
|
||||||
|
// Restore alle Spys
|
||||||
|
jest.restoreAllMocks();
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('POST /api/upload/batch', () => {
|
||||||
|
const testImagePath = path.join(__dirname, '../utils/test-image.jpg');
|
||||||
|
|
||||||
|
// Erstelle Test-Bild falls nicht vorhanden
|
||||||
|
beforeAll(() => {
|
||||||
|
if (!fs.existsSync(testImagePath)) {
|
||||||
|
// Erstelle 1x1 px JPEG
|
||||||
|
const buffer = Buffer.from([
|
||||||
|
0xFF, 0xD8, 0xFF, 0xE0, 0x00, 0x10, 0x4A, 0x46,
|
||||||
|
0x49, 0x46, 0x00, 0x01, 0x01, 0x00, 0x00, 0x01,
|
||||||
|
0x00, 0x01, 0x00, 0x00, 0xFF, 0xDB, 0x00, 0x43,
|
||||||
|
0x00, 0x08, 0x06, 0x06, 0x07, 0x06, 0x05, 0x08,
|
||||||
|
0x07, 0x07, 0x07, 0x09, 0x09, 0x08, 0x0A, 0x0C,
|
||||||
|
0x14, 0x0D, 0x0C, 0x0B, 0x0B, 0x0C, 0x19, 0x12,
|
||||||
|
0x13, 0x0F, 0x14, 0x1D, 0x1A, 0x1F, 0x1E, 0x1D,
|
||||||
|
0x1A, 0x1C, 0x1C, 0x20, 0x24, 0x2E, 0x27, 0x20,
|
||||||
|
0x22, 0x2C, 0x23, 0x1C, 0x1C, 0x28, 0x37, 0x29,
|
||||||
|
0x2C, 0x30, 0x31, 0x34, 0x34, 0x34, 0x1F, 0x27,
|
||||||
|
0x39, 0x3D, 0x38, 0x32, 0x3C, 0x2E, 0x33, 0x34,
|
||||||
|
0x32, 0xFF, 0xC0, 0x00, 0x0B, 0x08, 0x00, 0x01,
|
||||||
|
0x00, 0x01, 0x01, 0x01, 0x11, 0x00, 0xFF, 0xC4,
|
||||||
|
0x00, 0x14, 0x00, 0x01, 0x00, 0x00, 0x00, 0x00,
|
||||||
|
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
|
||||||
|
0x00, 0x00, 0x00, 0x03, 0xFF, 0xC4, 0x00, 0x14,
|
||||||
|
0x10, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
|
||||||
|
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
|
||||||
|
0x00, 0x00, 0xFF, 0xDA, 0x00, 0x08, 0x01, 0x01,
|
||||||
|
0x00, 0x00, 0x3F, 0x00, 0x37, 0xFF, 0xD9
|
||||||
|
]);
|
||||||
|
fs.writeFileSync(testImagePath, buffer);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
it('sollte Telegram-Benachrichtigung bei erfolgreichem Upload senden', async () => {
|
||||||
|
const response = await getRequest()
|
||||||
|
.post('/api/upload/batch')
|
||||||
|
.field('year', '2024')
|
||||||
|
.field('title', 'Test Upload')
|
||||||
|
.field('name', 'Test User')
|
||||||
|
.field('consents', JSON.stringify({
|
||||||
|
workshopConsent: true,
|
||||||
|
socialMediaConsents: ['instagram', 'tiktok']
|
||||||
|
}))
|
||||||
|
.attach('images', testImagePath);
|
||||||
|
|
||||||
|
// Upload sollte erfolgreich sein
|
||||||
|
expect(response.status).toBe(200);
|
||||||
|
expect(response.body.message).toBe('Batch upload successful');
|
||||||
|
|
||||||
|
// Warte kurz auf async Telegram-Call
|
||||||
|
await new Promise(resolve => setTimeout(resolve, 150));
|
||||||
|
|
||||||
|
// Telegram-Service sollte aufgerufen worden sein
|
||||||
|
expect(sendUploadNotificationSpy).toHaveBeenCalledWith(
|
||||||
|
expect.objectContaining({
|
||||||
|
name: 'Test User',
|
||||||
|
year: 2024,
|
||||||
|
title: 'Test Upload',
|
||||||
|
imageCount: 1,
|
||||||
|
workshopConsent: true,
|
||||||
|
socialMediaConsents: ['instagram', 'tiktok']
|
||||||
|
})
|
||||||
|
);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('sollte Upload nicht fehlschlagen wenn Telegram-Service nicht verfügbar', async () => {
|
||||||
|
// Restore mock und setze isAvailable auf false
|
||||||
|
jest.restoreAllMocks();
|
||||||
|
jest.spyOn(TelegramNotificationService.prototype, 'isAvailable')
|
||||||
|
.mockReturnValue(false);
|
||||||
|
sendUploadNotificationSpy = jest.spyOn(TelegramNotificationService.prototype, 'sendUploadNotification');
|
||||||
|
|
||||||
|
const response = await getRequest()
|
||||||
|
.post('/api/upload/batch')
|
||||||
|
.field('year', '2024')
|
||||||
|
.field('title', 'Test Upload')
|
||||||
|
.field('name', 'Test User')
|
||||||
|
.field('consents', JSON.stringify({
|
||||||
|
workshopConsent: false,
|
||||||
|
socialMediaConsents: []
|
||||||
|
}))
|
||||||
|
.attach('images', testImagePath);
|
||||||
|
|
||||||
|
// Upload sollte trotzdem erfolgreich sein
|
||||||
|
expect(response.status).toBe(200);
|
||||||
|
expect(response.body.message).toBe('Batch upload successful');
|
||||||
|
|
||||||
|
// Telegram sollte nicht aufgerufen worden sein
|
||||||
|
expect(sendUploadNotificationSpy).not.toHaveBeenCalled();
|
||||||
|
});
|
||||||
|
|
||||||
|
it('sollte Upload nicht fehlschlagen wenn Telegram-Benachrichtigung fehlschlägt', async () => {
|
||||||
|
sendUploadNotificationSpy.mockRejectedValueOnce(
|
||||||
|
new Error('Telegram API Error')
|
||||||
|
);
|
||||||
|
|
||||||
|
const response = await getRequest()
|
||||||
|
.post('/api/upload/batch')
|
||||||
|
.field('year', '2024')
|
||||||
|
.field('title', 'Test Upload')
|
||||||
|
.field('name', 'Test User')
|
||||||
|
.field('consents', JSON.stringify({
|
||||||
|
workshopConsent: true,
|
||||||
|
socialMediaConsents: []
|
||||||
|
}))
|
||||||
|
.attach('images', testImagePath);
|
||||||
|
|
||||||
|
// Upload sollte trotzdem erfolgreich sein
|
||||||
|
expect(response.status).toBe(200);
|
||||||
|
expect(response.body.message).toBe('Batch upload successful');
|
||||||
|
|
||||||
|
// Warte auf async error handling
|
||||||
|
await new Promise(resolve => setTimeout(resolve, 150));
|
||||||
|
|
||||||
|
// Telegram wurde versucht aufzurufen
|
||||||
|
expect(sendUploadNotificationSpy).toHaveBeenCalled();
|
||||||
|
});
|
||||||
|
|
||||||
|
it('sollte korrekte Daten an Telegram-Service übergeben', async () => {
|
||||||
|
const response = await getRequest()
|
||||||
|
.post('/api/upload/batch')
|
||||||
|
.field('year', '2025')
|
||||||
|
.field('title', 'Schweißkurs November')
|
||||||
|
.field('name', 'Max Mustermann')
|
||||||
|
.field('consents', JSON.stringify({
|
||||||
|
workshopConsent: true,
|
||||||
|
socialMediaConsents: ['facebook', 'instagram']
|
||||||
|
}))
|
||||||
|
.attach('images', testImagePath)
|
||||||
|
.attach('images', testImagePath);
|
||||||
|
|
||||||
|
expect(response.status).toBe(200);
|
||||||
|
|
||||||
|
await new Promise(resolve => setTimeout(resolve, 150));
|
||||||
|
|
||||||
|
expect(sendUploadNotificationSpy).toHaveBeenCalledWith({
|
||||||
|
name: 'Max Mustermann',
|
||||||
|
year: 2025,
|
||||||
|
title: 'Schweißkurs November',
|
||||||
|
imageCount: 2,
|
||||||
|
workshopConsent: true,
|
||||||
|
socialMediaConsents: ['facebook', 'instagram'],
|
||||||
|
token: expect.any(String)
|
||||||
|
});
|
||||||
|
});
|
||||||
|
});
|
||||||
|
});
|
||||||
216
backend/tests/unit/TelegramNotificationService.test.js
Normal file
216
backend/tests/unit/TelegramNotificationService.test.js
Normal file
|
|
@ -0,0 +1,216 @@
|
||||||
|
/**
|
||||||
|
* Unit Tests für TelegramNotificationService
|
||||||
|
*
|
||||||
|
* Phase 2: Basic Service Tests
|
||||||
|
*/
|
||||||
|
|
||||||
|
const TelegramNotificationService = require('../../src/services/TelegramNotificationService');
|
||||||
|
|
||||||
|
// Mock node-telegram-bot-api komplett
|
||||||
|
jest.mock('node-telegram-bot-api');
|
||||||
|
|
||||||
|
describe('TelegramNotificationService', () => {
|
||||||
|
let originalEnv;
|
||||||
|
let TelegramBot;
|
||||||
|
let mockBotInstance;
|
||||||
|
|
||||||
|
beforeAll(() => {
|
||||||
|
TelegramBot = require('node-telegram-bot-api');
|
||||||
|
});
|
||||||
|
|
||||||
|
beforeEach(() => {
|
||||||
|
// Speichere originale ENV-Variablen
|
||||||
|
originalEnv = { ...process.env };
|
||||||
|
|
||||||
|
// Setze Test-ENV
|
||||||
|
process.env.TELEGRAM_ENABLED = 'true';
|
||||||
|
process.env.TELEGRAM_BOT_TOKEN = 'test-bot-token-123';
|
||||||
|
process.env.TELEGRAM_CHAT_ID = '-1001234567890';
|
||||||
|
|
||||||
|
// Erstelle Mock-Bot-Instanz
|
||||||
|
mockBotInstance = {
|
||||||
|
sendMessage: jest.fn().mockResolvedValue({
|
||||||
|
message_id: 42,
|
||||||
|
chat: { id: -1001234567890 },
|
||||||
|
text: 'Test'
|
||||||
|
}),
|
||||||
|
getMe: jest.fn().mockResolvedValue({
|
||||||
|
id: 123456,
|
||||||
|
first_name: 'Test Bot',
|
||||||
|
username: 'test_bot'
|
||||||
|
})
|
||||||
|
};
|
||||||
|
|
||||||
|
// Mock TelegramBot constructor
|
||||||
|
TelegramBot.mockImplementation(() => mockBotInstance);
|
||||||
|
});
|
||||||
|
|
||||||
|
afterEach(() => {
|
||||||
|
// Restore original ENV
|
||||||
|
process.env = originalEnv;
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('Initialization', () => {
|
||||||
|
it('sollte erfolgreich initialisieren wenn TELEGRAM_ENABLED=true', () => {
|
||||||
|
const service = new TelegramNotificationService();
|
||||||
|
|
||||||
|
expect(service.isAvailable()).toBe(true);
|
||||||
|
expect(TelegramBot).toHaveBeenCalledWith('test-bot-token-123', { polling: false });
|
||||||
|
});
|
||||||
|
|
||||||
|
it('sollte nicht initialisieren wenn TELEGRAM_ENABLED=false', () => {
|
||||||
|
process.env.TELEGRAM_ENABLED = 'false';
|
||||||
|
|
||||||
|
const service = new TelegramNotificationService();
|
||||||
|
|
||||||
|
expect(service.isAvailable()).toBe(false);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('sollte fehlschlagen wenn TELEGRAM_BOT_TOKEN fehlt', () => {
|
||||||
|
delete process.env.TELEGRAM_BOT_TOKEN;
|
||||||
|
|
||||||
|
const service = new TelegramNotificationService();
|
||||||
|
|
||||||
|
expect(service.isAvailable()).toBe(false);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('sollte fehlschlagen wenn TELEGRAM_CHAT_ID fehlt', () => {
|
||||||
|
delete process.env.TELEGRAM_CHAT_ID;
|
||||||
|
|
||||||
|
const service = new TelegramNotificationService();
|
||||||
|
|
||||||
|
expect(service.isAvailable()).toBe(false);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('sendTestMessage', () => {
|
||||||
|
it('sollte Test-Nachricht erfolgreich senden', async () => {
|
||||||
|
const service = new TelegramNotificationService();
|
||||||
|
|
||||||
|
const result = await service.sendTestMessage();
|
||||||
|
|
||||||
|
expect(result).toBeDefined();
|
||||||
|
expect(result.message_id).toBe(42);
|
||||||
|
expect(mockBotInstance.sendMessage).toHaveBeenCalledWith(
|
||||||
|
'-1001234567890',
|
||||||
|
expect.stringContaining('Telegram Service Test')
|
||||||
|
);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('sollte null zurückgeben wenn Service nicht verfügbar', async () => {
|
||||||
|
process.env.TELEGRAM_ENABLED = 'false';
|
||||||
|
|
||||||
|
const service = new TelegramNotificationService();
|
||||||
|
|
||||||
|
const result = await service.sendTestMessage();
|
||||||
|
|
||||||
|
expect(result).toBeNull();
|
||||||
|
});
|
||||||
|
|
||||||
|
it('sollte Fehler werfen bei Telegram-API-Fehler', async () => {
|
||||||
|
const service = new TelegramNotificationService();
|
||||||
|
|
||||||
|
mockBotInstance.sendMessage.mockRejectedValueOnce(new Error('API Error'));
|
||||||
|
|
||||||
|
await expect(service.sendTestMessage()).rejects.toThrow('API Error');
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('formatSocialMediaIcons', () => {
|
||||||
|
it('sollte Social Media Plattformen korrekt formatieren', () => {
|
||||||
|
const service = new TelegramNotificationService();
|
||||||
|
|
||||||
|
const result = service.formatSocialMediaIcons(['facebook', 'instagram', 'tiktok']);
|
||||||
|
|
||||||
|
expect(result).toBe('📘 Facebook, 📷 Instagram, 🎵 TikTok');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('sollte leeren String bei leerer Liste zurückgeben', () => {
|
||||||
|
const service = new TelegramNotificationService();
|
||||||
|
|
||||||
|
const result = service.formatSocialMediaIcons([]);
|
||||||
|
|
||||||
|
expect(result).toBe('');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('sollte case-insensitive sein', () => {
|
||||||
|
const service = new TelegramNotificationService();
|
||||||
|
|
||||||
|
const result = service.formatSocialMediaIcons(['FACEBOOK', 'Instagram', 'TikTok']);
|
||||||
|
|
||||||
|
expect(result).toBe('📘 Facebook, 📷 Instagram, 🎵 TikTok');
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('getAdminUrl', () => {
|
||||||
|
it('sollte Admin-URL mit PUBLIC_URL generieren', () => {
|
||||||
|
process.env.PUBLIC_URL = 'https://test.example.com';
|
||||||
|
|
||||||
|
const service = new TelegramNotificationService();
|
||||||
|
|
||||||
|
const url = service.getAdminUrl();
|
||||||
|
|
||||||
|
expect(url).toBe('https://test.example.com/moderation');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('sollte Default-URL verwenden wenn PUBLIC_URL nicht gesetzt', () => {
|
||||||
|
delete process.env.PUBLIC_URL;
|
||||||
|
|
||||||
|
const service = new TelegramNotificationService();
|
||||||
|
|
||||||
|
const url = service.getAdminUrl();
|
||||||
|
|
||||||
|
expect(url).toBe('https://internal.hobbyhimmel.de/moderation');
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('sendUploadNotification (Phase 3)', () => {
|
||||||
|
it('sollte Upload-Benachrichtigung mit korrekten Daten senden', async () => {
|
||||||
|
const service = new TelegramNotificationService();
|
||||||
|
|
||||||
|
const groupData = {
|
||||||
|
name: 'Max Mustermann',
|
||||||
|
year: 2024,
|
||||||
|
title: 'Schweißkurs November',
|
||||||
|
imageCount: 12,
|
||||||
|
workshopConsent: true,
|
||||||
|
socialMediaConsents: ['instagram', 'tiktok'],
|
||||||
|
token: 'test-token-123'
|
||||||
|
};
|
||||||
|
|
||||||
|
await service.sendUploadNotification(groupData);
|
||||||
|
|
||||||
|
expect(mockBotInstance.sendMessage).toHaveBeenCalledWith(
|
||||||
|
'-1001234567890',
|
||||||
|
expect.stringContaining('📸 Neuer Upload!')
|
||||||
|
);
|
||||||
|
expect(mockBotInstance.sendMessage).toHaveBeenCalledWith(
|
||||||
|
'-1001234567890',
|
||||||
|
expect.stringContaining('Max Mustermann')
|
||||||
|
);
|
||||||
|
expect(mockBotInstance.sendMessage).toHaveBeenCalledWith(
|
||||||
|
'-1001234567890',
|
||||||
|
expect.stringContaining('Bilder: 12')
|
||||||
|
);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('sollte null zurückgeben und nicht werfen bei Fehler', async () => {
|
||||||
|
const service = new TelegramNotificationService();
|
||||||
|
|
||||||
|
mockBotInstance.sendMessage.mockRejectedValueOnce(new Error('Network error'));
|
||||||
|
|
||||||
|
const groupData = {
|
||||||
|
name: 'Test User',
|
||||||
|
year: 2024,
|
||||||
|
title: 'Test',
|
||||||
|
imageCount: 5,
|
||||||
|
workshopConsent: false,
|
||||||
|
socialMediaConsents: []
|
||||||
|
};
|
||||||
|
|
||||||
|
const result = await service.sendUploadNotification(groupData);
|
||||||
|
|
||||||
|
expect(result).toBeNull();
|
||||||
|
});
|
||||||
|
});
|
||||||
|
});
|
||||||
BIN
backend/tests/utils/test-image.jpg
Normal file
BIN
backend/tests/utils/test-image.jpg
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 159 B |
|
|
@ -10,6 +10,22 @@ NODE_ENV=development
|
||||||
# Port for the backend server
|
# Port for the backend server
|
||||||
PORT=5000
|
PORT=5000
|
||||||
|
|
||||||
|
# Admin Session Secret (IMPORTANT: Change in production!)
|
||||||
|
# Generate with: openssl rand -base64 32
|
||||||
|
ADMIN_SESSION_SECRET=change-me-in-production
|
||||||
|
|
||||||
|
# Telegram Bot Configuration (optional)
|
||||||
|
TELEGRAM_ENABLED=false
|
||||||
|
# Send test message on server start (development only)
|
||||||
|
TELEGRAM_SEND_TEST_ON_START=false
|
||||||
|
# Bot-Token from @BotFather
|
||||||
|
# Example: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz1234567890
|
||||||
|
TELEGRAM_BOT_TOKEN=your-bot-token-here
|
||||||
|
# Chat-ID of the Telegram group (negative for groups!)
|
||||||
|
# Get via: https://api.telegram.org/bot<TOKEN>/getUpdates
|
||||||
|
# Example: -1001234567890
|
||||||
|
TELEGRAM_CHAT_ID=your-chat-id-here
|
||||||
|
|
||||||
# Database settings (if needed in future)
|
# Database settings (if needed in future)
|
||||||
# DB_HOST=localhost
|
# DB_HOST=localhost
|
||||||
# DB_PORT=3306
|
# DB_PORT=3306
|
||||||
|
|
@ -6,7 +6,4 @@
|
||||||
# Production: http://backend:5000 (container-to-container)
|
# Production: http://backend:5000 (container-to-container)
|
||||||
API_URL=http://backend:5000
|
API_URL=http://backend:5000
|
||||||
|
|
||||||
# Client URL - the URL where users access the frontend
|
# Public/Internal host separation (optional)
|
||||||
# Development: http://localhost:3000 (dev server)
|
|
||||||
# Production: http://localhost (nginx on port 80)
|
|
||||||
CLIENT_URL=http://localhost
|
|
||||||
16
docker/dev/.env.example
Normal file
16
docker/dev/.env.example
Normal file
|
|
@ -0,0 +1,16 @@
|
||||||
|
# Docker Compose Environment Variables for Development
|
||||||
|
# Copy this file to .env and adjust values
|
||||||
|
|
||||||
|
# Admin Session Secret (optional, has default: dev-session-secret-change-me)
|
||||||
|
#ADMIN_SESSION_SECRET=your-secret-here
|
||||||
|
|
||||||
|
# Telegram Bot Configuration (optional)
|
||||||
|
TELEGRAM_ENABLED=false
|
||||||
|
TELEGRAM_SEND_TEST_ON_START=false
|
||||||
|
# Bot-Token from @BotFather
|
||||||
|
# Example: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz1234567890
|
||||||
|
TELEGRAM_BOT_TOKEN=your-bot-token-here
|
||||||
|
# Chat-ID of the Telegram group (negative for groups!)
|
||||||
|
# Get via: https://api.telegram.org/bot<TOKEN>/getUpdates
|
||||||
|
# Example: -1001234567890
|
||||||
|
TELEGRAM_CHAT_ID=your-chat-id-here
|
||||||
|
|
@ -12,8 +12,8 @@ RUN npm install
|
||||||
# Copy backend source code
|
# Copy backend source code
|
||||||
COPY backend/ .
|
COPY backend/ .
|
||||||
|
|
||||||
# Copy development environment configuration
|
# Note: Environment variables are set via docker-compose.yml
|
||||||
COPY docker/dev/backend/config/.env ./.env
|
# No .env file needed in the image
|
||||||
|
|
||||||
# Expose port
|
# Expose port
|
||||||
EXPOSE 5000
|
EXPOSE 5000
|
||||||
|
|
|
||||||
|
|
@ -15,7 +15,6 @@ services:
|
||||||
volumes:
|
volumes:
|
||||||
- ../../frontend:/app:cached
|
- ../../frontend:/app:cached
|
||||||
- dev_frontend_node_modules:/app/node_modules
|
- dev_frontend_node_modules:/app/node_modules
|
||||||
- ./frontend/config/.env:/app/.env:ro
|
|
||||||
environment:
|
environment:
|
||||||
- CHOKIDAR_USEPOLLING=true
|
- CHOKIDAR_USEPOLLING=true
|
||||||
- API_URL=http://localhost:5001
|
- API_URL=http://localhost:5001
|
||||||
|
|
@ -38,14 +37,20 @@ services:
|
||||||
volumes:
|
volumes:
|
||||||
- ../../backend:/usr/src/app:cached
|
- ../../backend:/usr/src/app:cached
|
||||||
- dev_backend_node_modules:/usr/src/app/node_modules
|
- dev_backend_node_modules:/usr/src/app/node_modules
|
||||||
- ./backend/config/.env:/usr/src/app/.env:ro
|
|
||||||
environment:
|
environment:
|
||||||
- NODE_ENV=development
|
- NODE_ENV=development
|
||||||
|
- PORT=5000
|
||||||
|
- REMOVE_IMAGES=false
|
||||||
|
- ADMIN_SESSION_SECRET=${ADMIN_SESSION_SECRET:-dev-session-secret-change-me}
|
||||||
- PUBLIC_HOST=public.test.local
|
- PUBLIC_HOST=public.test.local
|
||||||
- INTERNAL_HOST=internal.test.local
|
- INTERNAL_HOST=internal.test.local
|
||||||
- ENABLE_HOST_RESTRICTION=true
|
- ENABLE_HOST_RESTRICTION=true
|
||||||
- TRUST_PROXY_HOPS=0
|
- TRUST_PROXY_HOPS=0
|
||||||
- PUBLIC_UPLOAD_RATE_LIMIT=20
|
- PUBLIC_UPLOAD_RATE_LIMIT=20
|
||||||
|
- TELEGRAM_ENABLED=${TELEGRAM_ENABLED:-false}
|
||||||
|
- TELEGRAM_BOT_TOKEN=${TELEGRAM_BOT_TOKEN}
|
||||||
|
- TELEGRAM_CHAT_ID=${TELEGRAM_CHAT_ID}
|
||||||
|
- TELEGRAM_SEND_TEST_ON_START=${TELEGRAM_SEND_TEST_ON_START:-false}
|
||||||
networks:
|
networks:
|
||||||
- dev-internal
|
- dev-internal
|
||||||
command: [ "npm", "run", "server" ]
|
command: [ "npm", "run", "server" ]
|
||||||
|
|
|
||||||
|
|
@ -13,9 +13,9 @@ WORKDIR /app
|
||||||
# Copy package files first to leverage Docker cache for npm install
|
# Copy package files first to leverage Docker cache for npm install
|
||||||
COPY frontend/package*.json ./
|
COPY frontend/package*.json ./
|
||||||
|
|
||||||
# Copy environment configuration
|
# Copy environment shell script (generates env-config.js from ENV at runtime)
|
||||||
COPY docker/dev/frontend/config/env.sh ./env.sh
|
COPY docker/dev/frontend/config/env.sh ./env.sh
|
||||||
COPY docker/dev/frontend/config/.env ./.env
|
# Note: ENV variables are set via docker-compose.yml, not from .env file
|
||||||
|
|
||||||
# Make env.sh executable
|
# Make env.sh executable
|
||||||
RUN chmod +x ./env.sh
|
RUN chmod +x ./env.sh
|
||||||
|
|
|
||||||
|
|
@ -7,23 +7,18 @@ touch ./env-config.js
|
||||||
# Add assignment
|
# Add assignment
|
||||||
echo "window._env_ = {" >> ./env-config.js
|
echo "window._env_ = {" >> ./env-config.js
|
||||||
|
|
||||||
# Read each line in .env file
|
# List of environment variables to export (add more as needed)
|
||||||
# Each line represents key=value pairs
|
ENV_VARS="API_URL PUBLIC_HOST INTERNAL_HOST"
|
||||||
while read -r line || [[ -n "$line" ]];
|
|
||||||
do
|
|
||||||
# Split env variables by character `=`
|
|
||||||
if printf '%s\n' "$line" | grep -q -e '='; then
|
|
||||||
varname=$(printf '%s\n' "$line" | sed -e 's/=.*//')
|
|
||||||
varvalue=$(printf '%s\n' "$line" | sed -e 's/^[^=]*=//')
|
|
||||||
fi
|
|
||||||
|
|
||||||
# Read value of current variable if exists as Environment variable
|
# Read each environment variable and add to config
|
||||||
value=$(printf '%s\n' "${!varname}")
|
for varname in $ENV_VARS; do
|
||||||
# Otherwise use value from .env file
|
# Get value from environment using indirect expansion
|
||||||
[[ -z $value ]] && value=${varvalue}
|
value="${!varname}"
|
||||||
|
|
||||||
# Append configuration property to JS file
|
# Only add if value exists
|
||||||
echo " $varname: \"$value\"," >> ./env-config.js
|
if [ -n "$value" ]; then
|
||||||
done < .env
|
echo " $varname: \"$value\"," >> ./env-config.js
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
|
||||||
echo "}" >> ./env-config.js
|
echo "}" >> ./env-config.js
|
||||||
|
|
|
||||||
18
docker/prod/.env.example
Normal file
18
docker/prod/.env.example
Normal file
|
|
@ -0,0 +1,18 @@
|
||||||
|
# Docker Compose Environment Variables for Production
|
||||||
|
# Copy this file to .env and adjust values
|
||||||
|
# IMPORTANT: Keep this file secure and never commit .env to git!
|
||||||
|
|
||||||
|
# Admin Session Secret (REQUIRED: Generate new secret!)
|
||||||
|
# Generate with: openssl rand -base64 32
|
||||||
|
ADMIN_SESSION_SECRET=CHANGE-ME-IN-PRODUCTION
|
||||||
|
|
||||||
|
# Telegram Bot Configuration (optional)
|
||||||
|
# Set to true to enable Telegram notifications in production
|
||||||
|
TELEGRAM_ENABLED=false
|
||||||
|
# Bot-Token from @BotFather (production bot)
|
||||||
|
# Example: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz1234567890
|
||||||
|
TELEGRAM_BOT_TOKEN=your-production-bot-token-here
|
||||||
|
# Chat-ID of the production Telegram group (negative for groups!)
|
||||||
|
# Get via: https://api.telegram.org/bot<TOKEN>/getUpdates
|
||||||
|
# Example: -1001234567890
|
||||||
|
TELEGRAM_CHAT_ID=your-production-chat-id-here
|
||||||
|
|
@ -15,8 +15,8 @@ services:
|
||||||
- backend
|
- backend
|
||||||
environment:
|
environment:
|
||||||
- API_URL=http://backend:5000
|
- API_URL=http://backend:5000
|
||||||
- PUBLIC_HOST=deinprojekt.hobbyhimmel.de
|
- PUBLIC_HOST=public.test.local
|
||||||
- INTERNAL_HOST=deinprojekt.lan.hobbyhimmel.de
|
- INTERNAL_HOST=internal.test.local
|
||||||
|
|
||||||
networks:
|
networks:
|
||||||
- npm-nw
|
- npm-nw
|
||||||
|
|
@ -42,13 +42,18 @@ services:
|
||||||
# ⚠️ Für HTTP-only Labs per Override auf "false" setzen (nicht im Repo committen)
|
# ⚠️ Für HTTP-only Labs per Override auf "false" setzen (nicht im Repo committen)
|
||||||
- ADMIN_SESSION_COOKIE_SECURE=true
|
- ADMIN_SESSION_COOKIE_SECURE=true
|
||||||
# Host Configuration (Public/Internal Separation)
|
# Host Configuration (Public/Internal Separation)
|
||||||
- PUBLIC_HOST=deinprojekt.hobbyhimmel.de
|
- PUBLIC_HOST=public.test.local
|
||||||
- INTERNAL_HOST=deinprojekt.lan.hobbyhimmel.de
|
- INTERNAL_HOST=internal.test.local
|
||||||
- ENABLE_HOST_RESTRICTION=true
|
- ENABLE_HOST_RESTRICTION=true
|
||||||
- PUBLIC_UPLOAD_RATE_LIMIT=20
|
- PUBLIC_UPLOAD_RATE_LIMIT=20
|
||||||
- PUBLIC_UPLOAD_RATE_WINDOW=3600000
|
- PUBLIC_UPLOAD_RATE_WINDOW=3600000
|
||||||
# Trust nginx-proxy-manager (1 hop)
|
# Trust nginx-proxy-manager (1 hop)
|
||||||
- TRUST_PROXY_HOPS=1
|
- TRUST_PROXY_HOPS=1
|
||||||
|
# Telegram Bot Configuration (optional)
|
||||||
|
- TELEGRAM_ENABLED=${TELEGRAM_ENABLED:-false}
|
||||||
|
- TELEGRAM_BOT_TOKEN=${TELEGRAM_BOT_TOKEN}
|
||||||
|
- TELEGRAM_CHAT_ID=${TELEGRAM_CHAT_ID}
|
||||||
|
- TELEGRAM_SEND_TEST_ON_START=false
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -20,10 +20,10 @@ COPY --from=build /app/build /usr/share/nginx/html
|
||||||
# Default port exposure
|
# Default port exposure
|
||||||
EXPOSE 80
|
EXPOSE 80
|
||||||
|
|
||||||
# Copy .env file and shell script to container
|
# Copy .env shell script to container (generates env-config.js from ENV at runtime)
|
||||||
WORKDIR /usr/share/nginx/html
|
WORKDIR /usr/share/nginx/html
|
||||||
COPY docker/prod/frontend/config/env.sh ./env.sh
|
COPY docker/prod/frontend/config/env.sh ./env.sh
|
||||||
COPY docker/prod/frontend/config/.env ./.env
|
# Note: ENV variables are set via docker-compose.yml, not from .env file
|
||||||
|
|
||||||
# Add bash
|
# Add bash
|
||||||
RUN apk add --no-cache bash
|
RUN apk add --no-cache bash
|
||||||
|
|
|
||||||
|
|
@ -7,23 +7,18 @@ touch ./env-config.js
|
||||||
# Add assignment
|
# Add assignment
|
||||||
echo "window._env_ = {" >> ./env-config.js
|
echo "window._env_ = {" >> ./env-config.js
|
||||||
|
|
||||||
# Read each line in .env file
|
# List of environment variables to export (add more as needed)
|
||||||
# Each line represents key=value pairs
|
ENV_VARS="API_URL PUBLIC_HOST INTERNAL_HOST"
|
||||||
while read -r line || [[ -n "$line" ]];
|
|
||||||
do
|
|
||||||
# Split env variables by character `=`
|
|
||||||
if printf '%s\n' "$line" | grep -q -e '='; then
|
|
||||||
varname=$(printf '%s\n' "$line" | sed -e 's/=.*//')
|
|
||||||
varvalue=$(printf '%s\n' "$line" | sed -e 's/^[^=]*=//')
|
|
||||||
fi
|
|
||||||
|
|
||||||
# Read value of current variable if exists as Environment variable
|
# Read each environment variable and add to config
|
||||||
value=$(printf '%s\n' "${!varname}")
|
for varname in $ENV_VARS; do
|
||||||
# Otherwise use value from .env file
|
# Get value from environment using indirect expansion
|
||||||
[[ -z $value ]] && value=${varvalue}
|
value="${!varname}"
|
||||||
|
|
||||||
# Append configuration property to JS file
|
# Only add if value exists
|
||||||
echo " $varname: \"$value\"," >> ./env-config.js
|
if [ -n "$value" ]; then
|
||||||
done < .env
|
echo " $varname: \"$value\"," >> ./env-config.js
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
|
||||||
echo "}" >> ./env-config.js
|
echo "}" >> ./env-config.js
|
||||||
|
|
|
||||||
|
|
@ -318,10 +318,10 @@ function MultiUploadPage() {
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<p className="text-small" style={{ color: '#666', marginBottom: '4px' }}>
|
<p className="text-small" style={{ color: '#666', marginBottom: '4px' }}>
|
||||||
⚠️ <strong>Wichtig:</strong> Bewahren Sie diesen Link sicher auf! Jeder mit diesem Link kann Ihren Upload verwalten.
|
⚠️ <strong>Wichtig:</strong> Bewahre diesen Link sicher auf! Jeder mit diesem Link kann Deinen Upload verwalten.
|
||||||
</p>
|
</p>
|
||||||
<p className="text-small" style={{ color: '#666', fontStyle: 'italic' }}>
|
<p className="text-small" style={{ color: '#666', fontStyle: 'italic' }}>
|
||||||
ℹ️ <strong>Hinweis:</strong> Über diesen Link können Sie nur die Bilder in der Werkstatt verwalten. Bereits auf Social Media Plattformen veröffentlichte Bilder müssen separat dort gelöscht werden.
|
ℹ️ <strong>Hinweis:</strong> Über diesen Link kannst Du nur die Bilder in der Werkstatt verwalten. Bereits auf Social Media Plattformen veröffentlichte Bilder müssen separat dort gelöscht werden.
|
||||||
</p>
|
</p>
|
||||||
</div>
|
</div>
|
||||||
)}
|
)}
|
||||||
|
|
|
||||||
4059
package-lock.json
generated
4059
package-lock.json
generated
File diff suppressed because it is too large
Load Diff
15
scripts/.env.telegram.example
Normal file
15
scripts/.env.telegram.example
Normal file
|
|
@ -0,0 +1,15 @@
|
||||||
|
# Telegram Bot Configuration Template
|
||||||
|
#
|
||||||
|
# Kopiere diese Datei zu .env.telegram und trage deine echten Werte ein:
|
||||||
|
# cp .env.telegram.example .env.telegram
|
||||||
|
#
|
||||||
|
# WICHTIG: .env.telegram NIEMALS committen! (ist in .gitignore)
|
||||||
|
|
||||||
|
# Bot-Token von @BotFather
|
||||||
|
# Beispiel: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz1234567890
|
||||||
|
TELEGRAM_BOT_TOKEN=YOUR_BOT_TOKEN_HERE
|
||||||
|
|
||||||
|
# Chat-ID der Telegram-Gruppe (negativ für Gruppen!)
|
||||||
|
# Ermitteln via: https://api.telegram.org/bot<TOKEN>/getUpdates
|
||||||
|
# Beispiel: -1001234567890
|
||||||
|
TELEGRAM_CHAT_ID=YOUR_CHAT_ID_HERE
|
||||||
506
scripts/README.telegram.md
Normal file
506
scripts/README.telegram.md
Normal file
|
|
@ -0,0 +1,506 @@
|
||||||
|
# Telegram Bot Setup & Testing Guide
|
||||||
|
|
||||||
|
## Übersicht
|
||||||
|
|
||||||
|
Diese Anleitung beschreibt Schritt-für-Schritt, wie du den Telegram Bot für den Image Uploader erstellst und testest.
|
||||||
|
|
||||||
|
**Phase 1:** Standalone-Test (ohne Backend-Integration)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Voraussetzungen
|
||||||
|
|
||||||
|
- ✅ Windows 11 mit installiertem Telegram Desktop
|
||||||
|
- ✅ Telegram Account
|
||||||
|
- ✅ Node.js >= 18.x installiert
|
||||||
|
- ✅ Zugriff auf dieses Git-Repository
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. Telegram Bot erstellen
|
||||||
|
|
||||||
|
### 1.1 BotFather öffnen
|
||||||
|
|
||||||
|
1. **Telegram Desktop** öffnen
|
||||||
|
2. In der Suche eingeben: `@BotFather`
|
||||||
|
3. Chat mit **BotFather** öffnen (offizieller Bot mit blauem Haken ✓)
|
||||||
|
|
||||||
|
### 1.2 Neuen Bot erstellen
|
||||||
|
|
||||||
|
**Commands im BotFather-Chat eingeben:**
|
||||||
|
|
||||||
|
```
|
||||||
|
/newbot
|
||||||
|
```
|
||||||
|
|
||||||
|
**BotFather fragt nach Namen:**
|
||||||
|
```
|
||||||
|
Alright, a new bot. How are we going to call it?
|
||||||
|
Please choose a name for your bot.
|
||||||
|
```
|
||||||
|
|
||||||
|
**Antworten mit:**
|
||||||
|
```
|
||||||
|
Werkstatt Image Uploader Bot
|
||||||
|
```
|
||||||
|
|
||||||
|
**BotFather fragt nach Username:**
|
||||||
|
```
|
||||||
|
Good. Now let's choose a username for your bot.
|
||||||
|
It must end in `bot`. Like this, for example: TetrisBot or tetris_bot.
|
||||||
|
```
|
||||||
|
|
||||||
|
**Antworten mit (muss auf `bot` enden):**
|
||||||
|
```
|
||||||
|
werkstatt_uploader_bot
|
||||||
|
```
|
||||||
|
|
||||||
|
⚠️ **Falls Username vergeben:** Anderen Namen wählen (z.B. `werkstatt_upload_bot`, `hobbyhimmel_uploader_bot`)
|
||||||
|
|
||||||
|
### 1.3 Bot-Token speichern
|
||||||
|
|
||||||
|
**BotFather antwortet mit:**
|
||||||
|
```
|
||||||
|
Done! Congratulations on your new bot.
|
||||||
|
You will find it at t.me/werkstatt_uploader_bot.
|
||||||
|
You can now add a description, about section and profile picture for your bot.
|
||||||
|
|
||||||
|
Use this token to access the HTTP API:
|
||||||
|
123456789:ABCdefGHIjklMNOpqrsTUVwxyz1234567890
|
||||||
|
|
||||||
|
Keep your token secure and store it safely, it can be used by anyone to control your bot.
|
||||||
|
```
|
||||||
|
|
||||||
|
**Token kopieren** (z.B. `123456789:ABCdefGHIjklMNOpqrsTUVwxyz1234567890`)
|
||||||
|
|
||||||
|
➡️ **Diesen Token brauchst du gleich für `.env.telegram`!**
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. Test-Telegram-Gruppe erstellen
|
||||||
|
|
||||||
|
### 2.1 Neue Gruppe erstellen
|
||||||
|
|
||||||
|
1. In Telegram: **Neuer Chat** → **Neue Gruppe**
|
||||||
|
2. Gruppennamen eingeben: `Werkstatt Upload Bot Test`
|
||||||
|
3. **Weiter** klicken
|
||||||
|
4. (Optional) Weitere Mitglieder hinzufügen (oder nur dich selbst)
|
||||||
|
5. **Erstellen** klicken
|
||||||
|
|
||||||
|
### 2.2 Bot zur Gruppe hinzufügen
|
||||||
|
|
||||||
|
1. Test-Gruppe öffnen
|
||||||
|
2. Auf Gruppennamen (oben) klicken → **Mitglieder hinzufügen**
|
||||||
|
3. Suche nach: `@werkstatt_uploader_bot` (dein Bot-Username)
|
||||||
|
4. Bot auswählen → **Hinzufügen**
|
||||||
|
|
||||||
|
**Telegram zeigt:**
|
||||||
|
```
|
||||||
|
werkstatt_uploader_bot wurde zur Gruppe hinzugefügt
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2.3 Privacy Mode deaktivieren (WICHTIG!)
|
||||||
|
|
||||||
|
⚠️ **Ohne diesen Schritt sieht der Bot keine Gruppennachrichten!**
|
||||||
|
|
||||||
|
1. **BotFather** öffnen
|
||||||
|
2. Command eingeben: `/mybots`
|
||||||
|
3. Deinen Bot auswählen: `@werkstatt_uploader_bot`
|
||||||
|
4. **Bot Settings** klicken
|
||||||
|
5. **Group Privacy** klicken
|
||||||
|
6. **Turn off** klicken
|
||||||
|
|
||||||
|
**BotFather bestätigt:**
|
||||||
|
```
|
||||||
|
Privacy mode is disabled for <bot-name>.
|
||||||
|
All messages will now be sent to the bot.
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2.4 Bot als Admin hinzufügen (optional, aber empfohlen)
|
||||||
|
|
||||||
|
1. Gruppe öffnen → Gruppennamen klicken
|
||||||
|
2. **Administratoren** → **Administrator hinzufügen**
|
||||||
|
3. `@werkstatt_uploader_bot` auswählen
|
||||||
|
4. **Berechtigungen:**
|
||||||
|
- ✅ Nachrichten senden
|
||||||
|
- ❌ Alle anderen optional (nicht nötig)
|
||||||
|
5. **Speichern**
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. Chat-ID ermitteln
|
||||||
|
|
||||||
|
Die Chat-ID wird benötigt, um Nachrichten an die richtige Gruppe zu senden.
|
||||||
|
|
||||||
|
### Methode 1: Via Telegram API (empfohlen)
|
||||||
|
|
||||||
|
**Schritt 1:** Nachricht in Test-Gruppe senden
|
||||||
|
|
||||||
|
- Öffne die Test-Gruppe
|
||||||
|
- Sende eine beliebige Nachricht (z.B. "Test")
|
||||||
|
|
||||||
|
**Schritt 2:** Browser öffnen und folgende URL aufrufen:
|
||||||
|
|
||||||
|
```
|
||||||
|
https://api.telegram.org/bot<DEIN_BOT_TOKEN>/getUpdates
|
||||||
|
```
|
||||||
|
|
||||||
|
**Ersetze `<DEIN_BOT_TOKEN>`** mit deinem echten Token!
|
||||||
|
|
||||||
|
**Beispiel:**
|
||||||
|
```
|
||||||
|
https://api.telegram.org/bot123456789:ABCdefGHIjklMNOpqrsTUVwxyz/getUpdates
|
||||||
|
```
|
||||||
|
|
||||||
|
⚠️ **Wenn du `{"ok":true,"result":[]}` siehst (leeres result-Array):**
|
||||||
|
|
||||||
|
Das bedeutet, der Bot hat noch keine Nachrichten empfangen. **Checkliste:**
|
||||||
|
|
||||||
|
1. ✅ Hast du den Bot zur Gruppe hinzugefügt? (Schritt 2.2)
|
||||||
|
2. ✅ Hast du **NACH** dem Hinzufügen eine Nachricht gesendet? (Schritt 1)
|
||||||
|
3. ✅ War die Nachricht in der **richtigen Gruppe** (nicht im Bot-Direct-Chat)?
|
||||||
|
|
||||||
|
**Lösung - Mach jetzt folgendes:**
|
||||||
|
- Telegram öffnen
|
||||||
|
- **Test-Gruppe** öffnen (nicht den Bot direkt!)
|
||||||
|
- Prüfe, ob der Bot als Mitglied angezeigt wird
|
||||||
|
- Sende eine neue Nachricht: "Test"
|
||||||
|
- **Sofort** zurück zum Browser → Seite neu laden (F5)
|
||||||
|
|
||||||
|
**Schritt 3:** Im JSON-Response nach `chat` suchen:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"ok": true,
|
||||||
|
"result": [
|
||||||
|
{
|
||||||
|
"update_id": 123456789,
|
||||||
|
"message": {
|
||||||
|
"message_id": 1,
|
||||||
|
"from": { ... },
|
||||||
|
"chat": {
|
||||||
|
"id": -1001234567890, // ← DAS IST DEINE CHAT-ID!
|
||||||
|
"title": "Werkstatt Upload Bot Test",
|
||||||
|
"type": "supergroup"
|
||||||
|
},
|
||||||
|
"text": "Test"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Chat-ID kopieren** (z.B. `-1001234567890`)
|
||||||
|
|
||||||
|
⚠️ **Wichtig:** Gruppen-Chat-IDs sind **negativ** und beginnen meist mit `-100`!
|
||||||
|
|
||||||
|
### Methode 2: Via curl (Linux/WSL)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl "https://api.telegram.org/bot<DEIN_BOT_TOKEN>/getUpdates" | jq '.result[0].message.chat.id'
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. Environment-Datei erstellen
|
||||||
|
|
||||||
|
### 4.1 Template kopieren
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd scripts
|
||||||
|
cp .env.telegram.example .env.telegram
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4.2 `.env.telegram` bearbeiten
|
||||||
|
|
||||||
|
**Datei öffnen:** `scripts/.env.telegram`
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Telegram Bot Configuration
|
||||||
|
TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrsTUVwxyz
|
||||||
|
TELEGRAM_CHAT_ID=-1001234567890
|
||||||
|
```
|
||||||
|
|
||||||
|
**Deine echten Werte eintragen:**
|
||||||
|
- `TELEGRAM_BOT_TOKEN` → Token von BotFather (Schritt 1.3)
|
||||||
|
- `TELEGRAM_CHAT_ID` → Chat-ID aus Schritt 3 (negativ!)
|
||||||
|
|
||||||
|
**Speichern** und schließen.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. Dependencies installieren
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd scripts
|
||||||
|
|
||||||
|
# package.json initialisieren (falls nicht vorhanden)
|
||||||
|
npm init -y
|
||||||
|
|
||||||
|
# Telegram Bot API installieren
|
||||||
|
npm install node-telegram-bot-api dotenv
|
||||||
|
```
|
||||||
|
|
||||||
|
**Erwartete Ausgabe:**
|
||||||
|
```
|
||||||
|
added 15 packages, and audited 16 packages in 2s
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6. Test-Script ausführen
|
||||||
|
|
||||||
|
### 6.1 Script starten
|
||||||
|
|
||||||
|
```bash
|
||||||
|
node telegram-test.js
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6.2 Erwartete Ausgabe (Erfolg)
|
||||||
|
|
||||||
|
```
|
||||||
|
🔧 Lade Telegram-Konfiguration...
|
||||||
|
✅ Konfiguration geladen!
|
||||||
|
|
||||||
|
🤖 Verbinde mit Telegram Bot...
|
||||||
|
✅ Telegram Bot erfolgreich verbunden!
|
||||||
|
|
||||||
|
Bot-Details:
|
||||||
|
Name: Werkstatt Image Uploader Bot
|
||||||
|
Username: @werkstatt_uploader_bot
|
||||||
|
ID: 1234567890
|
||||||
|
|
||||||
|
📤 Sende Test-Nachricht an Chat -1001234567890...
|
||||||
|
✅ Nachricht erfolgreich gesendet!
|
||||||
|
|
||||||
|
Message-ID: 42
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6.3 Telegram-Gruppe prüfen
|
||||||
|
|
||||||
|
**In der Test-Gruppe sollte jetzt erscheinen:**
|
||||||
|
|
||||||
|
```
|
||||||
|
🤖 Telegram Bot Test
|
||||||
|
|
||||||
|
Dies ist eine Test-Nachricht vom Werkstatt Image Uploader Bot.
|
||||||
|
|
||||||
|
Status: ✅ Erfolgreich verbunden!
|
||||||
|
Zeitstempel: 2025-11-29 14:23:45
|
||||||
|
|
||||||
|
---
|
||||||
|
ℹ️ Dieser Bot sendet automatische Benachrichtigungen für den Image Uploader.
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 7. Troubleshooting
|
||||||
|
|
||||||
|
### ❌ Fehler: "Error: Unauthorized (401)"
|
||||||
|
|
||||||
|
**Ursache:** Bot-Token ist falsch oder ungültig
|
||||||
|
|
||||||
|
**Lösung:**
|
||||||
|
1. BotFather öffnen
|
||||||
|
2. `/token` eingeben
|
||||||
|
3. Deinen Bot auswählen
|
||||||
|
4. Neuen Token kopieren
|
||||||
|
5. `.env.telegram` aktualisieren
|
||||||
|
6. Script erneut starten
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### ❌ Fehler: "Bad Request: chat not found"
|
||||||
|
|
||||||
|
**Ursache:** Chat-ID ist falsch
|
||||||
|
|
||||||
|
**Lösung:**
|
||||||
|
1. Test-Gruppe öffnen
|
||||||
|
2. Neue Nachricht senden
|
||||||
|
3. Chat-ID erneut ermitteln (Schritt 3)
|
||||||
|
4. `.env.telegram` aktualisieren
|
||||||
|
5. Script erneut starten
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### ❌ Fehler: "Error: ETELEGRAM: 403 Forbidden"
|
||||||
|
|
||||||
|
**Ursache:** Bot wurde aus der Gruppe entfernt oder kann nicht posten
|
||||||
|
|
||||||
|
**Lösung:**
|
||||||
|
1. Test-Gruppe öffnen
|
||||||
|
2. Prüfen, ob Bot noch Mitglied ist
|
||||||
|
3. Falls nicht: Bot erneut hinzufügen (Schritt 2.2)
|
||||||
|
4. Falls ja: Bot als Admin hinzufügen (Schritt 2.3)
|
||||||
|
5. Script erneut starten
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### ❌ Fehler: "Cannot find module 'node-telegram-bot-api'"
|
||||||
|
|
||||||
|
**Ursache:** Dependencies nicht installiert
|
||||||
|
|
||||||
|
**Lösung:**
|
||||||
|
```bash
|
||||||
|
cd scripts
|
||||||
|
npm install
|
||||||
|
node telegram-test.js
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### ❌ Fehler: "TELEGRAM_BOT_TOKEN is not defined"
|
||||||
|
|
||||||
|
**Ursache:** `.env.telegram` fehlt oder nicht korrekt
|
||||||
|
|
||||||
|
**Lösung:**
|
||||||
|
1. Prüfen, ob `.env.telegram` existiert: `ls -la scripts/.env.telegram`
|
||||||
|
2. Falls nicht: Template kopieren (Schritt 4.1)
|
||||||
|
3. Werte eintragen (Schritt 4.2)
|
||||||
|
4. Script erneut starten
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 8. Erweiterte Tests
|
||||||
|
|
||||||
|
### Test 1: Formatierung mit Emojis
|
||||||
|
|
||||||
|
**Script anpassen:** `telegram-test.js`
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
const message = `
|
||||||
|
📸 Neuer Upload!
|
||||||
|
|
||||||
|
Uploader: Max Mustermann
|
||||||
|
Bilder: 12
|
||||||
|
Gruppe: 2024 - Schweißkurs November
|
||||||
|
|
||||||
|
Workshop: ✅ Ja
|
||||||
|
Social Media: 📘 Instagram, 🎵 TikTok
|
||||||
|
|
||||||
|
🔗 Zur Freigabe: https://internal.hobbyhimmel.de/moderation
|
||||||
|
`;
|
||||||
|
|
||||||
|
bot.sendMessage(chatId, message);
|
||||||
|
```
|
||||||
|
|
||||||
|
**Ausführen:**
|
||||||
|
```bash
|
||||||
|
node telegram-test.js
|
||||||
|
```
|
||||||
|
|
||||||
|
**Telegram prüfen:** Emojis sollten korrekt angezeigt werden
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Test 2: HTML-Formatierung
|
||||||
|
|
||||||
|
**Script anpassen:**
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
const message = `
|
||||||
|
<b>🤖 Telegram Bot Test</b>
|
||||||
|
|
||||||
|
<i>HTML-Formatierung funktioniert!</i>
|
||||||
|
|
||||||
|
<code>Status: ✅ Erfolgreich</code>
|
||||||
|
|
||||||
|
<a href="https://hobbyhimmel.de">Link zur Website</a>
|
||||||
|
`;
|
||||||
|
|
||||||
|
bot.sendMessage(chatId, message, { parse_mode: 'HTML' });
|
||||||
|
```
|
||||||
|
|
||||||
|
**Ausführen & prüfen:** Fetter Text, kursiver Text, Code, Link
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Test 3: Markdown-Formatierung
|
||||||
|
|
||||||
|
**Script anpassen:**
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
const message = `
|
||||||
|
*🤖 Telegram Bot Test*
|
||||||
|
|
||||||
|
_Markdown-Formatierung funktioniert!_
|
||||||
|
|
||||||
|
\`Status: ✅ Erfolgreich\`
|
||||||
|
|
||||||
|
[Link zur Website](https://hobbyhimmel.de)
|
||||||
|
`;
|
||||||
|
|
||||||
|
bot.sendMessage(chatId, message, { parse_mode: 'Markdown' });
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 9. Sicherheit
|
||||||
|
|
||||||
|
### ⚠️ Wichtig!
|
||||||
|
|
||||||
|
- ❌ **NIEMALS** `.env.telegram` committen!
|
||||||
|
- ❌ **NIEMALS** Bot-Token öffentlich teilen!
|
||||||
|
- ✅ `.env.telegram` ist in `.gitignore` eingetragen
|
||||||
|
- ✅ Nur `.env.telegram.example` (ohne echte Tokens) committen
|
||||||
|
|
||||||
|
### Bot-Token kompromittiert?
|
||||||
|
|
||||||
|
**Falls Token versehentlich exposed:**
|
||||||
|
|
||||||
|
1. BotFather öffnen
|
||||||
|
2. `/revoke` eingeben
|
||||||
|
3. Deinen Bot auswählen
|
||||||
|
4. **Neuen Token** kopieren
|
||||||
|
5. `.env.telegram` aktualisieren
|
||||||
|
6. Alle Services neu starten
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 10. Nächste Schritte
|
||||||
|
|
||||||
|
### ✅ Phase 1 abgeschlossen?
|
||||||
|
|
||||||
|
Checklist:
|
||||||
|
- [x] Bot erstellt
|
||||||
|
- [x] Test-Gruppe erstellt
|
||||||
|
- [x] Bot zur Gruppe hinzugefügt
|
||||||
|
- [x] Chat-ID ermittelt
|
||||||
|
- [x] `.env.telegram` konfiguriert
|
||||||
|
- [x] `npm install` erfolgreich
|
||||||
|
- [x] `node telegram-test.js` läuft ohne Fehler
|
||||||
|
- [x] Test-Nachricht in Telegram empfangen
|
||||||
|
|
||||||
|
### ➡️ Weiter zu Phase 2
|
||||||
|
|
||||||
|
**Backend-Integration:**
|
||||||
|
1. `TelegramNotificationService.js` erstellen
|
||||||
|
2. Service in Docker Dev Environment integrieren
|
||||||
|
3. ENV-Variablen in Backend übertragen
|
||||||
|
4. Unit-Tests schreiben
|
||||||
|
|
||||||
|
**Siehe:** `FeatureRequests/FEATURE_PLAN-telegram.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Referenzen
|
||||||
|
|
||||||
|
- [Telegram Bot API Dokumentation](https://core.telegram.org/bots/api)
|
||||||
|
- [node-telegram-bot-api (npm)](https://www.npmjs.com/package/node-telegram-bot-api)
|
||||||
|
- [BotFather Commands](https://core.telegram.org/bots#botfather)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Support
|
||||||
|
|
||||||
|
**Bei Problemen:**
|
||||||
|
1. Troubleshooting-Sektion durchlesen (Schritt 7)
|
||||||
|
2. Telegram Bot API Logs prüfen
|
||||||
|
3. BotFather `/mybots` → Bot auswählen → API Token prüfen
|
||||||
|
4. Chat-ID erneut ermitteln
|
||||||
|
|
||||||
|
**Erfolgreicher Test? 🎉**
|
||||||
|
```bash
|
||||||
|
git add scripts/
|
||||||
|
git commit -m "feat: Add Telegram Bot standalone test (Phase 1)"
|
||||||
|
```
|
||||||
|
|
@ -39,6 +39,8 @@ changed = False
|
||||||
|
|
||||||
cookie_pattern = re.compile(r'(\-\s*ADMIN_SESSION_COOKIE_SECURE\s*=\s*)([^\n\r]+)')
|
cookie_pattern = re.compile(r'(\-\s*ADMIN_SESSION_COOKIE_SECURE\s*=\s*)([^\n\r]+)')
|
||||||
secret_pattern = re.compile(r'(\-\s*ADMIN_SESSION_SECRET\s*=\s*)([^\n\r]+)')
|
secret_pattern = re.compile(r'(\-\s*ADMIN_SESSION_SECRET\s*=\s*)([^\n\r]+)')
|
||||||
|
telegram_token_pattern = re.compile(r'(\-\s*TELEGRAM_BOT_TOKEN\s*=\s*)([^\n\r${}]+)')
|
||||||
|
telegram_chat_pattern = re.compile(r'(\-\s*TELEGRAM_CHAT_ID\s*=\s*)(-?\d{10,})')
|
||||||
|
|
||||||
def ensure_entry(text, *, pattern, value, anchor_line, expected_line, label):
|
def ensure_entry(text, *, pattern, value, anchor_line, expected_line, label):
|
||||||
match = pattern.search(text)
|
match = pattern.search(text)
|
||||||
|
|
@ -80,6 +82,18 @@ if secret_expected not in new_text:
|
||||||
print('ERROR: Failed to ensure ADMIN_SESSION_SECRET uses environment variable in docker-compose.yml', file=sys.stderr)
|
print('ERROR: Failed to ensure ADMIN_SESSION_SECRET uses environment variable in docker-compose.yml', file=sys.stderr)
|
||||||
sys.exit(4)
|
sys.exit(4)
|
||||||
|
|
||||||
|
telegram_token_match = telegram_token_pattern.search(new_text)
|
||||||
|
if telegram_token_match and telegram_token_match.group(2).strip() not in ['${TELEGRAM_BOT_TOKEN}', '']:
|
||||||
|
print(f'ERROR: TELEGRAM_BOT_TOKEN contains hardcoded secret: {telegram_token_match.group(2)[:20]}...', file=sys.stderr)
|
||||||
|
print(' Use ${TELEGRAM_BOT_TOKEN} placeholder instead!', file=sys.stderr)
|
||||||
|
sys.exit(5)
|
||||||
|
|
||||||
|
telegram_chat_match = telegram_chat_pattern.search(new_text)
|
||||||
|
if telegram_chat_match:
|
||||||
|
print(f'ERROR: TELEGRAM_CHAT_ID contains hardcoded value: {telegram_chat_match.group(2)}', file=sys.stderr)
|
||||||
|
print(' Use ${TELEGRAM_CHAT_ID} placeholder instead!', file=sys.stderr)
|
||||||
|
sys.exit(6)
|
||||||
|
|
||||||
if changed:
|
if changed:
|
||||||
path.write_text(new_text)
|
path.write_text(new_text)
|
||||||
print('UPDATED')
|
print('UPDATED')
|
||||||
|
|
|
||||||
20
scripts/package.json
Normal file
20
scripts/package.json
Normal file
|
|
@ -0,0 +1,20 @@
|
||||||
|
{
|
||||||
|
"name": "telegram-test-scripts",
|
||||||
|
"version": "1.0.0",
|
||||||
|
"description": "Standalone Telegram Bot Testing Scripts for Image Uploader",
|
||||||
|
"main": "telegram-test.js",
|
||||||
|
"scripts": {
|
||||||
|
"test": "node telegram-test.js"
|
||||||
|
},
|
||||||
|
"keywords": [
|
||||||
|
"telegram",
|
||||||
|
"bot",
|
||||||
|
"testing"
|
||||||
|
],
|
||||||
|
"author": "Werkstatt Hobbyhimmel",
|
||||||
|
"license": "ISC",
|
||||||
|
"dependencies": {
|
||||||
|
"dotenv": "^17.2.3",
|
||||||
|
"node-telegram-bot-api": "^0.66.0"
|
||||||
|
}
|
||||||
|
}
|
||||||
166
scripts/telegram-test.js
Normal file
166
scripts/telegram-test.js
Normal file
|
|
@ -0,0 +1,166 @@
|
||||||
|
#!/usr/bin/env node
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Telegram Bot Standalone Test Script
|
||||||
|
*
|
||||||
|
* Testet die grundlegende Funktionalität des Telegram Bots
|
||||||
|
* ohne Integration in das Backend.
|
||||||
|
*
|
||||||
|
* Phase 1: Bot Setup & Standalone-Test
|
||||||
|
*
|
||||||
|
* Usage:
|
||||||
|
* node telegram-test.js
|
||||||
|
*
|
||||||
|
* Prerequisites:
|
||||||
|
* - .env.telegram mit TELEGRAM_BOT_TOKEN und TELEGRAM_CHAT_ID
|
||||||
|
* - npm install node-telegram-bot-api dotenv
|
||||||
|
*/
|
||||||
|
|
||||||
|
require('dotenv').config({ path: '.env.telegram' });
|
||||||
|
const TelegramBot = require('node-telegram-bot-api');
|
||||||
|
|
||||||
|
// =============================================================================
|
||||||
|
// Configuration
|
||||||
|
// =============================================================================
|
||||||
|
|
||||||
|
const BOT_TOKEN = process.env.TELEGRAM_BOT_TOKEN;
|
||||||
|
const CHAT_ID = process.env.TELEGRAM_CHAT_ID;
|
||||||
|
|
||||||
|
// =============================================================================
|
||||||
|
// Validation
|
||||||
|
// =============================================================================
|
||||||
|
|
||||||
|
console.log('🔧 Lade Telegram-Konfiguration...');
|
||||||
|
|
||||||
|
if (!BOT_TOKEN) {
|
||||||
|
console.error('❌ FEHLER: TELEGRAM_BOT_TOKEN ist nicht definiert!');
|
||||||
|
console.error('');
|
||||||
|
console.error('Bitte .env.telegram erstellen und Bot-Token eintragen:');
|
||||||
|
console.error('');
|
||||||
|
console.error(' TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrsTUVwxyz');
|
||||||
|
console.error(' TELEGRAM_CHAT_ID=-1001234567890');
|
||||||
|
console.error('');
|
||||||
|
console.error('Siehe: scripts/README.telegram.md');
|
||||||
|
process.exit(1);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!CHAT_ID) {
|
||||||
|
console.error('❌ FEHLER: TELEGRAM_CHAT_ID ist nicht definiert!');
|
||||||
|
console.error('');
|
||||||
|
console.error('Bitte .env.telegram erstellen und Chat-ID eintragen:');
|
||||||
|
console.error('');
|
||||||
|
console.error(' TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrsTUVwxyz');
|
||||||
|
console.error(' TELEGRAM_CHAT_ID=-1001234567890');
|
||||||
|
console.error('');
|
||||||
|
console.error('Chat-ID ermitteln: https://api.telegram.org/bot<TOKEN>/getUpdates');
|
||||||
|
console.error('Siehe: scripts/README.telegram.md');
|
||||||
|
process.exit(1);
|
||||||
|
}
|
||||||
|
|
||||||
|
console.log('✅ Konfiguration geladen!');
|
||||||
|
console.log('');
|
||||||
|
|
||||||
|
// =============================================================================
|
||||||
|
// Bot Initialization
|
||||||
|
// =============================================================================
|
||||||
|
|
||||||
|
console.log('🤖 Verbinde mit Telegram Bot...');
|
||||||
|
|
||||||
|
// Create bot instance (polling disabled for one-off script)
|
||||||
|
const bot = new TelegramBot(BOT_TOKEN, { polling: false });
|
||||||
|
|
||||||
|
// =============================================================================
|
||||||
|
// Main Test Function
|
||||||
|
// =============================================================================
|
||||||
|
|
||||||
|
async function runTest() {
|
||||||
|
try {
|
||||||
|
// Step 1: Verify bot connection
|
||||||
|
const botInfo = await bot.getMe();
|
||||||
|
|
||||||
|
console.log('✅ Telegram Bot erfolgreich verbunden!');
|
||||||
|
console.log('');
|
||||||
|
console.log('Bot-Details:');
|
||||||
|
console.log(` Name: ${botInfo.first_name}`);
|
||||||
|
console.log(` Username: @${botInfo.username}`);
|
||||||
|
console.log(` ID: ${botInfo.id}`);
|
||||||
|
console.log('');
|
||||||
|
|
||||||
|
// Step 2: Prepare test message
|
||||||
|
const timestamp = new Date().toLocaleString('de-DE', {
|
||||||
|
year: 'numeric',
|
||||||
|
month: '2-digit',
|
||||||
|
day: '2-digit',
|
||||||
|
hour: '2-digit',
|
||||||
|
minute: '2-digit',
|
||||||
|
second: '2-digit'
|
||||||
|
});
|
||||||
|
|
||||||
|
const message = `
|
||||||
|
🤖 Telegram Bot Test
|
||||||
|
|
||||||
|
Dies ist eine Test-Nachricht vom Werkstatt Image Uploader Bot.
|
||||||
|
|
||||||
|
Status: ✅ Erfolgreich verbunden!
|
||||||
|
Zeitstempel: ${timestamp}
|
||||||
|
|
||||||
|
---
|
||||||
|
ℹ️ Dieser Bot sendet automatische Benachrichtigungen für den Image Uploader.
|
||||||
|
`.trim();
|
||||||
|
|
||||||
|
// Step 3: Send test message
|
||||||
|
console.log(`📤 Sende Test-Nachricht an Chat ${CHAT_ID}...`);
|
||||||
|
|
||||||
|
const sentMessage = await bot.sendMessage(CHAT_ID, message);
|
||||||
|
|
||||||
|
console.log('✅ Nachricht erfolgreich gesendet!');
|
||||||
|
console.log('');
|
||||||
|
console.log(`Message-ID: ${sentMessage.message_id}`);
|
||||||
|
console.log('');
|
||||||
|
console.log('🎉 Test erfolgreich abgeschlossen!');
|
||||||
|
console.log('');
|
||||||
|
console.log('➡️ Nächste Schritte:');
|
||||||
|
console.log(' 1. Telegram-Gruppe öffnen und Nachricht prüfen');
|
||||||
|
console.log(' 2. Verschiedene Nachrichtenformate testen (siehe README.telegram.md)');
|
||||||
|
console.log(' 3. Phase 2 starten: Backend-Integration');
|
||||||
|
|
||||||
|
} catch (error) {
|
||||||
|
console.error('❌ FEHLER beim Senden der Nachricht:');
|
||||||
|
console.error('');
|
||||||
|
|
||||||
|
if (error.response && error.response.body) {
|
||||||
|
const errorData = error.response.body;
|
||||||
|
console.error(`Error Code: ${errorData.error_code}`);
|
||||||
|
console.error(`Description: ${errorData.description}`);
|
||||||
|
console.error('');
|
||||||
|
|
||||||
|
// Helpful error messages
|
||||||
|
if (errorData.error_code === 401) {
|
||||||
|
console.error('💡 Lösung: Bot-Token ist ungültig oder falsch.');
|
||||||
|
console.error(' → BotFather öffnen und Token prüfen');
|
||||||
|
console.error(' → .env.telegram aktualisieren');
|
||||||
|
} else if (errorData.error_code === 400 && errorData.description.includes('chat not found')) {
|
||||||
|
console.error('💡 Lösung: Chat-ID ist falsch oder ungültig.');
|
||||||
|
console.error(' → Chat-ID erneut ermitteln: https://api.telegram.org/bot<TOKEN>/getUpdates');
|
||||||
|
console.error(' → Neue Nachricht in Gruppe senden, dann getUpdates aufrufen');
|
||||||
|
console.error(' → .env.telegram aktualisieren');
|
||||||
|
} else if (errorData.error_code === 403) {
|
||||||
|
console.error('💡 Lösung: Bot hat keine Berechtigung, in diese Gruppe zu schreiben.');
|
||||||
|
console.error(' → Bot zur Gruppe hinzufügen');
|
||||||
|
console.error(' → Bot als Admin hinzufügen (empfohlen)');
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
console.error(error.message);
|
||||||
|
}
|
||||||
|
|
||||||
|
console.error('');
|
||||||
|
console.error('📖 Siehe Troubleshooting: scripts/README.telegram.md');
|
||||||
|
process.exit(1);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// =============================================================================
|
||||||
|
// Execute Test
|
||||||
|
// =============================================================================
|
||||||
|
|
||||||
|
runTest();
|
||||||
Loading…
Reference in New Issue
Block a user