Datenmanagement

Das Datenmanagement umfasst die Verarbeitung, Speicherung und Nutzung von Daten im gesamten Migrationsprozess des Migrations-Tools.

Quelldatentypen

Das Migrations-Tool verarbeitet verschiedene Typen von Quellanwendungen, die modernisiert werden sollen. Dazu gehören:

Anwendungstyp	Format	Beschreibung
Berechnungsprogramme	Excel (.xlsx)	Komplexe Formelwerke und Geschäftslogik (ohne Makros).
Makro-Anwendungen	Excel (.xlsm)	VBA-gesteuerte Tabellenkalkulationen mit prozeduraler Logik.
Datenimport-Tools	Excel + CSV	Anwendungen, die externe Datenquellen (CSV, Text) importieren, verarbeiten und exportieren.
Oracle Forms	Oracle Forms (.fmb)	Datenbank-gestützte Formulare mit PL/SQL-Logik (in Entwicklung).

Wissensextraktion und -speicherung

Um den Kontext der Legacy-Anwendung zu erhalten, werden im Pre-Processing verschiedene Wissensspeicher befüllt.

GraphRAG-Wissensspeicher

Die strukturelle Logik der Anwendung wird als Graph abgebildet, um Abhängigkeiten für die KI verständlich zu machen. * Neo4j: Speichert den Aufruf-Graphen (Call Graph) und Abhängigkeiten zwischen Modulen/Prozeduren. * Qdrant: Speichert vektorielle Einbettungen (Embeddings) für die semantische Suche.

AI‑generated Dokumentation

Automatisch erzeugte Dokumentation (Readme.md) der bestehenden Applikation, die Architektur, Abläufe und Abhängigkeiten nachvollziehbar beschreibt und als Grundlage für die Migration dient.

• OpenCode.ai: Agentic Coding System zur Analyse und Dokumentation bestehender Applikationen
• Agent Skills: Spezialisierte Fähigkeiten zur Extraktion und Strukturierung von Wissen aus Legacy-Anwendungen (z. B. Excel)

Test Use Cases (Szenarien)

Automatisch generierte Testszenarien, die typische Anwendungsfälle und Randbedingungen der bestehenden Applikation abbilden und für Validierung sowie Qualitätssicherung im Migrationsprozess genutzt werden.

• OpenCode.ai: Agentic Coding System zur Generierung von Testfällen basierend auf der Analyse der Quellapplikation
• Agent Skills: Spezialisierte Fähigkeiten zur Identifikation und Formulierung relevanter Test Use Cases für die Legacy-Anwendung (z. B. Excel)

Kontextinformationen

Zusätzliche Kontextinformationen, die das Agentic Coding System für seine Entscheidungen benötigt. Details hierzu sind im Abschnitt (unten) Konfigurationsdaten beschrieben.

Konfigurationsdaten

Umgebungsvariablen

Verbindungsdaten und Zugangsdaten werden über Umgebungsvariablen konfiguriert:

• LITELLM_API_KEY / LITELLM_BASE_URL: KI-Modell-Zugang
• DATABASE_URL / POSTGRES_*: Datenbankverbindung
• CONTEXT7_API_KEY: Dokumentations-MCP

Agenteninstruktionen

Die Datei AGENTS.md ist das zentrale Regelwerk des Agentic Coding Systems. Sie definiert verbindlich die Migrationsregeln, die Zielarchitektur, die Qualitätskriterien sowie das gewünschte Verhalten der KI‑Agenten. Festgelegt werden darin u. a. Rollen und Verantwortlichkeiten, erlaubte und verbotene Tool‑Nutzung, Architekturvorgaben, Coding‑Guidelines, Sicherheits‑ und Datenschutzanforderungen, Teststrategien, Dokumentationspflichten sowie Abbruch‑ und Eskalationsregeln. AGENTS.md stellt sicher, dass alle automatisch ausgeführten Transformations‑, Analyse‑ und Implementierungsschritte konsistent, reproduzierbar und regelkonform erfolgen.

Agent Skills

Die Datei SKILLS.md beschreibt jeweils einen einzelnen Agent Skill – ein kleines, spezialisiertes Fähigkeitspaket, das ein KI‑Agent gezielt einsetzen kann, um Aufgaben zu bewältigen. Jeder Skill ist wie ein Werkzeug in einer Werkzeugkiste: klar abgegrenzt, leicht verständlich und jederzeit griffbereit. Ein typischer Skill umfasst eine kurze Beschreibung (SKILLS.md), die erklärt, was er leistet und wie er genutzt wird, den dazugehörigen Code oder die Logik, die die Funktion ausführt, sowie optionale Materialien wie Vorlagen oder Daten. Agenten können flexibel genau die Skills laden, die sie benötigen. Neue Skills lassen sich einfach hinzufügen, sodass die Fähigkeiten der Agenten Schritt für Schritt wachsen und flexibel erweitert werden können.

Ausgabedaten

Migrierte Anwendungen

Die Zielanwendungen werden im target/-Verzeichnis generiert:

• Frontend (React/TypeScript)
• Backend (Node.js/Prisma)
• Datenbankschema
• Tests (Unit/Integration/E2E)
• Dokumentation (MAPPING.md, README.md)

Protokolle

Alle Migrationsschritte werden protokolliert:

• Session-Logs (Text + JSON-Lines)
• Tool-Aufrufe und -Ergebnisse
• Validierungsergebnisse