Приложения

Приложение это веб-интерфейс для людей: кабинет менеджера, экран склада, форма записи. Код пишет агент, собирает и раздаёт xflow. Приложение живёт в проекте и пользуется его базой и функциями. В проекте может быть несколько приложений, у каждого свой код, версии, адрес и уровень доступа.

Адрес

https://<id>--<организация>.xflowpage.ru

<id> выдаётся при создании, <организация> это короткое имя организации. Адрес не меняется при переименовании приложения или папки. Поисковикам приложения не показываются.

Добавить и собрать

xflow apps add <папка> создаёт приложение, кладёт стартовый шаблон в apps/<папка> и печатает адрес. xflow apps --json выводит приложения проекта с id.

xflow deploy apps/<папка> -m "что изменилось"

Платформа проверяет исходники, собирает приложение в чистом окружении и сохраняет новую версию. Если проверка не прошла, сборка не начинается, а агент получает список нарушений с файлами и строками. Локальная сборка на платформу не попадает.

Версии

Посетители видят одну версию, живую. Новая сборка не показывается, пока её не опубликуют, кроме самой первой сборки нового приложения: она публикуется сама.

Что хранится	Сколько
Сборки с файлами, к которым можно вернуться	три последних успешных и живая
История сборок	30 последних
Исходники ревизий	пока их сборка в истории, и 10 последних

xflow deployments выводит сборки. Сборка без файлов помечена no pages: на неё уже не вернуться. Код, который нельзя потерять, держите в своём git.

Публикация и откат

Публикация переключает адрес на выбранную сборку без копирования файлов: за секунду и без пустого экрана.

Действие	Как
Опубликовать последнюю сборку	кнопка «Опубликовать» в шапке приложения или xflow publish в папке приложения
Вернуть прежнюю сборку	xflow publish <номер> или xflow rollback <номер>
Без папки	--app <id> у тех же команд

Откат касается только приложения: функции и база проекта остаются текущими. Функции откатывают отдельно: xflow deploy functions --revision N.

Кто может открыть приложение

Уровень	Кто откроет	Тариф
Участники проекта	вошедшие в xflow люди с доступом к проекту	любой
Любой по ссылке	кто угодно, без входа	Старт и выше

На Бесплатном тарифе приложение работает только внутри xflow: прямой заход по адресу уводит на экран приложения в xflow. Старт добавляет прямой адрес и «Любой по ссылке».

Отдельного списка людей у приложения нет: его открывает каждый, кому открыт проект.

Уровень меняет человек: окно «Опубликовать» в шапке приложения, поле «Кто может открыть». Пересборка не нужна, агент уровень не меняет. При переключении на «Любой по ссылке» интерфейс показывает функции, которые станут открытыми, и просит подтвердить. На этом уровне платформа никого не узнаёт: вход, пользователей и права на данные делает само приложение через свои функции, см. Вход в публичном приложении.

Удаление

В интерфейсе, из меню приложения, с вводом названия. Удалить может автор проекта или Админ. Через CLI приложение не удаляется. Удаляются код, версии и адрес; база, функции и файлы проекта остаются. Корзины нет.