Homme/WISSENSBASIS_PLAN.md

HOEMMA – Wissensbasis: Basisfakten-Plan

Stand: 15.07.2026 — Problem: Fragen zu Öffnungszeiten/Adresse erreichen die lokale Wissensbasis nicht (bestDistance 0.61–0.70 > Schwelle 0.60) und laufen teuer über die Websuche. Lösung: atomare Fakten-Dateien (ein Thema = eine Datei = ein reiner Chunk).

---

Schritt 1: Alte Sammeldatei aus der Datenbank entfernen

-- IDs der Chunks der alten Sammeldatei finden und löschen:
DELETE FROM document_chunck
WHERE document_id = (SELECT id FROM document WHERE source_url ILIKE '%basisfakten%');

DELETE FROM document
WHERE source_url ILIKE '%basisfakten%';

(Sonst konkurriert die alte Misch-Datei mit den neuen atomaren Dateien.)

---

Schritt 2: Fünf atomare Word-Dateien erstellen

Jede Datei in Word anlegen, NUR den jeweiligen Text einfügen, als .docx speichern und in den Humbee-Projektordner hochladen.

Datei 1: Borsig11_Oeffnungszeiten_AKTUELL.docx

Wann ist das Büro geöffnet? Wie sind die Öffnungszeiten von Borsig11?
(AKTUELL, Stand: Juli 2026)

Die offiziellen aktuellen Öffnungszeiten des Büros der Machbarschaft Borsig11:
Montag bis Freitag von 11 bis 16 Uhr, sowie nach Vereinbarung.
Vor 11 Uhr ist das Büro geschlossen. Wer morgens früher kommen möchte,
sollte vorher telefonisch einen Termin vereinbaren.
Hinweis: Ältere Artikel auf der Website nennen teilweise veraltete
Öffnungszeiten (zum Beispiel aus dem Jahr 2021). Maßgeblich sind die hier
genannten aktuellen Zeiten: Montag bis Freitag, 11 bis 16 Uhr.

Datei 2: Borsig11_Adresse_AKTUELL.docx

Wo befindet sich Borsig11? Adresse und Anfahrt (AKTUELL, Stand: Juli 2026)

Die Machbarschaft Borsig11 e.V. befindet sich in der Flurstraße 10,
44145 Dortmund. Das Büro liegt in der Dortmunder Nordstadt, direkt am
Borsigplatz, in den Gemeinderäumen der Heiligen Dreifaltigkeits-Kirche
(der BVB-Gründerkirche). Wer uns besuchen möchte: Flurstraße 10,
44145 Dortmund.
Hinweis: Bis Ende 2020 war das Büro am Borsigplatz 9 — diese alte Adresse
gilt nicht mehr.

Datei 3: Borsig11_Kontakt.docx

Wie erreiche ich Borsig11? Kontakt, Telefonnummer und E-Mail

Telefon: 0231 / 80 41 81 50
E-Mail: info@borsig11.de
Adresse: Flurstraße 10, 44145 Dortmund
Website: www.borsig11.de

Datei 4: Borsig11_UeberUns.docx

Was ist die Machbarschaft Borsig11? Wer seid ihr?

Die Machbarschaft Borsig11 e.V. ist ein gemeinnütziger Verein in der
Dortmunder Nordstadt am Borsigplatz. Der Verein macht Kultur- und
Nachbarschaftsprojekte mit und für die Bewohnerinnen und Bewohner des
Borsigplatz-Quartiers — zum Beispiel die Nordstadt Sessions (offene
Musikabende), kreative Workshops, die Givebox (Tauschregal), das
Schach-Café, die Schneiderei 103 und den Vollmond Talk.

Datei 5: HOEMMA_UeberDasProjekt.docx

Was ist HOEMMA? Was ist die Human Library Ruhr?

HOEMMA – Human Library Ruhr ist ein Projekt der Machbarschaft Borsig11.
HOEMMA ist ein KI-basierter Gesprächsbegleiter, der Erinnerungen,
Geschichten und Erfahrungen von Menschen aus Dortmund und dem Ruhrgebiet
sammelt und für Seniorinnen und Senioren zugänglich macht. Der Name kommt
vom Ruhrgebiets-Ausdruck "Hömma!" ("Hör mal!").

---

Schritt 3: Einlesen

GET http://localhost:9192/knowledge-base/build

Prüfen, dass 5 neue Dokumente angelegt wurden:

SELECT id, source_url FROM document
WHERE source_url ILIKE '%oeffnungszeiten%'
   OR source_url ILIKE '%adresse%'
   OR source_url ILIKE '%kontakt%'
   OR source_url ILIKE '%ueberuns%'
   OR source_url ILIKE '%ueberdasprojekt%';

---

Schritt 4: Testfragen (Postman, POST /chat/ask)

Frage	Erwartung
Wie sind eure Öffnungszeiten?	bestDistance deutlich niedriger, true, Antwort 11–16
Wann habt ihr geöffnet?	dito
Kann ich morgen um 9 Uhr vorbeikommen?	"Büro öffnet erst um 11"
Bis wann ist das Büro heute offen?	"bis 16 Uhr"

Log-Zeile je Frage notieren: bestDistance … hatRelevantenKontext …

---

Falls Distanzen knapp über 0.60 bleiben

Schwelle in RagService moderat anheben (z. B. 0.65) — jetzt vertretbar, weil der 2021-Chunk annotiert ist (VERALTET-Hinweis) und die atomaren Chunks die nächsten Treffer sind.

---

Zukunftsaufgabe (systemische Verbesserung, ~1 Tag)

Cohere input_type einführen (asymmetrisches Embedding):

• AzureEmbeddingService.createEmbedding(text, inputType) — Request um "input_type": "query" bzw. "document" erweitern
• RagService (Nutzerfrage) → "query"
• DocumentStorageService (Chunks) → "document"
• Danach: ALLE Embeddings neu berechnen (Build + Ingest erneut ausführen)

Erwarteter Effekt: global bessere/niedrigere Distanzen im ganzen System.