Requirements: RAG Support Desk

Defined: 2026-03-24
Milestone: v2.0 — Channel-Based Knowledge System
Core Value: Die Crew kann jederzeit Logfiles hochladen und sofort Antworten auf operative Fragen bekommen.

v2.0 Requirements

Channel Management

  • [x] CH-01: User kann Channel anlegen (POST /channels mit name + category) — gibt channel id zurĂŒck
  • [x] CH-02: User kann alle Channels abrufen (GET /channels mit id, name, category)
  • [x] CH-03: Doppelter Channel-Name gibt 409 zurĂŒck (kein 500er)
  • [x] CH-04: POST /admin/reset?channel_id=X löscht nur Chunks dieses Channels (channel-scoped)

UI

  • [ ] UI-01: User sieht flache Channel-Liste links — navigierbar, aktiver Channel hervorgehoben
  • [ ] UI-02: User kann zwischen Chat- und Ingest-Tab wechseln (pro aktivem Channel)
  • [ ] UI-03: Aktiver Channel steuert channel_id in POST /query und POST /ingest
  • [ ] UI-04: Channel-Wechsel leert Ausgabebereiche sofort (kein Answer-Carry-over)
  • [ ] UI-05: User kann Channel direkt in der Sidebar anlegen (Name + Kategorie)
  • [ ] UI-06: Aktiver Channel bleibt nach Seiten-Reload erhalten (localStorage)
  • [ ] UI-07: Category-Badge pro Channel in der Sidebar (Wert aus DB)

Previously Validated (v2.0 Phase 3)

  • [x] DAT-01: chunks-Tabelle hat channel_id Spalte (Migration + Index)
  • [x] DAT-02: User kann Query auf aktiven Channel einschrĂ€nken (POST /query mit channel_id)
  • [x] DAT-03: User kann Ingest einem Channel zuordnen (POST /ingest mit channel_id)
  • [x] DAT-04: System hat Default-Channel "general" als Fallback

Future Requirements (v2.1+)

  • EXT-01: Sidebar mit kollabierbaren Gruppen (Server, Code, Dienste, Network, Repos, Logs)
  • EXT-02: Channel löschen (inkl. aller Chunks) — nach Auth-EinfĂŒhrung
  • EXT-03: Channel umbenennen / Beschreibung Ă€ndern
  • EXT-04: Chunk-Count pro Channel in der Sidebar
  • EXT-05: Mehrere Logquellen parallel (Quellenfilter bei Query)
  • EXT-06: Automatischer Ingest via Folder-Watch
  • EXT-07: Login/Auth fĂŒr Multi-Team-Betrieb

Out of Scope

Feature Grund
HTTPS/TLS Internes Netz, kein externer Zugriff
Auth/Login Ein Team, eine Instanz
ICINGA/OTRS-Integration Bewusst kein Overhead
Cloud-Embedding Datenschutz + Ollama ausreichend
Channel delete/rename (UI) Ohne Auth zu gefÀhrlich (Datenverlust)
Multi-turn Chat-History Single-Answer-Box reicht fĂŒr Crew-Use

Traceability

v2.0 (Active)

Requirement Phase Status
DAT-01 Phase 3 Complete
DAT-02 Phase 3 Complete
DAT-03 Phase 3 Complete
DAT-04 Phase 3 Complete
CH-01 Phase 4 Complete
CH-02 Phase 4 Complete
CH-03 Phase 4 Complete
CH-04 Phase 4 Complete
UI-01 Phase 5 Pending
UI-02 Phase 5 Pending
UI-03 Phase 5 Pending
UI-04 Phase 5 Pending
UI-05 Phase 5 Pending
UI-06 Phase 5 Pending
UI-07 Phase 5 Pending

Coverage:
- v2.0 Requirements: 11 total (4 complete, 7 pending) — alle gemappt ✓

Requirements defined: 2026-03-24