Microsoft naptári események és helyi feladatok
A BFF /calendar oldala a postafiók saját Outlook-naptárait mutatja. Az eseményeket a Microsoft Graph szolgáltatja. A feladatok helyiek, és a fiók munkamenetéhez tartoznak. A meglévő mail.read és mail.crud hozzáférés a calendar.read és calendar.manage jogosultságokkal együtt működik.
Mielőtt engedélyezed a szolgáltatóhozzáférést, fejezd be a Microsoft Graph setup lépéseit.
Setup-előfeltételek
Alkalmazd a mailGen/ECS_MovePST_To_TempSQL/DB_Lib/Sql/20260927_calendar_catalog.sql fájlt a deployment kontrollált sémaútján keresztül. Generáld a backend és a BFF Prisma kliensét a saját sémájukból, majd indítsd újra az érintett folyamatokat.
Eseményírás Entra application jogosultságot igényel, a Calendars.ReadWrite nevűt, adminisztrátori jóváhagyással. A Calendars.Read csak olvasási hozzáférést támogat, eseménymódosítást nem.
Katalógus és keresés
A GraphPullPoller calendar catalog workert futtat az aktív Microsoft-postafiókokhoz. A worker nagyjából ötpercenként nézi át az esedékes naptárakat, egyperces worker-ütemekben. Az egyedi eseményeket és az ismétlődő sorozatok főeseményeit időkorlát nélkül a tenant_data.calendar_event táblába indexeli.
A tenant_data.calendar_sync_state tárolja a következő frissítést, az utolsó sikeres futást és a worker lease-ét. A hiányzó eseményeket és naptárakat a rendszer csak teljes, sikeres lapozás után törli a helyi leképezésből. Graph-hiba esetén a meglévő indexelt adatok megmaradnak, és az újrapróbálkozási idő érvényes.
A felső keresés az indexben ellenőrzi a címet, a helyszínt és a szöveges előnézetet. Egy oldal legfeljebb 100, postafiókhoz kötött elemet tartalmaz. A migráció pg_trgm indexei a részszöveges keresést támogatják. A keresés az összes saját naptárra és sorozatra kiterjed, függetlenül a látható dátumtartománytól.
A naptárnézet a megjelenített időszakra a Graph calendarView endpointjától kéri le a konkrét előfordulásokat.
Műveletek és időzónák
Az új események az alapértelmezett Outlook-naptárba kerülnek. A szerkesztés és a törlés az esemény forrásnaptárát használja. Ismétlődő előfordulásnál válaszd ki, hogy csak az adott előfordulást vagy a teljes sorozatot módosítsd.
A Graph-eredetű jegyzetek szerkesztés közben csak olvashatók, így a meglévő megbeszélés tartalma nem változik. A helyi feladatok külön maradnak.
A felület az időpontokat az eszköz helyi időzónájában mutatja. A Graph-válaszok az időbélyegeket UTC-re normalizálják. A teljes napos események megtartják a naptári dátumukat. Mentés előtt a felület ellenőrzi a címet, az érvényes helyi időpontot, és azt, hogy a befejezés a kezdés után van.
A katalógus néhány perccel elmaradhat az Outlooktól. Hiba esetén a keresés figyelmeztet, hogy az eredmények elavultak lehetnek. Új esemény létrehozása jelenleg egyetlen eseményt hoz létre. A meglévő Outlook-ismétlődő sorozatok kezelhetők. Engedélyezett írás után ellenőrizd a szolgáltató eredményét.