Asmblyr Collaborative v0.1.0-beta.1 — первая публичная бета

Первая публичная бета Asmblyr Collaborative — открытой платформы для работы с данными PostgreSQL, совместного редактирования и подключения приложений через API. Лицензия MIT. Одна команда использует отдельную установку.

Что входит в версию

Данные и админка

• Коллекции, поля и связи M:1, 1:M и M:N; настройка форм, подписей записей и отображения полей.
• Таблицы с изменением ширины колонок, боковой редактор, вложенные фильтры, сохранённые виды, пакетные действия и история изменений.
• Поиск с приоритетом точного совпадения, начала названия и целых слов, в том числе при выборе связанных записей.
• Теги, даты и время, списки вариантов, файлы и зависимые поля форм.
• Подключение существующих PostgreSQL materialized views с настройкой отображения. Данные представлений доступны только для чтения в UI, API и генерируемом SDK.
• Дополнительные поля разрешённых системных коллекций через свёрнутый раздел управления коллекциями. Встроенные поля и сами системные таблицы защищены от изменения.

Команда и доступ

• Политики доступа на действия, поля и строки; отдельные права на разделы настроек.
• Приглашения по ссылке без обязательного SMTP, пароль, passkey, SSO/OIDC и управление сессиями.
• Профиль с именем, фамилией, описанием, часовым поясом и датами активности; загрузка аватара в настроенное файловое хранилище.
• Комментарии к записям и уведомления, присутствие участников в карточках и проверка конфликтов при сохранении изменённых полей.
• Сервисные аккаунты и ключи с датами выпуска, последней активности и счётчиком запросов; GitLab CI federation и OAuth/OIDC provider.

Интеграции и ассистент

• S3, AI-провайдер и интеграции настраиваются в админке. Настройки из окружения имеют приоритет и показываются только для чтения.
• Секреты подключений шифруются локальным ключом или Yandex KMS с федеративной аутентификацией.
• Опциональный AI-ассистент: потоковые ответы, отдельный ход работы, история сессий, новый диалог и сжатие старого контекста. Инструменты учитывают права пользователя.
• Личное подключение Google Drive и Sheets: поиск и чтение по запросу, изменения через предложение с явным подтверждением пользователя.
• Опциональный Sentry с отдельными настройками сервера и браузера; локальная диагностика API, включая p50/p95/p99.
• Переводы интерфейса и системных подписей, каталоги плагинов и API переводов; подписи пользовательских коллекций переводит владелец установки.

API, SDK и расширения

• HTTP API с обязательной авторизацией для защищённых операций.
• TypeScript SDK с fluent-запросами, типизацией коллекций и методов плагинов; CLI asm connect для входа через админку и генерации типов без специального компилятора.
• Kit для серверных обработчиков, коллекций, миграций, настроек, страниц и редакторов полей плагинов.

Docker-образ

UI и Core API поставляются в одном контейнере для Linux amd64. PostgreSQL и S3 подключаются отдельно. Все внутренние пакеты собираются из исходников репозитория; установка опубликованных SDK/Kit из npm для сборки образа не требуется.

docker pull ghcr.io/asmblyr/collaborative:0.1.0-beta.1

• Порт 3000 — интерфейс.
• Порт 3001 — прямой Core API для SDK, CLI и интеграций.
• Готовый Compose выполняет миграции отдельным запуском того же образа, затем запускает приложение.

Для установки возьмите Compose и шаблон окружения из этого тега. В приватном env-файле задайте внешний PostgreSQL 17+, setup token, публичный адрес UI и ключ шифрования согласно инструкции.

export ASMBLYR_IMAGE=ghcr.io/asmblyr/collaborative:0.1.0-beta.1
export ASMBLYR_ENV_FILE=/private/asmblyr.env
docker compose -f deploy/compose.yaml up -d --wait

Первый администратор создаётся на /setup. Compose по умолчанию публикует оба порта на 127.0.0.1; для внешнего интерфейса используется BIND_ADDRESS. Для внешней установки настройте HTTPS. Перед обновлением существующей установки сохраните резервную копию PostgreSQL и ключей шифрования.

Для закрепления точного образа используйте:

ghcr.io/asmblyr/collaborative@sha256:92745c4b6916a71b0bdabd82660cb6c6344a901f5d0937dba1b32b14cedf251c

Проверки

GitHub Actions этой версии завершился успешно. Проверены форматирование, типы, lint, тесты, документацию, production-сборку и архивы npm-пакетов в чистом проекте. Контейнер проверен с одноразовым PostgreSQL: 69 миграций, повторный запуск миграций, создание администратора, UI, прямой авторизованный API, корректная остановка и завершение контейнера при падении любого процесса.

Исходный коммит: 4c25c0f.

Границы беты

• Это предварительный релиз; стабильность всех будущих API/SDK-контрактов пока не гарантируется.
• Workspaces группируют коллекции, но не обеспечивают изоляцию разных компаний. Модель размещения — отдельная установка для команды.
• Materialized views создаются и обновляются внешним процессом; обычные SQL views и составные ключи в этом сценарии не поддерживаются.
• Собственные OAuth credentials и разрешение Google необходимы для подключения Google Workspace. Сам релиз не переводит OAuth-приложение Google в публичный режим.
• Плагины устанавливаются как пакеты; установки из UI и песочницы исполнения нет. Публичный MCP endpoint и отдельный движок процессов не входят в эту версию.
• Локальные процентили мониторинга ограничены окном наблюдений и сбрасываются при перезапуске.
• PostgreSQL, S3, HTTPS, резервные копии и развёртывание на сервере настраивает оператор.

SDK, CLI, Kit и contracts уже доступны отдельно как npm beta. Этот GitHub-релиз фиксирует версию приложения и контейнера и не перепубликует npm-пакеты.

Документация версии · SDK и CLI · Сообщить об ошибке