Projects

Projects - это каталог блокчейн-сетей, протоколов и dApp-интеграций, из которых Web3alert умеет собирать события и по которым пользователи могут создавать подписки.

В Next-версии проекта Project больше не является просто "сетью в списке". Это контейнер для всей публичной и технической конфигурации интеграции:

• метаданные проекта: название, описание, теги, иконки, обложка и внешние ссылки;
• Triggers: технические правила, которые описывают, какие события читать из data source, как их фильтровать, чем дополнять и в какой output преобразовывать;
• Templates: пользовательские сценарии подписки поверх триггеров, сгруппированные в понятные темы;
• Subscriptions: подписки workspace, созданные на основе проекта;
• связи с Data sources: источниками блокчейн-данных, из которых триггеры получают события, блоки, вызовы или runtime metadata.

Обычный пользователь чаще всего открывает Projects, чтобы найти нужную сеть или протокол и создать подписку. Администратор или владелец проекта использует этот раздел для настройки всей поверхности интеграции.

Список проектов

Страница Projects показывает каталог доступных проектов.

Поиск

Поле поиска фильтрует проекты по нескольким признакам:

• видимое название проекта;
• fullname проекта;
• внутренний id;
• workspace или author;
• теги.

Поиск удобно использовать и для пользовательского сценария ("найти Polkadot Asset Hub"), и для админского ("найти проект по slug/fullname").

Only this workspace

Переключатель Only this workspace оставляет в списке только проекты текущего workspace.

Это важно, если у аккаунта есть доступ к нескольким пространствам: например, публичный marketplace может показывать много проектов, а workspace-фильтр позволяет увидеть только собственные приватные или рабочие интеграции.

Фильтр по тегам

Под строкой поиска отображаются доступные теги. Выбранный тег оставляет в каталоге только проекты с этим тегом.

Кнопка Clear filters сбрасывает поиск, workspace-фильтр и выбранные теги.

Карточка проекта

Каждая карточка проекта показывает:

• иконку проекта;
• название;
• служебную строку с датой создания или обновления;
• автора или workspace;
• короткое описание;
• количество триггеров;
• количество ваших подписок на этот проект;
• до четырех тегов;
• кнопку Open;
• кнопку Edit, если текущий пользователь может редактировать проект.

Если по текущим фильтрам ничего не найдено, каталог показывает пустое состояние с предложением сбросить фильтры. Если проектов нет вообще, показывается пустое состояние каталога.

Create New Project

Создание проектов доступно пользователям на тарифе Advanced и выше.

У каждого тарифа есть свой лимит на количество приватных проектов. Пока лимит не исчерпан, новый проект создается приватным по умолчанию: его можно спокойно настраивать, тестировать триггеры и готовить templates до публикации.

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

У проекта может быть один из трех уровней доступа:

• Private - рабочий режим для подготовки и закрытых интеграций. Проект виден только тем, у кого есть доступ к его workspace/account. Такой проект занимает место в лимите приватных проектов.
• Public - опубликованный проект marketplace. Его могут найти и открыть другие пользователи, а владелец продолжает управлять triggers, templates и metadata. Публичный проект не занимает место в лимите приватных проектов.
• Free - публичный проект, подписки на который доступны бесплатно всем пользователям Web3alert. Такой уровень обычно нужен проектам и командам, которые хотят оплатить доступ к нотификациям для своего комьюнити. Команда Web3alert также может периодически публиковать в Free важные или интересные проекты для всей аудитории сервиса.

Создание и редактирование проекта

Форма создания и редактирования управляет метаданными проекта. Она не создает сами триггеры и шаблоны, но задает то, как проект будет выглядеть в каталоге и на странице проекта.

После успешного создания нового проекта интерфейс открывает страницу проекта с введенными метаданными. Дальше владелец сам выбирает следующий шаг: импортировать triggers, создать trigger вручную, подготовить templates или использовать AI agent для настройки проекта.

Права и read-only режим

Если пользователь может управлять триггерами и шаблонами, но не является владельцем metadata, форма показывает состояние Metadata is read-only.

В таком режиме можно продолжать работать с технической частью проекта, если права это позволяют, но нельзя менять название, описание, картинки, теги и другие metadata-поля.

Title

Title - обязательное видимое название проекта.

Ограничение: до 32 символов.

Пока поле Name не было изменено вручную, Title автоматически используется для генерации Name.

Name

Name - обязательный slug проекта.

При создании он формируется из title:

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

При редактировании существующего проекта Name заблокирован, потому что он участвует в идентификаторах и ссылках.

Access level

Access level выбирается при создании или редактировании проекта и определяет, кто увидит проект в marketplace.

Для большинства владельцев проектов базовый путь такой: сначала проект создается как Private, затем при готовности переводится в Public. Режим Free означает, что проект остается публичным, но доступ к подпискам по нему для пользователей бесплатный. Обычно это платная услуга для команды проекта, которая хочет предоставить своему комьюнити бесплатные нотификации.

Short description

Short description - короткое описание для карточек и компактных мест интерфейса.

Поле опциональное. Ограничение: до 256 символов.

Description

Description - полное markdown-описание проекта для вкладки Overview.

Поле опциональное. Ограничение: до 4096 символов.

В редакторе есть floating toolbar для выделенного текста:

• Bold;
• Italic;
• Link;
• Heading;
• Code.

Tags

Tags помогают искать и фильтровать проекты.

Чтобы добавить тег, нужно ввести его в поле Add tag and press Enter и нажать Enter или кнопку добавления.

Правила тегов:

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

Links

Links - внешние ссылки проекта.

Каждая ссылка состоит из:

• Title;
• URL;
• кнопки удаления строки.

Кнопка + Add link добавляет новую строку. При сохранении учитываются только ссылки, где заполнены и title, и URL.

На странице проекта эти ссылки отображаются в блоке Useful links - полезные ссылки проекта.

Icon и Cover

Эти поля позволяют задать отдельные URL для визуальных элементов проекта:

• Icon - компактная иконка проекта. Она используется в каталоге, на странице проекта, в wizard-ах и как значение по умолчанию для notification avatar;
• Cover - широкая обложка для страницы проекта.

Для каждого поля можно выбрать способ заполнения:

• URL - вручную вставить ссылку на изображение;
• Upload - загрузить файл через Web3alert.

В режиме Upload файл выбирается отдельно для каждого поля. Если загрузить новый Icon или Cover, он заменит предыдущее изображение этого же типа после сохранения проекта.

Ограничения для upload:

• форматы: jpg, jpeg, png, webp;
• максимальный размер файла: 5 MB.

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

Delete project

При редактировании существующего проекта владелец может удалить проект через delete action. Перед удалением показывается подтверждающий диалог.

Удаление проекта - опасная операция: проект связан с триггерами, templates и подписками, поэтому ее стоит использовать только когда проект действительно больше не нужен.

Быстрые действия

Набор быстрых действий зависит от вкладки и прав пользователя:

• на Overview: Edit metadata, если пользователь может редактировать metadata;
• на Subscriptions: Create subscription, если пользователь может управлять подписками текущего workspace;
• на Triggers: Import triggers и Add trigger, если пользователь может редактировать проект;
• на Templates: Add template, если пользователь может редактировать проект; Subscribe доступен у валидных templates с topics.

Overview

Вкладка Overview показывает пользовательское описание проекта.

Основные блоки:

• About - полное markdown-описание из metadata;
• Project details - количество триггеров, количество ваших подписок, project id, дата создания и дата обновления;
• Tags - теги проекта;
• Useful links - полезные внешние ссылки проекта.

Если URL ресурса начинается с http://, https://, mailto: или tel:, ссылка используется как есть. В остальных случаях интерфейс добавляет https://.

Subscriptions

Вкладка Subscriptions показывает подписки активного workspace, связанные с этим проектом.

Это тот же набор подписок, который доступен в большом разделе Subscriptions, но здесь он сразу отфильтрован по текущему проекту.

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

Triggers

Вкладка Triggers показывает таблицу триггеров проекта.

В режиме просмотра можно открыть trigger details. В режиме редактирования владелец может:

• выбрать один или несколько триггеров;
• удалить выбранные триггеры;
• открыть редактирование конкретного триггера;
• создать новый триггер через Add trigger;
• массово сгенерировать триггеры через Import triggers.

Templates

Вкладка Templates показывает templates проекта.

Template - это пользовательская оболочка над триггерами: она группирует inputs, topics и rules так, чтобы пользователь мог создать подписку без знания внутренней trigger-конфигурации. Подробнее templates описаны в разделе Templates.

В списке templates отображаются:

• title;
• key/id;
• description;
• количество topics;
• предупреждение Needs review, если template имеет issue;
• действия Edit и Delete, если пользователь может редактировать;
• Subscribe, если template валиден и содержит topics.

При нажатии Subscribe интерфейс открывает создание подписки с выбранным project/template/topic. Если у template есть selectedByDefault topics, они выбираются автоматически; иначе берется первый доступный topic.