Частые вопросы

Что такое SPLINE360?

Это платформа единого окна проектной документации по объекту (CDE-like): материалы по проекту, участники, доступ и история. Панорамные 360° туры — важный модуль внутри платформы (загрузка, обработка, просмотр); он не исчерпывает весь продукт — по дорожной карте добавляются другие типы контента и сценарии.

Как открыть материалы проекта (в т.ч. тур)?

Часто вам передают ссылку вида /projects/КОД/, где КОД — идентификатор проекта в вашей инсталляции. В браузере откроется зона просмотра; для проектов с панорамами загрузится просмотрщик тура. Если проект не найден или доступ ограничен, система покажет понятное сообщение или предложит войти.

Нужен ли вход?

Для проектов «по ссылке» и «публичных» вход не требуется. Для приватных проектов нужна авторизация — вас перенаправят на страницу входа.

Какие роли есть в системе?

• Viewer — может открывать приватные проекты в режиме просмотра.
• Editor — может создавать проекты, загружать панорамы и редактировать тур.
• Admin — всё, что умеет Editor, плюс управление пользователями и ролями.

Где кабинет и загрузка?

Редактирование проектов — в кабинете (нужен вход). Там можно загрузить архив или JPG, настроить связи между станциями и план этажа.

Поддержка

Вопросы по развёртыванию и доступам — к администратору вашей инсталляции SPLINE360.

Как устроен полный pipeline (для операторов)?

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

1. Вход в систему. Пользователь с учётной записью (например, Editor или Admin) открывает /login/, вводит логин/пароль и получает сессионную cookie.
2. Создание проекта. В /admin/ создаётся проект, задаётся название и режим privacy: link, public или private.
3. Загрузка материалов. В кабинет загружается ZIP или набор JPG-панорам. Файлы ставятся в очередь обработки.
4. Фоновая обработка Worker. Worker забирает задачу из Redis, режет панорамы в cube-faces, создаёт превью и формирует data.json проекта.
5. Формирование тура. API читает сцены и создаёт/обновляет tour.json: станции, уровни, связи, координаты, повороты и калибровка масштаба.
6. Редактирование карты этажей. В admin можно: добавить уровни, загрузить подложку на выбранный этаж, расставить станции, задать масштаб по точкам A/B и длине в метрах, отредактировать связи между станциями.
7. Проверка во viewer. Пользователь открывает /projects/<code>/: переходы по hotspot, миникарта, переключение этажей, клики по станциям, линейка масштаба.
8. Контроль доступа. Для private проекта nginx запрашивает проверку у API: без валидной сессии доступ к /admin/ и private-ассетам не выдаётся.
9. Аудит действий. Ключевые операции (login/logout, загрузки, изменения проекта и ролей) записываются в журнал действий в PostgreSQL.
10. Публикация. Для клиентов отправляется ссылка на проект. Для режимов link/public просмотр доступен без входа, для private — только после авторизации.

Как быстро обновить существующий тур?

• Загрузите новые панорамы в тот же проект.
• Дождитесь завершения обработки в статусе загрузки.
• Проверьте связи и карту уровней в admin, при необходимости скорректируйте точки.
• Откройте viewer и проверьте переходы, ориентацию и масштаб.

Почему обработка может идти долго?

Обработка 360-панорам ресурсоёмкая: для каждой фотографии worker формирует превью и несколько кубических граней. На скорость влияют разрешение исходников, качество рендера, нагрузка CPU/RAM и очередь задач на сервере.

• Загрузка в браузере и обработка на сервере — это разные этапы.
• Сначала файлы загружаются в проект, затем ставятся в очередь Redis.
• После этого worker по очереди обрабатывает файлы и обновляет прогресс.
• Если часть файлов не прошла обработку, в статусе появятся ошибки.

Как ускорить обработку без заметной потери качества?

• Использовать сервер с запасом CPU/RAM (рекомендуется минимум 4 vCPU и 8 GB RAM).
• Не смешивать в одном пакете повреждённые или очень «тяжёлые» исходники.
• Загружать панорамы партиями, если проект очень большой.
• При необходимости администратор может настроить параметры worker под инфраструктуру.