PuzzleRoster
1. O systemie PuzzleRoster
System PuzzleRoster został zbudowany dla centrów edukacyjnych STEM, które oferują pogłębioną naukę określonych przedmiotów (fizyki i/lub chemii) uczniom z wielu szkół. Centra takie jak ten stoją przed specyficznym wyzwaniem harmonogramowania — dni i godziny zajęć muszą być skoordynowane ze wszystkimi szkołami partnerskimi, których uczniowie tworzą daną grupę. Aplikacja ułatwia różnym rolom personelu — administratorom, nauczycielom, asystentom laboratoryjnym — zarządzanie dziesiątkami procesów operacyjnych: od koordynacji ze szkołami partnerskimi po przydzielanie laboratoriów i sal na podstawie sprzętu zamówionego przez nauczycieli. Daje kierownictwu centrum możliwość zarządzania obciążeniem nauczycieli (łączny czas pracy, godziny nauczania, liczebność grup) i podejmowania różnych decyzji operacyjnych. System zbiera również, przetwarza i analizuje wszystkie dane statystyczne dotyczące działalności centrum.
- Bez limituliczby szkół partnerskich
- Elastyczne grupyuczniowie z różnych szkół
- Inteligentny przydziałlaboratoriów według zadanych parametrów
- Wbudowane wyszukiwaniezastępstw nauczycieli
- Osobisty paneldla każdego nauczyciela
- Ekrany na korytarzachdla nauczycieli i uczniów
2. Kto korzysta z systemu
System ma osiem ról. Jednemu pracownikowi można przypisać więcej niż jedną rolę jednocześnie.
| Rola | Kim jest | Co robi |
|---|---|---|
| Super Admin | Lider techniczny | Pełny dostęp. Zarządza danymi referencyjnymi, personelem i ustawieniami globalnymi. |
| Admin | Dowolny pracownik z uprawnieniami administratora — także jako rola dodatkowa | Przegląda przychodzące wnioski o zmianę harmonogramu, wyjaśnia szczegóły i je zatwierdza. Jedyna rola, która faktycznie wprowadza zmiany w danych — zatwierdza lub odrzuca. |
| Nauczyciel | Prowadzący zajęcia | Inicjuje zmiany w harmonogramie: przełożenia, odwołania, zastępstwa, zamówienia sprzętu. Wszystko odbywa się przez wniosek do administratora — nauczyciele nigdy nie edytują danych bezpośrednio. |
| Asystent laboratoryjny | Pracownik laboratorium | Widzi listę nadchodzących lekcji z zamówionym sprzętem. Przygotowuje i dostarcza zestawy. Nigdy nie tworzy ani nie edytuje zamówień — tylko je realizuje. |
| Dyrektor | Dyrektor centrum | Pełny dostęp do odczytu harmonogramu i raportów za dowolny okres. Zarządza obciążeniem nauczycieli i przydziela zastępstwa. Może też prowadzić lekcje (jeśli przypisany także jako nauczyciel). |
| Wicedyrektor | Zastępca dyrektora ds. dydaktycznych | Dostęp do odczytu harmonogramu i raportów nauczycieli swojego przedmiotu. Zarządza obciążeniem nauczycieli i przydziela zastępstwa. Może też prowadzić lekcje (jeśli przypisany także jako nauczyciel). |
| Sekretarz | Sekretarz / administrator biura | Tylko odczyt: pełny harmonogram, wszystkie raporty, dowolny okres. Nie może wprowadzać zmian. |
| Koordynator centrum | Pracownik centrum | Obsługuje komunikację ze szkołami w imieniu centrum. Wspiera szkoły partnerskie, koordynuje logistykę. |
3. Główne procesy
3.1 Szablon roczny i propagacja
Harmonogram ma dwa poziomy. Poziom górny to roczny szablon tygodniowy: standardowe obciążenie każdego nauczyciela i grupy. Poziom dolny to rzeczywisty harmonogram tydzień po tygodniu na cały rok szkolny, wygenerowany na podstawie tego szablonu.
archived: całkowicie znika ze wszystkich harmonogramów i widoków, więc do końca roku
nie gromadzą się „lekcje-widma", ale fizycznie pozostaje w tabeli — klucze obce z historii
wniosków i audytu nie pozwalają jej usunąć.
3.2 Zmiany w harmonogramie
Harmonogram jest budowany na cały rok szkolny, ale codzienne korekty pojawiają się na bieżąco. System prowadzi je jasną ścieżką:
3.3 Przygotowanie sprzętu
3.4 Zastępstwa nauczycieli
Jeśli nauczyciel nie może poprowadzić lekcji, administrator, dyrektor lub wicedyrektor wybiera zastępstwo z listy nauczycieli dostępnych w danym czasie o odpowiednim profilu przedmiotowym. Lekcja natychmiast pokazuje się jako zastępstwo wszędzie — w harmonogramie i na wyświetlaczach korytarzowych.
3.5 Wypełnianie systemu danymi (przepływ danych)
Dane są wprowadzane w ścisłej kolejności — każdy krok zależy od poprzedniego.
- 11 tabel — pierwotne wypełnienie systemu (bootstrap)
- 2 tabele — katalogi doświadczeń (fizyka i chemia)
- 2 tabele — zgłoszenia i wątki komentarzy
- 4 tabele — blokady i migawki dnia
- 2 tabele — historia i dzienniki
- 1 tabela — uprawnienia dostępu
- 4 tabele — kolejka e-maili, reguły, adresy nadawców, status dostarczenia
- 1 tabela — ustawienia systemu
- 2 tabele — kalendarz roku szkolnego
- 2 tabele — dane kadrowe
4. Z czego zbudowany jest system
System składa się z kilku niezależnych komponentów, z których każdy odpowiada za swoją część:
| Komponent | Co robi |
|---|---|
| Baza danych | Przechowuje wszystkie dane i egzekwuje każdą regułę: walidację, blokady, historię zmian |
| Serwer API | Przyjmuje żądania, sprawdza, kto ma prawo co zrobić, i przekazuje polecenia do bazy danych |
| Interfejs webowy | PuzzleRoster, w całości po hebrajsku (RTL) |
| Wyświetlacze korytarzowe | Dedykowane ekrany na korytarzach centrum — bieżący harmonogram dnia dla nauczycieli i uproszczona wersja dla uczniów, bez osobistego logowania (uwierzytelnianie za pomocą statycznego klucza urządzenia) |
| Powiadomienia | Potok zdarzeniowy: każda akcja (wniosek złożony/zatwierdzony/odrzucony, zamówienie sprzętu, zastępstwo nauczyciela, konserwacja serwera) zapisuje zdarzenie do kolejki w tej samej transakcji — nieudany zapis nigdy nie blokuje samej akcji. Proces w tle wyznacza odbiorców na podstawie roli, przedmiotu i uczestników zdarzenia z tabeli reguł, renderuje wiadomość i wysyła ją przez transakcyjnego dostawcę poczty — z automatycznymi ponowieniami i wyłącznikiem po stronie administratora. Komunikatory (Telegram, WhatsApp) pozostają możliwym kierunkiem rozwoju. |
| Infrastruktura | Wdrożona w kontenerach Docker na serwerze AWS, z automatycznymi codziennymi kopiami zapasowymi bazy danych |
5. Niezawodność i bezpieczeństwo
- Każdy użytkownik otrzymuje token dostępu po zalogowaniu. Token jest ważny 2 godziny (automatyczne wylogowanie po 30 minutach bezczynności) i zawiera jego rolę. Bez ważnego tokenu nie ma dostępu — bez wyjątków.
- Każda reguła jest egzekwowana na poziomie bazy danych — nie da się ich obejść przez interfejs.
- Backend łączy się z bazą pod osobną, okrojoną rolą: ma fizycznie odebrane prawa do
bezpośredniego
INSERT/DELETEw tabelach lekcji, dzienników i sesji edycji — każda zmiana harmonogramu jest możliwa tylko przez funkcje składowane z jawnie podwyższonymi uprawnieniami (SECURITY DEFINER). - Historii zmian nie można zmienić ani usunąć — przez żadnego użytkownika, w żadnej roli. Gwarantuje to pełną przejrzystość każdego działania w systemie.
- System automatycznie blokuje konflikty w harmonogramie.
- Dostęp do internetu jest zaprojektowany na zasadzie Zero Trust — przez Cloudflare Tunnel.
- 391 automatycznych testów regresyjnych (warstwy API i bazy danych) uruchamianych przed każdym wdrożeniem — obejmujących przepływy zatwierdzania zgłoszeń, zastępstwa nauczycieli, mechanikę zamrażania/wycofywania dnia, zapobieganie konfliktom harmonogramu (EXCLUDE USING GIST), zamówienia sprzętu oraz macierz reguł powiadomień.