Skip to content

v4.2.4 - Wsparcie dla wielu uczniów

Latest

Choose a tag to compare

@piterkos piterkos released this 30 Oct 15:31

👥 Wsparcie dla wielu uczniów - Filtrowanie po userId

Ta wersja naprawia krytyczny problem z mieszaniem danych gdy do Home Assistant dodanych jest wielu uczniów.

✨ Co zostało dodane

Filtrowanie danych po userId:

  • ✅ Wszystkie endpointy API otrzymują teraz parametr userId
  • ✅ Dane są prawidłowo filtrowane dla każdego ucznia osobno
  • ✅ Możesz bezpiecznie dodać wielu uczniów do Home Assistant
  • ✅ Każdy uczeń widzi tylko swoje dane (lekcje, oceny, frekwencję, etc.)

🔧 Zmiany techniczne

Zaktualizowane pliki:

  • librus_client.py - wszystkie metody API otrzymują parametr user_id
  • fetch_data.py - funkcja get_lessons() przekazuje student_id
  • sensor.py - coordinator przekazuje student_id przy pobieraniu lekcji
  • manifest.json - wersja zaktualizowana do 4.2.4

Zmienione metody API:

  • get_lessons(user_id=...)
  • get_changed_lessons(user_id=...)
  • get_attendance(user_id=...)
  • get_grades(user_id=...)
  • get_homework(user_id=...)
  • get_exams(user_id=...)

🛡️ Wymagania

WAŻNE: Ta wersja wymaga zaktualizowanego PrivPortal API, które obsługuje parametr userId we wszystkich endpointach:

  • /api/mobile/lessons?userId=XXX
  • /api/mobile/lessons/changes?userId=XXX
  • /api/mobile/attendance?userId=XXX
  • /api/mobile/grades?userId=XXX
  • /api/mobile/homework?userId=XXX
  • /api/mobile/exams?userId=XXX

Jeśli Twoje API nie obsługuje jeszcze parametru userId, sensory będą działać (parametr jest opcjonalny), ale dane mogą być mieszane przy wielu uczniach.

📋 Instrukcja aktualizacji

  1. Zaktualizuj PrivPortal API - upewnij się że obsługuje parametr userId
  2. Zaktualizuj HALibrus do v4.2.4
  3. Zrestartuj Home Assistant
  4. Sprawdź czy każdy uczeń widzi tylko swoje dane

🐛 Naprawiony problem

Przed:

Użytkownik dodaje ucznia #1 → działa ✅
Użytkownik dodaje ucznia #2 → dane mieszają się ❌
Lekcje ucznia #1 pokazują dane ucznia #2 ❌

Po (v4.2.4):

Użytkownik dodaje ucznia #1 → działa ✅
Użytkownik dodaje ucznia #2 → działa ✅
Każdy uczeń widzi tylko swoje dane ✅

📝 Historia zmian

v4.2.4 (2025-10-30):

  • ✅ Dodano filtrowanie po userId
  • 👥 Wsparcie dla wielu uczniów
  • 🔧 Zaktualizowano całą ścieżkę wywołań API

v4.2.3 (2025-10-30):

  • 🐛 Naprawiono wyświetlanie lekcji z przyszłych dat

v4.2.2 (2025-10-29):

  • 🔍 Dodano debug logging

v4.2.1 (2025-10-29):

  • 🐛 Naprawiono porównywanie dat

v4.2.0 (2025-10-29):

  • 🇵🇱 Pełna polonizacja

Pełna dokumentacja: https://github.com/piterkos/HALibrus
Zgłaszanie problemów: https://github.com/piterkos/HALibrus/issues

🤖 Generated with Claude Code