
Projekt: Kalendarz Adwentowy 2025 (Excel + VBA)
Narzędzia: Microsoft Excel (UI), VBA (logika), GitHub (repo + dokumentacja)
Opis: Autorski kalendarz adwentowy stworzony jako mini-aplikacja offline w Excelu. Projekt łączy interfejs użytkownika (klikane okienka/pocztówki), logikę opartą o reguły czasowe oraz trwałe zapisywanie stanu aplikacji.
Cel: Zbudowanie spójnej aplikacji w środowisku Excel/VBA: z kontrolą dostępu zależną od daty, trwałym stanem, zasadami gry oraz logiką oddzieloną od warstwy interfejsu.
Dane: Brak klasycznych danych analitycznych – projekt aplikacyjny (event-driven UI, tabela sterująca, trwały stan).
Repozytorium:
Zobacz na GitHub
Wprowadzenie
Projekt powstał z myślą o świątecznej zabawie i interakcji użytkownika, jednak od strony technicznej został zbudowany jak prosta aplikacja: posiada logikę opartą o reguły czasowe, kontrolę postępu oraz trwałe zapisywanie stanu działania.
Kalendarz działa całkowicie offline — użytkownik pobiera plik .xlsm i uruchamia go lokalnie w Excelu (desktop). Interfejs prowadzi przez 24 „okienka” w formie pocztówek z zadaniami, które można zatwierdzić poprzez interakcję z elementami UI.
Dane
Projekt nie wykorzystuje zewnętrznych zbiorów danych. Źródłem stanu aplikacji są dane sterujące zapisane w pliku Excela.
- Stan aplikacji: przechowywany w arkuszu kontrolnym „tajne zapiski elfów” (ukryty przed użytkownikiem)
- Zakres funkcjonalny: 24 dni (okienka), reguły dostępności i blokad w oparciu o datę oraz historię działań użytkownika
- Trwałość: postęp użytkownika nie resetuje się po zamknięciu pliku
Proces
1) Logika aplikacji (VBA)
- zaprojektowanie reguł dostępności okienek zależnych od daty
- obsługa ograniczeń czasowych: na wykonanie zadania użytkownik ma 3 dni (okienko po terminie blokuje się)\walidacja postępu i warunków uruchomienia finału
- rozdzielenie odpowiedzialności na moduły VBA (logika/akcje/UI/efekty)
2) Trwały stan
- zapis postępu w arkuszu technicznym (tabela sterująca)
- brak ryzyka utraty postępu po zamknięciu Excela
- stan aplikacji stanowi źródło prawdy do odtworzenia UI
3) Interfejs użytkownika (Excel jako UI)
- klikane elementy w arkuszu pełnią funkcję UI aplikacji
- „zatwierdzanie zadania” odbywa się poprzez naklejenie znaczka w wyznaczonym miejscu
- elementy UI są dynamicznie aktualizowane (aktywne/nieaktywne okienka, blokady, efekty)
4) Dokumentacja + repozytorium
Repozytorium zawiera:
- moduły VBA
- dokumentację architektury i przepływu logiki
- opis modułów (modules.md)
- README w wersji dla użytkowników (no spoilers)
Wyniki
- interaktywny kalendarz adwentowy działający w pełni offline
- system reguł czasowych i blokad zapewniający spójny przebieg „gry”
- trwały stan aplikacji umożliwiający kontynuację bez resetu postępu
- całość opisana dokumentacją techniczną (projekt typu portfolio)
Refleksje
- Excel + VBA może być środowiskiem aplikacyjnym, jeśli projektuje się go jak system: UI + logika + stan
- kluczowe było utrzymanie przewidywalności działania: logika oparta o jedno źródło prawdy (tabela sterująca)
- oddzielenie warstwy logiki od interfejsu pozwoliło utrzymać porządek w kodzie i łatwiejsze testowanie zachowań
Rola AI w projekcie
W projekcie korzystałam z AI jako narzędzia wspierającego pracę koncepcyjną i iteracyjną nad rozwiązaniami w VBA.
Po mojej stronie było:
- zaprojektowanie logiki aplikacji
- decyzje architektoniczne
- testowanie zachowania w Excelu
- doprowadzenie całości do stabilnego, przewidywalnego efektu
Informacje końcowe
Projekt ma charakter autorski i portfolio. Repozytorium prezentuje zarówno efekt końcowy, jak i sposób myślenia projektowego oraz dokumentację techniczną.



Ciasteczko do kawy?