# StoryBench

**Internes Redaktions-Tool für bundesstadt.com**

StoryBench aggregiert News aus relevanten Bonner Quellen, clustert zusammenhängende Themen und generiert automatisch Story-Vorschläge für die Redaktion.

## Features

- 📰 **News-Aggregation** - RSS-Feeds & Web-Scraping
- 🔍 **Themen-Clustering** - Automatische Gruppierung zusammenhängender Meldungen
- 🎯 **Relevanz-Scoring** - KI-gestützte Priorisierung
- 📊 **Story-Vorschläge** - Automatische Generierung von Artikel-Ideen
- 🎨 **Dashboard** - HTMX-basiertes Interface
- 🔗 **Integrationen** - Taiga (Redaktionsplanung) & Mattermost (Alerts)

## Technologie-Stack

- **Backend:** PocketBase 0.36.5
- **Frontend:** HTMX + Alpine.js
- **Database:** SQLite (embedded)
- **Testing:** Mocha + Playwright

## Lokale Entwicklung

### Voraussetzungen

- PocketBase Binary (bereits in `bin/pocketbase`)
- Node.js 18+ (für Tests)

### Installation

```bash
# 1. Dependencies installieren (für Tests)
cd storybench
npm install

# 2. Environment Variables konfigurieren
cp .env.example .env
# .env bearbeiten und Credentials eintragen
```

### Starten

```bash
# Option 1: Direkt
cd storybench
./bin/pocketbase serve --http="127.0.0.1:8090"

# Option 2: Via Makefile (aus storybench/)
cd storybench
make dev

# Option 3: Via Makefile (aus Projekt-Root)
make storybench-dev
```

### Admin-UI

**URL:** http://127.0.0.1:8090/_/

Beim ersten Start:
1. Admin-Account erstellen
2. Collections werden automatisch angelegt (via Migrations)

### Dashboard-UI

**URL:** http://127.0.0.1:8090/dashboard

Login mit PocketBase-User-Account.

## Projektstruktur

```
storybench/
├── bin/
│   └── pocketbase              # PocketBase Binary
├── pb_data/                    # Datenbank & Uploads (auto-generiert)
│   ├── data.db
│   └── storage/
├── pb_hooks/                   # JavaScript Hooks
│   ├── scanner_rss.pb.js       # RSS-Scanner
│   ├── processing_*.pb.js      # Processing-Pipeline
│   ├── clustering_*.pb.js      # Clustering-Engine
│   ├── story_generator.pb.js   # Story-Generator
│   ├── api_*.pb.js             # API-Endpoints
│   └── integration_*.pb.js     # Taiga & Mattermost
├── pb_migrations/              # Datenbank-Migrationen
│   ├── 001_initial_schema.js
│   ├── 002_seed_ressorts.js
│   └── 003_seed_translations.js
├── pb_public/                  # Frontend
│   ├── _layout.html
│   ├── dashboard.html
│   └── assets/
│       └── dashboard.css
├── src/lib/                    # Utilities
├── test/                       # Tests
│   ├── unit/
│   ├── integration/
│   └── e2e/
├── README.md
├── package.json
└── .env.example
```

## Collections

### news_sources
News-Quellen (RSS, Scraper, API)

### news_items
Einzelne News-Meldungen

### news_clusters
Gruppierte Themen

### story_suggestions
Story-Vorschläge für Redaktion

### ressorts
Ressort-Konfiguration (Politik, Kultur, Sport, etc.)

### translations
i18n-Übersetzungen (DE/EN)

## Makefile Targets

StoryBench hat ein eigenes Makefile mit praktischen Shortcuts:

```bash
# Aus storybench/ Verzeichnis:
make dev              # Start PocketBase development server
make admin            # Open Admin UI in browser
make test             # Run all tests
make test-unit        # Run unit tests only
make test-integration # Run integration tests only
make test-e2e         # Run E2E tests
make coverage         # Run tests with coverage report
make backup           # Create database backup
make install          # Install npm dependencies
make status           # Show project status
make clean            # Clean generated files
make clean-all        # Clean everything including database (DANGEROUS!)
make help             # Show all available targets

# Aus Projekt-Root:
make storybench-dev   # Delegates to: cd storybench && make dev
make storybench-test  # Delegates to: cd storybench && make test
# etc.
```

## Development

### Tests ausführen

```bash
# Unit-Tests
npm test

# Watch-Mode
npm run test:watch

# Coverage
npm run test:coverage

# E2E-Tests
npm run test:e2e
```

### Neue Quelle hinzufügen

1. Admin-UI öffnen: http://127.0.0.1:8090/_/
2. Collection `news_sources` öffnen
3. Neuen Record erstellen:
   - **name:** Name der Quelle
   - **type:** rss, scraper, oder api
   - **url:** Feed-URL oder Webseiten-URL
   - **scan_interval:** Minuten zwischen Scans (Standard: 15)
   - **active:** true
   - **priority:** 1-10 (höher = wichtiger)
   - **default_ressort:** Politik, Kultur, Sport, etc.

### Manuellen Scan triggern

```bash
# Via API
curl -X POST http://127.0.0.1:8090/api/scanner/trigger/{source_id}

# Via Dashboard
Dashboard → Sources → "Jetzt scannen" Button
```

## Deployment

### Produktion (VPS)

**Domain:** bonn.storybench.de  
**Port:** 8090 (intern)  
**Reverse Proxy:** nginx  
**SSL:** Let's Encrypt

Siehe [`plans/storybench-updat`](../plans/storybench-updat) für Details.

### Systemd-Service

```bash
# Service-Datei: /etc/systemd/system/storybench.service
sudo systemctl enable storybench
sudo systemctl start storybench
sudo systemctl status storybench
```

### Backup

```bash
# Manuell
./bin/pocketbase backup

# Automatisch (via Cron)
# Siehe plans/storybench-updat für Backup-Script
```

## Environment Variables

```bash
# PocketBase
PB_ADMIN_EMAIL=admin@bundesstadt.com
PB_ADMIN_PASSWORD=

# Taiga Integration
TAIGA_URL=https://taiga.bundesstadt.com
TAIGA_TOKEN=
TAIGA_PROJECT_ID=

# Mattermost Integration
MATTERMOST_WEBHOOK_URL=

# Development
NODE_ENV=development
```

## Troubleshooting

### PocketBase startet nicht

```bash
# Port bereits belegt?
lsof -i :8090

# Logs prüfen
./bin/pocketbase serve --http="127.0.0.1:8090" --debug
```

### Scanner läuft nicht

1. Admin-UI → Logs prüfen
2. Quelle aktiv? (`active = true`)
3. URL erreichbar?
4. Cron-Jobs laufen? (siehe Logs)

### Dashboard zeigt keine Daten

1. Sind Quellen konfiguriert?
2. Wurde bereits gescannt? (siehe `last_scan` in `news_sources`)
3. Sind Items vorhanden? (Admin-UI → `news_items`)
4. User eingeloggt?

## Dokumentation

- **Build-Plan:** [`plans/storybench-build-plan.md`](../plans/storybench-build-plan.md)
- **News-Aggregation:** [`plans/redaktions-tool-newsaggregation.md`](../plans/redaktions-tool-newsaggregation.md)
- **Implementation:** [`plans/redaktions-tool-implementation.md`](../plans/redaktions-tool-implementation.md)
- **Deployment:** [`plans/storybench-updat`](../plans/storybench-updat)

## Lizenz

Internes Tool für bundesstadt.com - Nicht für öffentliche Nutzung bestimmt.

## Kontakt

**Projekt:** Hub Bonn  
**Repository:** /home/olav/Dokumente/Hub-Bonn