diff --git a/ARCHITEKTUR_GCP_SETUP.md b/ARCHITEKTUR_GCP_SETUP.md index 5fb3611b..c1111e89 100644 --- a/ARCHITEKTUR_GCP_SETUP.md +++ b/ARCHITEKTUR_GCP_SETUP.md @@ -77,3 +77,43 @@ graph TD 3. **Datenschutz (DSGVO):** * **Input:** Wir senden Webseiten-Texte und Firmennamen an die API. Wir senden *keine* Mitarbeiterlisten oder Kunden-Adressdaten zur Analyse. * **Enterprise-Garantie:** Durch Nutzung der Enterprise-Verträge (via GCP) ist vertraglich geregelt, dass Google die Daten **nicht** zum Training eigener Modelle verwendet (anders als bei der kostenlosen ChatGPT/Gemini-Consumer-Version). + +## Backend API (Company Explorer) + +Das System verfügt bereits über eine standardisierte, dokumentierte API (FastAPI) zur Datenverarbeitung. Dies ermöglicht eine saubere Trennung von Frontend und Backend sowie eine granulare Zugriffskontrolle. + +**Core Endpoints:** + +| Methode | Pfad | Beschreibung | +| :--- | :--- | :--- | +| `GET` | `/api/health` | System Status Check | +| `GET` | `/api/companies` | Liste von Unternehmen (Filterbar, Sortierbar) | +| `GET` | `/api/companies/{id}` | Detailansicht eines Unternehmens | +| `POST` | `/api/companies` | Manuelle Anlage eines Unternehmens | +| `POST` | `/api/companies/bulk` | Massenimport (Batch-Processing) | +| `GET` | `/api/companies/export` | CSV Export der angereicherten Daten | + +**Enrichment & KI-Analyse:** + +| Methode | Pfad | Beschreibung | +| :--- | :--- | :--- | +| `POST` | `/api/enrich/discover` | Startet Discovery-Prozess (Website-Suche) | +| `POST` | `/api/enrich/analyze` | Startet KI-Analyse (Scraping + Klassifizierung) | +| `PUT` | `/api/companies/{id}/industry` | Manuelle Korrektur der KI-Branchenzuordnung | +| `POST` | `/api/companies/{id}/override/*` | Manuelle Overrides für kritische Datenquellen (Website, Wikipedia, Impressum) | + +**Quality Assurance:** + +| Methode | Pfad | Beschreibung | +| :--- | :--- | :--- | +| `POST` | `/api/companies/{id}/report-mistake` | Melden von Datenfehlern ("Human in the Loop") | +| `GET` | `/api/mistakes` | Übersicht gemeldeter Fehler zur Überprüfung | +| `PUT` | `/api/mistakes/{id}` | Status-Update für Fehlermeldungen (Approved/Rejected) | + +**Stammdaten & Kataloge:** + +| Methode | Pfad | Beschreibung | +| :--- | :--- | :--- | +| `GET` | `/api/robotics/categories` | Katalog der Robotik-Kategorien | +| `GET` | `/api/industries` | Katalog der Branchen | +| `GET` | `/api/job_roles` | Katalog der Job-Rollen |