Emailsorter/PROJEKT_ORDNUNG.md

📁 Projekt-Ordnung und Dateistruktur

Diese Datei beschreibt die Organisation aller Dateien im Projekt.

✅ Wichtige Dateien (behalten)

Root-Verzeichnis

• README.md - Hauptdokumentation des Projekts
• STRUCTURE.md - Detaillierte Projektstruktur
• .gitignore - Git-Ignore-Regeln
• .env.example - Beispiel-Umgebungsvariablen

Client (client/)

• Alle Source-Dateien in src/
• Konfigurationsdateien (package.json, vite.config.ts, etc.)
• README.md - Client-spezifische Dokumentation

Server (server/)

• Alle Backend-Dateien
• routes/ - API-Routen (inkl. webhook.mjs für automatisches Deployment)
• config/ - Konfiguration
• .env - Umgebungsvariablen (nicht im Git!)

Dokumentation (docs/)

• deployment/ - Deployment-Anleitungen
  • GITEA_WEBHOOK_SETUP.md - Vollständige Webhook-Anleitung
  • WEBHOOK_QUICK_START.md - Schnellstart
  • WEBHOOK_AUTHORIZATION.md - Authentifizierung
  • DEPLOYMENT_INSTRUCTIONS.md - Manuelles Deployment
  • PRODUCTION_SETUP.md - Production-Setup
  • PRODUCTION_FIXES.md - Bekannte Probleme
• setup/ - Setup-Anleitungen
• development/ - Development-Dokumentation
• server/ - Server-Dokumentation

Scripts (scripts/)

• deploy-to-server.mjs - Deployment-Skript (wird vom Webhook aufgerufen)
• setup-*.ps1 - Setup-Scripts
• README.md - Scripts-Dokumentation

Marketing (marketing/)

• Alle Marketing-Materialien und Anleitungen

🗑️ Kann entfernt werden (temporäre/veraltete Dateien)

Scripts (scripts/)

Diese Git-Commit-Scripts sind veraltet und können entfernt werden:

• git-commit.bat
• git-commit.sh
• git-commit-fix.bat
• FINAL_COMMIT.bat
• run-git-commit.ps1
• COMMIT_COMMANDS.txt
• COMMIT_MESSAGE.md

Grund: Git-Commits sollten direkt über git commit gemacht werden.

Dokumentation (docs/)

Einige temporäre/veraltete Dokumentationsdateien können archiviert werden:

• development/TASK_5_COMPLETION.md - Task-spezifisch, kann archiviert werden
• server/TASK_4_COMPLETION_SUMMARY.md - Task-spezifisch, kann archiviert werden
• development/PROJECT_REVIEW_SUMMARY.md - Review-spezifisch, kann archiviert werden

Empfehlung: Verschiebe diese in docs/archive/ statt zu löschen.

📋 Dateien-Organisation

Aktuelle Struktur

/
├── client/              # Frontend
├── server/              # Backend
├── docs/                # Dokumentation
│   ├── deployment/      # Deployment-Docs ✅
│   ├── setup/           # Setup-Docs ✅
│   ├── development/     # Development-Docs (teilweise archivieren)
│   └── server/          # Server-Docs (teilweise archivieren)
├── scripts/             # Scripts
│   ├── deploy-to-server.mjs ✅
│   ├── setup-*.ps1 ✅
│   └── [veraltete Git-Scripts] ❌
├── marketing/           # Marketing ✅
└── README.md            # Hauptdokumentation ✅

🧹 Aufräumen-Empfehlungen

1. Veraltete Scripts entfernen

# Diese Dateien können gelöscht werden:
scripts/git-commit.bat
scripts/git-commit.sh
scripts/git-commit-fix.bat
scripts/FINAL_COMMIT.bat
scripts/run-git-commit.ps1
scripts/COMMIT_COMMANDS.txt
scripts/COMMIT_MESSAGE.md

2. Temporäre Dokumentation archivieren

Erstelle docs/archive/ und verschiebe:

• docs/development/TASK_5_COMPLETION.md
• docs/server/TASK_4_COMPLETION_SUMMARY.md
• docs/development/PROJECT_REVIEW_SUMMARY.md

3. README aktualisieren

Die scripts/README.md wurde bereits aktualisiert.

✅ Checkliste

• Webhook-Dokumentation in docs/deployment/ organisiert
• Scripts-README aktualisiert
• Deployment-Dokumentation strukturiert
• Veraltete Scripts entfernen (optional)
• Temporäre Dokumentation archivieren (optional)

📝 Wichtige Hinweise

1. .env Dateien sind nie im Git (siehe .gitignore)
2. Temporäre Anleitungen können nach erfolgreicher Einrichtung entfernt werden
3. Task-spezifische Dokumentation kann archiviert werden, sollte aber nicht gelöscht werden
4. Alle produktiven Dateien (Code, Konfiguration, aktive Dokumentation) bleiben erhalten

🔄 Regelmäßige Wartung

• Monatlich: Prüfe auf veraltete Scripts/Dokumentation
• Nach großen Features: Aktualisiere README und Dokumentation
• Nach Deployment: Entferne temporäre Deployment-Anleitungen (falls nicht mehr benötigt)