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

View File

@@ -19,74 +19,19 @@ Das Tool liest die öffentliche Planmeca Implant Library Webseite aus, zeigt die
- Aufruf der originalen `Install_implant.bat` / `Install_script.bat`
- Hashprüfung der bekannten Installerskripte
## Voraussetzungen
## Dokumentation
- Windows
- PowerShell 5.1 oder neuer
- Installiertes Planmeca Romexis
- Ausführung am Romexis-Server dringend empfohlen
- SQL Server Command Line Tools (`sqlcmd`) für Backup und SQL-Zugriff
- Schreibrechte auf:
- `C:\ProgramData\RomexisImplantLibraryCache`
- `C:\Program Files\Planmeca\Romexis\geometries`
- Administrative Rechte werden je nach Umgebung benötigt
Weitere technische Informationen befinden sich im Verzeichnis docs.
## Verwendung
PowerShell als Administrator starten und das Skript ausführen:
```powershell
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\RomexisImplantInstaller.ps1
```
Danach:
1. Bibliotheksliste wird automatisch geladen.
2. Gewünschte Bibliotheken auswählen.
3. Optional Backup aktiviert lassen.
4. Entweder nur herunterladen oder herunterladen und installieren.
## Cache
Die heruntergeladenen ZIP-Dateien werden standardmäßig unter folgendem Pfad abgelegt:
```text
C:\ProgramData\RomexisImplantLibraryCache
```
Neben jeder ZIP-Datei wird eine `.meta.json` gespeichert. Darin stehen unter anderem:
- URL
- ETag
- Last-Modified
- Content-Length
- Downloadzeitpunkt
- SHA256
Wenn sich eine Datei online geändert hat, wird sie erneut heruntergeladen.
## Backup
Vor der Installation kann automatisch ein SQL-Backup der Romexis-Datenbank erstellt werden. Das Backup ist nur als Sicherheitsnetz vor Bibliotheksänderungen gedacht und ersetzt kein reguläres Backupkonzept.
Die Logik ist an das Format vom Backup & Restore SCript von Tobias Bauer angeleht und kann damit ggf. wieder eingelesen werden
- [installer-analysis.md](docs/installer-analysis.md)
- [backup-concept.md](docs/backup-concept.md)
- [screenshots/](docs/screenshots)
## Hinweise
Dieses Projekt ist kein offizielles Planmeca-Tool. Es ruft die von Planmeca bzw. den Herstellern mitgelieferten Installationsskripte auf, statt die SQL-Logik vollständig nachzubauen.
Dieses Projekt ersetzt keine reguläre Datensicherung.
Die Nutzung erfolgt auf eigene Verantwortung. Vor produktivem Einsatz sollte ein vollständiges Backup vorhanden sein.
## Projektstruktur
```text
.
├── RomexisImplantInstaller.ps1
├── README.md
├── CHANGELOG.md
├── LICENSE
└── .gitignore
```
Vor Änderungen an produktiven Systemen sollten zusätzliche Backups vorhanden sein.
## Lizenz