docs: dev-Doku für den Live-Betrieb neu sortiert — Archiv + Betrieb + Roadmap

Das System ist seit 20.07.2026 live; die dev-Doku spiegelt jetzt den
Betriebszustand statt der Release-Vorbereitung:

- dev/betrieb/: Deploy-Runbook (neu: §10 Betrieb nach Go-Live mit
  SFTP-Deploy-Checkliste inkl. queue:restart-Pflicht und den
  Betriebs-Erkenntnissen der Go-Live-Woche), Legacy-API-Parität, Umami.
- dev/roadmap.md: offene Nachlauf-Punkte (Go-Live-Mails, Merge nach main,
  Stripe-Test-Artefakte, Key-Rotation, Alt-System-Abschaltung) und
  Ideen-Backlog.
- dev/archive/: abgeschlossene Phasen — Migration-2026-Planung,
  Cutover-Runbook (mit Erledigt-Vermerk), Release-Plan/QA-Checkliste,
  Optimierungsphasen, Frontend-Konzepte + Responsive-Audits vom 16.07.,
  Altsystem-Reste.
- dev/README.md als Wegweiser; gitignore-Pfad der SQL-Dumps mitgezogen
  (dev/archive/migration-2026/sql/ bleibt untracked, ebenso dev/migration/
  und dev/api/).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Kevin Adametz 2026-07-21 07:52:38 +00:00
parent 58c773b153
commit 6a4c4d8837
360 changed files with 923 additions and 1 deletions

38
dev/README.md Normal file
View file

@ -0,0 +1,38 @@
# dev/ — Projekt- und Betriebsdokumentation
Stand: 20.07.2026 — **das System ist live** (pressekonto.com, presseecho.de,
businessportal24.com). Die Struktur trennt aktive Betriebs-/Planungsdoku von
abgeschlossenen Phasen (Archiv).
## Aktiv
| Pfad | Inhalt |
| --- | --- |
| `betrieb/deploy-runbook.md` | Deploy- und Betriebs-Runbook (SFTP-Deploy-Checkliste, Worker, Scheduler, Stripe-Webhook, Rollback) — **erste Anlaufstelle für alles Operative** |
| `betrieb/api-legacy-paritaet.md` | Verhaltens-Referenz der Legacy-API-Kompatibilitätsschicht (`/service/…`) — lebendes Dokument, solange Alt-Integrationen (Connektar) die Pfade nutzen |
| `betrieb/umami.md` | Umami-Analytics-Snippets je Domain |
| `roadmap.md` | Offene Punkte und nächste Entwicklungen/Optimierungen |
## Lokal / gitignored (bleiben liegen, nicht committen)
| Pfad | Inhalt |
| --- | --- |
| `migration/` | Medien-Staging der Legacy-Migration (~7 GB Uploads beider Altportale) — Quelle für `legacy:migrate-media`; behalten, bis das Alt-System endgültig abgeschaltet und ein Server-Backup gezogen ist |
| `api/` | Postman-Collection (enthält API-Keys!) und Activity-Log-Auswertungen der Alt-APIs |
| `archive/migration-2026/sql/` | Legacy-DB-Dumps (Snapshots vom 23.04.2026) |
## Archiv (`archive/`)
Abgeschlossene Phasen, als Historie/Referenz erhalten:
- `optimize/` — System-Optimierungsphasen 0–6 **und das Cutover-Runbook der
Legacy-Migration** (erledigt 20.07.2026; enthält weiterhin die Anleitung für
`--since`-Delta-Läufe, falls das Alt-System noch einmal Daten liefert)
- `release/` — Release-Entwicklungsplan, manuelle QA-Checkliste,
Boost-Platzierungs-Entscheidung
- `migration-2026/` — Analyse- und Planungsdoku der Legacy-Migration
(Datenmodell, Merge-Strategie, API-Kunden, Fortschritt)
- `frontend/` + `frontend-audits/` — Frontend-Konzepte und die
Responsive-/Mobile-Audits vom 16.07.
- `agentur-attribution/`, `legacy_logging/`, `legacy_performance/`, `_old/` —
ältere Einzelthemen bzw. Altsystem-Reste