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

Как открыть тур?

Вам передают ссылку вида /projects/КОД/, где КОД — номер проекта. Откройте ссылку в браузере: загрузится просмотрщик панорам.

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

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

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

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

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

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

Поддержка

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

Как устроен полный pipeline в SPLINE360?

Ниже — пошаговый сценарий от загрузки исходников до просмотра тура пользователями.

1. Вход в систему. Администратор открывает /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 под инфраструктуру.