Проект :: Story Gym – приложение за денонощен достъп до фитнес с QR турникет и картови плащания

ВРЕМЕ ЗА ЧЕТЕНЕ: Мин

Не всеки проект, който правим, живее в браузъра. За Story Gym – денонощен фитнес в Пазарджик – изградихме софтуера, с който клиентът купува карта с банкова карта и минава през истински турникет само с телефона си.

Без рецепция, без пластмасови карти, без работно време. Клиентът отваря приложението Story Gym, натиска „Покажи код“, показва въртящ се QR код на четеца и турникетът се отваря – само ако в този момент човекът има валиден достъп.

В този проект описваме цялата система: клиентския портал и мобилното приложение, картовото плащане, услугата за контрол на достъпа, която говори с хардуера на турникета, и инженерните решения, които държат вратата работеща и когато нещо се обърка.

За проекта

Story Gym искаше да работи като фитнес без персонал. Това означава всяка стъпка, която иначе върши рецепционист – продажба на карта, проверка, пускане, запис на посещението – да стане софтуер, и този софтуер да е достатъчно надежден, за да стои между платил клиент и заключена врата в 2 часа през нощта.

Доставихме три свързани части: публичен сайт (story-gym.org), клиентски портал и мобилно приложение (my.story-gym.org, също в Google Play и подадено в App Store) и отделна услуга за контрол на достъпа, която валидира QR кодовете за контролера на турникета в реално време.

Цели

• Онлайн продажба на единични тренировки и месечни карти с български банкови карти (Visa, Mastercard, B-card) и 3-D Secure
• Отваряне на съществуващ трипод турникет от телефон, с код, който не може да се снима и препрати
• Бизнес правила на самата врата: активна карта, едно влизане на ден за единична тренировка, обвързване с устройство, персонал с постоянен достъп
• Запис на реалните преминавания (не само на сканиранията) за отчетите на собственика
• Услугата за вратата да е независима от портала, така че deploy или проблем в портала никога да не заключи клиентите отвън
• Всичко на serverless инфраструктура, без сървъри за поддръжка

Ключови функционалности

Клиентски портал и мобилно приложение

Регистрация и вход (имейл/парола или Google), табло с активната карта и срока ѝ, покупка на единични тренировки или месечни карти, история на плащанията и абонамента, дневник на посещенията и форма за поддръжка. Интерфейсът е двуезичен (български и английски) със светла и тъмна тема по бранда на клуба.

Картови плащания през Банка ДСК

Плащането е интегрирано с виртуалния POS на Банка ДСК: поръчката се регистрира, клиентът минава 3-D Secure на страницата на банката, а обратното повикване потвърждава плащането, преди да се издаде правото на достъп. Данни за карти никога не минават през нашите системи. Промо кодове и роли за персонал покриват безплатните случаи.

Въртящ се QR код

Кодът в приложението е краткотраен, HMAC-подписан токен, който носи указател към правото на достъп, време на издаване и срок от 30 секунди. Обновява се автоматично, така че снимка на екрана е безполезна след секунди. В мобилното приложение яркостта на екрана се вдига на максимум, докато кодът е показан, за да го хване четецът от първия път.

Услуга за контрол на достъпа към турникета

Турникетът се управлява от мрежов контролер Soneco, който вика нашата услуга по HTTPS при всяко сканиране и при всяко реално завъртане. Услугата проверява подписа и срока, пита портала дали този клиент може да влезе точно сега и отговаря „allow“ или „deny“ с цвят на LED, звук и съобщение на дисплея – за милисекунди. Преминаването се изразходва и записва само когато турникетът реално се завърти.

Административен панел

Собственикът вижда клиенти, карти, поръчки, преминавания и заявки за поддръжка с pagination, групови действия и управление на роли (клиент, персонал с постоянен достъп, супер админ) – без да има нужда от нас за ежедневната работа.

Технологии

• Портал и API: Cloudflare Workers с framework Hono, server-rendered TypeScript изгледи
• База данни: Cloudflare D1 (SQLite на edge) за потребители, права, поръчки, преминавания и устройства; KV за сесии
• Услуга за достъп: отделен stateless Cloudflare Worker, реализиращ протокола SCAN / TURN на контролера
• Мобилни: Capacitor приложения за Android и iOS с deep links и native контрол на яркостта
• Плащания: виртуален POS на Банка ДСК (register / status API, 3-D Secure)
• Сигурност: PBKDF2 хеширане на пароли, HMAC-подписани сесии и токени, Cloudflare Turnstile, обвързване с устройство
• Хардуер: трипод турникет IESTO с контролер Soneco TC-1U-R07 и QR четец
• Сайт: статичен Astro сайт на Cloudflare

Акценти в архитектурата

• Две независими услуги по замисъл: порталът отговаря за акаунти, плащания и права; lock услугата само отговаря allow/deny на хардуера и няма собствена база данни
• QR токенът е указател плюс защита от фалшификация, никога самото право – правата винаги се проверяват на живо в базата
• Защита от повторно използване на токен, дневно нулиране за единичните тренировки и път „постоянен достъп“ за персонала, който заобикаля лимитите, без да пипа хардуерната интеграция
• TLS от страната на устройството: контролерът пинва CA и поддържа ограничен набор алгоритми за подпис, затова сертификатната верига на edge беше конфигурирана да сервира RSA верига, която четецът може да провери – детайл, който определи хостинга
• Запис на преминаването при реалното завъртане, не при сканиране, така че отчетите показват кой наистина е влязъл
• Нула сървъри: цялата система е Workers, D1 и KV, deploy с една команда

Резултати

Story Gym отвори като изцяло самообслужващ се клуб. Клиентите купуват карти онлайн, турникетът се отваря от телефона, персоналът влиза с постоянен код, а собственикът има картина на живо за продажби и посещения. Android приложението е в продукция в Google Play, а iOS приложението е подадено в App Store.

Сайт: story-gym.org · Клиентски портал: my.story-gym.org

Защо да работите с Vipe Studio

Този проект събра уеб, мобилни приложения, плащания и хардуерна интеграция в една доставка – и всяка част трябваше да е точна, защото бъг тук означава клиент пред затворена врата. Проектираме именно за това: изолирани услуги, подписани токени, проверки на живо и тестове на ниво хардуер преди пускане.

Ако бизнесът ви има нужда от софтуер, който докосва физическия свят – контрол на достъпа, билети, киоски, IoT устройства – или просто от serverless платформа с картови плащания и мобилни приложения, говорете с нас. Ще го изградим по същия начин.

Още по темата

• Проект :: Coach by Vipe – платформа за треньори и мобилно приложение за спортни отбори
• Проект :: CRM за спедиция и логистични операции
• Проект :: Хибридна LMS платформа, задвижвана от Headless WordPress и Next.js
• Проект :: Платформа за детегледачи

Съдържанието на този сайт е запазено от силата на договора с Creative Commons 4.0.

Автор Vipe Team

Нашият неуморен екип, който създава качествено WordPress насочено съдържание за Вас 24/7/365.