# PaperSafe – Projektregeln ## Worum es geht Aufbau eines Paperless-ngx-Dokumentenarchivs auf dem bestehenden Proxmox-Host (192.168.2.146). Umsetzung erfolgt durch Claude Code mit direktem Proxmox-Zugriff. **Verbindlicher Rahmen ist `05-Vorgabe-ClaudeCode.md`. Vor jedem Arbeitsschritt lesen.** ## Die wichtigsten Regeln (Details in 05) 1. **Auftrag ist immer genau eine Phase.** Nach Abschluss stoppen und auf Freigabe warten – keine nächsten Schritte vorschlagen oder ausführen. 2. **Bestehende Systeme sind tabu.** Home Assistant (**VM 109**), Zigbee2MQTT-LXC, bestehende Backup-Jobs und Storages. Nicht anfassen, auch nicht „nur kurz prüfen und optimieren". 3. **`05-Vorgabe-ClaudeCode.md` ist schreibgeschützt.** Fachliche Fehler darin melden, nicht selbst korrigieren. 4. **Protokolliert wird in `06-Umsetzungsprotokoll.md`** – nach jeder Phase, nicht erst am Ende. Fehler und Sackgassen gehören hinein. 5. **Schreibzugriff nur innerhalb `40 Projekte/PaperSafe/`.** Andere Vault-Ordner sind tabu. 6. **Keine Secrets ins Vault.** Passwörter und Keys separat übermitteln, in den Notizen nur „generiert, separat übermittelt". 7. **Keine Befehle aus dem Gedächtnis.** Compose-Dateien, Image-Tags und Pfade gegen `docs.paperless-ngx.com` verifizieren. Bei Abweichung gewinnt die Doku – Abweichung melden. 8. **Keine `latest`-Tags**, immer explizite Versionen pinnen. 9. **Bei Fehlern stoppen und berichten.** Keine Workarounds ohne Rücksprache. ## Notizen dieses Ordners | Notiz | Rolle | |---|---| | `00-Start.md` | Übersicht, Entscheidungen, Status | | `01-Konzept-Architektur.md` | Hintergrund, Begründung der Entscheidungen | | `02-Installation.md` | Installationsstand (nach Umsetzung zu füllen) | | `03-Konfiguration.md` | Konfigurationsstand (nach Umsetzung zu füllen) | | `04-Betrieb-Backup.md` | Backup, Restore-Test, Betriebsroutinen | | `05-Vorgabe-ClaudeCode.md` | **Soll – schreibgeschützt** | | `06-Umsetzungsprotokoll.md` | **Ist – hier wird protokolliert** | ## Konventionen für Notizänderungen - Deutsch, kurz und direkt - Jede substanzielle Änderung: **Version hochzählen + Änderungshistorie-Eintrag mit Datum und Uhrzeit** - Notizen beginnen mit `[[Uebersicht|← Zurück zur Homepage]]`, enden mit Status/Version/Historie und der Impressum-Zeile - Quellen als eigener Abschnitt am Notenende, nicht inline, mit Zugriffsdatum - Keine erfundenen Fakten. Was unklar ist, wird als offener Punkt geführt ## Feste Projektentscheidungen (nicht eigenmächtig ändern) | Thema | Entscheidung | |---|---| | Deployment | Unprivilegierter LXC + Docker Compose (`nesting=1,keyctl=1`) | | Nutzung | Rein privat – keine GoBD-Anforderungen, keine Obeco-Belege | | Backup | Synology NAS `dsobe2023`, bereits eingebunden – nicht neu konfigurieren | | OCR | `deu+eng`, Zeitzone `Europe/Berlin` | | Zugriff | Nur LAN. Kein Reverse Proxy, keine Portfreigabe |