Тестовые доступы для просмотра админки (логин и пароль):

admin1.kazan@showcase-mt.demo

ShowcaseMT2026!

Тематика: CRM/ERP платформа для ведения бизнеса.

Целевая аудитория проекта: медицинские центры, стоматологии, салоны красоты в РФ.

Возраст проекта: новый, пре-релиз.

Домен: https://goodcode-app.ru (это демо-домен для демонстрации проекта, у проекта нет утвержденного бренда).

Кто создал проект: создавал проект Fullstack разработчик с целью создать настоящего конкурента для Yclients и Bitrix и запустить как собственный бизнес.

Участие владельца в развитие: проект находится в стадии кастомизации: продукт готов как движок, но нужно одеть в бренд, докрутить мелкие фишки во фронте, зарегестрировать как ИП/ООО и подключить все бизнес-API для настоящего внедрения (кассы, smsc и др). Нужна команда для его запуска: разработчики, юристы, дизайнеры, маркетологи.

Перспективы и планы развития на будущее: проект имеет современную архитектуру и легко масштабируется, запустить тестовых клиентов можно уже на данной стадии, движок абсолютно готов к эксплуатации. Нагрузка, бэкапы, тесты, всё налажено. CI/CD тоже.

ЛОГИКА ПРОДУКТА (SaaS)

======================

Dental Booking — облачная платформа (SaaS) для работы медицинских клиник, салонов красоты: клиенты записываются онлайн, персонал ведёт операции в браузере, данные каждой клиники разделены (мультитенантность). Один кодовый продукт и одна пользовательская поверхность; глубина возможностей в интерфейсе может следовать тарифному плану подписки.

ЧТО ДЕЛАЕТ ПРОДУКТ

------------------

• Привлечение и запись — публичные страницы и сценарий онлайн-записи в слоты расписания, лист ожидания и напоминания о возврате (recall), предоплата там, где включены платежи.

• Обслуживание визита — расписание врачей, услуги и прайс, записи, пациентская карточка и связанная документация и формы; внутренние задачи и контроль исполнения.

• Коммуникации — чат с пациентом в приложении, внутренний чат сотрудников, омниканал (каналы обращений), политики уведомлений; при необходимости — ИИ-настройки и работа с базой знаний для подсказок операторам.

• Коммерция и учёт — финансы, касса/коммерция, отчёты, скидки, учёт связанных с клиникой платёжных шлюзов.

• Маркетинг и удержание — лиды, маркетинговые кампании, воронка продаж, удержание — в рамках единого SaaS, а не отдельного «enterprise-модуля».

• Лояльность и повторные визиты — программы лояльности, семейные связи пациентов (где реализовано в коде).

• Администрирование клиники — филиалы (если у аккаунта несколько точек), роли и права, интеграции, встраиваемые сценарии (embed), экспорт данных, оформление и брендирование, договоры и согласия.

• Подписка на сервис — учёт коммерческой подписки клиники на платформу (оплата сервиса, а не только приём платежей от пациентов).

Смысловые потоки стыкуются через доменные события и фоновые задачи: из одного действия (например, запись или оплата) обновляются CRM, финансовые агрегаты и уведомления в пределах реализованной логики.

РАЗДЕЛЫ ПРИЛОЖЕНИЯ (ПО КОНТУРАМ ПОЛЬЗОВАТЕЛЯ)

---------------------------------------------

Публичный контур

Сайты и страницы до входа в систему: маркетинговая часть, выбор клиники/вход пациента, сценарий записи как гость, страницы успеха бронирования.

Приложение пациента

Одна зона SPA с маршрутами личного кабинета: сводка (лента), запись на приём, история обращений, лояльность, цифровые формы, чат с клиникой, профиль. Такой же набор может открываться в контексте конкретной клиники по короткой ссылке с идентификатором/слэгом. Поддерживается режим PWA для установки как приложения и офлайн-оболочки статики.

Кабинет клиники (администраторы и персонал)

Центральная операционная зона — маршруты под /admin с боковой навигацией (десятки тематических разделов), объединённые смыслом так:

Группа Примеры направлений

------------------------------- ---------------------------------------------------------

Расписание и запись Календарь, расписание врача, журнал записей, лист ожидания

Контуры пациента База пациентов, предоплата, связанные настройки

Специалисты и услуги Врачи, услуги, общее расписание

Задачи и совместная работа Задачи, внутренний чат, личный кабинет сотрудника, база знаний

CRM и маркетинг Лиды, маркетинг, удержание, воронка продаж, эскалации внимания

Коммуникации с внешним миром Каналы, омниканал (чаты, каналы, хранилище секретов интеграций), настройки ИИ для омниканала

Финансы и аналитика Финансы, коммерция, отчёты

Лояльность и формы Лояльность, конструктор/учёт форм

Документы и политика Соглашения, политики уведомлений, права и политики доступа

Настройки и расширения Клиники (точки), интеграции, виджет/встраивание, скидки, справочники, стилизация, наклейки/маркетинговые материалы, RAG-база знаний, экспорт данных

Администрирование доступа Администраторы, платёжный шлюз на стороне клиники, общие настройки, подписка на SaaS.

Кабинет поставщика платформы

Отдельный ограниченный контур для команды, обслуживающей SaaS (высокопривилегированный вход, отдельные маршруты): обзор и операции уровня платформы, очереди провижининга и сопутствующие сценарии. Это не отдельный «продукт для enterprise-установки», а служебная поверхность одного облачного сервиса.

ТЕХНОЛОГИЧЕСКИЙ СТЭК

Стек ориентирован на многопользовательскую клиническую платформу: асинхронный backend, реляционное хранилище, очереди, SPA и наблюдаемость в продакшене.

## Backend

- Python 3.11.

- FastAPI / Starlette / Uvicorn — REST и ASGI.

- SQLAlchemy 2 и asyncpg — асинхронный доступ к PostgreSQL.

- Alembic — версионируемая схема БД.

- Pydantic v2 и pydantic-settings — контракты API и типизированная конфигурация.

- Celery с Redis как брокером и backend результатов — отложенная обработка, расписание, outbox-доставка.

- Redis — также кэш отчётных представлений, rate limiting, коды авторизации и прочие короткоживущие данные.

- HTTP-клиенты для исходящих интеграций.

- Криптография и аутентификация — современные хэши паролей, JWT, TOTP для чувствительных ролей.

- Объектное хранилище по протоколу S3 — медиа и файлы.

- Метрики Prometheus — стандартный эндпоинт для скрейпинга.

## Данные и очереди

- PostgreSQL 16 — основной источник истины; конфигурация допускает повышенный лимит одновременных соединений под нагрузку от API, воркеров и регрессионных прогонов.

- Redis — логическое разделение индексов БД под приложение, брокер и результаты задач.

## Frontend

- React 18, TypeScript, Vite.

- Mantine — дизайн-система и компоненты.

- TanStack Query — кэш и синхронизация с сервером.

- React Router — единое SPA с зонами для публичного сайта, пациента, администратора клиники и платформы.

- PWA — офлайн-оболочка и кэш статики через Workbox.

- Vitest и Playwright на стороне фронта; браузерные сценарии дополнительно входят в общий контур Python-тестов.

## Внешние контуры

Интеграции включаются конфигурацией: без ключей и endpoint соответствующий модуль остаётся неактивным или деградирует в безопасный режим.

- Приём платежей — провайдер с вебхуками; разделение секретов и лимитов для пациентского контура и контура подписки платформы.

- Платёжные шлюзы на уровне клиники — несколько провайдеров, учётные данные в защищённом хранилище, маршрутизация в доменной логике.

- Уведомления — электронная почта, SMS, мессенджеры.

- OAuth для пациента — крупные провайдеры идентичности по региональным требованиям.

- Captcha — защита публичных форм.

- AI — вызовы к OpenAI-совместимому API; при отсутствии конфигурации допускаются безопасные заглушки для разработки и тестов.

## Качество и поставка\

- Poetry для Python, npm для фронта.

- GitHub Actions — автоматизированные проверки: тесты, сканирование уязвимостей зависимостей, утечек секретов, ссылок в документации, сборка контейнеров, опциональная публикация в публичный registry.

- Jenkins — альтернативный корпоративный pipeline с публикацией в приватный registry и выкладкой по политике заказчика.

- Docker — отдельные образы backend и статического frontend.

- Ruff, Black, mypy — стиль, формат и статическая типизация backend.

Актуальные версии пакетов задаются lock-файлами Python и npm в репозитории поставки.

Более подробная документация: https://drive.google.com/drive/folders/1Zxmt4LxIVs_SU1_oyUxDeETGEh9wZQAY?usp=drive_link