Dokumentations- & Referenz-Architektur (Joplin ↔ Forgejo)

# Dokumentations- & Referenz-Architektur (Joplin ↔ Forgejo)

> Beschlossen 2026-08-30. Gilt für alle Projekte. Diese Note ist die
> Regeln-Quelle; Verweise darauf statt Duplikation.

## Die Zuordnung (eine Wahrheit pro Artefakt-Typ)

| Inhalt | Zuhause (Wahrheit) |
|---|---|
| Code, Repo-Doku (README, docs/, OpenUP-Werkprodukte) | Repos (moria kanonisch) |
| Backlog, Arbeit, Iterationsstand, Zustände | moria Issues/Milestones |
| Externe Nutzer-Reports | hunnius Issues (Eingang, Triage → moria) |
| Prozess, Entscheidungen, Sessions, narrative Lessons | Joplin |
| Betriebs-Konfiguration + Betriebs-Lessons | infra-Repo (configs/, docs/lessons.md) |

## Die zwei Richtungs-Regeln

1. **Joplin → Forgejo, nie umgekehrt.** Joplin hat keine stabilen URLs;
   Issues müssen standalone lesbar sein. Verweise laufen immer vom
   Privaten zum Adressierbaren.
2. **Joplin ist der Index, nicht der Speicher.** Status-Noten liefern
   Erzählung (Warum, Entscheidungen, Kontext) und VERLINKEN die Daten
   (Issues, Milestones, Repos). Was generierbar ist (generate-pm-docs aus
   der Issues-API), wird nicht per Hand gepflegt.

## URL-Konventionen

- **Öffentlich/Repos/Dokumente**: immer `https://git.hunnius.net/...`
  (LAN-Adressen wie 192.168.1.10 haben in Repos und öffentlichem Material
  nichts verloren)
- **Joplin-intern/eigene Notizen**: LAN-URLs der moria-Instanz ok
  (`http://192.168.1.10:3000/jan/<repo>/issues/N`)
- Issue-Kurzreferenz in Notizen: `<repo>#<nummer>` (z. B. `keyfob-station#2`)

## Einstiegspunkte

- **Development Projects Index** — der eine Überblick (Projekt → Repo →
  Status-Note → Forgejo)
- Status-Notes pro Projekt — Snapshots + Links
- infra-Repo docs/lessons.md — Betriebswissen neben der Konfiguration

id: 3125d6c0f44844e4a488e5b006cebd9f
parent_id: 86f1e0f3538341dfaa58cc3357e03343
created_time: 2026-08-30T11:40:24.056Z
updated_time: 2026-08-30T11:40:24.056Z
is_conflict: 0
latitude: 0.00000000
longitude: 0.00000000
altitude: 0.0000
author: 
source_url: 
is_todo: 0
todo_due: 0
todo_completed: 0
source: joplin-desktop
source_application: net.cozic.joplin-desktop
application_data: 
order: 1788090024056
user_created_time: 2026-08-30T11:40:24.056Z
user_updated_time: 2026-08-30T11:40:24.056Z
encryption_cipher_text: 
encryption_applied: 0
markup_language: 1
is_shared: 0
share_id: 
conflict_original_id: 
master_key_id: 
user_data: 
deleted_time: 0
is_locked: 0
extracted_resource_ids: 
type_: 1