pzarnecki/planer_klient_zewnetrzny
Watch
1
0
Fork
You've already forked planer_klient_zewnetrzny
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Planowanie semestru i zarządzanie czasem. Klient zewnętrzny do sprawdzania kalendarza.
15 commits 1 branch 0 tags 786 KiB
  • TypeScript 93.1%
  • CSS 2.8%
  • Dockerfile 2.7%
  • JavaScript 1.4%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
PrzemekZ d1581a1658 zmiany
2026-07-13 21:49:09 +02:00
dokumentacja docs: dokumentacja wdrozeniowa i wykadrowane zrzuty ekranu 2026-07-13 21:30:14 +02:00
public Initial commit from Create Next App 2026-07-12 13:29:20 +02:00
src security: uzycie zmiennej srodowiskowej SYNC_API_TOKEN do zabezpieczenia endpointu api 2026-07-13 10:13:23 +02:00
.env.example Dockerize Next.js app and add login logic 2026-07-12 18:11:38 +02:00
.gitignore zmiany 2026-07-13 21:49:09 +02:00
DEPLOYMENT.md docs: dokumentacja wdrozeniowa i wykadrowane zrzuty ekranu 2026-07-13 21:30:14 +02:00
docker-compose.yml fix: przywrocenie oryginalnego portu 3000 w docker-compose.yml 2026-07-13 20:34:06 +02:00
Dockerfile fix: docker permissions for data directory 2026-07-13 09:13:48 +02:00
eslint.config.mjs Initial commit from Create Next App 2026-07-12 13:29:20 +02:00
next.config.ts Dockerize Next.js app and add login logic 2026-07-12 18:11:38 +02:00
package-lock.json Dockerize Next.js app and add login logic 2026-07-12 18:11:38 +02:00
package.json Dockerize Next.js app and add login logic 2026-07-12 18:11:38 +02:00
postcss.config.mjs Initial commit from Create Next App 2026-07-12 13:29:20 +02:00
README.md docs: dokumentacja wdrozeniowa i wykadrowane zrzuty ekranu 2026-07-13 21:30:14 +02:00
tsconfig.json Initial commit from Create Next App 2026-07-12 13:29:20 +02:00

README.md

System Zarządzania Harmonogramem Akademickim (Moduł Prezentacyjny - Kalendarz)

Wprowadzenie

Moduł Prezentacyjny (Kalendarz) jest finalnym punktem interakcji dla użytkowników końcowych w architekturze systemu zarządzania harmonogramami akademickimi. Odpowiada za agregację znormalizowanych struktur zajęć otrzymywanych z Modułu Organizera oraz ich wizualizację za pomocą zaawansowanego interfejsu użytkownika, zbudowanego zgodnie z koncepcją projektową (Glassmorphism, Sci-Fi Design).

Architektura Systemu

Moduł ten funkcjonuje w oparciu o architekturę Single Page Application wspieraną przez Server-Side Rendering:

  • Framework Główny: Next.js (App Router), React, TypeScript.
  • Stylizacja i UI: Tailwind CSS, niestandardowe systemy siatek kalendarzowych (CSS Grid/Flexbox).
  • Baza Danych: System oparty na strukturach JSON (lokalny zasób dyskowy z pełnym mapowaniem wolumenów).
  • Środowisko Uruchomieniowe: Docker, Node.js (konteneryzacja alpejska).

Kluczowe Funkcjonalności

  1. Autoryzowany Kanał Synchronizacji (API): Punkt końcowy (Endpoint) zabezpieczony kryptograficznie poprzez Bearer Token, obsługujący obustronną komunikację i autoryzację zapytań wejściowych od Modułu Organizera.
  2. Siatka Kalendarza (Month Grid): Zaawansowany widok macierzowy pozwalający na przeglądanie zdarzeń akademickich w perspektywie miesięcznej z zaimplementowanym systemem filtrowania po nazwach instytucji macierzystych.
  3. Perspektywa Agendy (Agenda View): Syntetyczny, sekwencyjny układ dnia dla środowisk responsywnych, ułatwiający precyzyjne odczytanie planu.
  4. Zarządzanie Stanem Sesji: Bezstanowe logowanie z wbudowaną persystencją autoryzacji w interfejsie użytkownika z wykorzystaniem pamięci lokalnej (Local Storage).

Przykłady Interfejsu

Poniżej zaprezentowano wybrane zrzuty ekranu ilustrujące interfejs użytkownika Modułu Prezentacyjnego:

Autoryzacja Widok Siatki Kalendarza Widok Agendy

Dokumentacja Wdrożeniowa

Szczegółowe instrukcje dotyczące środowiska Nginx, portów, ustawień Dockera oraz zmiennych środowiskowych znajdują się w dokumencie DEPLOYMENT.md.