# Dokumentation

> Vollständige Dokumentation der dsyr.DataBridge — von der Installation bis zum täglichen Betrieb.

---

Site [llms.txt](/llms.txt)

---

Willkommen in der dsyr.DataBridge-Dokumentation. Hier findest du alles,
was du für Einrichtung, Konfiguration und Betrieb einer DataBridge-Instanz benötigst.

---

## Überblick

Neu hier? Starte mit dem konzeptuellen Einstieg.

<div class="td-card-group card-group p-0 mb-4">
<div class="td-card card border me-4">
<div class="card-header">
      <strong>Wie es funktioniert</strong>
    </div>
<div class="card-body">
    <p class="card-text">
        <p>Der Datenfluss in fünf Schritten — verständlich ohne technischen Ballast.</p>
<p><a href="/docs/ueberblick/wie-es-funktioniert/">→ Zum Artikel</a></p>
</p>
      </div>
  </div>

<div class="td-card card border me-4">
<div class="card-header">
      <strong>Technische Architektur</strong>
    </div>
<div class="card-body">
    <p class="card-text">
        <p>Azure-Komponenten, Queue-Struktur, Service-Schicht und Connector-Hierarchie.</p>
<p><a href="/docs/ueberblick/architektur/">→ Zum Artikel</a></p>
</p>
      </div>
  </div>

</div>


---

## Einrichtung

<div class="td-card-group card-group p-0 mb-4">
<div class="td-card card border me-4">
<div class="card-header">
      <strong>Voraussetzungen</strong>
    </div>
<div class="card-body">
    <p class="card-text">
        <p>Benutzerkonten, Berechtigungen, Azure-Provider, Change Tracking.</p>
<p><a href="/docs/einrichtung/voraussetzungen/">→ Zum Artikel</a></p>
</p>
      </div>
  </div>

<div class="td-card card border me-4">
<div class="card-header">
      <strong>Installation</strong>
    </div>
<div class="card-body">
    <p class="card-text">
        <p>Azure-Ressourcen per Bicep anlegen, Function App deployen.</p>
<p><a href="/docs/einrichtung/installation/">→ Zum Artikel</a></p>
</p>
      </div>
  </div>

<div class="td-card card border me-4">
<div class="card-header">
      <strong>Umgebungsvariablen</strong>
    </div>
<div class="card-body">
    <p class="card-text">
        <p>Alle App-Settings mit Standardwerten und Wirkung.</p>
<p><a href="/docs/einrichtung/umgebungsvariablen/">→ Zum Artikel</a></p>
</p>
      </div>
  </div>

</div>


---

## Konfiguration

Die DataBridge wird vollständig über vier Azure Tables gesteuert.

| Tabelle | Inhalt | Seite |
|---|---|---|
| `connections` | Zugangsdaten zu Quell- und Zielsystemen | [→](konfiguration/verbindungen/) |
| `jobs` | Synchronisations-Jobs: Richtung, Zeitplan, Priorität | [→](konfiguration/jobs/) |
| `mappings` | Feld-Mappings und Transformationen | [→](konfiguration/mappings/) |
| `watermark` | Letzter synchronisierter Stand pro Job | [→](konfiguration/watermarks/) |

---

## Konnektoren

| Konnektor | System | Lesen | Schreiben | Seite |
|---|---|:---:|:---:|---|
| D365BC | Business Central v17+ | ✅ | ✅ | [→](konnektoren/d365bc/) |
| D365CE | Dataverse v9.1+ | ✅ | ✅ | [→](konnektoren/d365ce/) |
| D365NAV | Dynamics NAV 2018+ | ✅ | ✅ | [→](konnektoren/d365nav/) |
| MSSQL | SQL Server | ✅ Preview | — | [→](konnektoren/mssql/) |
| MySQL | MySQL / MariaDB | ⚠️ | — | [→](konnektoren/mysql/) |
| Oracle | Oracle Database | ⚠️ | — | [→](konnektoren/oracle/) |
| PostgreSQL | PostgreSQL | ⚠️ | — | [→](konnektoren/pgsql/) |

Die Versionsangaben sind getestete Mindestversionen; im Code findet keine Versionsprüfung statt.
⚠️ = nur ungefiltertes Vollauslesen — Details auf der jeweiligen Konnektorseite.

---

## MCP-Server

Eingebauter, read-only [MCP](https://modelcontextprotocol.io/)-Server für KI-Assistenten wie
Claude Code: Jobs, Mappings, Service-Bus-Queues und echte Connector-Schemas (D365BC/NAV/CE,
OpenAPI und die SQL-Connectoren) zum Validieren von Mappings.

[→ Zum Artikel](mcp-server/)

---

## Betrieb & Wartung

<div class="td-card-group card-group p-0 mb-4">
<div class="td-card card border me-4">
<div class="card-header">
      <strong>Logging</strong>
    </div>
<div class="card-body">
    <p class="card-text">
        <p>Gepuffertes Logging, Sampling von Abhängigkeiten, Custom Metrics, KQL-Abfragen.</p>
<p><a href="/docs/betrieb/logging/">→ Zum Artikel</a></p>
</p>
      </div>
  </div>

<div class="td-card card border me-4">
<div class="card-header">
      <strong>Monitoring &amp; Alerts</strong>
    </div>
<div class="card-body">
    <p class="card-text">
        <p>Action Groups, Alert Rules, empfohlene Schwellwerte.</p>
<p><a href="/docs/betrieb/monitoring/">→ Zum Artikel</a></p>
</p>
      </div>
  </div>

<div class="td-card card border me-4">
<div class="card-header">
      <strong>Grafana-Dashboard</strong>
    </div>
<div class="card-body">
    <p class="card-text">
        <p>Mitgeliefertes Betriebsdashboard: Erfolgsraten, Laufzeiten, Änderungen je Job, Exceptions.</p>
<p><a href="/docs/betrieb/grafana-dashboard/">→ Zum Artikel</a></p>
</p>
      </div>
  </div>

<div class="td-card card border me-4">
<div class="card-header">
      <strong>Updates &amp; Upgrades</strong>
    </div>
<div class="card-body">
    <p class="card-text">
        <p>Upgrade-Pfade, Breaking Changes, Wartungsfenster-Checkliste.</p>
<p><a href="/docs/betrieb/updates/">→ Zum Artikel</a></p>
</p>
      </div>
  </div>

</div>


---

## Versionshistorie

Änderungen, neue Features und Breaking Changes je Release:
[→ Versionshistorie](versionen/)

---

Section pages:

- [Überblick](/docs/ueberblick/): Was die dsyr.DataBridge ist, wie sie funktioniert und wie sie technisch aufgebaut ist.
- [Einrichtung](/docs/einrichtung/): Von null zur laufenden DataBridge-Instanz: Voraussetzungen, Installation und Konfiguration der Umgebung.
- [Konfiguration](/docs/konfiguration/): Die vier Azure Tables als zentrales Konfigurationssystem: Verbindungen, Jobs, Mappings und Watermarks.
- [Konnektoren](/docs/konnektoren/): Die unterstützten Quell- und Zielsysteme: Dynamics 365, Dataverse, NAV und SQL-Datenbanken.
- [MCP-Server](/docs/mcp-server/): Die DataBridge unterstützt das Model Context Protocol: ein eingebauter, read-only Server für Jobs, Mappings, Service-Bus-Queues und echte Connector-Schemas für KI-Assistenten wie Claude Code, GitHub Copilot oder Microsoft 365 Copilot.
- [Betrieb & Wartung](/docs/betrieb/): Logging, Monitoring, Alerts und Updates für den laufenden Betrieb der DataBridge.
- [Versionshistorie](/docs/versionen/): Release-Dokumentation aller Versionen der dsyr.DataBridge — Änderungen, neue Funktionen und Installationshinweise.