Projekt własny · Po godzinach
Bede.app
Przygotowywanie zaproszeń, podgląd strony dla gości i zbieranie potwierdzeń obecności bez zakładania kont.
- Wyzwanie
- Chciałem lepszego wyglądu zaproszeń i czytelniejszego sposobu odpowiadania niż w narzędziach RSVP, które znałem. Organizator potrzebuje przygotować stronę dla gości i zebrać odpowiedź od każdej osoby objętej wspólnym zaproszeniem.
- Podejście
- Całą aplikację zbudowałem sam, pracując nad nią z przerwami po godzinach. Edytor Composer korzysta ze strony dla gości, przechowuje niezapisane zmiany w lokalnym szkicu i zapisuje powiązane dane w jednej transakcji.
- Rezultat
- Produkt przed premierą: panel organizatora, zaproszenia dla rodzin i par, RSVP bez konta, Composer, udostępnianie zaproszeń, integracja wysyłki e-maili i płatności za rozszerzenie konkretnego wydarzenia. Nie było jeszcze użycia na żywym wydarzeniu; dowodem jest zbudowany zakres funkcji i testy w repozytorium.
Najważniejsze elementy
- • Samodzielny twórca i programista full-stack
- • Jeden link dla kilku osób, odpowiedzi indywidualne i wspólne
- • Ten sam widok zaproszenia w edytorze i na stronie dla gości
- • Odzyskiwanie lokalnego szkicu i zapis w jednej transakcji
- • Oddzielne tworzenie szkicu, limity publikacji i rozszerzenia wydarzenia
TypeScript · Next.js · NestJS · PostgreSQL · Drizzle ORM · Zod · Stripe · AWS S3 / SES / SQS
O projekcie
Bede.app służy do przygotowywania zaproszeń na wydarzenia i zbierania potwierdzeń obecności (RSVP). Głównym zastosowaniem są wesela. Organizator przygotowuje zaproszenie i śledzi odpowiedzi, a goście otwierają link z tajnym identyfikatorem i odpowiadają bez zakładania konta.
Jedno zaproszenie może obejmować kilka osób, na przykład rodzinę lub parę. Każda osoba ma własny status obecności i odpowiedzi, a część pytań dotyczy całej grupy. Goście mogą wrócić przez ten sam link i zmienić odpowiedź.
Sam wymyśliłem i zbudowałem całą aplikację, pracując nad nią z przerwami po godzinach. Pomysł wynikał z mojej oceny istniejących narzędzi RSVP: chciałem lepszego wyglądu zaproszeń i czytelniejszego sposobu odpowiadania. Bede.app nie miało jeszcze premiery.
Problem
Przygotowanie zaproszenia i zbieranie odpowiedzi są ze sobą powiązane. Organizator potrzebuje zobaczyć stronę, którą otrzymają goście, wybrać widoczne informacje i sprawdzić, kto już odpowiedział. Wspólny link dla kilku osób musi zachować odpowiedzi każdej z nich.
Edytor wprowadza dodatkowe ograniczenie: zmiana podglądu nie powinna od razu zmieniać strony dla gości. Fikcyjne osoby używane w podglądzie nie mogą też trafiać do statystyk ani na listy wysyłkowe.
Podejście
Oddzieliłem tożsamość organizatora, dostęp do zaproszenia i wskazanie osoby udzielającej odpowiedzi. Tajny identyfikator w linku daje dostęp do grupy, a wybór imienia określa, kto odpowiada w jej ramach.
Edytor Composer umieściłem poza układem panelu organizatora i wykorzystałem w nim rzeczywisty widok strony dla gości w docelowym rozmiarze. Obsługiwane zmiany tworzą jeden lokalny szkic, który można odzyskać i zapisać jednym poleceniem. Skonfigurowane sekcje pokazują treść albo informację o jej braku; sekcji RSVP nie można usunąć.

Podgląd w lokalnym Storybooku dla deweloperów. Imiona oraz szczegóły wydarzenia są przykładowe.

Composer pozwala edytować stronę dla gości i jednocześnie obserwować podgląd. Szczegóły wydarzenia są przykładowe.
Kluczowe decyzje
Jeden link dla kilku osób
Kontekst: Zaproszenie na wesele może obejmować kilka osób o różnych statusach obecności i odpowiedziach.
Decyzja: Każda grupa otrzymuje jeden link z tajnym identyfikatorem. Odpowiedzi poszczególnych gości są przechowywane oddzielnie od odpowiedzi wspólnych.
Dlaczego: Goście mogą odpowiedzieć za osoby objęte zaproszeniem bez rejestracji, a organizator nadal widzi obecność każdej osoby.
Kompromis: Link pełni funkcję klucza dostępu. Wybór imienia wskazuje osobę odpowiadającą, ale nie potwierdza jej tożsamości. Każdy, kto ma link, może odpowiedzieć za tę grupę.
Ten sam widok zaproszenia w edytorze
Kontekst: Osobny podgląd może zacząć różnić się od zaproszenia, które rzeczywiście otrzymują goście.
Decyzja: Wykorzystałem komponent strony dla gości z osobnym zaproszeniem do podglądu oraz trybami edycji i przejścia przez zaproszenie.
Dlaczego: Organizator może sprawdzić rzeczywisty przebieg otwierania zaproszenia, w tym kopertę i wybór gościa, bez tworzenia zaproszenia dla prawdziwej osoby.
Kompromis: Dane podglądu wymagają osobnego oznaczenia i wykluczenia z wysyłki, limitów oraz statystyk. Tryb podglądu musi też blokować zapisy odpowiedzi i aktywności gości.
Lokalny szkic i jeden świadomy zapis
Kontekst: Composer zmienia kilka powiązanych rekordów. Zapisywanie każdego pola osobno mogłoby udostępnić gościom niepełny zestaw treści i ustawień sekcji.
Decyzja: Niezapisane zmiany przechowuję w przeglądarce jako szkic przypisany do wydarzenia. Cały obsługiwany zestaw zmian zapisuję w jednej transakcji bazy danych.
Dlaczego: Po odświeżeniu strony można odzyskać szkic, a błąd zapisu jednego z elementów wycofuje całą transakcję. Późniejsze odpowiedzi API aktualizują tylko nieedytowane części szkicu, bez zastępowania zmian organizatora.
Kompromis: Szkic pozostaje w tej przeglądarce i znika po wyczyszczeniu jej pamięci. Composer zakłada jednego aktywnego organizatora i nie rozstrzyga konfliktów między kartami lub urządzeniami.
Oddzielne przygotowanie, publikacja i płatność
Kontekst: Utworzenie szkicu, wykorzystanie limitu opublikowanych wydarzeń i zakup funkcji dla jednego wydarzenia mają różne skutki.
Decyzja: Nowe wydarzenie powstaje jako szkic. Limit publikacji sprawdzam osobno, a Event Premium przypisałem do konkretnego wydarzenia.
Dlaczego: Przygotowanie wydarzenia nie zużywa limitu publikacji. Jego rozszerzenie nie oznacza subskrypcji konta ani zwiększenia liczby wydarzeń, które można opublikować.
Kompromis: Interfejs musi wyjaśniać te różnice. Publikacja decyduje o udostępnieniu zapisanej konfiguracji sekcji z edytora Composer, ale nie ukrywa wszystkich danych szkicu przed osobą z ważnym linkiem do zaproszenia.
Jak to działa
- Organizator loguje się przez Google i tworzy szkic z danymi wydarzenia, lokalizacjami, pytaniami RSVP i grupami gości.
- W sekcji materiałów otwiera Composer, przegląda stronę dla gości i przygotowuje zmiany. Odświeżenie strony przywraca lokalny szkic w tej samej przeglądarce.
- Zapis utrwala cały zestaw zmian. W opublikowanym wydarzeniu goście otrzymują nową konfigurację; w szkicu zapisana konfiguracja sekcji zaczyna obowiązywać po publikacji.
- Organizator udostępnia linki dla grup lub kody QR. Wysyłka e-maili korzysta z osobnego procesu dostarczania wiadomości.
- Gość otwiera zaproszenie, wybiera osobę udzielającą odpowiedzi i przesyła potwierdzenie obecności oraz odpowiedzi na pytania. Może je później zmienić. Organizator widzi wynik w panelu.

Gość odpowiada z poziomu wspólnego zaproszenia dla gospodarstwa domowego. Imiona i szczegóły wydarzenia są przykładowe.

Organizator widzi grupy zaproszeń i status odpowiedzi każdego gościa. Wszystkie imiona i szczegóły wydarzenia są przykładowe.

Pełną listę gości można filtrować według statusu odpowiedzi. Imiona i dane kontaktowe są syntetyczne.
Rezultat
Zbudowałem panel organizatora, zaproszenia grupowe, RSVP bez konta, Composer, narzędzia udostępniania, integrację wysyłki e-maili i płatności za rozszerzenie konkretnego wydarzenia. Goście nie potrzebują kont. To cecha dostępu do produktu, a nie wskaźnik jego popularności.
Testy jednostkowe obejmują odzyskiwanie szkicu, przygotowanie danych podglądu, sprawdzanie właściciela zasobu i wycofanie zapisu w Composerze. Scenariusze przeglądarkowe obejmują zapis w edytorze widoczny po ponownym otwarciu strony dla gości oraz odpowiedź gościa widoczną w panelu organizatora. Są to scenariusze z repozytorium, a nie dowód użycia podczas rzeczywistych wydarzeń.
Bede.app jest rozwijanym produktem przed premierą. Dokumentacja wdrożenia wskazuje, że infrastruktura produkcyjna nie została jeszcze przygotowana, a wysyłka SMS pozostaje niewdrożona. Nie było jeszcze użycia na żywym wydarzeniu, więc nie ma metryk produkcyjnych.