1 - Dokumentacja

Wstęp do dokumentacji zespołu PRz-Racing Team

Ta strona dotyczy konkretnie dokumentacji! Warto to przeczytać!

Dokumentacja jest projektem mającym na celu stworzenie jednego portalu, który będzie skarbnicą wiedzy zespołu PRz-Racing Team.

W tym miejscu, znajdziecie zasady, regulaminy, instrukcje użycia, a także dokumenty odnośnie designów i projektów prowadzonych pod skrzydłem naszego zespołu.

Jeżeli masz jakiekolwiek pytania odnośnie systemu dokumentacji, lub chciałby/aś coś dodać od siebie, skontaktuj się z liderem Sekcji Informatyki.

2 - Kanały Komunikacyjne

What does your user need to know to try your project?

Twitter

Instagram

Tiktok

Linked.in

3 - Praca w zespole

What does your user need to know to try your project?

This is a placeholder page that shows you how to use this template site.

Information in this section helps your user try your project themselves.

  • What do your users need to do to start using your project? This could include downloading/installation instructions, including any prerequisites or system requirements.

  • Introductory “Hello World” example, if appropriate. More complex tutorials should live in the Tutorials section.

Consider using the headings below for your getting started page. You can delete any that are not applicable to your project.

Prerequisites

Are there any system requirements for using your project? What languages are supported (if any)? Do users need to already have any software or tools installed?

Installation

Where can your user find your project code? How can they install it (binaries, installable package, build from source)? Are there multiple options/versions they can install and how should they choose the right one for them?

Setup

Is there any initial setup users need to do after installation to try your project?

Try it out!

Can your users test their installation, for example by running a command or deploying a Hello World example?

3.1 - Cele tygodniowe

Czym są cele tygodniowe?

Cele tygodniowe - jest to zbiór zadań, nad którymi będziemy pracowac w określonym tygodniu.

Są one publikowane na zespołowym kanale “Announcements” dostępnym na platformie Telegram.

3.2 - Sprzątanie

Sprzatąnie warsztatu!

Wstęp

Jak wszystko na tym świecie, rzeczy się brudzą, a tym bardziej na naszym warsztacie ;)

W związku z tym, wymagane jest jego regularne sprzątanie - co u nas przypada na raz w każdym tygodniu, przed konkretną sekcje której w tym tygodniu wypada tura.

Tury sprzątań

Co tydzień przypada rotacja zgodnie z niżej podaną kolejnością:

  • Sekcja…
  • Sekcja …

Lista czynności

Niżej zostały podane podstawowe rzeczy które wymagają poświęcania uwagi w trakcie sprzątania warsztatu przez zespół:

1. Podłogi

Zamiecenie

Zaczniemy od zamiecienia podłóg za pomocą zmiotek znajdujących się zazwyczaj w toalecie, ale mogą być też porozrzucone po części warsztatowej.

Należy zamieć:

  • w części czystej
  • w części warsztatowej

Umycie podłóg

  • w części czystej
  • w części warsztatowej

3. Posprzatanie ze stołów w strefie czystej

4. Naczynia

Należy umyć różnego rodzaju naczynia, m.in:

  • kubki
  • sztućce
  • itp. A następnie poukładać je w części czystej na suszarce.

5. Przetarcie kurzów w strefie czystej

  • stoły i biurka (te dostepne)
  • półki ( te dostępne

6. Toaleta

Należy też wysprzątać toalete, m.in:

  • prysznic
  • umywalkę
  • kompakt WC
  • zamieść WC
  • zamieć podłogę
  • wymyc podłogę
  • uzupełnić papiery w pojemnikach (jak są to nie)

7. Narzędzia

Jeżeli nikt nie używa narzędzi, należy odłożyć je na swoje odpowiednie miejsce w warsztacie.

8. Wyrzucenie śmieci

Po zakończeniu całego sprzątania, należy wynieść śmieci do śmietników, a następnie wymienić worki w koszach. Worki możemy znaleźć na półce w toalecie.

TODO:

Dodać zdjęcia zmiotek, myjki itp

4 - Sekcje

What does your user need to know to try your project?

This is a placeholder page that shows you how to use this template site.

4.1 - Sekcja Elektroniki

What does your user need to know to try your project?

This is a placeholder page that shows you how to use this template site.

Information in this section helps your user try your project themselves.

  • What do your users need to do to start using your project? This could include downloading/installation instructions, including any prerequisites or system requirements.

  • Introductory “Hello World” example, if appropriate. More complex tutorials should live in the Tutorials section.

Consider using the headings below for your getting started page. You can delete any that are not applicable to your project.

Prerequisites

Are there any system requirements for using your project? What languages are supported (if any)? Do users need to already have any software or tools installed?

Installation

Where can your user find your project code? How can they install it (binaries, installable package, build from source)? Are there multiple options/versions they can install and how should they choose the right one for them?

Setup

Is there any initial setup users need to do after installation to try your project?

Try it out!

Can your users test their installation, for example by running a command or deploying a Hello World example?

4.2 - Sekcja Informatyki

What does your user need to know to try your project?

This is a placeholder page that shows you how to use this template site.

Information in this section helps your user try your project themselves.

  • What do your users need to do to start using your project? This could include downloading/installation instructions, including any prerequisites or system requirements.

  • Introductory “Hello World” example, if appropriate. More complex tutorials should live in the Tutorials section.

Consider using the headings below for your getting started page. You can delete any that are not applicable to your project.

Prerequisites

Are there any system requirements for using your project? What languages are supported (if any)? Do users need to already have any software or tools installed?

Installation

Where can your user find your project code? How can they install it (binaries, installable package, build from source)? Are there multiple options/versions they can install and how should they choose the right one for them?

Setup

Is there any initial setup users need to do after installation to try your project?

Try it out!

Can your users test their installation, for example by running a command or deploying a Hello World example?

4.2.1 - Spotkania Sekcji IT

Skróty cotygodniowych spotkań Sekcji Informatyki

Spotkanie 22.02.2023

  • Typ spotkania: zdalne
  • Ilość osób obecnych: X

Tematy do poruszenia odnośnie Sekcji

  • Wprowadzenie do nowego systemu dokumentacji:

    • https://www.docs.przracing.pl
    • Cotygodniowy skrót spotkań
    • Przykładowa dokumentacja projektowa
    • Pokazanie jak edytować stronę dokumentacji w plikach markdown
  • Ustalenie potencjalnego nowego terminu spotkań sekcji

    https://www.when2meet.com/?18913916-jYZdR

  • Przejrzenie produktów potencjalnego partnera CSI)

    • https://csi.pl/
    • Rzeczy z kategorii:
      • Routery
      • UPS
      • Części do serwera (Dyski, RAM, etc.)
      • Mini-komputery (np. z terminale z ekranem dotykowym do telemetrii)
  • Bitrix:

    • PRT-Tools
    • Magazyn
  • Rzeczy na ASAP

    • Serwer:
      • Aktualizacja do najnowszej wersji Nextclouda (i sprawdzenie czy błędy z wrzucaniem plików przestaną występować)
  • Możliwość wzięcia udział w wydarzeniu Nvidii

  • Możliwość wzięcia udziału w spotkania programistów:

Tematy ogólne


Spotkanie XX.XX.20XX

  • Typ spotkania: zdalne/stacjonarne
  • Ilość osób obecnych: X

Tematy do poruszenia

  • A
  • B
  • C
  • D

4.2.2 - Projekty

Informacje odnosnie projektów realizowanych pod szyldem Sekcji Informatyki

Wstęp

Sekcja Informatyki jest sekcją techniczną zespołu PRz-Racing Team, mająca na celu rozwijanie możliwosci drużyny o różnego rodzaju rozwiązania informatyczne.

Nasza historia zaczęła się jako odłam Sekcji Elektroniki, gdzie spośród osób mających doświadczenie z szeroko pojętą informatyką, realizowaliśmy oprogramowanie dla naszej drużyny.

Obecnie zajmuejmy się tworzeniem oprogramowania oraz rozwiązań informatycznych, mającego wspomóc działanie drużyny, są to m.in:

  • System zbierania danych z bolidu wyścigowego
  • Obsługa danych i wyświetlanie zbieranych danych telemetrycznych
  • Budowa i utrzymanie serwera głównego zespołu
  • Wewnętrzny system wspomagania drużyny (IMS) - PRT-Hub

Będąc członkiem naszej sekcji, będziesz miał omżliwość pracy z naszymi obecnymi rozwiązaniami, korzystać z nich, utrzymywać i rozwijać je o kompletnie nowe możliwości.

Od naszych członków oczekujemy pisania czystego, funkcjonalnego kodu, który spełnia wszystkie standardy obowiązujące projekty wykorzystywanych w produkcji, nie odbiegając od projektów tworzonych pod skrzydłami dużych firm programistycznych.

Korzyści z pracy w sekcji

Organizacja pracy

Kod

Zarządzanie zadniami

Spotkania

4.2.2.1 - Przykładowy projekt

Przykładowa dokumentacja projektu Sekcji ITs

Nazwa projektu

Opis w bardzo prostych słowach, na temat tego do czego służy ten projekt i co on robi.

Max. 5 zdań.

Osoby odpowiedzialne:

  • Jan Kowalski
  • etc

Gdzie można znaleźć ten projekt? Opisać gdzie ten projekt się znaduje, czy np. jest to na jakiejś stronie internetowej, czy w miejscu na formule bądź bolidzie.

Jak z niego korzystac?

Jeżeli twój projekt został zrealizowany dla wszystkich w formule, w tym miejscu powinna znaleźć się dokładna instrukcja jak korzystać z danego rozwiązania. Np. dla kreatora dokumentów ofertowych, powinien być opis jak to wyklikać, co się kiedy dzieje, itp.

Część techniczna

Część przeznaczona dla osób z Sekcji Informatyki bądź elektroniki, bądź zainteresowanych szczegółami projektu.

Linki do repozytorium

Cele

Opis tego jakie cele chcielibyśmy uzyskać i jakie projekt powinien spełniać cechy Przykładowo, jeżeli mielibysmy projekt internetowego włącznika do światła, to byłoby to:

  • Dostępność (Łatwo wejść na strone i przełączyć światło)
  • Skalowalność ( proste dodawanie kolejnych guzików żeby móc pstrykać więcej lampek)
  • Wydajność (mając podłączonych 1000 lampek do systemu, po kliknięciu przełączą sie one i tak w 1 sekundę )

Założenia projektowe

Przykładowo, założeniem projektowym są odgórne limity i wymagania które projekt musi spełnić, np. ograniczeniem telemetrii jest układ STM32, albo to że projekt strony internetowej będzie postawiony na AWS i musi być możliwość szybkiego deploy’a na tą platformę.

Użyte technologie

  • Języki programowania
  • Biblioteki
  • Usługi np. AWS, Retool

W jaki sposób działa ten projekt?

Bardziej szczegółowy opis, na ten moment zostawiam stosunkową dowolność.

Napotkane problemy

W tym miejscu, powinny znajdować się duże problemy, które sprawiły nam problem przez dłuższy okres czasu i warto wrzucić tutaj informacje na jego temat, w celu protego znalezienia rozwiązania, bądź ogólnej przestrogi, na przyszłość, jak dla siebie jak i dla innych osób które mogą rozwinać ten dany projekt.

Jeżeli jakiś problem pojawił się z powodu źle popełnionej decyzji, taka informacja też jest bardzo wartościowa - zwłaszcza na designach!

Problem XYZ

Napotkałe/am problem […] w czasie […], naprawiony został poprzez […]

4.2.2.2 - Projekt serwera

Informacje odnośnie zespołowego serwera.

Wstęp

Projekt majacy na celu stworzenie drużynowego serwera w celu hostowania własnego oprogramowania oraz przetrzymywania danych długoterminowo.

Hardware serwera

Komputer służacy jako serwer został złożony z następujących części:

  • Płyta główna - ASRock B460M Steel Legend
  • Procesor - Intel Core i5-10400
  • Pamieć RAM - GOODRAM 16GB (2x8GB) 3200MHz CL16 IRDM X Black
  • Zasilacz - be quiet! Pure Power 11 400W 80 Plus Gold
  • Dysk systemowy - ADATA 256GB M.2 PCIe NVMe XPG SX6000 Pro
  • Dyski - Seagate IRONWOLF CMR 4TB 5900obr. 64MB - 3 sztuki

Osoby odpowiedzialne za serwer

  • Wiktor Jezioro
  • Patryk Kępa

4.2.2.3 -

4.2.3 - Przydatne narzędzia

W tym miejscu, znajdziesz katalog przydatnych stron oraz narzędzia podczas działania w Sekcji Informatyki!

Tworzenie Favicon

Edytowanie strony dokumentacji

Jeżeli pragniesz modyfikować szablon tej strony, bądź dodać nowy content - polecam skorzystać z dokumentacji tego szablonu pod linkiem:

5 - Oprogramowanie i narzędzia

5.1 - Kreator Ofert

Opis korzystania z kreatora ofert

Opis

5.2 - Logowanie się do platformy Nextcloud

Opis logowania się do platformy Nextcloud

Czym jest Nextcloud?

Nextcloud - jest to platforma służąca do hostowania plików, coś w stylu Google Drive’a - w naszym przypadku, służy ona do trzymania plików związanych z pracą w zespole, a więc różnego rodzaju dokumenty, zdjęcia, video, szablony, itp.

Jak się na nią dostać?

Aby wejść na naszą stronę Nextcloud’a, należy się udać pod adres:

Gdzie nastepnie, jeżeli nie logowaliśmy się wcześniej, zostaniemy poproszeni o dane dostępowe do platformy. Nasze dane dostępowe, podane są w formie:

  • Nazwa użytkownika: 1 litera imienia, a potem nazwisko bez polskich znaków (np. Jan Kowalski -> jkowalski)
  • Hasło: losowo wygenerowane bezpieczne hasło podane przez administratora platformy, bądź hasło które zmieniłeś po otrzymaniu konta.

Organizacja plików

Pliki na platformie Nextcloud są grupowane według bolidów przy których dane pliki zostały wykorzystane. Przykładowo, jeżeli chcielibyśmy znaleźć pliki designów Sekcji Aerodynamiki bolidu PMT-03, będziemy się kierować folderami:

  • PMT-03 Sekcja Aerodynamika

5.3 - Szlaban Bot

Opis korzystania z szlaban bota

Opis

“Szlaban Bot” to bot na platformie Telegram pozwalający cżłonkom zespołu otwierać szlaban przy wjeździe do parkingu przy warsztacie PRz-Racing Team.

Jak korzystać?

Aby korzystac z bota, należy spełniać dwa warunki:

Kontakt

W celu jakichkolwiek informacji odnośnie działania i problemów w związku z Szlaban Botem, proszę kontaktować się z:

  • Gabriel Olszewski

6 - Liderzy Sekcji

Poniżej znajduje się aktualna lista osób reprezentujących oraz zarządzających sekcjami w zespole PRz-Racing Team:

  • Lider zespołu - Konrad Ner

  • Sekcja Aerodynamiki- Daniel Wilusz

  • Sekcja Elektroniki - Szymon Wasąg, Sebastian Niemiec

  • Sekcja Informatyki - Patryk Kępa

  • Sekcja Konstrukcji Nośnej - Dariusz Wacek

  • Sekcja Marketingu - Kamil Kołeczek, Filip Kaniewski, Katarzyna Panek

  • Sekcja Silnika i Napędu - Sebastian Rosół

  • Sekcja Zawieszenia - Kacper Więcek

W razie wątpliwości, zawsze aktualne informacji odnośnie członków i liderów sekcji możesz znaleźć na stronie Organizacja PRz-Racing Team.