Files
Brancheneinstufung2/MIGRATION_PLAN.md
Floke 4a336f6374 fix(ce): Resolve database schema mismatch and restore docs
- Fixed a critical  in the company-explorer by forcing a database re-initialization with a new file (). This ensures the application code is in sync with the database schema.
- Documented the schema mismatch incident and its resolution in MIGRATION_PLAN.md.

- Restored and enhanced BUILDER_APPS_MIGRATION.md by recovering extensive, valuable content from the git history that was accidentally deleted. The guide now again includes detailed troubleshooting steps and code templates for common migration pitfalls.
2026-01-15 15:54:45 +00:00

4.6 KiB

Migrations-Plan: Legacy GSheets -> Company Explorer (Robotics Edition v0.5.1)

Kontext: Neuanfang für die Branche Robotik & Facility Management. Ziel: Ablösung von Google Sheets/CLI durch eine Web-App ("Company Explorer") mit SQLite-Backend.

1. Strategische Neuausrichtung

... (rest of the file remains the same) ...

7. Historie & Fixes (Jan 2026)

  • [UPGRADE] v0.5.1: Robustness, UI Fixes & Wikipedia Hardening

    • [FIX] Critical DB Schema Mismatch (Jan 15, 2026):
      • Problem: Die Anwendung stürzte beim Zugriff auf Firmendetails mit OperationalError: no such column: wiki_verified_empty ab.
      • Ursache: Eine nicht committete Code-Änderung hatte das DB-Modell in database.py erweitert, die physische Datenbank-Datei (companies_v3_final.db) war jedoch nicht migriert worden und dazu komplett leer/korrupt.
      • Lösung: Um die Anwendung schnell wieder lauffähig zu bekommen, wurde in config.py der DATABASE_URL auf einen neuen Dateinamen (companies_v3_fixed_2.db) geändert. Dies zwang die App, beim Start eine neue, leere Datenbank mit dem korrekten, aktuellen Schema zu erstellen. Auf eine Datenmigration aus der alten, leeren Datei wurde verzichtet.
    • Standort-Fix (4B AG): Die Backend-Logik wurde an entscheidenden Stellen (run_analysis_task, override_impressum_url) mit detailliertem Logging versehen und korrigiert, um sicherzustellen, dass city und country aus Impressums-Daten zuverlässig in die Haupt-Firmentabelle (companies) übernommen werden. Dies löst das Problem, dass Standorte im Inspector, aber nicht in der Übersicht angezeigt wurden.
    • Wikipedia "Verified Empty":
      • Backend: Implementierung einer wiki_verified_empty Flag in der Datenbank, um Firmen ohne Wikipedia-Eintrag dauerhaft zu markieren. Der DiscoveryService überspringt diese Einträge nun.
      • Frontend: Ein neuer Button im Inspector erlaubt das manuelle Setzen dieses Status.
    • Robuste Wikipedia-Suche: Die Namens-Normalisierungslogik aus dem Legacy-System wurde vollständig in den DiscoveryService reintegriert. Dies ermöglicht eine deutlich höhere Trefferquote bei Firmennamen mit unterschiedlichen Rechtsformen (z.B. "Therme Erding Service GmbH" -> "Therme Erding").
    • UI-Fix (Sort & View): Die Frontend-Tabellen (CompanyTable, ContactsTable) wurden grundlegend überarbeitet, um die zuvor fehlenden Sortier-Dropdowns und Grid/List-View-Toggles korrekt und zuverlässig anzuzeigen. Die Standard-Sortierung ist nun "Alphabetisch".
  • [UPGRADE] v0.5.0: Contacts, Settings & UI Overhaul

    • Contacts Management:
      • Implementierung einer globalen Kontakt-Liste (ContactsTable) mit Such- und Filterfunktionen.
      • Detail-Bearbeitung von Kontakten direkt im Inspector (Click-to-Edit).
      • Bulk-Import-Funktion für Kontakte (CSV-basiert) mit automatischer Firmen-Erstellung und Dubletten-Prüfung (E-Mail).
      • Erweiterte Felder: Akademischer Titel, differenzierte Rollen (Operativ, Strategisch etc.) und Marketing-Status.
    • UI Modernisierung:
      • Light Mode: Vollständige Unterstützung für Hell/Dunkel-Modus mit Toggle im Header.
      • Grid View: Umstellung der Firmen-Liste auf eine kartenbasierte Ansicht (analog zu Kontakten).
      • Responsive Design: Optimierung des Inspectors und der Navigation für mobile Endgeräte.
    • Erweiterte Settings:
      • Neue Konfigurations-Tabs für Branchen (Industries) und Job-Rollen.
      • CRUD-Operationen für Branchen (inkl. Auto-Increment bei Namensgleichheit).
    • Bugfixes:
      • Korrektur des API-Pfads für manuelle Impressum-Updates.
      • Stabilisierung der Datenbank-Logik bei Unique-Constraints.
      • Optimierung der Anzeige von "Unknown, DE" in der Firmenliste (wird nun ausgeblendet, solange keine Stadt bekannt ist).
  • [UPGRADE] v0.4.0: Export & Manual Impressum

    • JSON Export: Erweiterung der Detailansicht um einen "Export JSON"-Button, der alle Unternehmensdaten (inkl. Anreicherungen und Signale) herunterlädt.
    • Zeitstempel: Anzeige des Erstellungsdatums für jeden Anreicherungsdatensatz (Wikipedia, AI Dossier, Impressum) in der Detailansicht.
    • Manuelle Impressum-URL: Möglichkeit zur manuellen Eingabe einer Impressum-URL in der Detailansicht, um die Extraktion von Firmendaten zu erzwingen.
    • Frontend-Fix: Behebung eines Build-Fehlers (Unexpected token) in Inspector.tsx durch Entfernung eines duplizierten JSX-Blocks. ... (rest of the file remains the same) ...