WPanda/GEMINI_sharepoint_concept.md

SharePoint IT Dokumentációs Központ - Koncepció

1. Célkitűzés

Egy központi, felhőalapú (O365) platform létrehozása az IT részleg összes dokumentációjának, konfigurációjának és tudásbázisának tárolására. Ez egy zárt, belső IT gyűjtemény, nem nyilvános a többi dolgozó számára.

2. Webhely Típusa

• Típus: SharePoint Team Site (Privát)
• Név javaslat: IT Internal Repository
• Hozzáférés: Kizárólag az IT csapat tagjai számára.

3. Javasolt Struktúra (Dokumentumtárak)

A meglévő helyi struktúra alapján az alábbi könyvtárakat hozzuk létre:

• 01_Infrastructure (Infrastruktúra):
  • Switch konfigok (Conf/Switch/), szerver beállítások (Conf/aps.local/), hálózati rajzok.
  • Metaadat javaslat: Eszköz típusa, Gyártó.
• 02_Development_Projects (Projektek):
  • Docker fájlok, n8n munkafolyamatok, Python fejlesztések (Dev/).
  • Cél: Fejlesztési dokumentáció és kódminták.
• 03_Knowledge_Base (Wiki / SOP):
  • Telepítési útmutatók, hibajegy-megoldások, folyamatleírások (Doc/).
  • Formátum: SharePoint Pages vagy Markdown.
• 04_Automation_Scripts (Szkriptek):
  • Bash, PowerShell, Python szkriptek gyűjteménye (Scripts/).
  • Előny: Felhőből bárhonnan elérhető kódminták.
• 05_Archive (Archívum):
  • Régi backupok, kifutott projektek (Backup/).

4. Technikai Funkciók (IT Fókusz)

• Verziókezelés: Minden fájl módosítása visszakövethető (SharePoint Version History).

• OneDrive Sync: A fájlok helyi (Windows/Linux) szerkesztése és automatikus szinkronizációja (VS Code ajánlott).

• Markdown és Plain Text (.txt) Stratégia:

  • A technikai dokumentáció (.md) és a nyers konfigurációk (.txt, .conf, .sh) eredeti formátumban maradnak.
  • A switch konfigok (.txt) közvetlenül olvashatók és kereshetők a SharePoint webes felületén.
  • A verziókövetés lehetővé teszi a konfigurációk közötti különbségek követését.
  • A képek megjelenítése miatt a komplex dokumentációhoz a helyi szerkesztés (VS Code + OneDrive) ajánlott.

• Teams Integráció:

  • A SharePoint webhelyhez kapcsolódó Teams csapat automatikusan létrejön.
  • A dokumentumtárak (Libraries) külön fülként (Tab) hozzáadhatók a Teams csatornákhoz.
  • Gyors elérés: Fájlok megtekintése és alapvető szerkesztése közvetlenül a Teams felületén.
  • Központi keresés: A Teams keresője megtalálja a SharePointon tárolt konfigokat és leírásokat is.

5. Következő Lépések (Teendők)

• Célközönség meghatározása (Csak IT).
• Üres SharePoint Site létrehozása (Privát Team Site).
• Dokumentumtárak (Libraries) létrehozása a fenti struktúra szerint.
• Kezdeti adatok feltöltése (OneDrive szinkronizációval).

---

Ez a dokumentum a Gemini CLI segítségével készült, és a projekt aktuális állapotát tükrözi.