WordPress

2026-07-15 20:47:58 +02:00
parent d6153521ca
commit daf48f3f91
29 changed files with 1203 additions and 128 deletions
@@ -0,0 +1,147 @@
+# 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
+
+```sql
+-- 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:
+
+```sql
+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.