Сводка

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

  • Поддерживает три формы компонентов: локальные (одного приложения), упакованные (npm) и гибридные (оба варианта), с деревом решений для выбора подходящего варианта

  • Соблюдает архитектурные границы: компоненты владеют своими таблицами и функциями, тогда как приложение отвечает за аутентификацию, доступ к окружению и клиентские обертки

  • Обеспечивает полный рабочий процесс от планирования (таблицы, открытое API, поток данных) до реализации, подключения через app.use(...), и проверки через npx convex dev

  • Включает образцы для передачи аутентификации, передачи идентификаторов через границы, обработчики функций для обратных вызовов и клиентские обертки на основе классов для опубликованных компонентов

Convex Создать компонент

Создавайте повторно используемые компоненты Convex с четкими границами и небольшим API, ориентированным на приложение.

Когда использовать

  • Создание нового компонента Convex в существующем приложении

  • Выделение повторно используемой логики бэкенда в компонент

  • Создание сторонней интеграции, которая должна владеть своими таблицами и рабочими процессами

  • Упаковка функциональности Convex для повторного использования в нескольких приложениях

Когда не использовать

  • Единичная бизнес-логика, которая должна находиться в основном приложении

  • Тонкие утилиты, которым не нужны таблицы или функции Convex

  • Оркестрация на уровне приложения, которая должна оставаться в convex/

  • Случаи, когда достаточно обычной библиотеки TypeScript