# 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*