docs: add VibeSoul context, SOUL.md, and README

Project character, agent rules, and run/deploy docs for mobea.de. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-01 11:52:00 +02:00
parent 5961293faa
commit b9ad7f0c40
9 changed files with 955 additions and 0 deletions
@@ -0,0 +1,113 @@
+# mobea.de
+
+Tägliche Satire-Website — [mobea.de](https://mobea.de/)
+
+*Das Startup, das jeden Tag ein anderes Startup ist.*
+
+**Vision & Ton:** [SOUL.md](SOUL.md)
+
+## Was passiert hier?
+
+Ein Python-Generator erfindet jeden Tag ein neues absurdes Startup (OpenRouter), rendert eine Landing Page (Jinja2) und legt optional ein Hero-Bild an (Pixazo SDXL). Ausgabe landet in `public/`; nginx liefert statisch aus. Alle Kauf-/Kontakt-Links führen zu `/echt-jetzt/` — Satire-Disclaimer, kein echtes Produkt.
+
+## Projektstruktur
+
+```text
+/
+├── compose.yml              # nginx + Generator (Produktion)
+├── nginx.conf
+├── generator/
+│   ├── generate.py          # Tages-Generator
+│   ├── backfill.py          # Archiv-Lücken nachfüllen
+│   ├── topics.py            # Themen-Pool
+│   ├── templates/           # startup.html.j2, archiv.html.j2
+│   └── Dockerfile
+├── public/                  # Webroot (teilweise generiert, siehe unten)
+│   └── echt-jetzt/          # Fourth-Wall-Seite (im Repo)
+└── data/                    # archive.json (generiert, gitignored)
+```
+
+## Voraussetzungen
+
+- Docker + Docker Compose (Produktion)
+- Optional lokal: Python 3.12+, `venv`
+- API-Keys in `.env` (Vorlage: [`.env.example`](.env.example))
+
+| Variable | Zweck |
+|----------|--------|
+| `OPENROUTER_API_KEY` | Text-Generierung (Pflicht) |
+| `OPENROUTER_MODEL` | z. B. `openai/gpt-4o-mini` |
+| `PIXAZO_API_KEY` | Hero-Bild (optional) |
+
+## Lokale Entwicklung
+
+### Generator einmal ausführen
+
+```sh
+cp .env.example .env   # Keys eintragen
+
+cd generator
+python -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+
+SITE_DIR=../public DATA_DIR=../data python generate.py
+```
+
+Der Generator läuft standardmäßig ab **05:00 UTC** pro Tag; vorher wird eine bestehende Edition nicht überschrieben. Für erneutes Generieren am selben Tag: `public/index.html` und den heutigen Eintrag in `data/archive.json` entfernen.
+
+### Archiv backfillen
+
+```sh
+cd generator
+source .venv/bin/activate
+SITE_DIR=../public DATA_DIR=../data python backfill.py --from 2026-01-01 --to 2026-01-07
+```
+
+### Statische Seite lokal ansehen
+
+Nach einem Generator-Lauf (oder mit vorhandenem `public/index.html`):
+
+```sh
+docker run --rm -p 8080:80 \
+  -v "$(pwd)/public:/usr/share/nginx/html:ro" \
+  -v "$(pwd)/nginx.conf:/etc/nginx/nginx.conf:ro" \
+  nginx
+```
+
+→ [http://localhost:8080](http://localhost:8080)
+
+### Mit Docker Compose (wie auf dem Server)
+
+```sh
+cp .env.example .env
+docker compose up -d --build
+```
+
+Benötigt das externe Netzwerk `traefik` (auf `boka` vorhanden). Lokal ggf. nur den Generator-Container nutzen oder das Netzwerk einmal anlegen: `docker network create traefik`.
+
+## Deployment
+
+Manuell per SSH auf `boka` — siehe auch [INFRASTRUCTURE.md](INFRASTRUCTURE.md).
+
+```sh
+ssh frank-schwenk.de
+cd /home/frank/mobea.de
+git pull
+docker compose up -d --build
+```
+
+Der Generator-Container versucht stündlich `generate.py`; ein Fehlschlag stoppt die Schleife nicht.
+
+## Was im Repo liegt vs. generiert wird
+
+| Im Git | Generiert (gitignored) |
+|--------|-------------------------|
+| `public/echt-jetzt/`, Favicon, Manifest, `robots.txt` | `public/index.html` |
+| `generator/templates/`, Python-Code | `public/archiv/` |
+| | `public/img/` |
+| | `data/archive.json` |
+
+## Tests
+
+Keine automatisierte Test-Suite. Nach UI-Änderungen: Generator-Lauf + Seite in Mobile-Breite (~390px) prüfen.