Pala

A Pala ingyenes, nyílt forráskódú kliens a Kréta e-naplóhoz. Gyorsan és reklámok nélkül mutatja meg a jegyeidet, az órarendedet, a hiányzásaidat, a házi feladataidat és az üzeneteidet, négy formában:

1. Böngésző-kiterjesztés: Chrome, Brave és Edge
2. Mobilalkalmazás: Android
3. Terminálos alkalmazás (TUI): Windows, Linux, macOS és Android (Termux)
4. Asztali alkalmazás: Windows, Linux és macOS; ugyanaz, mint a mobilalkalmazás, csak asztali felülettel

A fejlesztési prioritás is ez a sorrend: a kiterjesztés kapja a legtöbb figyelmet, az asztali alkalmazás a legkevesebbet.

Weboldal: pala-app.hu

Mit tud?

• Élő dashboard: visszaszámlálás az óra vagy a szünet végéig, mai órarend, helyettesítések és elmaradt órák.
• Jegyek és átlagok: tantárgyi és osztályátlagok, jegy-trendek, Szellem jegy kalkulátor és Bizonyítvány tervező.
• Hiányzások: igazolt, igazolandó és igazolatlan órák, valamint a 250 órás keret figyelése.
• Kereső: ékezet-érzéketlen keresés a jegyek, órák, feladatok, üzenetek és hiányzások között.
• Pala Wrapped: éves statisztika a tanévedről.
• Export: naptár (.ics) és táblázat (CSV).
• Demó mód: kipróbálható bejelentkezés nélkül, fiktív adatokkal.

A böngésző-kiterjesztés ezen felül a háttérben megújítja a Kréta munkamenetet, így 40-60 perc után sem léptet ki. Az összes funkció részletesen: Felhasználói kézikönyv.

Telepítés

Warning

Az első pala kiadás még nem jelent meg, ezért a csomagkezelős és az egysoros telepítők egyelőre nem működnek: sikeres telepítést írnak ki, de a letöltés 404-es hibát ad (#2). Addig csak a forráskódból fordítás használható.

Forráskódból

Szükséges a Dart SDK, az asztali alkalmazáshoz a Flutter SDK is.

git clone https://github.com/CsPS0/pala.git
cd pala
dart pub get
dart compile exe bin/pala.dart -o pala    # terminálos alkalmazás
cd app && flutter build windows           # asztali alkalmazás (vagy: linux, macos)

Android (Termux)

A terminálos alkalmazás APK és root jog nélkül fut a Termux alatt:

pkg update && pkg install dart git -y
git clone https://github.com/CsPS0/pala.git
cd pala
dart pub get
dart run bin/pala.dart

Gyorsabb indításhoz lefordíthatod natívan is: dart compile exe bin/pala.dart -o pala, majd ./pala.

Böngésző-kiterjesztés

1. Töltsd le a kiterjesztést a pala-app.hu oldalról és csomagold ki, vagy használd a repó extension/ mappáját.
2. Nyisd meg a chrome://extensions (Edge alatt edge://extensions) oldalt, és kapcsold be a Fejlesztői módot.
3. Kattints a „Kicsomagolt betöltése” gombra, és válaszd ki a mappát.

Telepítők (az első kiadástól)

Windows, Linux, macOS és csomagkezelők

Windows

• Grafikus telepítő: Pala-Setup.exe (asztali alkalmazás, terminálos alkalmazás és PATH, választhatóan)
• PowerShell:

  irm https://raw.githubusercontent.com/CsPS0/pala/main/install.ps1 | iex

• Scoop:

  scoop bucket add pala https://github.com/CsPS0/pala-bucket
  scoop install pala

Linux és macOS

• Egysoros telepítő:

  curl -fsSL https://raw.githubusercontent.com/CsPS0/pala/main/install.sh | bash

• Debian / Ubuntu / Linux Mint (APT):

  curl -fsSL https://CsPS0.github.io/pala/public.key | sudo gpg --dearmor -o /usr/share/keyrings/pala-archive-keyring.gpg
  echo "deb [signed-by=/usr/share/keyrings/pala-archive-keyring.gpg] https://CsPS0.github.io/pala/repo stable main" | sudo tee /etc/apt/sources.list.d/pala.list > /dev/null
  sudo apt update
  sudo apt install pala

• Arch Linux (AUR):

  yay -S pala-bin

• macOS (Homebrew):

  brew tap CsPS0/pala https://github.com/CsPS0/pala
  brew install pala

Használat

pala              # terminálos felület
pala --desktop    # asztali alkalmazás (röviden: pala -g)
pala dash         # közvetlenül az élő dashboard
pala --demo       # demó profil (Teszt Elek), bejelentkezés nélkül
pala --daemon     # háttérfolyamat az értesítésekhez
pala --help       # az összes kapcsoló

A parancsikonok, a PATH, a gyorsítótár törlése és az eltávolítás a Felhasználói kézikönyvben található.

Adatvédelem

A Pala csak a hivatalos Kréta szerverekkel kommunikál, és frissítések ellenőrzéséhez a GitHubbal. Az adataid a saját gépeden maradnak, a bejelentkezési tokenek titkosítva, telemetria és analitika nélkül.

• Adatkezelés és biztonság: mit, hol és hogyan tárol a Pala, és hogyan törölheted.
• Adatvédelmi szabályzat
• Biztonsági hibát találtál? Lásd: SECURITY.md.

Fejlesztés és hozzájárulás

• Fejlesztői dokumentáció: architektúra, build és a Kréta API sajátosságai.
• Hozzájárulási irányelvek és Magatartási kódex.
• Kiadási napló.

AI használat

A Pala fejlesztése során AI-alapú kódolóasszisztenseket is használok, és ezt nem titkolom. Ez nem megy a minőség rovására: minden változtatást átnézek, és a kiadások előtt ugyanazok az ellenőrzések futnak (elemzés, tesztek, build), mint bármely más kódnál. Az alkalmazás ettől függetlenül ingyenes és szabadon használható marad. A hozzájárulókra vonatkozó elvárások a CONTRIBUTING.md fájlban találhatók.

Elismerések

Köszönet minden felhasznált nyílt forráskódú csomagnak, és a hasonló célú projekteknek, amelyek inspirációt adtak:

• Aktív projektek: Firka, app-legacy (refilc), firka-extension, Folio, folio-extension, RozsdásFilc (rsfilc), Toll
• Archivált projektek: Filc, Szivacs-Naplo

A felsorolt projektek egy része eltérő licenc (pl. GPL) alatt áll. A Pala a nyilvánosan dokumentált e-Kréta API alapján, ezektől függetlenül készült, és egyikükből sem vett át kódot.

Licenc

MIT, lásd: LICENSE.