Dokumentacja Pinmate

Rejestracja wymaga maila i hasła. Wysyłamy link potwierdzający na ten adres; masz 24 godziny, żeby go kliknąć. Do tego momentu konto istnieje, ale nie może stawiać pinów ani zapisywać się na nie — widoczna jest tylko publiczna mapa.

Logowanie używa tego samego maila + hasła. Następnie na skrzynkę przychodzi sześciocyfrowy kod 2FA; wpisanie go daje sesję, która przeżywa reload strony. Możesz poprosić o nowy kod, jeśli pierwszy nie dotarł (sprawdź spam) lub wygasł.

Pulpit to ekran startowy dla zalogowanych. Ładuje do 200 aktywnych pinów wewnątrz twojego promienia obserwacji, sortowane po czasie startu. Piny poza promieniem nie ładują się — sąsiednie miasta nie pojawią się, dopóki nie zwiększysz promienia w panelu filtrów.

Markery niosą dwie informacje na pierwszy rzut oka: dyscyplinę (kolor wypełnienia kropki) i stan czasowy. Piny live pulsują limonkowym ringiem; piny startujące wkrótce dostają statyczny fioletowy ring; piny wygasłe blakną do połowy nieprzezroczystości. Zaznaczenie markera dodaje miękką fioletową poświatę na wierzchu, żebyś wiedział, który pin opisuje panel boczny.

Filtry siedzą w panelu po prawej, składanym na mobilce. Zmiany aplikują się natychmiast po stronie klienta — mapa rysuje się ponownie bez zapytania do serwera. Stan URL nie jest synchronizowany, więc reload resetuje filtry do twoich domyślnych.

Stuknij dowolny punkt na mapie, żeby zacząć stawiać pin, albo użyj przycisku „postaw pinezkę”, który włącza kursor-celownik i czeka na następne kliknięcie. Modal, który się otwiera, jest pre-fillowany wybraną szerokością/długością — możesz przepiknąć punkt z nagłówka modala.

Pola wymagane: tytuł (maks 120 znaków), kategoria, audience, czas startu, długość. Opcjonalne: opis (do 2000 znaków), dyscyplina (40 znaków wolnego tekstu, np. „MTB” albo „5v5”) i widoczność (publiczny vs grupowy). Linki społecznościowe z profilu doczepiają się automatycznie — nie musisz ich wklejać do każdego pina.

Edycja istniejącego pina używa tego samego formularza. Niektóre pola są zablokowane: lokalizację można zmienić tylko przez usunięcie i ponowne utworzenie, a widoczności nie da się przełączyć między publiczną a grupową (zaskoczyłoby to osoby już zapisane).

Każdy pin pokazuje dwa przyciski odpowiedzi: „Idę” (deklaracja udziału, twardy licznik) i „Zainteresowany” (miękki sygnał obserwacji, osobny licznik). Możesz przełączać się między nimi albo zupełnie wyzerować swoją odpowiedź w każdej chwili przed startem pina.

Liczniki uczestników są widoczne dla każdego, kto widzi pin — także dla osób, które jeszcze nie odpowiedziały. Imiona uczestników nie są wypisywane, dopóki host tego nie włączy (przyszłe ustawienie). Twoja własna odpowiedź jest podświetlona zielonym znacznikiem.

Strona Aktywności to twój osobisty kalendarz na wszystkich pinach. Dzieli się na trzy kubełki: Nadchodzące „Idę”, Obserwowane („Zainteresowany”) i Minione „Idę”. Każdy kubełek jest stronicowany serwerowo.

Minione „Zainteresowany” celowo się nie pokazują — jeśli tylko obserwowałeś bez zobowiązania, nie ma o czym pamiętać po fakcie. Piny, które sam hostowałeś, też się tu pojawiają, obok tych, do których dołączyłeś.

Twój publiczny profil znajduje się pod adresem /profile/[twoje-id]. Pokazuje nazwę wyświetlaną, awatar, opis, linki społecznościowe, odznakę weryfikacji (jeśli ją masz), licznik obserwujących i twoje nadchodzące publiczne piny. Piny tylko-grupowe są ukryte przed osobami spoza grupy — nawet na twoim własnym profilu.

Edytuj pola profilu w Ustawienia → Profil. Awatar może być zdjęciem, które wgrasz, albo jednym z ośmiu kolorów palety Trail Mix z pierwszą literą twojej nazwy. Odznaki weryfikacji („organizer” lub „creator”) to sygnały zaufania nadawane przez administratorów — automat weryfikacji promuje cię na „creator” po pięciu samodzielnie zorganizowanych pinach.

Stuknij Obserwuj na czyimś profilu, żeby nadchodzące piny tej osoby pojawiły się w twoim kafelku Sieć na pulpicie. Follow jest jednokierunkowy — adresat nie musi akceptować i nie dostaje powiadomienia, że zacząłeś go obserwować. Kierunek przeciwny (kto obserwuje ciebie) jest pokazywany tylko na twoim własnym profilu.

Preferencje per-follow żyją na stronie /network. Możesz wyciszyć obserwację (powiadomienia milkną bez unfollow), przełączyć kanał mail vs push niezależnie, ograniczyć powiadomienia do konkretnych kategorii i dodać promień geograficzny, żeby odległe piny obserwowanej osoby nie pojawiały się w twoim lokalnym feedzie.

Powiadomienia o pinach obserwowanych wysyłają się z 12-minutowym opóźnieniem od utworzenia pina. To jest celowe: absorbuje pętlę utwórz-edytuj-usuń, którą hosci często robią w pierwszych minutach, dzięki czemu nie spamuje cię powiadomienie o pinie, który już nie istnieje.

Grupy to kręgi dostępne tylko z zaproszenia, dzielące prywatne piny. Obecnie dostępny jest tylko tryb secret — discoverable closed groups (request-to-join) i open public groups są odroczone. Piny dodawane w grupie są niewidoczne dla nie-członków na każdej warstwie, włącznie z publiczną mapą i wyszukiwarką.

Stwórz grupę z /groups. Stajesz się jej właścicielem. Zaproszenia członków: wygeneruj link do udostępniania z opcjonalną datą wygaśnięcia i limitem użyć, albo zaproś konkretnego usera po id. Bezpośrednie zaproszenia powiadamiają adresata in-app.

Wyjście z grupy to jeden klik. Jeśli jesteś jedynym członkiem i wyjdziesz, grupa zostaje usunięta. Jeśli jesteś właścicielem z innymi członkami, musisz najpierw przekazać własność albo usunąć innych — w innym wypadku akcja odmówi, żeby nie zostawić grupy bez ownera.

Pinmate ma dwa kanały: push (web push przez service workera, wymaga zgody przeglądarki) i mail (wysyłany przez SMTP w dev, Elastic Email w produkcji). Są niezależne — wyłącz dowolny bez wpływu na drugi.

Kanały są konfigurowalne osobno dla każdego pina (twoje przypomnienia o uczestnictwie), osobno dla każdej obserwowanej osoby (powiadomienia o ich nowych pinach) i globalnie w Ustawieniach (główny przełącznik, wyprzedzenie przypomnień). Gdy powiadomienie ma się wysłać, serwer sprawdza ponownie, czy pin nadal istnieje, nie wygasł i jest dla ciebie widoczny — późne usunięcia ani zmiany widoczności nie tworzą „duchowych” powiadomień.

Pinmate jest zbudowane wokół zasady, że twoja lokalna mapa zostaje lokalna. Konkretnie: serwer egzekwuje zakres widoczności w każdym zapytaniu o piny, twoja domowa lokalizacja nigdy nie jest transmitowana, a domyślny build nie zawiera trzeciostronnych trackerów.

Ciasteczka są podzielone na ściśle konieczne (sesja, locale, motyw), analityczne (domyślnie off, opt-in przez banner) i marketingowe (domyślnie off). Banner cookies jest kanoniczną prawdą; przełączenie przełącznika tam natychmiast cofa zgodę na następnym loadzie strony.