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:
67
docs/backup-concept.md
Normal file
67
docs/backup-concept.md
Normal 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.
|
||||
95
docs/installer-analysis.md
Normal file
95
docs/installer-analysis.md
Normal 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
BIN
docs/screenshots/main.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 59 KiB |
Reference in New Issue
Block a user