# 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.