Dokumentation und Projektstruktur erweitert

- README ergänzt
- Technische Dokumentation erstellt
- Backup-Konzept dokumentiert
- docs-Verzeichnis angelegt
- Changelog erweitert
- Vorbereitungen für Screenshots und weitere Dokumentation
This commit is contained in:
2026-05-31 17:50:08 +02:00
parent 42e37e8de7
commit 4dc0568ab5
5 changed files with 203 additions and 62 deletions

67
docs/backup-concept.md Normal file
View File

@@ -0,0 +1,67 @@
# Backup-Konzept
## Hintergrund
Vor Änderungen an der Romexis-Datenbank kann automatisch ein Datenbankbackup erstellt werden.
Das Ziel ist nicht die Bereitstellung einer vollständigen Backup-Lösung, sondern eine zusätzliche Sicherheitsmaßnahme vor Bibliotheksinstallationen.
## Herkunft der Backup-Logik
Die verwendete Backup-Logik wurde nicht neu entwickelt.
Sie basiert auf dem bereits vorhandenen Projekt von Tobias Bauer:
```text
Backup & Restore
```
Die Ermittlung von SQL-Server, Datenbank, Romexis-Version und Image-Verzeichnis orientiert sich an der dort verwendeten Vorgehensweise.
## Kompatibilität
Ein wichtiges Ziel war die vollständige Kompatibilität mit den bereits vorhandenen Sicherungen.
Die mit diesem Installer erzeugten Backups können daher direkt mit dem bestehenden Projekt „Backup & Restore“ wiederhergestellt werden.
Es werden keine projektspezifischen Änderungen am Format vorgenommen.
## Speicherort
Backups werden im Romexis Images im "Backup" Verzeichnis gespeichert.
Beispiel:
```text
C:\Romexis_Images\Backup
```
## Dateiname
Format:
```text
YYYYMMDDHHMMSS#Datenbank#Version#.BAK
```
Beispiel:
```text
20260531163206#Romexis_db#65#.BAK
```
## SQL-Zugriff
Die Verbindungsinformationen werden aus der vorhandenen Romexis-Konfiguration gelesen:
```text
<Romexis>\sconfig\romexis_server.properties
```
Dadurch sind normalerweise keine manuellen Angaben erforderlich.
## Einschränkungen
Die Backup-Funktion ersetzt keine reguläre Datensicherung.
Für produktive Umgebungen werden weiterhin vollständige Backup- und Restore-Konzepte empfohlen.

View File

@@ -0,0 +1,95 @@
# Analyse der Implantbibliotheken
## Ziel dieser Analyse
Dieses Dokument beschreibt den Aufbau der von Planmeca bereitgestellten Implantbibliotheken sowie den Installationsablauf innerhalb des Projekts.
## Herkunft der Bibliotheken
Die Bibliotheken werden über die offizielle Planmeca Implant Library Webseite bereitgestellt.
Die Anwendung lädt die Seite herunter, analysiert die verfügbaren Downloadlinks und stellt diese dem Benutzer zur Auswahl bereit.
## Aufbau der ZIP-Dateien
Typischer Aufbau:
```text
Hersteller_installer.zip
└── Implant_library_files
└── Hersteller
├── implants
│ ├── files
│ └── scripts
└── sleeves
├── files
└── scripts
```
## Implantatdateien
Quelle:
```text
Implant_library_files\Hersteller\implants\files
```
Ziel:
```text
<Romexis>\geometries\implants\Hersteller
```
## Sleeve-Dateien
Quelle:
```text
Implant_library_files\Hersteller\sleeves\files
```
Ziel:
```text
<Romexis>\geometries\sleeves\Hersteller
```
## SQL-Dateien
Typische Dateien:
```text
RX_Hersteller_implantssqlsrv.sql
RX_Hersteller_sleevessqlsrv.sql
```
Diese werden nicht direkt durch das Projekt ausgeführt.
Stattdessen werden die vom Hersteller gelieferten Installationsskripte verwendet.
## Installationsskripte
Typische Dateien:
```text
Install_implant.bat
Install_script.bat
```
Die Nutzung der Originalskripte reduziert den Pflegeaufwand erheblich und erhöht die Kompatibilität bei zukünftigen Bibliotheksupdates.
## Hash-Prüfung
Zur Erkennung größerer Änderungen können bekannte SHA256-Hashes überprüft werden.
Dies dient als zusätzliche Sicherheitsmaßnahme und soll auffällige Änderungen an den Installationsskripten sichtbar machen.
## Ablauf
1. Bibliotheksliste laden
2. ZIP-Datei herunterladen
3. ZIP-Datei entpacken
4. Dateien nach Romexis kopieren
5. SQL-Dateien ermitteln
6. Originalinstaller ausführen
7. Ergebnis protokollieren

BIN
docs/screenshots/main.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 59 KiB