📘 ПАСПОРТ СИСТЕМЫ
CRM «Студия лазерной эпиляции»
Версия 1.1 · Ноябрь 2026
Платформа: PocketBase (база данных и сервер) + веб-интерфейс (HTML/JS)
Адрес системы: локальный сервер или домен, вход через страницу login.html
1. Роли и разграничение доступа
В системе три роли пользователя: admin (администратор), manager (менеджер), master (мастер).
| Раздел / возможность | admin | manager | master |
| Главная: обзор и статистика дня | ✅ | ✅ | ✅ |
| 👥 Клиенты: поиск, просмотр, карточки | ✅ | ✅ | ✅ |
| 📅 Календарь: просмотр, создание, правка, удаление записей | ✅ | ✅ | ✅ |
| 💆 Услуги и цены: просмотр справочника и истории цен | ✅ | ✅ | ✅ |
| 💆 Услуги и цены: редактирование (добавить, изменить, цена, удалить) | ✅ | ❌ | ❌ |
| 📊 Отчёты | ✅ | ✅ | ✅ |
| 👩⚕️ Мастера (справочник мастеров) | ✅ | ❌ | ❌ |
| 💰 Прайс мастеров (индивидуальные цены/длительность) | ✅ | ❌ | ❌ |
| 🔐 Пользователи (создание, роли, пароли) | ✅ | ❌ | ❌ |
| 🧹 Сброс данных (служебная очистка базы) | ✅ | ❌ | ❌ |
| 🎭 Демо-данные и 📘 документы (паспорт, КП) | ✅ | ❌ | ❌ |
Особенности реализации прав:
- Администраторские блоки на главной («🔐 Администрирование» и «📚 Документы и демо-стенд») видны только роли admin.
- На странице «Услуги и цены» не-админам показывается баннер «👁 Режим просмотра», кнопки редактирования скрыты.
- Страница «Пользователи» для не-админов показывает «⛔ Доступ запрещён» с указанием текущей роли.
- Страница «Сброс данных» защищена проверкой роли admin в коде.
- Управление коллекцией пользователей на сервере закрыто правилом «только admin».
- Защита от самоблокировки: при изменении собственной роли/статуса запрашивается дополнительное подтверждение; кнопка «Удалить» на своей учётной записи скрыта.
2. Главная страница (дашборд)
- Обзор на сегодня: количество записей, выручка (завершённые и в процессе), клиентов в базе, активных мастеров.
- Основные разделы (все роли): Клиенты → Календарь → Услуги и цены → Отчёты.
- Администрирование (только admin): Мастера → Прайс мастеров → Пользователи → Сброс данных.
- Документы и демо-стенд (только admin): Паспорт системы → Коммерческое предложение → Демо-данные.
- В шапке отображается имя текущего пользователя и кнопка «Выход».
3. Календарь записей
3.1. Представление
- Горизонтальная сетка-таймлайн: строки — мастера, столбцы — часы 08:00–21:00.
- Колонка мастеров закреплена при прокрутке; у каждого мастера — график работы и число записей на день.
- Подсветка рабочего времени мастера (зелёная зона, определяется из графика, например «ПН-ПТ, 08:00-18:00» или «2/2 с 10:00 до 20:00»).
- Красная линия текущего времени (только сегодня) и автопрокрутка к нему.
3.2. Навигация по датам
- Кнопки: «←− Неделя», «← Назад», «Вперёд →», «Неделя →», «📍 Сегодня».
- Кнопка-дата с мини-календарём (навигация по месяцам, подсветка сегодняшней и выбранной даты).
- Дата сохраняется в адресной строке (calendar.html?date=ГГГГ-ММ-ДД): при обновлении страницы календарь остаётся на выбранной дате; ссылкой можно делиться.
- Корректная работа с часовыми поясами: без «сдвига на день» при обновлении и переходах.
3.3. Фильтры и статистика дня
- Фильтры: по мастеру, по статусу записи, по статусу оплаты (фильтр «Не оплачено» находит и старые записи без поля оплаты).
- Панель статистики дня: выручка (завершённые), запланировано, завершено, отменено, скоро начнутся, наложения, не оплачено.
3.4. Карточки записей
- Цвет по статусу: запланирована (фиолетовый), подтверждена (синий), в процессе (оранжевый), завершена (зелёный), отменена (красный полупрозрачный), не явился (серый).
- «⏰ Скоро начнётся»: пульсирующая подсветка записей, начинающихся в ближайшие 30 минут (только сегодня).
- «⚠️ Наложение»: красная рамка и значок, если у мастера пересекаются по времени две активные записи.
- Точка оплаты в углу карточки: красная — не оплачено, жёлтая — частично, зелёная — оплачено.
- Всплывающая подсказка при наведении: клиент, услуги, время, статус, сумма, оплата, телефон, комментарий; для наложений — список «Конфликтует с…».
- Быстрая смена статуса при наведении (с подтверждением).
- Удаление записи при наведении (✕, с подтверждением) — для ошибочных регистраций.
- Клик по карточке — редактирование записи; клик по пустой ячейке сетки — новая запись с подставленными мастером, датой и временем (шаг 15 минут).
3.5. Печать
- Кнопка «🖨 Печать»: печатается только расписание с заголовком (дата, мастер); служебные элементы скрываются, цвета сохраняются.
3.6. Обновления в реальном времени (Realtime)
- Календарь подписан на изменения записей через встроенный механизм PocketBase Realtime: создание, изменение и удаление записей другими пользователями появляются во всех открытых окнах примерно за секунду, без обновления страницы.
- Индикатор «⚡ Live» в панели управления: зелёный — соединение активно; серый — realtime недоступен, календарь работает в обычном режиме (обновление по F5).
- Всплывающие уведомления (toast) в углу экрана: «📅 Новая запись» (клиент, время, мастер), «✏️ Запись изменена» (с новым статусом), «🗑 Запись удалена».
- Изменённая карточка подсвечивается мигающей рамкой около 2,5 секунд.
- Необязательный звуковой сигнал при новой записи: кнопка 🔕/🔔, настройка запоминается в браузере.
- События других дней показываются уведомлением, но не переключают открытую дату.
4. Форма записи (создание / редактирование)
4.1. Клиент
- Автоподстановка: при вводе ФИО или телефона — список совпадений (до 10), навигация стрелками, выбор Enter или кликом.
- Принятая логика работы: сначала создаётся/находится клиент, затем делается запись.
4.2. Время и зоны
- Время начала в формате ЧЧ:ММ с автоформатированием ввода и проверкой корректности.
- Время окончания рассчитывается автоматически: сумма длительностей выбранных зон плюс буфер после процедуры.
- Зоны обработки — флажки; у каждой зоны отображаются фактические длительность и цена для выбранных мастера и даты.
4.3. Двухуровневая модель цен (ключевая особенность)
Приоритет расчёта цены на дату записи:
- Индивидуальная цена мастера, действующая на эту дату;
- Базовая цена из истории цен, действующая на эту дату (учитывает заранее внесённые будущие цены);
- Текущая базовая цена услуги.
Приоритет расчёта длительности:
- Индивидуальная длительность мастера (если задана);
- Базовая длительность услуги.
При смене мастера или даты в форме цены, длительности и итог пересчитываются автоматически.
4.4. Финансы
- Скидка: тип (без / процент / сумма), значение, причина (акция, постоянный клиент, день рождения, комплекс, другое).
- Предоплата («оплачено»), способ оплаты (наличные / карта / СБП).
- Статус оплаты (Не оплачено / Частично оплачено / Оплачено):
- авторасчёт при изменении предоплаты;
- ручная установка отключает авторасчёт до следующего изменения предоплаты;
- при ручной установке «Оплачено» предоплата выравнивается до итоговой суммы (остаток 0), «Не оплачено» — до 0;
- при открытии существующей записи статус загружается из базы и не затирается авторасчётом.
- Итоговая сумма, остаток к оплате, выработка мастера (процент от его комиссии).
4.5. Контроль наложений
- При сохранении проверяется пересечение с другими активными записями мастера в этот день.
- При конфликте — окно со списком конфликтующих записей: «Отмена» или «Всё равно сохранить».
- При открытии существующей записи с наложением — красный баннер со списком конфликтов.
4.6. Прочее
- Дополнительно: номер процедуры в курсе, буфер после процедуры (мин), статус записи, комментарий.
- Режим редактирования помечается жёлтым баннером.
- Кнопки «← Календарь» и «Отмена» возвращают в календарь на дату записи (не на сегодня).
- После сохранения календарь открывается на дате записи.
- Автозаполнение из ссылки: клиент, мастер, дата, время, номер записи (переходы из календаря и карточек клиентов).
5. Клиенты
5.1. Страница списка (режим сверки и редактирования)
- Быстрый поиск с автоподстановкой (ФИО или телефон, от 2 символов): в списке — ФИО, телефон, долг и кнопка «✏️ Карточка»; клик по строке или Enter — редактирование карточки клиента.
- Режим «🕑 Последние изменённые»: 6 карточек недавно изменённых клиентов (быстрый доступ).
- Режим «👥 Все клиенты (N)»: фильтры (ФИО, телефон, фототип, аллергия, задолженность), сортировка (новые / А-Я / Я-А / по долгу), пагинация по 12 карточек.
- Карточка-превью клиента: ФИО, телефон, бейджи (долг, фототип), фототип кожи, день рождения, аллергия на крем (с примечанием), наличие тату (с примечанием), сумма долга, комментарий (жёлтый блок), дата последнего изменения, кнопка «✏️ Карточка».
- Кнопка «+ Новый клиент» — создание карточки.
- Сознательно отсутствует кнопка «Записать»: запись создаётся только через календарь (принятое бизнес-решение).
5.2. Карточка клиента
- Создание и редактирование данных клиента: ФИО, телефон, фототип, аллергия, тату, комментарий и другие поля.
6. Услуги и цены (базовый прайс)
- Просмотр — всем ролям; редактирование — только admin.
- Таблица: название, базовая длительность, текущая цена, статус (активна/неактивна).
- Поиск по названию, фильтр по статусу.
- Добавление услуги: название, длительность, стартовая цена, активность; автоматически создаётся первая запись истории цен.
- Редактирование: название, длительность, активность (цена меняется отдельно).
- Смена цены с даты: новая цена и дата «действует с»; предыдущая цена автоматически закрывается днём ранее; если дата в будущем — текущая цена не меняется до её наступления (в расчётах новая цена применится сама).
- История цен: таблица всех цен услуги с периодами; текущая подсвечена, будущая помечена бейджем.
- Деактивация/активация: неактивные услуги не показываются в форме записи.
- Удаление услуги (с подтверждением): удаляется вместе с историей цен.
7. Прайс мастеров (индивидуальные условия)
- Доступ: только admin (через главную).
- Таблица: мастер, услуга, цена, длительность (жёлтым — отличная от базовой; «базовая» — если 0/пусто), период действия, бейдж «истёк».
- Добавление/редактирование: мастер, услуга, цена, длительность (0 = базовая), дата начала, дата окончания (пусто = бессрочно).
- Удаление записи прайса. Фильтр по мастеру.
- Логика: запись прайса мастера переопределяет базу только в своём периоде действия; можно задать только длительность без цены и наоборот.
8. Мастера (справочник)
- Доступ: только admin.
- Список мастеров с поиском (ФИО, специализация, статус).
- Карточка мастера: ФИО, специализация/зоны, комиссия (%), график работы (текстом), статус активности.
- График мастера используется календарём для подсветки рабочего времени; комиссия — для расчёта выработки в записи и отчётах; активные мастера попадают в списки выбора.
9. Отчёты
- Выручка по дням за период.
- Выработка мастеров (с учётом комиссий).
- Топ услуг по выручке и количеству.
- Загрузка мастеров.
- Доступ: все роли.
10. Пользователи системы (только admin)
- Список: имя, логин (email), роль (admin/manager/master), статус (активен/отключён), метка «(вы)».
- Поиск по имени и логину.
- Создание пользователя: имя, email, пароль (минимум 8 символов), роль, активность; новым пользователям автоматически открывается видимость логина.
- Редактирование: имя, логин, роль, активность.
- Смена пароля: с указанием текущего пароля (требование платформы для не-суперпользователей); подсказка со ссылкой на сброс через админку PocketBase, если текущий пароль неизвестен.
- Удаление (кроме собственной учётной записи).
- Кнопка «👁 Открыть логины»: одноразово делает email видимым для всех записей.
- Страницы принудительно освежают данные пользователя, роль всегда актуальна.
11. Служебные инструменты (admin)
11.1. Сброс данных (reset.html)
- Назначение: обнуление рабочих данных при сохранении всего функционала — для передачи системы новому клиенту или подготовки демо-стенда.
- Счётчики текущих объёмов данных (записи, клиенты, услуги, история цен, прайс мастеров, мастера).
- Выборочная очистка: записи календаря; клиенты; услуги + история цен; мастера + прайс мастеров.
- Полный сброс рабочих данных с подтверждением словом «СБРОС»: удаляет записи, клиентов, услуги, историю цен, мастеров и прайс мастеров.
- Не трогает: пользователей и роли, структуру коллекций, настройки сервера, страницы CRM — система остаётся полностью работоспособной и пустой.
- Удаление выполняется пакетами, в порядке «дочерние данные → справочники», база остаётся консистентной.
- На странице размещена рекомендуемая процедура передачи системы новому клиенту: резервная копия → полный сброс → создание пользователей нового клиента → наполнение (демо-данные или ручной ввод) → финальная резервная копия.
11.2. Генератор демо-данных (demo_seed.html)
- Создаёт реалистичный демонстрационный набор: 8 клиентов (с аллергиями, тату, долгами, комментариями), 8 услуг с историей цен, 4 мастера с графиками и комиссиями, 6 индивидуальных цен мастеров (своя цена и/или длительность), около 28 записей на неделю вперёд с разными статусами и оплатами.
- Защита от дубликатов: существующие клиенты/услуги/мастера/цены не создаются повторно.
- Все демо-записи помечены меткой DEMO_SEED — кнопка «Очистить демо-данные» удаляет только их, реальные данные не страдают.
- Индикатор подключения к серверу, журнал операций и прогресс-бар; доступно пошаговое создание отдельных типов данных.
11.3. Документы
- Паспорт системы (passport.html) и коммерческое предложение (commercial_proposal.html) — страницы с печатной вёрсткой A4; сохраняются в PDF через Ctrl+P.
- Ссылки на служебные страницы размещены на главной в блоках «🔐 Администрирование» и «📚 Документы и демо-стенд» (только admin).
12. Резервное копирование
- Скрипты backup.bat / backup.ps1 в папке PocketBase (запуск двойным кликом).
- Алгоритм: остановка сервера → архив всей папки (база данных и файлы, страницы CRM, исполняемый файл, служебные скрипты) с датой и временем в имени → удаление старых архивов (хранятся последние 10) → запуск сервера → проверка работоспособности.
- Целевая папка настраивается в скрипте; поддерживается сохранение в облако (Яндекс.Диск) как второй носитель.
- Восстановление: распаковать архив в папку → запустить pocketbase.exe serve.
- Рекомендованный регламент: ежедневно в конце дня; еженедельная копия на второй носитель; обязательный бэкап перед изменением структуры базы и перед сбросом данных.
13. Технические особенности (важно при эксплуатации)
- Даты и время: все даты хранятся в UTC; формат дат платформы корректно обрабатывается во всех модулях; «сдвигов на день» при смене дат и обновлении нет.
- Статусы с пробелами («В процессе», «Не явился») корректно отображаются и окрашиваются.
- Устойчивость к схеме базы: модули прайса автоматически определяют имена полей коллекций (защита от переименований).
- Защита интерфейса: кнопки не вызывают случайных переходов; защита от автоподстановки паролей и логинов браузером на странице пользователей.
- Основные коллекции базы: пользователи (role, is_active), клиенты, мастера (staff), услуги (price, duration_min, is_active), история цен услуг (service, price, valid_from, valid_to), прайс мастеров (master, service, price, duration_min, valid_from, valid_to), записи (включая payment_status, prepaid, balance, master_commission, buffer_after и др.).
- Серверные правила доступа: коллекция пользователей — только для admin; для услуг и истории цен рекомендованы правила «просмотр — все авторизованные, изменение — только admin».
- Страницы passport.html и commercial_proposal.html — статические документы без ограничения доступа (предназначены для печати и передачи); reset.html защищена проверкой роли; demo_seed.html доступна авторизованным пользователям.
14. Сознательно не реализовано (решения заказчика)
- Быстрое создание клиента из формы записи (принята логика «сначала карточка клиента»).
- Экспорт в Excel/CSV.
- Перетаскивание записей в календаре и изменение длительности перетаскиванием.
- Абонементы/курсы процедур со списанием.
- SMS/WhatsApp-напоминания клиентам.
- Учёт склада материалов.
Отложено на будущее:
- График отпусков/выходных мастеров с блокировкой дней в календаре.
15. Типовые сценарии работы (памятка пользователю)
- Новый клиент: Клиенты → «+ Новый клиент» → заполнить карточку → сохранить.
- Запись: Календарь → клик по свободной ячейке нужного мастера и времени (или «+ Новая запись») → выбрать клиента и зоны → проверить итог и время → сохранить.
- Оплата: в записи указать предоплату (статус оплаты подставится сам) или вручную выставить статус; долг виден точкой на карточке и счётчиком дня.
- Закрытие дня: календарь → кнопка завершённого статуса на карточках или статус в записи; выручка дня видна в статистике и на главной.
- Подорожание с определённой даты: Услуги и цены → «💰 Сменить цену» → новая цена и дата → старые записи остаются по старым ценам, новые считаются по новым (история сохраняется).
- Особые условия мастера: Прайс мастеров → добавить цену/длительность мастера с периодом действия.
- Конец дня: двойной клик по backup.bat → архив ушёл в папку бэкапов.
- Подготовка демо-показа: demo_seed.html → «✨ Создать все демо-данные» → показать календарь, отчёты, карточки; после показа при необходимости «🗑 Очистить демо-данные».
- Передача системы новому клиенту: backup.bat → reset.html → «☢️ Полный сброс» (слово СБРОС) → создать пользователей клиента → наполнить справочники или демо-данные → финальный backup.bat.
Документ подготовлен для передачи заказчику. При изменении функционала системы паспорт подлежит актуализации. Текущая версия: 1.1.