feat(livia): Research-PoC — drei reale Zürcher Quellen live

Livia liest jetzt tatsächlich aus dem Netz statt aus Mockdaten. Ein Knopf
«Research aktualisieren» ruft serverseitig drei Quellen ab, beurteilt die
Einträge in einem einzigen LLM-Aufruf und zeigt nur an, was plausibel zu
Flächenbedarf oder Flächenfreisetzung führen könnte.

Kein Crawler, kein Scheduler, keine Queue, keine Datenbank. Der Hoster kann
bereits serverlose Funktionen — es hat bisher nur niemand eine gebraucht.
Deshalb genügt eine einzige Datei unter `api/`, drei Abruffunktionen, eine
Normalisierung und ein Analyseaufruf.

Quellen, alle drei live geprüft:
- Zürcher Handelskammer, 10 Artikel
- Greater Zurich Area, 9 Artikel
- Zefix / Open Data Kanton Zürich, CSV direkt

Zur Zefix-Quelle eine Feststellung, die von der Aufgabenstellung abweicht: die
CSV enthält keine Firmennamen. Sie führt Tageszahlen von Neugründungen je
NOGA-Branche für den Kanton Zürich. Daraus lässt sich kein Unternehmenslead
bauen, sondern nur ein aggregiertes Frühsignal zum Zielmarkt — und genau so
wird es übergeben. Namen zu erfinden, um das erwartete Format zu treffen, wäre
die eine Sache, die Livia nie tun darf.

Die drei Quellen stehen im Frontend unter «Angebundene Kanäle & Systeme» mit
Status und anklickbarem Originallink; jeder erzeugte Lead verlinkt zusätzlich
die Seite, aus der er stammt. Die Adressen kommen aus derselben Liste, die der
Abruf benutzt — der angezeigte Link kann damit nicht von dem abweichen, was
tatsächlich gelesen wurde.

Der Textextraktor sucht den Artikeltext im engsten passenden Container. Ohne
das standen bei der Handelskammer Telefonnummern und Öffnungszeiten am Anfang
jedes Textes, und das Modell hätte die Fusszeile mitbeurteilt.

Der LLM-Schlüssel liegt ausschliesslich serverseitig in `ANTHROPIC_API_KEY`.
Fehlt er, sagt die Oberfläche offen, dass gelesen, aber nicht beurteilt wurde —
statt eine leere Liste als «nichts gefunden» auszugeben.

Für die lokale Entwicklung mountet ein Vite-Plugin dieselbe Handler-Datei, die
Vercel in der Produktion ausliefert; es gibt keine zweite Fassung des
Endpoints. `tsconfig.api.json` nimmt `api/` in `tsc -b` auf, damit ein
Tippfehler dort nicht erst beim Deployment auffällt.

Geprüft: tsc 0 Fehler, eslint 0 Fehler/0 Warnungen, 423/423 Tests grün, Build
erfolgreich, Live-Lauf im Browser mit 20 real gelesenen Einträgen aus 3/3
Quellen ohne Laufzeitfehler. Die LLM-Beurteilung selbst ist mangels Schlüssel
noch ungetestet.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Benjamin SutterandClaude Opus 5 committed 2026-08-30 14:23:35 +02:00
1 parent 37b6270f50
commit 2a0ba287f6
16 files changed
+1509 -31

No files matched your search

+50
View File
@@ -0,0 +1,50 @@
/**
* Property On — die real angebundenen Recherchequellen von Livia.
*
* Eine einzige Liste für beide Seiten: die serverlose Funktion liest daraus
* die abzurufenden Adressen, die Oberfläche zeigt daraus «Angebundene Kanäle
* & Systeme». Stünden die URLs an zwei Stellen, könnte der angezeigte Link
* irgendwann auf etwas anderes zeigen als der tatsächliche Abruf — und genau
* die Nachvollziehbarkeit ist der Zweck der Anzeige (§2).
*
* Die Datei enthält bewusst nur Daten und keine Abruflogik: so kann `api/`
* sie importieren, ohne dass der HTML-Parser im Frontend-Bundle landet.
*/
export interface ResearchSourceDescriptor {
id: string
name: string
url: string
/** Wofür die Quelle im PoC steht — erscheint in der Oberfläche. */
purpose: string
}
export const RESEARCH_SOURCES = {
ZHK: {
id: 'zhk',
name: 'Zürcher Handelskammer — News',
url: 'https://www.zhk.ch/de/wirtschaft-und-politik/news-liste.html',
purpose: 'Regionale Unternehmensmeldungen, Expansion, Investitionen, Kapazitätsausbau',
},
GZA: {
id: 'gza',
name: 'Greater Zurich Area — News',
url: 'https://www.greaterzuricharea.com/de/alle-news',
purpose: 'Ansiedlungen, Markteintritte, internationale Expansionen und neue Standorte',
},
ZEFIX: {
id: 'zefix',
name: 'Zefix / Open Data Kanton Zürich',
url: 'https://www.web.statistik.zh.ch/ogd/data/KANTON_ZUERICH_ZEFIX_Neugruendungen.csv',
purpose: 'Strukturierte Daten zu Zürcher Neugründungen; CSV wird direkt eingelesen',
},
} as const satisfies Record<string, ResearchSourceDescriptor>
export const RESEARCH_SOURCE_LIST: ResearchSourceDescriptor[] = [
RESEARCH_SOURCES.ZHK,
RESEARCH_SOURCES.GZA,
RESEARCH_SOURCES.ZEFIX,
]
/** Der eine Endpoint des PoC (§20). */
export const RESEARCH_REFRESH_ENDPOINT = '/api/livia/research/refresh'