Заказчик/Контекст проекта:
Сфера услуг (салоны красоты, барбершопы, медицинские клиники, автосервисы) сталкивается с проблемами при ручной записи клиентов через телефон и мессенджеры. Администраторы тратят много времени на ручные ответы, клиенты забывают о визитах, освободившееся время простаивает, а из-за человеческого фактора регулярно возникают двойные записи (овербукинг).
Цель и задачи:
Создать отказоустойчивый экосистемный SaaS-сервис для автоматизации онлайн-записи с минимальным порогом входа для клиента и мощным кабинетом управления для заведения. Key-задачи разработки:
1. Реализовать удобный клиентский путь записи там, где клиент уже общается — через Telegram Mini App, Telegram-бота, мессенджер MAX и встраиваемый виджет для сайта.
2. Исключить вероятность двойных записей (race conditions) на фундаментальном уровне архитектуры базы данных.
3. Разработать гибкий веб-кабинет управления для администраторов и владельцев: интерактивное расписание (drag-and-drop), управление сменами и графиками мастеров, клиентская база, лояльность (баллами и абонементами), модуль предоплаты и аналитика.
4. Обеспечить полную изоляцию данных клиентов (Multi-tenant security) и высокие показатели производительности под нагрузкой.
Для решения поставленных задач была спроектирована и реализована кроссплатформенная веб-система на базе современного стека (React 19, Node.js/NestJS, Fastify, PostgreSQL 18, Redis 8).
Инженерные и архитектурные решения:Исключение овербукинга на уровне СУБД:
1. Время записи хранится как временной диапазон с exclusion-ограничениями PostgreSQL по мастеру и рабочему месту. При 100 одновременных попытках занять один слот проигравшие запросы получают корректный отказ, а не сбой сервера, гарантируя 0% двойных записей.
2. Чистый движок свободного времени: Чистая функция подбора слотов учитывает графики мастеров, перерывы, буферные зоны, комбинации сложных услуг, часовые пояса, переносы часов и праздничные дни производственного календаря без жесткой привязки к базе.
3. Двухуровневая изоляция Multi-tenancy: Использованы составные ключи и механизмы Row-Level Security (RLS) PostgreSQL, предотвращающие доступ к чужим данным заведения даже при прямой подмене ID. Надёжная доставка уведомлений (Pattern Outbox): Уведомления и напоминания отправляются в единой транзакции с изменениями записи.
4. Реализована защита от спама: если запись перенесена и вернулась на место в течение минуты, уведомление не беспокоит клиента.
5. Единая кодовая база и гибкость бизнес-модели: Разработан адаптер для работы с Telegram SDK и внешней эмуляцией. Специфика бизнеса (салон, клиника, автосервис) перенесена в структуры данных (реестры), что позволяет добавлять новые типы заведений без изменения кода.
6. Строгие контракты API: Использование Zod-схем гарантирует сквозную валидацию запросов, типизацию TypeScript и автоматическую генерацию OpenAPI.
Разработан полноценно функционирующий продукт с готовой демо-версией на реальных тестовых данных (4 заведения, >7 400 записей за 4 месяца с учетом сезонности). Ключевые показатели и достижения:
• Надёжность: 0 двойных записей при жестких нагрузочных тестах (100 параллельных запросов на 1 слот — 1 запись, 99 корректных отказов).
• Производительность: Подбор свободного времени отрабатывает за p95 = 45 мс (100 зап/с на одном ядре API), а загрузка раздела «Мои записи» — p95 = 5 мс.
• Оптимизация: В процессе нагрузочного тестирования k6 подбор времени был ускорен с 6,98 сек до 117 мс по p95 при 50 зап/с.
• Покрытие тестами: Написано 117 тестов доменной логики и 61 интеграционный тест с реальными PostgreSQL и Redis.
• Практическое применение: Продукт полностью готов к коммерческому запуску и масштабированию в нишах Beauty, Health и Auto-service.