Repository navigation
👥 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ą parametruser_idfetch_data.py- funkcjaget_lessons()przekazujestudent_idsensor.py- coordinator przekazujestudent_idprzy pobieraniu lekcjimanifest.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
- Zaktualizuj PrivPortal API - upewnij się że obsługuje parametr
userId - Zaktualizuj HALibrus do v4.2.4
- Zrestartuj Home Assistant
- 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