Das Handbuch ist eine ASP.NET-Core-Anwendung (.NET 10, Blazor Server) mit MySQL/MariaDB als Datenbank. Alle Zugänge – Browser, BBSnap, Skripte und KI-Assistenten – landen bei derselben Anwendung und unterliegen denselben Rechten.

Abb.: Architektur: vier Zugangswege, eine Anwendung, eine Datenbank
Die Bausteine
| Baustein | Aufgabe | Adresse |
|---|---|---|
| Weboberfläche | Lesen, Suchen, Bearbeiten, Verwaltung | / |
| REST-API | Programmzugriff mit JSON, Swagger-Dokumentation | /api/v1, /api/docs |
| MCP-Server | Werkzeuge für KI-Assistenten (Model Context Protocol) | /mcp |
| BBSnap | Windows-Programm für Screenshots mit Upload | Download unter /bbsnap |
| PDF-Erzeugung | Edge/Chrome ohne Fenster druckt die Druckansicht | /api/v1/projects/{{id}}/pdf |
| Datenbank | Handbücher, Seiten, Medien-Verzeichnis, Benutzer, Verlauf | MySQL 8 / MariaDB |
| Medienablage | Bilder und PDFs je Handbuch | /uploads/{{projekt}}/… |
Datenmodell in einem Satz
Ein Handbuch (Projekt) enthält Kapitel (beliebig tief verschachtelt) und Seiten; Seiten verweisen aufeinander („Verwandte Themen“), binden Medien ein und haben einen Verlauf früherer Stände.
| Objekt | Schlüssel | Hinweis |
|---|---|---|
| Handbuch | GUID | importierte DocumentX-Projekte behalten ihre Projekt-ID |
| Kapitel | GUID | Inhaltsverzeichnis-Knoten |
| Seite (Topic) | GUID | Inhalt als HTML; bei Importen stabil über Reimporte |
| Medium | GUID | Datei unter /uploads |
| Stand im Verlauf | GUID | bis zu 50 frühere Stände je Seite |
Weiter mit dem Schnellstart oder direkt zu den Schnittstellen.