Меню документации

Бэкенд и API

На этой странице

Бэкенд реализует бизнес-логику и предоставляет данные, необходимые интерфейсу. OwlMeans Common задаёт соглашения для сервисов, запросов и проверок доступа.

Библиотеки по назначению

Библиотека или стандартНазначениеПубличный пакет OwlMeans
FastifyОбслуживает HTTP API.@owlmeans/server-api
Ajv и расширения форматовПроверяют структурированные данные запросов и конфигурации.@owlmeans/entrypoint
Плагины Fastify CORS и HelmetКонтролируют источники браузерных запросов и поддерживают HTTP-заголовки, связанные с безопасностью.@owlmeans/server-api
Поддержка multipart в FastifyОбрабатывает поддерживаемые запросы на загрузку файлов.@owlmeans/server-api

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

Использование в проекте

  1. Опишите нужное поведение в спецификации или истории.
  2. Попросите агента следовать существующим в проекте соглашениям OwlMeans Common.
  3. Чтобы разобраться в зависимости, изучите документацию соответствующего публичного пакета.
  4. Опробуйте поведение в предварительном просмотре и проверьте правила доступа.

Опишите, какие пользователи вправе создавать или изменять контакт. Попросите агента вместе с формой реализовать проверку данных и прав доступа, затем протестируйте как допустимый запрос, так и запрос, который должен быть отклонён.

API — способ, которым интерфейс просит сервер что-либо сделать. Валидация запроса проверяет его структуру; авторизация проверяет, вправе ли отправитель совершить это действие.

Об архитектуре приложения читайте в OwlMeans Tech Concept, а о работе со средой агента — в руководстве по продолжению разработки с другим агентом.

Пример приложения

Категория: CRM и управление клиентами. Пример: CRM для небольшой команды, где контакты закреплены за ответственными сотрудниками, а руководитель имеет доступ к ним.

Названия и товарные знаки

Названия Fastify, Ajv и связанные с ними знаки принадлежат соответствующим владельцам или сопровождающим проектов. Упоминания служат для обозначения продуктов, стандартов или примеров исходного кода. Документация OwlMeans не подразумевает спонсорства или одобрения со стороны этих владельцев.