Basketball Recovery, czyli kto był i kto się zrzucił
Nie każda aplikacja potrzebuje własnego panelu w przeglądarce, kont użytkowników i abonamentu. Czasem potrzebny jest po prostu program, który wykona konkretną robotę, a wynik pokaże tam, gdzie i tak pracujemy. W moim przypadku jest to arkusz Google i rozliczenie wspólnych gier w koszykówkę.
Zaczęło się od skakania
Na koszykówkę zacząłem chodzić w 2017 roku. Trenowałem już szermierkę historyczną i chciałem trochę poprawić skoczność, bieganie i ogólną sprawność.
Szermierkę traktowałem dość poważnie. Mój najlepszy wynik to 300. miejsce w światowym rankingu szablistów historycznych, które osiągnąłem w 2022 roku. Polacy są w tej konkurencji bardzo mocni: w rankingu HEMA Ratings z listopada 2026 roku czterech jest w pierwszej dziesiątce. Ze swojego wyniku i tak jestem dumny. W 2018 roku wystartowałem w mistrzostwach Polski we Wrocławiu, wygrałem kilka walk i dotarłem do drabinki pucharowej. Bardzo dobre doświadczenie.
Pandemia przerwała ten rytm. Przez wiele miesięcy nie dało się normalnie trenować szermierki. To był jeden z powodów, dla których mocniej zaangażowałem się w koszykówkę i naszą grupę, która sama organizowała sobie salę i gry.
Zostałem stałym uczestnikiem. Potem kolega, który prowadził grę, poprosił mnie o pomoc w organizacji. Stopniowo pomagałem coraz więcej, aż w 2022 roku, gdy się wycofał, przejąłem organizację w całości.
Wraz z nią przyszły listy obecności, zrzutki na salę i pytanie: kto był, kto zapłacił, a komu trzeba przypomnieć. Zacząłem prowadzić to w arkuszu. Data gry, uczestnicy, oznaczenia wpłat, podsumowanie. Proste.
Tyle że po każdej grze, kiedy wszyscy wychodzili już z szatni do domu, mnie czekała jeszcze druga część. Po powrocie albo następnego ranka trzeba było usiąść i uzupełnić obecności. Później dopisywać wpłaty, sprawdzać przelewy, pamiętać o gotówce. Samo liczenie nie było trudne. Uciążliwa była konieczność regularnego wracania do tego samego.
Arkusz działał. Regularność już gorzej
W pewnym momencie, przy natłoku innych spraw, przestałem uzupełniać dane. Kilka miesięcy minęło, gry odbywały się dalej, pieniądze wpływały, a ja miałem coraz większą zaległość w notatkach. I coraz mniej jasny obraz tego, co właściwie jest rozliczone.
Pod koniec 2025 roku powstała pierwsza wersja Basketball Recovery. Pomogła mi uporządkować prawie rok zaległości. Dane nadal istniały: listy wydarzeń na Facebooku, komentarze, historia przelewów. Trzeba je było zebrać, zestawić i wyjaśnić wyjątki.
Udało się. Zakładałem więc, że od tej pory będę już tylko na bieżąco dorzucał pliki. Ten plan też nie zadziałał.
Pierwsza wersja dobrze sprawdzała się przy dużym porządkowaniu, raz na pół roku czy rok. Przy cotygodniowej lub comiesięcznej obsłudze część czynności nadal była podobnie upierdliwa jak ręczne wpisywanie do Excela. Program pomagał w dopasowaniu danych, ale końcowe sprawdzanie i przygotowywanie zestawień wymagało za dużo pracy.
Druga wersja wraca do arkusza
Pod koniec 2026 roku projekt doczekał się drugiej wersji. Zamiast dokładać kolejny panel do obsługi, połączyłem lokalny program z arkuszem Google. Mam go pod ręką, znam ten sposób pracy i mogę sprawdzić rozliczenie bez uruchamiania osobnego interfejsu.
Do programu trafiają eksporty list z Facebooka, osobno przygotowane uzupełnienia z komentarzy oraz wyciągi bankowe w CSV. Program porównuje obecności i płatności, korzysta ze słownika nazw i pseudonimów, proponuje dopasowania oraz zbiera sprawy wymagające mojej decyzji. Gotówkę i inne wyjątki mogę dopisać ręcznie.
W arkuszu przeglądam osoby i terminy, sprawdzam rozbieżności, widzę koszty sali i bilans. Dla wybranej osoby mogę przygotować tabelę z obecnościami, przypisanymi wpłatami i pozycjami, które zostały do wyjaśnienia. Takie zestawienie mogę skopiować do osobnego pliku i przekazać tej osobie do sprawdzenia.
Nie chodzi o to, żeby program za wszelką cenę uznał każdą pozycję za rozliczoną. Jeśli nie znalazł wpłaty albo nie wie, jak ją przypisać, ma pokazać pytanie. Brak dopasowania nie oznacza przecież automatycznie, że ktoś nie zapłacił.
Co dzieje się pod spodem
To lokalny program w Pythonie. Wczytuje pliki CSV, porządkuje dane, zestawia je z zapisanymi decyzjami i przez Google Sheets API odczytuje oraz aktualizuje powiązany arkusz. Połączenie z moim kontem Google autoryzuję przez OAuth.
Program nie loguje się do banku ani Facebooka. Pliki dostarczam sam, a uzupełnienia z komentarzy przygotowuję osobno. Nie wysyła też wiadomości i nie wykonuje przelewów. Automatyzuje porównywanie danych; rozstrzygnięcia i kontakt z uczestnikami zostają po mojej stronie.
W JocArd tworzymy też takie aplikacje: pod konkretny proces i sposób pracy, czasem dla jednej osoby. Tutaj nie potrzebowałem publicznego serwisu. Potrzebowałem móc wrócić po kilku miesiącach, zebrać dane i odtworzyć rozliczenie, zamiast nadrabiać każdą grę osobno.
Basketball Recovery jest moją prywatną aplikacją do rozliczania wspólnych gier. Informacje dotyczące połączenia z Google i przetwarzania danych: polityka prywatności oraz zasady korzystania. Kontakt: aleksander.kulesza@jocard.eu.





