diff --git a/src/content/docs/sections/Backend/Get started.mdx b/src/content/docs/sections/Backend/Get started.mdx index 34a558cd..d0906f37 100644 --- a/src/content/docs/sections/Backend/Get started.mdx +++ b/src/content/docs/sections/Backend/Get started.mdx @@ -11,62 +11,27 @@ import { Image } from "astro:assets"; import { Picture } from "astro:assets"; import { getTeam, TeamMembers } from "../../../../components/TeamMembers"; -# O sekcji backend +## O sekcji backend -## Motyw przewodni sekcji backend +Elo żelo, przed Wami sekcja Backend. Zajmujemy się tworzeniem serwisów backendowych, używanych następnie przez inne sekcje. Wszystkiego rodzaju bazy danych, api, automatyczne synchronizacje i wiele więcej to właśnie my. Używamy głównie TypeScripta wraz z frameworkiem **NestJS**. -Sekcja backend jest dobrze ugruntowaną częścią **KN Solvro**, która stale rozwija się, tworząc rozwiązania, które są podstawą działania naszych aplikacji. Powstała ona w wakacje 2024 roku na wskutek rozbicia sekcji web na frontend, backend oraz devops. Naszym pierwszym działaniem było przeprowadzenie szkolenia "Od zera do backend developera". Skupiamy się na projektowaniu oraz implementacji systemów backendowych, które są zoptymalizowane, bezpieczne oraz skalowalne. Głównie korzystamy z **TypeScript**, wykorzystując framework **AdonisJS**. Programowanie jest naszą pasją - na naszych spotkaniach, dzielimy się pomysłami oraz wspieramy - problemy jednego członka są problemami całego zespołu, dzięki czemu nikt nie zostanie pozostawiony samemu sobie. +{" "} -## Działanie w sekcji backend - -W naszej sekcji nie znajdziesz nudnych projektów, przekopiowanych z poradnika. Działamy od podstaw samodzielnie, definiując problem, sposób jego rozwiązania oraz implementację. Równie ważne jest to, iż nasze działania mają realny wpływ. Rozwiązania tworzone przez sekcję backend są podstawą aplikacji, które są wykorzystywane przez studentów **Politechniki Wrocławskiej.** -Jeśli chcesz do nas dołączyć, skontaktuj się z **przewodniczącym sekcji!** - -## Onboarding + -- Jak wcześniej wspomnieliśmy, w naszych projektach korzystamy z **Adonisa**, z którym koniecznie musisz się zapoznać [**AdonisJS**](https://docs.solvro.pl/sections/backend/adonis/) -- Komunikacja to kluczowy element współpracy, tutaj dowiesz się jak skontaktować się ze swoim nowym zespołem [**Komunikacja**](https://docs.solvro.pl/communication) -- Nie wstydź się nam pokazać swojego kodu! W tej sekcji dowiesz się gdzie oraz w jaki sposób umieszczać swoje rozwiązania [**Korzystanie z GitHub**](https://docs.solvro.pl/github) +## Rozwój -## Nasze projekty +Wszyscy chcemy poszerzać swoje horyzonty. Tym samym niezależnie w jakim miejscu jestesmy mamy możliwość rozwoju. W KN Solvro nie boimy się pytać, szkolić i testować na produkcji. Działamy wspólnie, więc zachęcamy do dzielenia się swoimi osiągnięciami i umiejętnościami z resztą sekcji. Zacząć możecie poniżej, ale to dopiero początek. + + - - - - - - - - - - ## Nasze inne aktywności @@ -75,18 +40,15 @@ Jeśli chcesz do nas dołączyć, skontaktuj się z **przewodniczącym sekcji!** - uczestniczenie w konferencjach i warsztatach, aby śledzić najnowsze trendy i nawiązywać kontakty, - integracje i spotkania zespołowe, które pomagają nam budować relacje, ale również, aby zrelaksować się po ciężkim tygodniu na uczelni, - pomoc naszym członkom, w zdobyciu pierwszego doświadczenia zawodowego, umożliwiając udział w stażach oraz praktykach, -- tworzenie wytycznych, dotyczących tworzenia przejrzystego kodu. +- tworzenie wytycznych, dotyczących pisania przejrzystego kodu +- i wiele więcej aktywności wnoszących pozytywną wartość do koła i sekcji. Masz pomysł - zaproponuj! ## Nasz zespół ### Przewodniczący sekcji - - Prezes VII zarządu KN Solvro oraz przewodniczący sekcji backend. - - ![Uśmiechnięty Dawid Linek patrzący wprost w - obiektyw](../../../../assets/people/dawid_linek.jpg) + Przewodniczący Sekcji Backend 2025/2026 ### Członkowie sekcji diff --git a/src/content/docs/sections/Backend/History.mdx b/src/content/docs/sections/Backend/History.mdx new file mode 100644 index 00000000..e170e837 --- /dev/null +++ b/src/content/docs/sections/Backend/History.mdx @@ -0,0 +1,113 @@ +--- +title: Historia backendowa +description: Co porabialiśmy w ostatnich latach +sidebar: + order: 2 +--- + +import { Card, CardGrid, LinkCard } from "@astrojs/starlight/components"; + +import { Image } from "astro:assets"; +import { Picture } from "astro:assets"; +import { getTeam, TeamMembers } from "../../../../components/TeamMembers"; + +## Początki + +Sekcja backend jest dobrze ugruntowaną częścią KN Solvro, która stale rozwija się, tworząc rozwiązania, które są podstawą działania naszych aplikacji. Powstała ona w wakacje 2024 roku na wskutek rozbicia sekcji web na frontend, backend oraz devops. Naszym pierwszym działaniem było przeprowadzenie szkolenia “Od zera do backend developera”, gdzie wykonaliśmy tranzycję na ujednoliconą technologię Adonis JS. + +## 2024 + +### Przewodniczący + + + + Prezes VII zarządu KN Solvro oraz przewodniczący sekcji backend 2024/2025. + + ![Uśmiechnięty Dawid Linek patrzący wprost w + obiektyw](../../../../assets/people/dawid_linek.jpg) + + +### Projekty + +| Nazwa | Github | Daty | Techlead | +| --------------- | ------------------------------------------------------------------------------------ | -------------------------------- | ---------------- | +| Eventownik | [backend-eventownik](https://github.com/Solvro/backend-eventownik) | od marca 2024 | Dawid Linek | +| ToPWr | [backend-topwr](https://github.com/Solvro/backend-topwr) | 2024 | Jakub Czajkowski | +| ToPWr SKS | [backend-topwr-sks](https://github.com/Solvro/backend-topwr-sks) | od września 2024 | Jakub Czajkowski | +| Led Cube | [backend-led-cube](https://github.com/Solvro/backend-led-cube) | listopad 2024 – styczeń 2025 | Jakub Stępkowski | +| Kurs backendowy | [backend-course](https://github.com/Solvro/backend-course) | sierpień 2024 – październik 2024 | Dawid Linek | +| Parking API | [backend-parking-api-wrapper](https://github.com/Solvro/backend-parking-api-wrapper) | wrzesień 2024 – styczeń 2025 | Ignacy Smoliński | +| Cocktails API | [backend-cocktail-api](https://github.com/Solvro/backend-cocktail-api) | sierpień 2024 – wrzesień 2024 | Dawid Linek | + +### Technologia + +Przez lata działalności koła przeczołgaliśmy się przez wiele różych technologii. + +### Java + +Java była popularną technologią głównie ze względu na swoją powszechność na studiach i wysoką komercyjność. Ostatecznie zdecydowaliśmy się zrezygnować z Javy na rzecz standaryzacji stosowanych technologii — wybraliśmy rozwiązania oparte na TypeScripcie, który był już używany na froncie. + +Kolejnym czynnikiem był wpływ sposobu nauczania Javy na studiach. Choć pozornie mogła być to zaleta, w praktyce okazała się wadą. Do zespołów dołączały często osoby mające jedynie podstawową, akademicką znajomość Javy, a nie pasję i umiejętność samodzielnej nauki nowej technologii. + +Historycznie również projekty oparte na Javie rzadko doczekiwały się zakończenia i wdrożenia. Pod koniec 2024 roku zdecydowaliśmy się całkowicie wycofać Javę z koła, a w lutym 2025 roku zamknęliśmy ostatni aktywny projekt w Javie (Parking API). + +### DIY w Node.js + +Przez pewien okres w działalności koła powtstawały projekty oparte na Node.js np. expressie czy fastify, gdzie w ramach potrzeby były doklejane kolejne biblioteki. Początkowo wydawało się to dobrym rozwiązaniem. Jednak praktyka boleśnie pokazała, że brak standaryzacji i jasno określonej struktury znacząco utrudnial wdrożenie nowych osób. Po odejściu techleada pojawiały się problemy z maintenance projektu oraz przekazaniem go kolejnym ekipom. Z tych powodów w wakacje 2024 projekty DIY zostały wygaszone oraz wprowadzona technologia w postaci ustrukturyzowanego frameworku adonis js. + +### Adonis js + +Decyzją przewodniczącego sekcji w wakacje 2024 wybrano framework AdonisJS — nowoczesne narzędzie w ekosystemie Node.js, w pełni wspierające TypeScript i inspirowane rozwiązaniami znanymi z Laravel. + +O wyborze zdecydowała prostota, implementacja uniwersalnych konceptów backendowych, silne standaryzowanie oraz bogate, komercyjne doświadczenie przewodniczącego sekcji w korzystaniu z tego narzędzia. + +Latem 2024 roku zorganizowano wakacyjne wyzwanie, które pozwoliło członkom sekcji zapoznać się z technologią i wdrożyć ją w praktyce. Następnie AdonisJS został zastosowany w zadaniu rekrutacyjnym, a także w projektach ToPWR, Eventownik, Translator, SolvroBOT i Planner. Przeprowadzono dwie rekrutacje i dwa wdrożenia członków w tę technologię. + +## 2025 + +### Przewodniczący + + + + Przewodniczący sekcji backend do 1 lipca 2025. + + ![Uśmiechnięty Dawid Linek patrzący wprost w + obiektyw](../../../../assets/people/dawid_linek.jpg) + + + + Przewodniczący sekcji backend od 1 lipca 2025. + + +### Projekty + +| Nazwa | Github | Daty | Techlead | +| -------------- | -------------------------------------------------------------------------------------- | ----------------------- | ----------------- | +| ToPWr Parking | [backend-topwr-parking-adonis](https://github.com/Solvro/backend-topwr-parking-adonis) | luty 2025 – marzec 2025 | Jakub Czajkowski | +| Eventownik 3.0 | [backend-eventownik](https://github.com/Solvro/backend-eventownik) | od lipca 2025 | Szymon Stępień | +| Translator | [backend-translator](https://github.com/Solvro/backend-translator) | luty 2025 – maj 2025 | Jakub Czajkowski | +| Testownik | [backend-testownik](https://github.com/Solvro/backend-testownik) | od stycznia 2025 | Antoni Czaplicki | +| Formularz Snu | [backend-formularz-snu](https://github.com/Solvro/backend-formularz-snu) | luty 2025 – marzec 2025 | Szymon Kowaliński | + +### Technologia + +### NestJS + +Podczas prawie roku działania na frameworku adonis js pojawiło się kilka głównych zastrzeżeń: + +- framework jest utrzymywany przez 4 osoby, co ograniczło rozwój i nie świadczyło dobrze o stabilności +- pojawiły się problemy z integracją z admin js, który miał być używany w ToPWR +- adonis nie był bardzo popularnie komercyjny i brakowało mu opcji enterprise +- NestJS był 100x bardziej popularny pod względem pobrań niż adonis +- brakowało ugruntowanych materiałów i kursów w adonisie np. testy + +Ze względu na te czynniki w czerwcu 2025 roku odbyły się spotkania dotyczące zmiany technologii. Kończąc na debacie 22 czerwca 2025 po 2 godzinach pasjonujących rozmów oraz 2 turach głosowania większością głosów została wybrana technologia **NESTJS**. + +Z założeń chcieliśmy, aby technologia: + +- opierała się na TS z uwagi na współpracę z sekcją frontend oraz bezpieczeństwo dawane przez typowanie +- była ujednolicona w kole z uwagi na łatwiejszy rozwój, onboarding oraz utrzymanie projektów. Dopuszczamy jednak w uzasadnionych sytuacjach użycie innych technologii. +- posiadała dobrą dokumentacją oraz materiały szkoleniowe +- miała narzuconą strukturę z uwagi na łatwiejsze wdrożenie nowych członków + +Kontrkandydatami był framework DIY, przy którym pojawiły się zastrzeżenia co do jego utrzymania i rozwoju. Drugim kontrkandydatem było Django, które nie zostało wybrane większością głosów. Pojawiły się zastrzeżenia co do braku TS. diff --git a/src/content/docs/sections/Backend/LimeSurvey.md b/src/content/docs/sections/Backend/LimeSurvey.md index 5443a7eb..016ca175 100644 --- a/src/content/docs/sections/Backend/LimeSurvey.md +++ b/src/content/docs/sections/Backend/LimeSurvey.md @@ -1,6 +1,8 @@ --- title: LimeSurvey description: Zarządzanie kontami badawczymi studentów i uprawnieniami na naszej platformie LimeSurvey +sidebar: + hidden: true --- ## Instrukcja zarządzania LimeSurvey diff --git a/src/content/docs/sections/Backend/API.md b/src/content/docs/sections/Backend/Poradniki/API.md similarity index 100% rename from src/content/docs/sections/Backend/API.md rename to src/content/docs/sections/Backend/Poradniki/API.md diff --git a/src/content/docs/sections/Backend/Adonis.md b/src/content/docs/sections/Backend/Poradniki/Adonis.md similarity index 100% rename from src/content/docs/sections/Backend/Adonis.md rename to src/content/docs/sections/Backend/Poradniki/Adonis.md diff --git a/src/content/docs/sections/Management/Role/index.mdx b/src/content/docs/sections/Management/Role/index.mdx index 8e7e9cf4..0360031b 100644 --- a/src/content/docs/sections/Management/Role/index.mdx +++ b/src/content/docs/sections/Management/Role/index.mdx @@ -103,7 +103,7 @@ Poniższa matryca definiuje, kto jest odpowiedzialny za poszczególne aktywnośc | Przygotować backlog | RA | C | C | I | | Build deliverables | I | C | A | R | | Przeprowadzanie code review | I | C | RA | I | -| Deployment na produkcję | I | A | R | C | +| Deployment na produkcję | I | A | R | C | | Organizacja weekly projektu | I | RA | C | I | | Marketing i Promocja | C | A | I | R | | Prezentacja postępów na Weekly | C | RA | C | I | diff --git a/src/content/docs/sections/Management/Tools/raci.mdx b/src/content/docs/sections/Management/Tools/raci.mdx index d279db80..e9cb3c92 100644 --- a/src/content/docs/sections/Management/Tools/raci.mdx +++ b/src/content/docs/sections/Management/Tools/raci.mdx @@ -30,7 +30,7 @@ Stosowanie macierzy RACI przynosi wiele korzyści: | Przygotować backlog | RA | C | C | I | | Build deliverables | | C | A | R | | Przeprowadzanie code review | I | C | RA | I | -| Deployment na produkcję | I | A | R | C | +| Deployment na produkcję | I | A | R | C | | Organizacja weekly | I | RA | C | I | | Marketing i Promocja | C | RA | | | diff --git a/src/content/docs/solvro/VIII_Board.mdx b/src/content/docs/solvro/VIII_Board.mdx index c4208358..14ffa52c 100644 --- a/src/content/docs/solvro/VIII_Board.mdx +++ b/src/content/docs/solvro/VIII_Board.mdx @@ -37,6 +37,7 @@ import olaImg from "../../../assets/people/aleksandra_dominiak.jpg"; /> {" "} +