docs: initial project documentation for 0012.de webspace

Document hosting setup, external monitoring architecture, landing page concept, env template, and phased todo checklist for the wint.global Classic 1.0 counterpart to boka. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-11 22:25:56 +02:00
commit 54d29d3afa
16 changed files with 803 additions and 0 deletions
@@ -0,0 +1,72 @@
+# 0012.de — Webspace-Projekt
+
+Repository für den **wint.global Classic 1.0** Webspace (`0012.de`): Deployment, Betrieb und Dokumentation.
+
+Dieser Webspace ist bewusst **unabhängig vom vServer `boka`** (Webtropia Cloud VPS, `89.163.231.180`) aufgesetzt. Er dient als externer Beobachter, Mail-Relay und leichtgewichtiger Begleiter — nicht als Ersatz für den VPS.
+
+## Rollen
+
+| Rolle | Beschreibung |
+|-------|--------------|
+| **Externes Monitoring** | Cron-gestützte PHP-Checks auf Erreichbarkeit, SSL und (später) Push-Metriken von boka |
+| **Alarmierung** | E-Mail (und optional Telegram) bei Ausfällen — vom Webspace aus, ohne Zugang zu boka |
+| **SMTP-Relay** | Prozesse auf boka und anderswo können über den Plesk-Mailserver von 0012.de senden |
+| **Mail-Hosting** | Postfächer für Domains, die noch keinen eigenen Mailserver haben |
+| **Öffentliche Präsenz** | Minimale, aber sinnvolle Landing Page statt leerer Domain |
+
+## Hosting
+
+- **Paket:** Classic 1.0 / 15 GB, Traffic unlimitiert ([Produktseite](https://wint.global/linux-hosting-pakete-plesk/))
+- **Domain:** `0012.de`
+- **Panel:** Plesk auf `ha01s019.org-dns.com`
+- **Details:** [`HOSTING.md`](HOSTING.md)
+
+Zugangsdaten gehören in `.env` (Vorlage: [`.env.example`](.env.example)). **Niemals committen.**
+
+## Monitoring
+
+Architektur und Prioritäten: [`MONITORING.md`](MONITORING.md)
+
+Kurzfassung:
+
+- **Pull:** PHP-Cron auf 0012.de prüft HTTPS/SSL/TCP von außen (alle 5–15 Min)
+- **Push:** Cron auf boka postet JSON an `ingest.php` (Disk, RAM, Container, Backup-Heartbeat)
+
+## vServer boka (Gegenstück)
+
+| | |
+|---|---|
+| Anbieter | Webtropia Cloud VPS S Linux NVMe |
+| IP | `89.163.231.180` |
+| Hostname | `boka` |
+| Dienste | Traefik, Gitea, Immich, viele `*.schwenk.online`-Apps, u. a. |
+
+Der Webspace sieht boka **von außen** — interne Metriken brauchen das Push-Skript auf boka.
+
+## Projektstruktur (Ziel)
+
+```
+0012/
+├── README.md
+├── HOSTING.md
+├── MONITORING.md
+├── SITE.md                 # Konzept Landing Page
+├── .env.example
+├── public/                 # Document Root (FTP → httpdocs)
+│   ├── index.php           # Status-Beacon Landing
+│   ├── monitor.php         # Cron: Pull-Checks
+│   └── ingest.php          # Empfang Push von boka
+├── config/                 # PHP-Konfiguration (lädt .env)
+└── todo/                   # Aufgabenliste
+```
+
+## Aufgaben
+
+Offene Arbeiten: [`todo/README.md`](todo/README.md)
+
+## Schnellstart (wenn eingerichtet)
+
+1. `.env.example` → `.env` kopieren und ausfüllen
+2. Dateien nach `httpdocs/` deployen (FTP/rsync)
+3. In Plesk: geplante Aufgabe für `monitor.php` (Cron-Stil, z. B. `*/10 * * * *`)
+4. Auf boka: Push-Skript + Crontab (siehe `todo/04-monitoring-push-boka.md`)