CalendarVault — instrukcja dla testerów

Dziękujemy za testy! CalendarVault to natywna aplikacja macOS, która działa lokalnie na Twoim Macu — Twoje dane kalendarza nie trafiają na żaden serwer.

1. Co aplikacja robi

Jeśli masz kilka kalendarzy z różnych firm/kont, CalendarVault pokazuje je w jednym oknie i synchronizuje zajętość między nimi jako prywatne bloki „Zajęty / Busy":

• Spotkanie w kalendarzu Firmy A → blok „Busy" w kalendarzu Firmy B (domyślnie bez tytułu i szczegółów — B widzi tylko, że jesteś zajęty, nie na czym).
• Nikt nie umówi Cię „na zakładkę", a żadna firma nie widzi treści spotkań drugiej.

Konta: Apple/iCloud, Google, Microsoft 365/Exchange — dodane przez Ustawienia systemowe macOS → Konta internetowe (te same, których używa Kalendarz Apple).

2. Wymagania

• macOS 14 (Sonoma) lub nowszy.
• Konta kalendarzy dodane w Ustawienia systemowe → Konta internetowe. Nie logujesz się hasłem w aplikacji — korzysta z kont systemu.

3. Instalacja

1. Pobierz CalendarVault-beta.dmg (przycisk wyżej).
2. Kliknij dwukrotnie — otworzy się okno z ikoną aplikacji i skrótem Aplikacje.
3. Przeciągnij CalendarVault na folder Aplikacje.
4. Uruchom z Launchpada / Spotlight (⌘+spacja → „CalendarVault").

4. Pierwsze uruchomienie — uprawnienia

Przy starcie macOS zapyta o dostęp do Kalendarza → wybierz „Zezwól na pełny dostęp". Bez tego aplikacja nie zobaczy ani nie zmieni wydarzeń (dane i tak zostają lokalnie).

Jeśli przez pomyłkę odmówisz: Ustawienia systemowe → Prywatność i bezpieczeństwo → Kalendarze → włącz CalendarVault i zrestartuj aplikację.

5. Dodawanie kont

W panelu kont (po lewej): „Add account" → „Kalendarz macOS". Pojawią się kalendarze z Twoich kont. Konta możesz przeciągać (kolejność = priorytet przy deduplikacji), grupować w foldery i ustawić jedno jako domyślne (gwiazdka). Każde konto ma swój kolor na kaflach.

6. Sedno: synchronizacja zajętości

Pary (Pairs) — kierunek 1→1 lub kilka→1

• 1 → 1: np. Praca → Prywatny (prywatny pokazuje „Busy", gdy masz coś w pracy).
• Kilka źródeł → 1 cel (fan-in): wszystkie zajętości w jednym kalendarzu; nakładające się spotkania scalają się w jeden blok (bez duplikatów).
• Tryb: „Busy" (domyślny, bez treści) lub pełne szczegóły (kopiuje tytuł/miejsce — przy kilku źródłach niedostępne).
• Opcje: godziny pracy, pomijanie weekendów, dzielenie bloków >1h na 1-godzinne.

Grupy (Groups) — siatka N↔N z kierunkiem per konto

Przy każdym koncie zaznaczasz Source (zajętość propaguje się do innych) i/lub Target (przyjmuje bloki od innych). Domyślnie oba = pełna siatka. Przykład: Prywatny = tylko Source (praca widzi zajętość prywatną, ale prywatny się nie zaśmieca); Praca = Source + Target. Po odznaczeniu Target aplikacja sama posprząta zbędne bloki.

Po utworzeniu pary/grupy sync rusza automatycznie; możesz też kliknąć „Sync now".

7. Widok kalendarza i edycja

• Widoki Schedule / Day / Week / Month (styl Kalendarza macOS), czerwona „now-line".
• Tworzenie: dwuklik w puste miejsce lub przeciągnięcie zakresu; „+"/⌘N rozumie język naturalny („Lunch jutro 13:00").
• Edycja: dwuklik w wydarzenie (Enter = zapisz, Escape = anuluj), przeciąganie/zmiana długości dla Twoich wydarzeń.
• Zaproszenia: cudze zaproszenie odrzucisz (Decline) wprost z menu kontekstowego (znika z Twojego kalendarza). Pełne Accept/Maybe dla kont z Kont internetowych zrobisz przez „Odpowiedz w Kalendarzu" (otwiera Kalendarz Apple). Szczegóły w „Znane ograniczenia".
• Dedup — to samo spotkanie z kilku kont pokazane raz (z oznaczeniem „też w …").

8. Czego się spodziewać

• Bloki „Busy" to osobne wydarzenia tworzone przez aplikację w kalendarzu docelowym — to zamierzone.
• Pierwsza synchronizacja może chwilę potrwać; kolejne są szybkie (przyrostowe).
• Auto-sync działa w tle (interwał + reakcja na zmiany + odświeżanie o :01/:16/:31/:46).
• Minione bloki są sprzątane automatycznie; po usunięciu źródła znika blok „Busy".
• To wersja 0.1 (beta) — możliwe drobne usterki.

9. 📱 Kalendarze i bloki „Busy" na iPhone

Ważne: CalendarVault działa tylko na Macu — nie instaluje nic na iPhonie. Kalendarze trafiają na telefon przez te same konta w chmurze:

1. Aplikacja zapisuje bloki/wydarzenia do kalendarza w jednym z kont (iCloud / Google / Exchange).
2. Jeśli to samo konto jest na iPhonie (Ustawienia → Kalendarz → Konta), telefon sam to zsynchronizuje — łącznie z blokami „Busy". Nic nie kopiujesz ręcznie.

Czyste kopie do iCloud — automatycznie (bez ręcznej pracy): pogrupuj konta robocze w folderze w panelu kont. CalendarVault sam tworzy i utrzymuje ich czyste kopie w iCloud (zwykłe wydarzenia, bez technicznych bloków „Busy"), odświeżane przy każdej zmianie. Robi to lokalnie przez macOS (EventKit) — bez żadnego API i bez osobnego logowania. Ponieważ iCloud jest już na iPhonie, te kalendarze pojawiają się na telefonie same, bez kopiowania.

10. Na co zwrócić uwagę

• Czy bloki „Busy" pojawiają się w celu i znikają po usunięciu źródła.
• Czy nic się nie dubluje (to samo spotkanie z kilku kont = jeden wpis/blok).
• Godziny pracy, weekendy, dzielenie >1h; widoki i edycja; RSVP.
• Zachowanie po uśpieniu/wybudzeniu Maca i po dłuższej przerwie; wydajność i bateria.

11. Znane ograniczenia tej bety

• Accept/Maybe dla zaproszeń na kontach z Kont internetowych (iCloud/Exchange/Google-via-Apple) nie jest dostępne wprost w aplikacji (EventKit nie ma API do ustawienia statusu) — użyj „Odpowiedz w Kalendarzu" (otwiera Kalendarz Apple). Decline (usunięcie z kalendarza) działa z menu kontekstowego.
• To 0.1 — spodziewaj się szlifowania.

12. Zgłaszanie błędów

Pisz na hello@calendarvault.app i dołącz:

1. Co się stało + kroki do odtworzenia, ewentualnie zrzut/nagranie.
2. Wersja: menu CalendarVault → About (lub nazwa pliku DMG).
3. Log diagnostyczny: ~/Library/Application Support/CalendarVault/health.log
   Najszybciej: w Finderze ⌘⇧G, wklej ścieżkę, przeciągnij health.log do maila. Log zawiera stan kont i błędy synchronizacji — bez treści Twoich wydarzeń.

13. Prywatność

Treść kalendarza przetwarzana jest lokalnie na Twoim Macu i nie jest wysyłana do nas (brak serwera, brak telemetrii). Szczegóły: Polityka prywatności.