65 lines
3.9 KiB
Markdown
65 lines
3.9 KiB
Markdown
# Empfehlung: SharePoint Architektur für die IT-Dokumentation
|
||
|
||
## Zielsetzung
|
||
Aufbau einer zentralen, sicheren und effizienten Wissensdatenbank für die IT-Abteilung zur Speicherung von Konfigurationen (Switch-Configs), Skripten und Dokumentationen.
|
||
|
||
## Empfehlung: SharePoint Team Site (Privat)
|
||
Für unsere Anforderungen ist eine klassische **SharePoint Team Site** die optimale Lösung. Im Vergleich zum „Inhaltscenter“ (Content Center) bietet sie folgende entscheidende Vorteile:
|
||
|
||
### 1. Nahtlose Microsoft Teams Integration
|
||
* **Team Site:** Erstellt automatisch eine Microsoft 365 Gruppe und ein dediziertes Teams-Team. Dokumente sind direkt über den Reiter „Dateien“ in Teams erreichbar.
|
||
* **Inhaltscenter:** Ist ein spezielles Template für Microsoft Syntex (KI-Dokumentenanalyse) und bietet keine direkte, automatisierte Teams-Anbindung.
|
||
|
||
### 2. Fokus auf Zusammenarbeit und Dateiverwaltung
|
||
* **Team Site:** Optimiert für das tägliche Arbeiten mit Dateien (.txt, .md, .conf, .sh). Unterstützt hervorragend die **OneDrive-Synchronisation**, was die Bearbeitung mit Tools wie VS Code ermöglicht.
|
||
* **Inhaltscenter:** Konzipiert für die Klassifizierung von Dokumenten (z. B. Rechnungsverarbeitung mittels KI). Für reine IT-Dokumentation und Konfigurationsdateien ist dieser Overhead kontraproduktiv.
|
||
|
||
### 3. Einfachheit und Wartbarkeit
|
||
* **Team Site:** Einfache Rechteverwaltung auf Teamebene. Keine komplexen KI-Modelle oder Syntex-Lizenzen erforderlich.
|
||
* **Inhaltscenter:** Erfordert spezifisches Know-how in der Inhaltsmodellierung, was für eine technische Wiki-Struktur unnötig kompliziert ist.
|
||
|
||
### 4. Unterstützung technischer Formate
|
||
* Die Team Site ermöglicht eine schnelle Vorschau und Suche innerhalb von **Plain-Text-Dateien (.txt)** und **Markdown (.md)** direkt im Browser, was für Switch-Konfigurationen und Anleitungen essenziell ist.
|
||
|
||
---
|
||
|
||
## Umsetzung & Fortschritt (Stand: 16.03.2026)
|
||
|
||
Das Projekt wurde erfolgreich gestartet und die Basis-Infrastruktur steht bereit.
|
||
|
||
### 1. Implementierte Web-Struktur
|
||
Der SharePoint wurde als **private Team Site** unter dem Namen `IT Internal Repository` erstellt.
|
||
|
||
**Verzeichnisstruktur in der Dokumentenbibliothek (Documents):**
|
||
* `01_Infrastructure`: Konfigurationen (z. B. Postfix, Switches) und Netzwerkpläne.
|
||
* `02_Software`: Installationsdateien, Lizenzschlüssel und Software-Dokumentation.
|
||
* `03_Knowledge_Base`: Allgemeine IT-Anleitungen und Knowledge-Base-Artikel (.md).
|
||
* `04_Automation_Scripts`: Zentrale Ablage für Python, Bash und PowerShell Skripte.
|
||
* `05_Archive`: Veraltete Backups und Protokolle.
|
||
|
||
### 2. Dashboard & Navigation
|
||
Die Startseite wurde als **IT Dashboard** konfiguriert:
|
||
* **Hero-Bereich:** Direkte Verlinkung zu Infrastruktur, Software und Wiki.
|
||
* **Schnelllinks:** Schnellzugriff auf alle Hauptverzeichnisse (01-05).
|
||
* **News/Updates:** Automatische Anzeige der neuesten SOP-Seiten.
|
||
|
||
### 3. Erstellte Dokumentationen (SOPs)
|
||
Folgende Standard Operating Procedures (SOPs) wurden bereits auf SharePoint-Seiten sowie lokal als `.md` Dateien implementiert:
|
||
* `SOP: Automatisierter PDF-Import aus O365 (v2.2)`
|
||
* `SOP: Bereinigung alter Datensätze (delete_old_records.py)`
|
||
* **SOP: Konfiguration Postfix SMTP Relay (APS-SMTP01)**
|
||
* **SOP: Export von Druckprotokollen in MySQL (PowerShell)**
|
||
|
||
### 4. Integrationen
|
||
* **Microsoft Teams:** Die SharePoint-Seite ist mit dem Team `Informationstechnologie` (Private Gruppe) verbunden.
|
||
* **OneNote:** Das gemeinsame Notizbuch (Notizbuch) wurde integriert und lokale Abschnitte erfolgreich migriert.
|
||
* **OneDrive Sync:** Die Synchronisation für die Bearbeitung via Windows Explorer und WSL ist vorbereitet.
|
||
|
||
### 5. Nächste Schritte
|
||
* Vollständiger Upload des Software-Archivs via OneDrive.
|
||
* Integration von Switch-Konfigurationen in `01_Infrastructure`.
|
||
* Erweiterung der Wissensdatenbank durch das IT-Team.
|
||
|
||
---
|
||
*Aktualisiert für das IT-Team – Projekt: Internal Repository*
|