docs: add PROJECT_MAP, AGENTS.md; add PROJECT_MAP update rule to CLAUDE.md

2026-04-03 11:14:35 +02:00
parent 6ac0376539
commit 8ea3b14860
3 changed files with 208 additions and 0 deletions
@@ -0,0 +1,42 @@
+# CLAUDE.md – helldivers
+
+## Overview
+Port: 3012
+Type: Authenticated Multiplayer App (WebSocket, SQLite, ELO-Rating, Bcrypt, Helmet)
+
+## Running
+```bash
+node server.js    # Produktion
+npm run dev       # Entwicklung
+```
+
+## Structure
+```
+helldivers/
+├── server.js        # Express + WebSocket (ws) + SQLite (better-sqlite3)
+├── public/app.js    # Gesamte Client-Logik (~1840 Zeilen)
+├── public/styles.css
+├── public/index.html
+├── scripts/         # DB-Migrations / Seed
+└── data/helldivers.db
+```
+
+## Deployment
+- Runs under PM2 on the host
+- Nginx reverse-proxies to port 3012
+
+## Branches
+- `main` – stable, production-ready code
+- `bugfixes-features` – active development
+
+## Commit Convention
+`type: short description`
+Types: `feat`, `fix`, `refactor`, `docs`, `chore`
+
+## PROJECT_MAP.md – Pflege
+
+Falls Funktionen, API-Routen, WebSocket-Message-Types oder State-Variablen **hinzugefügt, geändert oder entfernt** werden, muss `PROJECT_MAP.md` **vor dem Commit** aktualisiert werden. Gilt für beide KIs (Claude und Codex) gleichermaßen.
+
+## Changelog
+- Nach jeder Änderung `CHANGELOG.md` aktualisieren
+- Format: `## [Unreleased]` für laufende Änderungen