Kalendarz Adwentowy 2025 (Excel + VBA)

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ą.

Prezentacja kalendarza