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

+81
View File
@@ -0,0 +1,81 @@
/**
* Property On — Livias Research-PoC: echte Quellen statt Mockdaten.
*
* Diese Typen werden von beiden Seiten benutzt — von der serverlosen Funktion
* unter `api/` und vom Frontend. Sie liegen deshalb im Domänenordner und nicht
* neben dem Endpoint: ein zweites, fast gleiches Typenpaar wäre die erste
* Stelle, an der Server und Oberfläche auseinanderlaufen.
*
* Bewusst klein gehalten (PoC, §9/§13). Es ist ausdrücklich **nicht** der
* `FutureSignal`-Typ: der trägt Wahrscheinlichkeiten, Datenqualität und
* Portfoliobezug, die eine Live-Recherche nicht liefern kann. Ein Feld zu
* füllen, für das keine Grundlage existiert, wäre genau die Behauptung, die
* Livia nicht aufstellen darf.
*/
/** Die neun Kategorien des PoC (§11). */
export const ResearchEventType = {
EXPANSION: 'EXPANSION',
NEW_LOCATION: 'NEW_LOCATION',
HEADCOUNT_GROWTH: 'HEADCOUNT_GROWTH',
INVESTMENT: 'INVESTMENT',
M_AND_A: 'M_AND_A',
RESTRUCTURING: 'RESTRUCTURING',
SITE_CLOSURE: 'SITE_CLOSURE',
NEW_COMPANY: 'NEW_COMPANY',
IRRELEVANT: 'IRRELEVANT',
} as const
export type ResearchEventType = typeof ResearchEventType[keyof typeof ResearchEventType]
export type ResearchRelevance = 'high' | 'medium' | 'low'
/** Ein von Livia aus einer echten Quelle abgeleiteter Lead (§13). */
export interface ResearchLead {
company: string
eventType: ResearchEventType
headline: string
location?: string
summary: string
relevance: ResearchRelevance
/** 0–1. Wie sicher ist die Einordnung angesichts der Quellenlage? */
confidence: number
reason: string
recommendedAction?: string
/** Anzeigename der Quelle, z. B. «Zürcher Handelskammer». */
source: string
/** Die tatsächlich gelesene Originalquelle — muss anklickbar sein (§2). */
sourceUrl: string
publishedAt?: string
}
/** Ergebnis je abgerufener Quelle — auch im Fehlerfall (§21). */
export interface ResearchSourceResult {
id: string
name: string
url: string
ok: boolean
/** Gelesene Einträge; 0, wenn die Quelle nicht erreichbar war. */
itemCount: number
error?: string
}
/** Antwort des Refresh-Endpoints. */
export interface ResearchRefreshResult {
sources: ResearchSourceResult[]
/** Wie viele Einträge insgesamt gelesen wurden. */
analyzed: number
/** Davon als nicht relevant verworfen — der Kern des PoC (§14). */
discarded: number
/** Beobachtungswürdig, aber ohne bestätigten Flächenbezug. */
watchlist: number
/** Nur `high` und `medium` erscheinen hier. */
leads: ResearchLead[]
/** Zeitpunkt des Laufs, ISO. */
refreshedAt: string
/**
* Gesetzt, wenn die Analyse nicht laufen konnte — etwa weil serverseitig
* kein Schlüssel hinterlegt ist. Die Oberfläche sagt das dann offen, statt
* eine leere Liste als «nichts gefunden» auszugeben.
*/
analysisError?: string
}