Full-Doc.md aktualisiert

-add license

Full-Doc.md

@@ -1,6 +1,6 @@
 # LeanderShiftPlannerV2 – Technische Dokumentation
 
-**Version:** 2.0.1  
+**Version:** 2.0.2  
 **Sprache:** C# / .NET 9.0  
 **Framework:** Avalonia UI 11.2.1  
 **Repository:** https://gitea.leanderserver.de/leander19961/LeanderShiftPlannerV2
@@ -343,4 +343,24 @@ Die Oberfläche ist mit **Avalonia UI** und dem **Fluent Theme** umgesetzt. Sie
 
 ---
 
-*Dokumentation erstellt am 22.04.2026*
+**Google API Zugangsdaten einrichten**
+Da das Programm über deinen persönlichen Google Account auf den Kalender zugreift, musst du einmalig eigene OAuth-Zugangsdaten in der Google Cloud Console erstellen und in der Datei Resources/templates/googleapi.txt hinterlegen.
+
+Schritt-für-Schritt-Anleitung:
+
+- Öffne die [Google Cloud Console](https://console.cloud.google.com/) und melde dich mit deinem Google-Konto an.
+- Erstelle ein neues Projekt oder wähle ein bestehendes aus.
+- Navigiere zu „APIs & Dienste" → „Bibliothek" und suche nach „Google Calendar API". Klicke auf „Aktivieren".
+- Gehe zu „APIs & Dienste" → „Anmeldedaten" und klicke auf „Anmeldedaten erstellen" → „OAuth-Client-ID".
+- Falls noch nicht geschehen, wirst du aufgefordert, den OAuth-Zustimmungsbildschirm zu konfigurieren. Wähle dort „Extern" und fülle die Pflichtfelder (App-Name, Support-E-Mail) aus. Alle anderen Felder können leer bleiben.
+- Als Anwendungstyp wähle „Desktop-App" und vergib einen beliebigen Namen.
+- Nach der Erstellung siehst du deine Client-ID und dein Client-Secret. Trage beide Werte in die Datei Resources/templates/googleapi.txt ein:
+
+  `ClientId=deine-client-id`
+  `ClientSecret=dein-client-secret`
+   
+Beim ersten Programmstart öffnet sich einmalig ein Browser-Fenster, in dem du den Zugriff für dein Google-Konto bestätigst. Danach wird das Zugriffstoken lokal gespeichert und der Dialog erscheint nicht mehr.
+
+**Wichtig ist:** Es muss am Ende ein OAuth2-Client für die Google Calendar API des eigenen Kontos freigegeben sein, die ClientID und das ClientSecret werden vom Programm für den Kalenderzugriff benötigt.
+
+*Dokumentation erstellt am 28.04.2026*

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 leander19961
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

LeanderShiftPlannerV2/FileIO/GoogleApiLoader.cs

@@ -7,7 +7,7 @@ namespace LeanderShiftPlannerV2.FileIO;
 
 public static class GoogleApiLoader
 {
-    public static bool CheckFileSystem()
+    public static bool CheckFileSystem_ReadFile()
     {
         if (!Directory.Exists(Constants.DataPath))
             Directory.CreateDirectory(Constants.DataPath);
@@ -21,9 +21,21 @@ public static class GoogleApiLoader
         return true;
     }
     
+    public static bool CheckFileSystem_ReadToken()
+    {
+        if (!Directory.Exists(Constants.DataPath))
+            Directory.CreateDirectory(Constants.DataPath);
+        if (!File.Exists(Constants.DataPath + Constants.GoogleApiTokenPath))
+        {
+            File.Create(Constants.DataPath + Constants.GoogleApiTokenPath);
+            return false;
+        }
+        return true;
+    }
+
     public static Dictionary<string, string> ReadFile()
     {
-        if (!CheckFileSystem()) return new  Dictionary<string, string>();
+        if (!CheckFileSystem_ReadFile()) return new  Dictionary<string, string>();
         Dictionary<string, string> apiSecrets = new Dictionary<string, string>();
             
         try
@@ -51,4 +63,30 @@ public static class GoogleApiLoader
 
         return apiSecrets;
     }
+
+    public static void WriteToken(string token)
+    {
+        if (File.Exists(Constants.DataPath + Constants.GoogleApiTokenPath))
+            File.Delete(Constants.DataPath + Constants.GoogleApiTokenPath);
+        File.Create(Constants.DataPath + Constants.GoogleApiTokenPath).Close();
+        File.WriteAllText(Constants.DataPath + Constants.GoogleApiTokenPath, token);
+    }
+    
+    public static string? ReadToken()
+    {
+        if (!CheckFileSystem_ReadToken()) return null;
+        string tokenString = null;
+            
+        try
+        {
+            tokenString = File.ReadAllText(Constants.DataPath + Constants.GoogleApiTokenPath);
+        }
+        catch (Exception ex)
+        {
+            //TODO
+            Console.WriteLine($"Fehler beim Lesen der Datei: {ex.Message}");
+        }
+
+        return (tokenString.Equals(String.Empty) ? null : tokenString);
+    }
 }

LeanderShiftPlannerV2/LeanderShiftPlannerV2.csproj

@@ -8,10 +8,10 @@
         <ApplicationIcon>Resources/icon/ShiftPlannerIcon.ico</ApplicationIcon>
         <AvaloniaUseCompiledBindingsByDefault>true</AvaloniaUseCompiledBindingsByDefault>
         <PackageIcon>Resources\icon\ShiftPlannerIcon.png</PackageIcon>
-        <AssemblyVersion>1.0.5</AssemblyVersion>
-        <FileVersion>1.0.5</FileVersion>
+        <AssemblyVersion>2.0.2</AssemblyVersion>
+        <FileVersion>2.0.2</FileVersion>
         <NeutralLanguage>en</NeutralLanguage>
-        <Version>1.0.5</Version>
+        <Version>2.0.2</Version>
     </PropertyGroup>
 
     <ItemGroup>

LeanderShiftPlannerV2/Service/TimesheetService.cs

@@ -10,6 +10,8 @@ using System.Threading.Tasks;
 using LeanderShiftPlannerV2.Model;
 using LeanderShiftPlannerV2.Util;
 using Google.Apis.Auth.OAuth2;
+using Google.Apis.Auth.OAuth2.Flows;
+using Google.Apis.Auth.OAuth2.Responses;
 using Google.Apis.Calendar.v3;
 using Google.Apis.Services;
 using LeanderShiftPlannerV2.FileIO;
@@ -30,25 +32,54 @@ public class TimesheetService
 
     public async Task GenerateGoogleTimeSheets(List<Person> persons, bool randomize)
     {
-        string[] scopes = { CalendarService.Scope.CalendarReadonly };
         const string applicationName = "LeanderShiftPlanner";
 
         Dictionary<string, string> secrets = GoogleApiLoader.ReadFile();
 
         if (!secrets.ContainsKey(Constants.GoogleClientId) || !secrets.ContainsKey(Constants.GoogleClientSecret))
             return;
-        if (secrets[Constants.GoogleClientId].Equals(string.Empty) || secrets[Constants.GoogleClientSecret].Equals(string.Empty))
+        if (secrets[Constants.GoogleClientId].Equals(string.Empty) ||
+            secrets[Constants.GoogleClientSecret].Equals(string.Empty))
             return;
 
+        UserCredential credential;
+        string[] scopes = { CalendarService.Scope.CalendarReadonly };
         ClientSecrets clientSecrets = new ClientSecrets();
         clientSecrets.ClientId = secrets[Constants.GoogleClientId];
         clientSecrets.ClientSecret = secrets[Constants.GoogleClientSecret];
-        //clientSecrets.ClientId = "823920428427-ub5n9a9dkfpuvjlut4eneg2058so49o3.apps.googleusercontent.com";
-        //clientSecrets.ClientSecret = "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";
-        UserCredential credential = await GoogleWebAuthorizationBroker.AuthorizeAsync(clientSecrets, scopes, "user", CancellationToken.None);
+        string? tokenString = GoogleApiLoader.ReadToken();
+
+
+        try
+        {
+            TokenResponse token = new TokenResponse { RefreshToken = tokenString };
+
+            credential = new UserCredential(
+                new GoogleAuthorizationCodeFlow(new GoogleAuthorizationCodeFlow.Initializer
+                {
+                    ClientSecrets = clientSecrets
+                }),
+                "user",
+                token
+            );
+
+            if (!await credential.RefreshTokenAsync(CancellationToken.None))
+            {
+                credential = await GoogleWebAuthorizationBroker.AuthorizeAsync(clientSecrets, scopes, "user",
+                    CancellationToken.None);
+                GoogleApiLoader.WriteToken(credential.Token.RefreshToken);
+            }
+        }
+        catch (Exception e)
+        {
+            credential = await GoogleWebAuthorizationBroker.AuthorizeAsync(clientSecrets, scopes, "user",
+                CancellationToken.None);
+            GoogleApiLoader.WriteToken(credential.Token.RefreshToken);
+        }
+
 
         // Erstelle den CalendarService
-        var service = new CalendarService(new BaseClientService.Initializer()
+        CalendarService service = new CalendarService(new BaseClientService.Initializer()
         {
             HttpClientInitializer = credential,
             ApplicationName = applicationName,
@@ -66,7 +97,8 @@ public class TimesheetService
                 // Erster Tag des aktuellen Monats (00:00:00 Uhr)
                 DateTime firstDayOfMonth = new DateTime(now.Year, Constants.Months.IndexOf(month), 1, 0, 0, 0);
                 // Letzter Tag des aktuellen Monats (23:59:59 Uhr)
-                DateTime lastDayOfMonth = new DateTime(now.Year, Constants.Months.IndexOf(month), DateTime.DaysInMonth(now.Year, Constants.Months.IndexOf(month)),
+                DateTime lastDayOfMonth = new DateTime(now.Year, Constants.Months.IndexOf(month),
+                    DateTime.DaysInMonth(now.Year, Constants.Months.IndexOf(month)),
                     23, 59, 59);
 
                 // Beispiel: Liste die nächsten 10 Ereignisse im ITM Kalender auf
@@ -134,7 +166,8 @@ public class TimesheetService
                 int currentPersonHours = 0;
                 int currentPatternIndex = 0;
                 int dayOfMonth = 1;
-                int lastDayOfMonth = new DateTime(DateTime.Now.Year, Constants.Months.IndexOf(month), dayOfMonth).AddMonths(1).AddDays(-1).Day;
+                int lastDayOfMonth = new DateTime(DateTime.Now.Year, Constants.Months.IndexOf(month), dayOfMonth)
+                    .AddMonths(1).AddDays(-1).Day;
                 while (currentPersonHours != monthHours)
                 {
                     DateTime currentDay = new DateTime(DateTime.Now.Year, Constants.Months.IndexOf(month), dayOfMonth);
@@ -148,7 +181,8 @@ public class TimesheetService
                     {
                         case 6:
                         {
-                            DateTime dayStart = new DateTime(currentDay.Year, currentDay.Month, currentDay.Day, 9, 0, 0);
+                            DateTime dayStart = new DateTime(currentDay.Year, currentDay.Month, currentDay.Day, 9, 0,
+                                0);
                             DateTime dayEnd = new DateTime(currentDay.Year, currentDay.Month, currentDay.Day, 16, 0, 0);
                             timesheetValue.Add((dayStart, dayEnd, true));
                             currentPersonHours += 6;
@@ -156,7 +190,8 @@ public class TimesheetService
                         }
                         case 4:
                         {
-                            DateTime dayStart = new DateTime(currentDay.Year, currentDay.Month, currentDay.Day, 9, 0, 0);
+                            DateTime dayStart = new DateTime(currentDay.Year, currentDay.Month, currentDay.Day, 9, 0,
+                                0);
                             DateTime dayEnd = new DateTime(currentDay.Year, currentDay.Month, currentDay.Day, 13, 0, 0);
                             timesheetValue.Add((dayStart, dayEnd, false));
                             currentPersonHours += 4;
@@ -164,7 +199,8 @@ public class TimesheetService
                         }
                         case 2:
                         {
-                            DateTime dayStart = new DateTime(currentDay.Year, currentDay.Month, currentDay.Day, 14, 0, 0);
+                            DateTime dayStart = new DateTime(currentDay.Year, currentDay.Month, currentDay.Day, 14, 0,
+                                0);
                             DateTime dayEnd = new DateTime(currentDay.Year, currentDay.Month, currentDay.Day, 16, 0, 0);
                             timesheetValue.Add((dayStart, dayEnd, false));
                             currentPersonHours += 2;
@@ -172,7 +208,8 @@ public class TimesheetService
                         }
                         case 1:
                         {
-                            DateTime dayStart = new DateTime(currentDay.Year, currentDay.Month, currentDay.Day, 9, 0, 0);
+                            DateTime dayStart = new DateTime(currentDay.Year, currentDay.Month, currentDay.Day, 9, 0,
+                                0);
                             DateTime dayEnd = new DateTime(currentDay.Year, currentDay.Month, currentDay.Day, 10, 0, 0);
                             timesheetValue.Add((dayStart, dayEnd, false));
                             currentPersonHours += 1;
@@ -202,7 +239,8 @@ public class TimesheetService
         for (int i = 0; i <= daysInYear; i++)
         {
             DateTime currentDay = firstDayOfYear.AddDays(i);
-            if (currentDay.DayOfWeek == DayOfWeek.Saturday || currentDay.DayOfWeek == DayOfWeek.Sunday) weekends.Add(currentDay);
+            if (currentDay.DayOfWeek == DayOfWeek.Saturday || currentDay.DayOfWeek == DayOfWeek.Sunday)
+                weekends.Add(currentDay);
         }
 
         return weekends;
@@ -328,11 +366,13 @@ public class TimesheetService
 
             int currentPatternIndex = 0;
             int dayOfMonth = 1;
-            int lastDayOfMonth = new DateTime(DateTime.Now.Year, Constants.Months.IndexOf(month), dayOfMonth).AddMonths(1).AddDays(-1).Day;
+            int lastDayOfMonth = new DateTime(DateTime.Now.Year, Constants.Months.IndexOf(month), dayOfMonth)
+                .AddMonths(1).AddDays(-1).Day;
             while (currentPersonHours != monthHours)
             {
                 DateTime currentDay = new DateTime(DateTime.Now.Year, Constants.Months.IndexOf(month), dayOfMonth);
-                if (holidays.Contains(currentDay) || weekends.Contains(currentDay) || CheckForDayIsNotEmpty(currentDay, timesheetValue))
+                if (holidays.Contains(currentDay) || weekends.Contains(currentDay) ||
+                    CheckForDayIsNotEmpty(currentDay, timesheetValue))
                 {
                     dayOfMonth++;
                     continue;

LeanderShiftPlannerV2/Util/Constants.cs

@@ -21,6 +21,7 @@ namespace LeanderShiftPlannerV2.Util
         public const string GoogleClientId = "GoogleClientId";
         public const string GoogleClientSecret = "GoogleClientSecret";
         public const string GoogleApiFileResource = @"Resources/templates/googleapi.txt";
+        public const string GoogleApiTokenPath = @"/googleapitoken.txt";
         
         // TimeSheets
         public static readonly string TimeSheetSourceRandom = "Random";

LeanderShiftPlannerV2/View/LeanderShiftPlannerView/LeanderShiftPlannerMainWindow.axaml.cs

@@ -47,7 +47,8 @@ public partial class LeanderShiftPlannerMainWindow : Window
 
     private void CreateApiFile()
     {
-        GoogleApiLoader.CheckFileSystem();
+        GoogleApiLoader.CheckFileSystem_ReadFile();
+        GoogleApiLoader.CheckFileSystem_ReadToken();
     }
 
     // ------------------------------------------------------UI-Interactions------------------------------------------------------