yes

Took 6 minutes

.github/workflows/deployment.yml

@@ -94,7 +94,7 @@ jobs:
           port: ${{ secrets.SSH_SERVER_PORT }}
           script: |
             cd ${{ secrets.SSH_SERVER_BACKEND_PATH }}
-            echo -e 'OAUTH_CLIENT_ID="${{ secrets.OAUTH_CLIENT_ID }}"\nOAUTH_CLIENT_SECRET="${{ secrets.OAUTH_CLIENT_SECRET }}"\nOAUTH_REDIRECT_URI="${{ secrets.OAUTH_REDIRECT_URI }}"\nDB_URL="${{ secrets.DB_URL }}"' > .env
+            echo -e 'OAUTH_CLIENT_ID="${{ secrets.OAUTH_CLIENT_ID }}"\nOAUTH_CLIENT_SECRET="${{ secrets.OAUTH_CLIENT_SECRET }}"\nOAUTH_REDIRECT_URI="${{ secrets.OAUTH_REDIRECT_URI }}"\nDB_URL="${{ secrets.DB_URL }}"\nSTRIPE_PUBLISHABLE_KEY="${{ secrets.STRIPE_PUBLISHABLE_KEY }}"\nSTRIPE_SECRET_KEY="${{ secrets.STRIPE_SECRET_KEY }}"\nSTRIPE_SUCCESS_KEY="${{ secrets.STRIPE_SUCCESS_KEY }}"' > .env
 
       - name: Run backend
         uses: appleboy/[email protected]

README.md

@@ -1,3 +1,140 @@
-# 🏋️‍♂️ FitPlan Connect
+<div align='center'>
+  <img src='assets/fitplan.png' width='256' alt=''>
+</div>
 
-<img src='https://raw.githubusercontent.com/rokartur/fitplanconnect/main/assets/db-uml.png' alt=''/>
+## About
+
+FitPlan Connect is a scheduling app that has earned recognition as one of the best on the market thanks to its array of advanced features and intuitive user interface. **This project is part of the Object-Oriented Programming subject at the University.**
+
+## Features
+
+- Fast create account and login with GitHub OAuth
+- Planning and tracking meetings with personal trainers
+- Choose your personal trainer
+- Preview your plan along with your subscription end date
+
+## Installation
+
+1. Install the latest LTS version of [Node.js](https://nodejs.org/en/download/)
+2. Install [yarn](https://yarnpkg.com/en/docs/install), run the following command:
+    ```bash
+    npm i -g yarn
+     ```
+3. Install [bun](https://bun.sh/), run the following command for Linux & macOS:
+    ```bash
+    curl -fsSL https://bun.sh/install | bash
+    ```
+    or for Windows:
+    ```bash
+    powershell -c "irm bun.sh/install.ps1 | iex"
+    ```
+4. Click `Code` button on the top right of this page and copy the link under `Clone` tab.
+5. Open project in any IDE of your choice.
+6. Install nginx and configure it with the
+   following [config](https://github.com/rokartur/fitplanconnect/blob/main/nginx.conf)
+7. **Frontend** Open terminal and run the following command:
+    ```bash
+    cd website
+    yarn
+    yarn dev
+    ```
+8. **Backend** Open another terminal and run the following command:
+    ```bash
+    cd backend
+    bun install
+    bun run dev
+    ```
+9. Environment file should be created in the root of the backend folder with the following content:
+    ```dotenv
+    OAUTH_CLIENT_ID=""
+    OAUTH_CLIENT_SECRET=""
+    OAUTH_REDIRECT_URI="http://localhost/api/oauth/callback"
+    DB_URL="postgresql://user:password@host:port/database"
+    STRIPE_PUBLISHABLE_KEY=""
+    STRIPE_SECRET_KEY=""
+    STRIPE_SUCCESS_KEY=""
+    ```
+10. Setup database with the following command:
+    ```bash
+    bun run db:generate
+    bun run db:migrate
+    ```
+11. For the database preview you can use the following command:
+    ```bash
+    bun run db:studio
+    ```
+
+## Database Schema
+
+![Database Schema](https://raw.githubusercontent.com/rokartur/fitplanconnect/main/assets/db-uml.png)
+
+## Technologies
+- [TypeScript](https://www.typescriptlang.org/)
+- [React](https://reactjs.org/)
+- [ElysiaJS](https://elysiajs.com/)
+- [PostgreSQL](https://www.postgresql.org/)
+- [Drizzle ORM](https://orm.drizzle.team/)
+- [Bun](https://bun.sh/)
+- [Nginx](https://nginx.org/en/)
+- [GitHub OAuth](https://docs.github.com/en/apps)
+- [Stripe](https://stripe.com/docs)
+
+## 🇵🇱 Podsumowanie
+### Koncept
+
+Założenia projektu były ogromne, udało nam się zrealizować cześć z nich. Aplikacja posiada podstawowe funkcjonalności, takie jak logowanie, wybór trenera, planowanie treningu personalnego z wybranym trenerem oraz jego podgląd. Aplikacja jest w pełni responsywna, co pozwala na korzystanie z niej na każdym urządzeniu.
+
+Mieliśmy w planach rozbudowanie jej o dodatkowe funkcjonalności, aplikacja miała być podzielona na dwa moduły panel dla trenerów personalnych oraz główna aplikacja dla ich podopiecznych. Panel dla trenerów miał posiadać:
+- Przegląd gdzie byłyby widoczne wszystkie statystyki sprzedaży usługi, statystyki treningowe oraz użytkowników.
+- Zakładkę wszystkich użytkowników z możliwością sortowania oraz filtrowania po najważniejszych danych, oraz informacje o konkretnym użytkowniku, gdzie byłyby wyświetlane wszystkie dostępne dane za wyjątkiem hasła.
+- Kalendarz dla zalogowanego trenera, gdzie byłyby widoczne wszystkie treningi z przypisanymi podopiecznymi oraz możliwość zmiany harmonogramy dostępności dla trenera, kiedy można z nim ćwiczyć, a kiedy nie.
+- Zakładkę do zarządzania wszystkimi trenerami, byłby jeden główny trener z rolą "ADMIN", który miałby dostęp i mógłby zarządzać trenerami. Dostępne byłyby 3 role ADMIN, EDITOR, VIEWER. Editor mógłby przesyłać plany treningowe oraz diety, dla podopiecznego. Viewer mógłby tylko wyświetlać dane o konkretnym użytkowniku.
+- Ostatnią zakładką byłyby kody promocyjne oraz cały system do zarządzania nimi. Wyświetlana byłaby lista wszystkich kodów z opcją filtrowania po statusie czy jest aktywny, czy nie oraz po typie kodu, czy jest on procentowy lub stały. Możliwość sortowania byłaby przypisana dla wartości nazwy kodu, wartości, czasu wygaśnięcia, pozostałej liczbie użyć, ilości zamówieniach z danym kodem. Opcja byłaby przypisana danego kodu rabatowego dla konkretnej lub wszystkich usług oraz można byłoby je usuwać, lub dezaktywować.
+
+Natomiast aplikacja dla użytkowników została zrealizowana w części. Posiada ona teraz:
+- Kalendarz, poprzez który podopieczni mogą umawiać się w określonych dniach o określonej godzinie na trening z wybranym trenerem.
+- Podstronę z wyborem dostępnych trenerów personalnych, użytkownik może ich sobie zmieniać w dowolnym momencie.
+- Opcję płatności, za pomocą platformy Stripe, gdzie przydzielany jest dostęp do aplikacji na rok po pozytywnie zrealizowanym zakupie.
+- Ustawienia, gdzie użytkownik może zobaczyć, jak wyglądają jego dane tzn. nazwa użytkownika oraz email, które są powiązane z kontem GitHub, poprzez które można się zalogować. Aplikacja głównie została stworzona dla siedzących programistów 😉
+
+Są jeszcze anulowane plany dla głównej aplikacji użytkowników. Było kilka systemów:
+- System raportów użytkownika, gdzie przesyłałby swoje raporty sylwetki co określony czas.
+- System diet oraz planów treningowych, gdzie użytkownik miałby dostęp do przesłanych materiałów przez trenera.
+
+Z mniejszych ogólnych rzeczy, miało być więcej zbieranych danych o użytkownikach w celu wystawienia automatycznej faktury elektronicznej na maila, po pozytywnie zrealizowanej płatności. Temat z logowaniem oraz rejestracją miał wyglądać kompletnie inaczej, niż jest obecnie. Przeszło przez nasze głowy bardzo dużo opcji zaczęło się od standardowej metody za pomocą maila i hasła oraz późniejsza weryfikacja za pomocą JWT (JSON Web Token) poprzez link na maila. Zaczęliśmy minimalizować ilość interakcji, jaką użytkownik musi wykonać, aby korzystać z naszej aplikacji, więc chcieliśmy przejść do metody za pomocą OTP (One-Time Password) przy użyciu numeru telefonu, ale okazało się, że aby wysyłać takie SMS'y do użytkownika trzeba płacić za dostęp do takiej usługi, a celem projektu było zminimalizowanie generujących kosztów, więc została droga mailowa, ale nie za pomocą 6 cyfrowego kodu tylko passphrase, a później za pomocą samego linku weryfikacyjnego z JWT przesyłanego na maila. Jesteśmy w miejscu i sytuacji, gdzie można się zalogować za pomocą 2 kliknięć, autoryzując się za pomocą zewnętrznego dostawcy w tym przypadku GitHuba przy użyciu biblioteki "arctic", która obsługuje 47 różnych popularnych dostawców takich jak Google, Facebook, Apple, Microsoft kończąc po osu!, MyAnimeList, Keycloak czy Roblox. Pozwala to na elastyczne skalowanie i szybkie dodawanie kolejnych dostawców autoryzacji, co pozwoli dotrzeć do większej ilości użytkowników i się do nich dostosować.
+
+Całość projektu była dokładnie planowana podczas pierwszych spotkań oraz ewentualnie korygowana i kwestionowana wraz z rozwojem projektu. Wszystkie plany koncepcyjne oraz makietę projektową, zostały wykonane we Figmie oraz FigJamie, do których linki są w sekcji [Resources](https://github.com/rokartur/fitplanconnect?tab=readme-ov-file#resources).
+
+Jednak z powodu ograniczeń czasowych nie udało nam się zrealizować w pełni naszych założeń. Mimo to jesteśmy zadowoleni z tego, co udało nam się zrobić.
+
+### Technologie
+
+Wiedząc, jaka jest [lista technologii](https://github.com/rokartur/fitplanconnect?tab=readme-ov-file#technologies) użytych do tego projektu omówmy, dlaczego wybraliśmy akurat te.
+
+Zaczynając od języka postawiliśmy na TypeScript, który przy użyciu prostoty, jaką znamy z JavaScript oraz dodaniu do niego typowania pozwala na napisane czytelnego, oraz bezpiecznego kodu — co powinno być priorytetem w każdej aplikacji. Aby wyświetlić cały interfejs, skorzystaliśmy z biblioteki React 18, oraz aby stylować elementy wykorzystaliśmy bibliotekę sass i język SCSS, aby czytelność względem zwykłego CSS była lepsza i aby łatwiej się odnaleźć w strukturze. Do zarządzania routingiem w aplikacji została zastosowana biblioteka React Router w swojej odmianie DOM (Document Object Model). Z ostatnich i ważniejszych bibliotek zastosowanych w aplikacji po stronie frontendu jest Redux, który pozwala na przechowywanie stanów w obrębie całej aplikacji oraz kompilator Vite `/vit/`, który jest wydajniejszy i lepiej zoptymalizowany niż domyślny, który zaoferowali nam twórcy Facebook'a.
+
+Przejdźmy do kuchni i kelnerów, czyli do backendu i API. W tym miejscu wręcz wymagane było to, aby pisać to w języku, gdzie typy są wymagane, aby zniwelować i wywoływać jak najmniej błędów, wybór był prosty, i aby zachować spójność, wyborem był TypeScript. Package manager, który został użyty to [bun](https://bun.sh/), nie jest on tu bez powodu, ponieważ przy użyciu frameworku [ElysiaJS](https://elysiajs.com/), który jest do 21 razy szybszy od popularnego rozwiązania, którym jest [Express](http://expressjs.com/). Dzięki temu połączeniu jesteśmy w stanie uzyskać prawie 2.5 mln zapytań na sekundę, co powoduje, że takie rozwiązanie jest w pierwszych 100 najszybszych na rynku, i drugie najszybsze w języku TypeScript (na 87 miejscu jest czysty bun według [TechEmpower Benchmark](https://www.techempower.com/benchmarks/#hw=ph&test=plaintext&section=data-r22)). Przechodząc dalej dochodzimy do przechowywania danych, postawiliśmy na PostgreSQL oraz na bibliotekę Drizzle ORM (Object-Relational Mapping (pl. Mapowanie obiektowo-relacyjne)). Bardzo dobre połączenie, gdzie za pomocą Drizzle definiujemy, jak ma wyglądać cała struktura bazy danych jej relację. Jest to bardzo proste i elastyczne narzędzie, kiedy chcemy pracować nad danymi lub edytować całą strukturę bazy. Po stronie serwera użyliśmy Nginx, który jest serwerem WWW, może być również używany jako odwrotny serwer proxy lub load balancer. Głównie służy nam on, aby uzyskać dostęp do aplikacji oraz API na jednym adresie IP, niwelując używanie portu w adresie URL.
+
+
+### Założenia przedmiotowe projektu
+
+Projekt był stworzony na potrzebę przedmiotu "Programowanie obiektowe". Podstawowe wymagania zawierały, aby były zastosowane następujące pojęcia: interfejsy, dziedziczenie, polimorfizm oraz hermetyzacja przy użyciu paradygmatu programowania obiektowego. Było to dla nas wyzwanie, ponieważ zazwyczaj aplikacje napisane w nowoczesnym React, nie są zazwyczaj pisane pod strukturę obiektową, ale udało nam zastosować pewne elementy w następujących miejscach lub rozwiązanie jest analogiczne:
+
+- Interfejsy znalazły zastosowanie do zdefiniowania typów dla tzw. props, czyli atrybutów dla praktycznie każdego komponentu. Możemy interfejs wykorzystać w kilku miejscach np. UserTypes jest definiowany przy stworzeniu globalnego miejsca do przetrzymywania stanów, aby później uzyskać dane użytkownika oraz przy pobieraniu danych o użytkowniku podczas włączania aplikacji.
+- Dziedziczenie udało nam się uzyskać poprzez stworzenie klasy `Member` i dziedziczyć ją dla klas `User` oraz `Trainer`.  Podobna sytuacja dzieje się dla klasy `TrainingMeetings`, która jest dziedziczona po `Meetings`, pozwala nam to zaoszczędzić linijki powtarzalnego kodu podczas uzyskiwania informacji o danym użytkowniku, trenerze lub spotkaniu.
+- Polimorfizm jest stosowany w komponentach, które mogą przyjmować różne formy i zachowania, zależnie od przekazanych atrybutów. Na przykład komponent Button może wyglądać inaczej w zależności od przekazanych mu wcześniej ustalonych atrybutów `type` lub `onClick`.
+- Hermetyzację możemy zauważyć przy używaniu tzw. hooków, które działają tylko w obrębie funkcji, do której zostały wpisane, możemy je przekazywać jedynie poprzez atrybuty do niższej hierarchii w strukturze. Istnieje ona również w komponentach wyższego rzędu np. przy użyciu biblioteki Redux do zdefiniowania "sklepu", który służy do globalnego przechowywania stanów dla całej aplikacji lub dla `HelmetProvider`, który służy do zarządzania meta danymi, zależnie od lokalizacji, w jakiej się znajdujemy.
+
+## Resources
+- [Website](https://fitplanconnect.site/)
+- [API Documentation](https://docs.fitplanconnect.site/reference)
+- [GitHub](https://github.com/rokartur/fitplanconnect)
+- [Figma Design](https://www.figma.com/design/EDRxiPZHsJCeHKlrh08gsY/fitplanconnect?node-id=0-1&t=V9B6evOnen69xHga-1)
+- [Figma Concept](https://www.figma.com/board/RMC8nNxTpV9zmUGCyHQcvy/fitplanconnect?node-id=0-1&t=5IN80e5pnA5W9Tyq-1)
+
+## License
+[“Commons Clause” License Condition v1.0](https://github.com/rokartur/fitplanconnect/?tab=License-1-ov-file)
+
+## Authors
+- [Artur Rok](https://github.com/rokartur)
+- [Paweł Polok](https://github.com/polokpawel)

Tasks/Task 1/Program.cs

@@ -0,0 +1,43 @@
+using System;
+
+namespace Task_1
+{
+    public class Rectangle
+    {
+        private double _a;
+        private double _b;
+        private double _surfaceArea;
+
+        public void read_data()
+        {
+            Console.WriteLine("Enter the value of side a:");
+            _a = Convert.ToDouble(Console.ReadLine());
+
+            Console.WriteLine("Enter the value of side b:");
+            _b = Convert.ToDouble(Console.ReadLine());
+        }
+
+        public void process_data()
+        {
+            _surfaceArea = _a * _b;
+        }
+
+        public void show_results()
+        {
+            Console.WriteLine($"Value of side a: {_a:F2}");
+            Console.WriteLine($"Value of side b: {_b:F2}");
+            Console.WriteLine($"Surface area: {_surfaceArea:F2}");
+        }
+    }
+
+    internal abstract class Program
+    {
+        public static void Main()
+        {
+            var rectangle = new Rectangle();
+            rectangle.read_data();
+            rectangle.process_data();
+            rectangle.show_results();
+        }
+    }
+}

Tasks/Task 1/Properties/AssemblyInfo.cs

@@ -0,0 +1,35 @@
+using System.Reflection;
+using System.Runtime.InteropServices;
+
+// General Information about an assembly is controlled through the following 
+// set of attributes. Change these attribute values to modify the information
+// associated with an assembly.
+[assembly: AssemblyTitle("Task_1")]
+[assembly: AssemblyDescription("")]
+[assembly: AssemblyConfiguration("")]
+[assembly: AssemblyCompany("")]
+[assembly: AssemblyProduct("Task_1")]
+[assembly: AssemblyCopyright("Copyright ©  2024")]
+[assembly: AssemblyTrademark("")]
+[assembly: AssemblyCulture("")]
+
+// Setting ComVisible to false makes the types in this assembly not visible 
+// to COM components.  If you need to access a type in this assembly from 
+// COM, set the ComVisible attribute to true on that type.
+[assembly: ComVisible(false)]
+
+// The following GUID is for the ID of the typelib if this project is exposed to COM
+[assembly: Guid("6E294257-4066-4FB1-8744-5AA72F0EBE11")]
+
+// Version information for an assembly consists of the following four values:
+//
+//      Major Version
+//      Minor Version 
+//      Build Number
+//      Revision
+//
+// You can specify all the values or you can default the Build and Revision Numbers 
+// by using the '*' as shown below:
+// [assembly: AssemblyVersion("1.0.*")]
+[assembly: AssemblyVersion("1.0.0.0")]
+[assembly: AssemblyFileVersion("1.0.0.0")]

Tasks/Task 1/Task 1.csproj

@@ -0,0 +1,55 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Project ToolsVersion="4.0" DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+    <Import Project="$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props"
+            Condition="Exists('$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props')"/>
+    <PropertyGroup>
+        <Configuration Condition=" '$(Configuration)' == '' ">Debug</Configuration>
+        <Platform Condition=" '$(Platform)' == '' ">AnyCPU</Platform>
+        <ProjectGuid>{6E294257-4066-4FB1-8744-5AA72F0EBE11}</ProjectGuid>
+        <OutputType>Exe</OutputType>
+        <AppDesignerFolder>Properties</AppDesignerFolder>
+        <RootNamespace>Task_1</RootNamespace>
+        <AssemblyName>Task_1</AssemblyName>
+        <TargetFrameworkVersion>v4.7.2</TargetFrameworkVersion>
+        <FileAlignment>512</FileAlignment>
+        <AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>
+    </PropertyGroup>
+    <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' ">
+        <PlatformTarget>AnyCPU</PlatformTarget>
+        <DebugSymbols>true</DebugSymbols>
+        <DebugType>full</DebugType>
+        <Optimize>false</Optimize>
+        <OutputPath>bin\Debug\</OutputPath>
+        <DefineConstants>DEBUG;TRACE</DefineConstants>
+        <ErrorReport>prompt</ErrorReport>
+        <WarningLevel>4</WarningLevel>
+    </PropertyGroup>
+    <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' ">
+        <PlatformTarget>AnyCPU</PlatformTarget>
+        <DebugType>pdbonly</DebugType>
+        <Optimize>true</Optimize>
+        <OutputPath>bin\Release\</OutputPath>
+        <DefineConstants>TRACE</DefineConstants>
+        <ErrorReport>prompt</ErrorReport>
+        <WarningLevel>4</WarningLevel>
+    </PropertyGroup>
+    <ItemGroup>
+        <Reference Include="System"/>
+        <Reference Include="System.Core"/>
+        <Reference Include="System.Data"/>
+        <Reference Include="System.Xml"/>
+    </ItemGroup>
+    <ItemGroup>
+        <Compile Include="Program.cs"/>
+        <Compile Include="Properties\AssemblyInfo.cs"/>
+    </ItemGroup>
+    <Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets"/>
+    <!-- To modify your build process, add your task inside one of the targets below and uncomment it. 
+         Other similar extension points exist, see Microsoft.Common.targets.
+    <Target Name="BeforeBuild">
+    </Target>
+    <Target Name="AfterBuild">
+    </Target>
+    -->
+
+</Project>

Tasks/Task 1/obj/Debug/.NETFramework,Version=v4.7.2.AssemblyAttributes.cs

@@ -0,0 +1,4 @@
+// <autogenerated />
+using System;
+using System.Reflection;
+[assembly: global::System.Runtime.Versioning.TargetFrameworkAttribute(".NETFramework,Version=v4.7.2", FrameworkDisplayName = ".NET Framework 4.7.2")]

Tasks/Task 1/obj/Debug/Task 1.csproj.CoreCompileInputs.cache

@@ -0,0 +1 @@
+f9fa4d8035e0f98d331bcefb7b0e1ab7c3cf386e53719f63d32749870109d736

Tasks/Task 1/obj/Debug/Task 1.csproj.FileListAbsolute.txt

@@ -0,0 +1,6 @@
+C:\Users\artur\Developer\fitplanconnect\Tasks\Task 1\bin\Debug\Task_1.exe
+C:\Users\artur\Developer\fitplanconnect\Tasks\Task 1\bin\Debug\Task_1.pdb
+C:\Users\artur\Developer\fitplanconnect\Tasks\Task 1\obj\Debug\Task 1.csproj.AssemblyReference.cache
+C:\Users\artur\Developer\fitplanconnect\Tasks\Task 1\obj\Debug\Task 1.csproj.CoreCompileInputs.cache
+C:\Users\artur\Developer\fitplanconnect\Tasks\Task 1\obj\Debug\Task_1.exe
+C:\Users\artur\Developer\fitplanconnect\Tasks\Task 1\obj\Debug\Task_1.pdb