Документація Pinmate

Реєстрація — email і пароль. На пошту приходить лінк підтвердження; маєш 24 години, щоб клікнути. До того моменту акаунт існує, але не може ставити мітки чи записуватись на них — видно лише публічну мапу.

Логін — той самий email + пароль. Далі на пошту приходить шестизначний 2FA-код; ввівши його, отримуєш сесію, що переживає перезавантаження сторінки. Можна попросити новий код, якщо перший не дійшов чи прострочився.

Панель — стартовий екран для залогінених. Завантажує до 200 активних міток у твоєму радіусі спостереження, відсортованих за часом старту. Мітки поза радіусом не завантажуються.

Маркери несуть два сигнали: вид спорту (колір кружечка) і часовий стан. Live-мітки пульсують лаймовим кільцем; ті, що скоро стартують — статичним фіолетовим; прострочені блякнуть. Виділення додає мʼяку фіолетову поволоку.

Фільтри в правій панелі (на мобільному складається). Зміни застосовуються миттєво на клієнті. URL-стан не синхронізується — перезавантаження повертає твої збережені defaults.

Торкнись мапи, щоб поставити мітку, або натисни „поставити мітку”, що активує курсор-приціл і чекає твого наступного кліку. Модалка попередньо заповнена вибраною позицією — можна перевибрати з заголовка.

Обовʼязкові поля: заголовок (до 120 символів), категорія, аудиторія, час старту, тривалість. Опціональні: опис (до 2000), дисципліна (40 символів вільного тексту, наприклад „MTB” чи „5v5”) і видимість (публічна vs група). Соцлінки з профілю чіпляються автоматично.

Редагування існуючої мітки — той самий форм. Деякі поля залочені: локацію змінюєш через видалення і повторне створення, а видимість не перемикається між публічною і груповою (це здивувало б вже записаних учасників).

Кожна мітка має дві кнопки відповіді: „Йду” (зобовʼязання, твердий лічильник) та „Цікаво” (мʼякий сигнал спостереження, окремий лічильник). Можна перемикатись між ними або зняти відповідь взагалі до старту мітки.

Лічильники учасників видно всім, хто бачить мітку — включно з тими, хто ще не відповів. Імена тих, хто йде, не перелічуються, поки хост явно не увімкне це (майбутнє налаштування).

Сторінка Активності — твій особистий календар. Три кошики: Майбутні „Йду”, Спостережувані („Цікаво”) та Минулі „Йду”. Кожен серверно сторінкований.

Минулі „Цікаво” свідомо не виводяться — якщо лише спостерігав без зобовʼязання, нічого згадувати після факту.

Твій публічний профіль на /profile/[твій-id]. Показує імʼя, аватар, біо, соцпосилання, бейдж верифікації (якщо є), кількість підписників і твої майбутні публічні мітки. Мітки лише-в-групі приховані для не-учасників навіть на твоєму профілі.

Редагуй у Налаштування → Профіль. Аватар — або фото, що ти завантажиш, або одна з восьми кольорів Trail Mix з твоєю ініціалою. Бейджі верифікації („organizer” або „creator”) — адмін-куровані сигнали довіри. Cron автоверифікації промотує тебе на „creator” після пʼяти власних міток.

Натисни Підписатись на чиємусь профілі, щоб майбутні мітки тієї особи зʼявились у твоїй плитці Мережа. Підписка односторонна — адресат не мусить приймати і не отримує сповіщення. Хто підписаний на тебе — видно лише на твоєму профілі.

Налаштування per-follow живуть на /network. Можна вимкнути звук (сповіщення мовчать без відписки), перемикати email/push незалежно, обмежити сповіщення категоріями і додати географічний радіус.

Сповіщення про підписки виходять із 12-хвилинною затримкою від створення мітки. Це навмисно — поглинає петлю створити-редагувати-видалити, яку хости часто роблять у перші хвилини.

Групи — кола за запрошенням, що ділять приватні мітки. Зараз доступний лише secret-режим; closed (заявка на вступ) і open відкладені. Мітки в групі невидимі для не-учасників на всіх рівнях, включно з публічною мапою і пошуком.

Створи групу з /groups. Стаєш власником. Запрошення: згенеруй посилання з опційним терміном і лімітом використань, або запроси конкретного користувача за id.

Вихід — один клік. Якщо ти єдиний учасник і виходиш — група видаляється. Якщо ти власник з іншими учасниками — мусиш спочатку передати власність або видалити інших.

Pinmate має два канали: push (web push через service worker, потребує дозволу браузера) і email (SMTP у dev, Elastic Email у проді). Незалежні — вимикай один без впливу на другий.

Канали налаштовуються окремо для кожної мітки (твої нагадування про участь), окремо для кожної підписки (сповіщення про чужі нові мітки) і глобально в Налаштуваннях. Коли сповіщення збирається вийти, сервер перевіряє, що мітка ще існує, не прострочена і досі видима тобі.

Pinmate побудовано довкола ідеї, що твоя локальна мапа залишається локальною. Конкретно: сервер примушує область видимості в кожному запиті про мітки, твоя домашня локація не транслюється, і дефолтний build не містить третьосторонніх трекерів.

Куки розбиті на суто необхідні (сесія, локаль, тема), аналітичні (за замовчуванням off, opt-in через банер) і маркетингові (за замовчуванням off). Cookie banner — канонічне джерело правди.