Переезд с WordPress на Strapi 5 и Astro: как сервис для врачей сжал базу в 20 раз и поднял Lighthouse с 44 до 100Лонгрид · дайджест за 20 ноября
Кинематографичный натюрморт инженерного рабочего места с экраном максимальной оценки Lighthouse 100 и скетчбуком с архитектурной схемой миграции на Strapi 5 и Astro.
Лонгрид8 разделов≈ 34 мин

Переезд с WordPress на Strapi 5 и Astro: как сервис для врачей сжал базу в 20 раз и поднял Lighthouse с 44 до 100

Мобильный Lighthouse вырос с 44 до 100 баллов, база данных похудела с 1 ГБ до 50 МБ, а выручка по подпискам за год подскочила на 225% вместе с конверсией (+90%) и глубиной просмотра (+75%). Такой результат команда evilUnion получила не на синтетическом демо-проекте, а на живом платном сервисе для врачей после полного переезда с WordPress на связку Strapi 5 и Astro. Причём сработало это только при одном жёстком условии: перетащить вообще всё — статьи, клинические рекомендации, платные PDF-гайды, многосекционные курсы, активные подписки, промокоды и старые пароли — так, чтобы ни один врач после релиза не потерял доступ.

Подробную историю этого переезда в статье на Хабре разобрал fullstack-разработчик Артем из evilUnion (материал вышел в блоге Александра Бахарева). И это редкий кейс, где показана не витринная демка с тремя коллекциями, а вся кухня целиком: кэшируемый фронтенд, редактура без участия программистов, гибридный поиск, фоновые очереди, своя CRM, аналитика и раскопки в старой базе WordPress.

Почему старый WordPress упёрся в потолок

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

Во-первых, сайт стал откровенно тормозить на мобильных — 44 балла в Lighthouse Performance для контентного проекта, который живёт в том числе за счёт поискового трафика, это уже прямая потеря читателей. Во-вторых, тормозить начала сама админка: просто открыть и сохранить статью превращалось в тест на терпение. В-третьих, на старом сайте уже случались взломы — классическая история, когда на одном движке висит десяток сторонних плагинов. И четвёртое, самое неприятное для бизнеса: данным во встроенной CRM перестали верить. Цифры в соседних разделах не сходились из-за внутренних фильтров, логику которых было почти невозможно раскопать.

После переезда на новый стек просадки по скорости исчезли — это хорошо видно по замерам загрузки и навигации до и после миграции.

Время загрузки (мобильный Lighthouse) и переходов (Яндекс Метрика): WordPress vs Strapi 5 + Astro

На практике этот рывок ощущается сразу: страница перестаёт «думать» перед первым появлением текста, а клики по ссылкам внутри каталога отрабатывают почти мгновенно. Речь не о косметической оптимизации картинок, а о смене всей архитектуры: вместо тяжёлого монолита проект получил раздельный бэкенд на Node.js и лёгкий фронтенд, который не тащит в браузер лишний JavaScript.

Strapi 5 как единый бэкенд: схема данных и конвейер запроса

Когда слышишь «headless CMS» (система управления контентом без встроенных HTML-шаблонов — она хранит данные, даёт админку и отдаёт всё по API), кажется, что она нужна только для текстов. А под подписки, платежи и CRM придётся поднимать отдельный сервер. Команда evilUnion пошла другим путём и сделала Strapi 5 единственным бэкендом проекта.

Внутри Strapi работает обычный Node.js поверх фреймворка Koa, а в качестве базы поддерживаются PostgreSQL, MySQL, MariaDB и SQLite (в этом проекте выбрали PostgreSQL в Docker за nginx, полностью self-hosted, чтобы код и персональные данные оставались на своих серверах). Порог входа низкий: описываешь сущность через визуальный Content-Type Builder или руками в файле schema.json — это два взгляда на один и тот же конфиг.

{
  "kind": "collectionType",
  "info": {
    "singularName": "article",
    "pluralName": "articles"
  },
  "options": {
    "draftAndPublish": true
  },
  "attributes": {
    "title": { "type": "string", "required": true },
    "content": { "type": "richtext" },
    "category": {
      "type": "relation",
      "relation": "manyToOne",
      "target": "api::category.category"
    }
  }
}

После сохранения этой схемы Strapi сам создаёт таблицу в базе, рисует форму в админке и поднимает готовые REST-эндпоинты (GET, POST, PUT, DELETE для /api/articles). При этом всё закрыто по умолчанию: пока ты явно не разрешишь роли Public методы find и findOne, посторонний ничего не прочитает. Для внешних интеграций выдаются ограниченные API-токены, а пароли и служебные поля в ответы не утекают.

Интерфейс Content-Type Builder в Strapi 5 для настройки коллекций, полей и связей (Источник: docs.strapi.io)

Любой HTTP-запрос проходит в Strapi 5 по понятной цепочке: запрос → роут → middleware и policies → контроллер → сервис → Document Service API → база. Поясним роли звеньев без зауми. middleware и policies перехватывают запрос до основной логики (например, проверяют права или ставят заголовки). Контроллер разбирает параметры и отдаёт HTTP-ответ. Сервис держит переиспользуемую бизнес-логику, которую удобно дёргать не только из контроллера, но и из крона или фоновых очередей. А Document Service API (strapi.documents(...)) общается с базой по стабильному идентификатору documentId, который в пятой версии пришёл на смену числовым ID из четвёрки.

Чтобы база не превратилась в свалку, команда сразу разложила сущности по трём полкам. Всё самостоятельное, на что ссылаются другие записи (статьи, категории, преподаватели), ушло в коллекции. То, что живёт только внутри конкретной страницы (аккордеон в статье, блок «вопрос-ответ», карточка преподавателя), стало компонентами. А страницы курсов собрали через динамические зоны — это поле-конструктор, куда редактор сам добавляет разрешённые компоненты в нужном порядке.

Отдельное удачное решение — профиль пользователя. В Strapi есть встроенный плагин users-permissions, и велик соблазн навесить все поля подписчика прямо на его стандартную модель. Команда не стала этого делать и вынесла профиль в отдельную коллекцию api::profile.profile, связав её с подписками, тарифами, платежами, купленными гайдами, промокодами, сессиями и избранным. Итог: по любой записи мгновенно видно всю цепочку — кто купил, по какому тарифу, каким платежом и с каким промокодом.

Фронтенд на Astro: статика, кэшируемый SSR и React-острова

На витрину сайта вместо привычных Next.js или Nuxt поставили Astro. Главная фишка Astro — по умолчанию он отправляет в браузер чистый HTML вообще без клиентского JavaScript. Интерактивные виджеты подключаются точечно как «острова» (Astro Islands) на React, Vue или Svelte, так что браузеру не приходится скачивать и пережёвывать бандл всего приложения ради обычной текстовой статьи.

Архитектура островов Astro Islands — чистый HTML по умолчанию и точечная интерактивность (Источник: docs.astro.build)

Рендеринг настраивается на уровне каждой конкретной страницы через on-demand rendering. Разделы, которые меняются редко, собираются в статику один раз при билде — достаточно дописать одну строчку в начале файла. А вот статьи и каталоги обновляются постоянно, поэтому они рендерятся на сервере (SSR) и кэшируются в nginx.

---
// Редко меняющаяся страница собирается в статику при билде
export const prerender = true;
---

Такой файл превращается в готовый HTML ещё на этапе сборки и отдаётся с диска без участия Node.js. А вот для живых статей и каталогов используют серверный рендеринг с точечным островом интерактивности:

---
// Статья тянет данные из Strapi на сервере (SSR)
const { data } = await fetchApi({
  endpoint: 'articles',
  query: { filters: { slug } },
});
---
<ArticleHeader title={data.title} />
<ArticleBody content={data.content} />
<!-- React-остров загрузит JS только когда кнопка появится на экране -->
<FavouriteButton client:visible articleId={data.documentId} />

Здесь кроется красивая архитектурная хитрость, без которой общий кэш в nginx просто не сработал бы. На сервере Astro рендерит только открытую часть страницы, одинаковую для всех посетителей и поисковых роботов. Такой HTML можно безопасно закэшировать в nginx целиком и раздавать тысячам людей вообще без обращения к Strapi. А всё персональное — закрытые материалы по подписке, личный кабинет, статус избранного, уведомления — подгружается уже на клиенте. При этом директива client:visible у кнопки <FavouriteButton /> откладывает загрузку её React-кода до момента, пока пользователь доскроллит до самой кнопки.

Сверху добавили встроенный в Astro prefetch: по умолчанию он начинает тихо подгружать следующую страницу, как только курсор наводится на ссылку (и сам притормаживает на медленном интернете или в режиме экономии трафика). В связке с кэшем nginx это и дало ощущение «моментальных» переходов по сайту. А если редактор поправил опечатку и не хочет ждать истечения кэша, он просто жмёт кнопку сброса прямо в админке Strapi.

Редакционный процесс: CKEditor 5, живое превью и ловушка прав

Главная проверка любой CMS — перестанут ли редакторы дёргать разработчиков по каждой мелочи. В Content Manager Strapi 5 всё базовое уже на месте: таблицы записей с фильтрами, сортировкой и поиском, плюс Media Library с папками, обрезкой, alt-текстами и автоматической нарезкой картинок в разные размеры, чтобы мобильные не тянули тяжёлый оригинал.

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

А вот со встроенными редакторами текста Strapi (Markdown и Blocks) случилось классическое «ожидание vs реальность»: для медицинских статей с объёмными таблицами их возможностей не хватило. Вместо них подключили CKEditor 5 через плагин strapi-plugin-ckeditor и дописали поверх него четыре своих плагина под задачи редакции:

  • вставка медицинских меток УДД и УУР (уровни достоверности доказательств и убедительности рекомендаций в клинических документах);
  • скрытие фрагментов текста и картинок;
  • горячие кнопки со всплывающими пояснениями;
  • нормальная обработка клавиши Tab во вложенных списках.

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

Экран редактирования записи в Strapi 5 Content Manager с переключением Draft/Published и боковой панелью (Источник: docs.strapi.io)

Механизм Draft & Publish (черновик и опубликованная версия живут отдельно) пригодился даже для SEO-редиректов. Когда у материала меняется URL, старую запись не удаляют, а переводят в черновик и прописывают ей поле redirect_url. Фронтенд видит его и сам делает перенаправление — программист для смены адреса больше не нужен.

Чтобы редактор видел, как статья реально ляжет в вёрстку, в Strapi 5 включили штатный Preview. Он открывает живую страницу сайта прямо в iframe внутри админки с переключателем между черновиком и публикацией.

// config/admin.js — настройка встроенного превью в Strapi 5
preview: {
  enabled: true,
  config: {
    // Разрешаем обмен сообщениями с iframe только нашему домену
    allowedOrigins: [env('PREVIEW_URL')],
    async handler(uid, { documentId, status }) {
      const pathname = getPreviewPathname(uid, documentId);
      // Возврат null прячет кнопку Preview для служебных таблиц
      if (!pathname) return null;
      const base = `${env('PREVIEW_URL')}${pathname}`;
      return `${base}?token=${env('PREVIEW_SECRET')}&status=${status}`;
    },
  },
},

Фронтенд на Astro проверяет PREVIEW_SECRET и рендерит запись ровно теми же компонентами, что на проде, но в обход nginx-кэша. Рядом в правой панели карточки команда добавила две свои кнопки: «Открыть страницу» и «Обновить кэш».

Чтобы формы платных гайдов не раздувались в бесконечные простыни, подключили условные поля (conditions.visible в schema.json). Поле цены price и файл пробной версии появляются в интерфейсе только тогда, когда у гайда включён флаг isPremium.

"price": {
  "type": "decimal",
  "conditions": {
    "visible": {
      "==": [{ "var": "isPremium" }, true]
    }
  }
}

И вот здесь живёт одна очень тихая грабля Strapi, на которую легко наступить в продакшене. Когда ты добавляешь новое поле в schema.json, у супер-админа оно появляется сразу, а вот у кастомных ролей редакторов прав на него по умолчанию нет. Редактор открывает карточку и вместо цены видит заглушку No permissions to see this field. Права на каждое новое поле нужно выдавать вручную — забыть об этом проще простого. Пощёлкай переключатель и смени роль в макете ниже, чтобы увидеть, как ведут себя условные поля и эта ловушка в админке.

Интерактивный макет: условные поля и ловушка прав в Strapi 5

На этом простом примере сразу видно, почему после каждой миграции схемы стоит заходить в настройки ролей и проверять видимость новых полей глазами редактора, а не только под учёткой администратора.

Кастомный бэкенд: Koa, гибридный поиск Meilisearch, очереди BullMQ и своя админка

Когда базового CRUD перестаёт хватать, Strapi 5 не мешает писать обычный серверный код. В оригинальной статье Артем честно предупреждает в дисклеймере: все сниппеты ниже упрощены, чтобы показать саму механику инструментов Strapi, и в продакшен их нельзя копировать без валидации, проверки прав и защиты от гонок (например, счётчик просмотров в бою лучше обновлять атомарным SQL-инкрементом, а не связкой чтения и записи).

Вот как рядом со стандартными роутами статьи добавляется свой эндпоинт для подсчёта просмотров через createCoreController, createCoreService и strapi.documents:

Архитектурная изометрическая схема модульного бэкенда на Strapi 5 со связками контроллеров, гибридного поиска Meilisearch и фоновых очередей BullMQ.

// src/api/article/routes/custom.js
module.exports = {
  routes: [
    {
      method: 'POST',
      path: '/articles/:documentId/view',
      handler: 'article.view',
    },
  ],
};

// src/api/article/controllers/article.js
module.exports = createCoreController(
  'api::article.article',
  ({ strapi }) => ({
    async view(ctx) {
      const svc = strapi.service('api::article.article');
      await svc.incrementViews(ctx.params.documentId);
      ctx.status = 204;
    },
  })
);

// src/api/article/services/article.js
module.exports = createCoreService(
  'api::article.article',
  ({ strapi }) => ({
    async incrementViews(documentId) {
      const docs = strapi.documents('api::article.article');
      const article = await docs.findOne({ documentId });
      await docs.update({
        documentId,
        data: { views: (article.views ?? 0) + 1 },
      });
    },
  })
);

Поверх этого слоя легко навешиваются ещё три штатных механизма: Koa-middleware, хуки жизненного цикла (lifecycles) и встроенный планировщик cron из Server Configuration. Middleware подключается одной строкой в config/middlewares.js и умеет менять ответ уже после await next() — например, вешать Cache-Control на публичные GET-запросы статей. Lifecycles срабатывают автоматически при создании или правке записи (удобно считать время чтения по 200 словам в минуту), а крон по расписанию каждую неделю помечает десятку самых популярных материалов.

// src/middlewares/cache-headers.js — заголовки кэша после ответа
module.exports = (config, { strapi }) => {
  return async (ctx, next) => {
    await next();
    const isArticles = ctx.url.startsWith('/api/articles');
    if (ctx.method === 'GET' && isArticles && ctx.status === 200) {
      ctx.set('Cache-Control', 'public, max-age=60');
    }
  };
};

// src/api/article/content-types/article/lifecycles.js
const getReadingTime = (html = '') => {
  const words = html.replace(/<[^>]+>/g, ' ').split(/\s+/).length;
  return Math.ceil(words / 200);
};

module.exports = {
  beforeCreate(event) {
    const { data } = event.params;
    data.readingTime = getReadingTime(data.content);
  },
  beforeUpdate(event) {
    const { data } = event.params;
    if (data.content) {
      data.readingTime = getReadingTime(data.content);
    }
  },
};

// config/server.js — встроенный cron без отдельного сервиса
cron: {
  enabled: true,
  tasks: {
    '0 3 * * 1': async ({ strapi }) => {
      const svc = strapi.service('api::article.article');
      await svc.markPopular({ limit: 10 });
    },
  },
},

Отдельной задачей стал поиск. Врачи редко набирают точное название статьи — они вводят термины в другой словоформе, промахиваются по клавишам или описывают симптомы своими словами. Для этого подключили Meilisearch через официальный плагин strapi-plugin-meilisearch, который сам обновляет индекс при любой правке записи.

Настройка вышла хитрой, но чистой: в индекс подтягиваются вложенные аккордеоны через entriesQuery.populate, HTML очищается функцией stripHtml, заголовки приводятся к основе слова (stemText), а сверху подключается мультиязычная нейросеть-эмбеддер sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2. При параметре source: 'huggingFace' Meilisearch скачивает и крутит модель локально без платных внешних API.

// config/plugins.js — индексация статей и локальный эмбеддер
meilisearch: {
  config: {
    host: env('MEILISEARCH_HOST'),
    apiKey: env('MEILISEARCH_API_KEY'),
    article: {
      entriesQuery: {
        populate: { content: { populate: { accordion: true } } },
      },
      transformEntry({ entry }) {
        return {
          ...entry,
          contentPlain: stripHtml(entry.content),
          stemmedTitle: stemText(entry.title),
        };
      },
      settings: {
        embedders: {
          default: {
            source: 'huggingFace',
            model:
              'sentence-transformers/' +
              'paraphrase-multilingual-MiniLM-L12-v2',
          },
        },
      },
    },
  },
},

В результате поиск работает в гибридном режиме 50/50 (semanticRatio: 0.5): половина веса уходит на точные слова и защиту от опечаток, вторая половина — на смысловую близость. Глобальная строка поиска на сайте одним запросом опрашивает сразу несколько индексов, а поиск внутри конкретного раздела (скажем, только по гайдам) бьёт в один нужный индекс.

Следующий узел — фоновые очереди на BullMQ поверх Redis. Фронтенд шлёт на сервер поток событий: просмотры, раскрытия аккордеонов, скачивания гайдов, клики по баннерам. Если писать всё это в аналитическую базу синхронно прямо в HTTP-запросе, бэкенд быстро захлебнётся под нагрузкой. С BullMQ эндпоинт мгновенно складывает задачу в очередь и отпускает пользователя, а воркер спокойно разгребает её в фоне с тремя попытками повтора и нарастающей паузой.

// Эндпоинт ставит задачу в очередь и сразу отдаёт ответ
const queue = strapi.plugin('bullmq').service('queue').get('analytics');
await queue.add('track', event, {
  attempts: 3,
  backoff: { type: 'exponential', delay: 2000 },
});

// Воркер в фоне пишет события в ClickHouse
const workers = strapi.plugin('bullmq').service('worker');
workers.create(queue, async (job) => {
  await writeToClickHouse(job.data);
});

Через те же очереди крутятся тяжёлые выгрузки, пересчёт сегментов и отмена зависших платежей. А чтобы не гадать в консоли, что сейчас висит или упало, на отдельной странице сервера Strapi подняли веб-интерфейс Bull Board. Заодно закрыли документацию API: стандартные роуты описал официальный плагин OpenAPI/Swagger, а схемы для кастомных эндпоинтов команда дописала с помощью ИИ-агентов.

Наконец, допилили саму админку. Интерфейс Strapi написан на React и открывает Admin Panel API в файле src/admin/app.js. Поскольку доработки используют родную дизайн-систему Strapi, они не выглядят чужеродными заплатками. Через addEditViewSidePanel добавили правую панель с кнопками «Открыть страницу» и «Обновить кэш». А через injectComponent (в Strapi 5 этот метод переехал внутрь плагина content-manager) повесили кнопку «Поменять порядок» для перетаскивания категорий — готовый плагин из каталога пришлось выкинуть, потому что его приходилось настраивать отдельно под каждого администратора.

// src/admin/app.js — расширение интерфейса редактора и списка
export default {
  bootstrap(app) {
    const cm = app.getPlugin('content-manager');
    cm.apis.addEditViewSidePanel([ActionsPanel]);
    cm.injectComponent('listView', 'actions', {
      name: 'category-order-sort',
      Component: CategoryOrderSort,
    });
  },
};

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

Собственная CRM, конструктор сегментов и аналитика поверх того же API

Помнишь ту самую проблему со старой CRM в WordPress, где цифры в соседних вкладках не сходились? В новой архитектуре её вылечили радикально: написали отдельную CRM на React и TypeScript, у которой вообще нет своей базы данных. Она ходит в ровно тот же REST API Strapi, что и основной сайт. Один источник данных — никаких расхождений.

Всё, что обычно мучительно долго пилить в админских таблицах (серверная пагинация, фильтрация, сортировка, подгрузка связей через populate), Strapi отдал из коробки. Менеджеры настраивают нужные колонки под себя и выгружают любую выборку в Excel. Авторизация сотрудников работает через Users & Permissions, а кастомные роли с матрицей доступов по разделам лежат в обычной коллекции Strapi — новую роль можно завести прямо в интерфейсе без правки кода.

Любопытная деталь про разработку: фронтенд CRM команда собирала с помощью Claude Code. Заранее описали в Markdown типы данных, экраны и формат запросов к Strapi, разбили работу на этапы, и агент реализовывал их шаг за шагом с ведением журнала изменений. Выстрелило это благодаря единообразию API Strapi: формат фильтров и пагинации хватило описать в спецификации один раз, а дальше агент применял его ко всем таблицам подряд.

Самая вкусная часть CRM — конструктор сегментов. Маркетологи собирают аудитории вроде «врачи с активной подпиской, которая заканчивается через неделю» или «пользователи, у которых не прошло автосписание». Внутри больше 20 типов правил (статус подписки, специальность, посещённые страницы, события аналитики), любые связки AND и OR, причём поддерживаются и зарегистрированные врачи, и анонимные посетители.

Хранятся эти правила как JSON-дерево в коллекции сегментов. Свой язык запросов писать не пришлось: короткая рекурсивная функция пробегает по дереву и переводит почти все условия в стандартные фильтры $and и $or самого Strapi.

// Рекурсивный перевод JSON-дерева правил в фильтры Strapi
async function evaluateNode(node) {
  if (node.logic) {
    const filters = await Promise.all(
      node.conditions.map(evaluateNode)
    );
    return node.logic === 'AND'
      ? { $and: filters }
      : { $or: filters };
  }
  return evaluators[node.type](node);
}

const filters = await evaluateNode(segment.conditions);
const users = await strapi
  .documents('api::profile.profile')
  .findMany({ filters });

Попробуй пощёлкать правила и логику AND / OR в мини-конструкторе ниже — он показывает, как дерево из интерфейса превращается в готовый объект filters для Strapi и сразу отбирает подходящие карточки из демо-набора врачей.

Интерактивный макет: конструктор сегментов CRM и фильтры Strapi

В реальном сервисе сегменты пересчитываются в фоне каждые 30 минут через очередь BullMQ. Когда нужно массово записать результаты пересчёта в базу, Strapi не заставляет гонять тысячи одиночных запросов через ORM — под капотом есть прямой доступ к Knex.js (strapi.db.connection) для быстрой пакетной вставки. Готовые сегменты автоматически синхронизируются со списками рассылок в Unisender и тут же идут в рекламный модуль.

Сам рекламный модуль тоже живёт как обычная коллекция Strapi. Поддерживаются три формата — баннер в шапке, попап и баннер в личном кабинете. Креатив можно загрузить картинкой, HTML5-архивом или собрать во встроенном конструкторе (например, акцию со скидкой и кнопкой копирования промокода), сразу проверить в адаптивном превью под разные экраны и настроить таргетинг по сегментам, страницам и лимиту показов за сессию. На сайте работает один эндпоинт Strapi: он вычисляет сегменты посетителя, возвращает подходящие баннеры, а показы и клики улетают в очередь аналитики. Маркетологи запускают кампании за несколько минут без разработчиков.

Вся собранная в ClickHouse аналитика рисуется на дашбордах Yandex DataLens, встроенных прямо в экраны CRM. Чтобы не светить приватные ключи в браузере, подписанный JWT-токен для приватного встраивания (по документации DataLens — подпись PS256 и срок жизни до 10 часов) генерирует бэкенд Strapi.

Детектив с базой WordPress: разворот wp_usermeta и 5 сюрпризов в данных

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

WordPress устроен по модели EAV (Entity-Attribute-Value): почти весь контент свален в wp_posts с делением по post_type, а произвольные поля от десятков плагинов распиханы по таблицам wp_postmeta и wp_usermeta парами «ключ — значение». Чтобы просто собрать одного пользователя, приходилось разворачивать десятки строк SQL-пивотом:

-- Разворачиваем EAV-строки wp_usermeta в одну запись пользователя
SELECT
  u.ID,
  u.user_email,
  MAX(CASE WHEN um.meta_key = 'first_name'
    THEN um.meta_value END) AS first_name,
  MAX(CASE WHEN um.meta_key = 'telefon_lk'
    THEN um.meta_value END) AS phone,
  MAX(CASE WHEN um.meta_key = 'user_registration_select_1667036325'
    THEN um.meta_value END) AS status,
  MAX(CASE WHEN um.meta_key = 'user_registration_select_1667037133924'
    THEN um.meta_value END) AS specialty
FROM wp_users u
LEFT JOIN wp_usermeta um ON um.user_id = u.ID
GROUP BY u.ID;

Посмотри на эти ключи в запросе: понять, что user_registration_select_1667036325 означает статус пользователя, можно было только опытным путём, сверяя значения в базе с живым сайтом. За годы работы плагины ставились и удалялись, оставляя бесхозные таблицы без всякой документации. Когда этот мусор вычистили и разложили полезные данные по нормальным реляционным таблицам Strapi, база похудела в 20 раз — с 1 ГБ до 50 МБ.

Инженерный натюрморт процесса нормализации базы данных: хаотичные EAV-карточки WordPress трансформируются в компактную реляционную модель Strapi со сжатием с 1 ГБ до 50 МБ.

Но до чистого переноса пришлось разгрести пять вполне реальных аномалий, на каждую из которых писали отдельную обработку. Во-первых, одно и то же JSON-поле в разных строках могло быть нормальным JSON-объектом, строкой с вложенным JSON или строкой с задвоенными кавычками. Во-вторых, вместо пустых дат (NULL) в базе встречалось 0000-00-00. В-третьих, у части сущностей вообще отсутствовали связи по ID — купленные гайды и тарифы пришлось склеивать по текстовому названию. В-четвёртых, нашлись дубли пользователей с одинаковым email. И в-пятых, пароли хранились в разных форматах хэшей.

Перенос разбили на цепочку скриптов: сначала пользователи, потом тарифы, затем подписки и платежи, и в конце гайды, промокоды и реферальные ссылки. На каждом шаге скрипт сохранял словарь соответствий старых и новых ID, а старый идентификатор WordPress специально оставили в профиле Strapi — он пригодился для внешних интеграций.

Проверяли результат без мутных SQL-отчётов: менеджеры поддержки просто открывали перенесённые профили в новой админке Strapi. И впервые за долгое время увидели в одной карточке всё сразу — подписки, платежи, гайды, избранное, промокоды и сессии. Если врач писал, что у него что-то пропало, поддержка сама открывала профиль и разбиралась без тикета к разработчикам.

Чек-лист перед миграцией базы с WordPress

  • Снять карту всех meta_key в wp_usermeta и wp_postmeta и сверить загадочные ключи плагинов с реальными экранами сайта.
  • Проверить базу на нулевые даты 0000-00-00, дубли email и «битый» JSON с двойным экранированием до запуска импорта.
  • Найти сущности без связей по ID, которые придётся сопоставлять по текстовым названиям, и подготовить правила очистки.
  • Сохранять словарь old_id -> new_id на каждом шаге скрипта и оставить старый WordPress ID в профиле под внешние интеграции.
  • Прогнать выборочную проверку перенесённых карточек вместе со службой поддержки прямо в новой админке.

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

Своя авторизация, встроенный MCP-сервер и границы этого стека

От стандартной авторизации плагина users-permissions для конечных пользователей сайта команда тоже отказалась и собрала свою — на обычных роутах, контроллерах и сервисах Strapi поверх коллекции профиля. На то было четыре причины: профиль с десятками полей и связей удобнее держать в одной таблице; нужен лимит устройств на аккаунт, чтобы платную подписку не раздавали на десятерых; требовался вход через VK и Яндекс с привязкой к уже существующему аккаунту; и главное — нужно было проверять старые хэши паролей из WordPress, чтобы тысячи врачей вошли в обновлённый сервис без принудительного сброса пароля.

Из свежих фич самой платформы в кейсе отдельно отмечен встроенный MCP-сервер (Model Context Protocol — открытый протокол, через который ИИ-агенты вроде Claude или Cursor подключаются к внешним системам). В Strapi 5 он появился начиная с версии v5.47.0 и включается тремя строками в config/server.js:

// config/server.js — включение встроенного MCP-сервера Strapi 5
module.exports = ({ env }) => ({
  mcp: {
    enabled: true,
  },
});

После перезапуска и пересборки поднимается эндпоинт /mcp (Streamable HTTP). Важный нюанс из документации Strapi 5: для подключения агента нужен именно Admin API Token (обычные Content API токены сервер отклонит). Агент получает ровно те права, которые выданы этому токену — так ему можно поручить рутину вроде разбора сотни статей по категориям, не открывая доступ к платежам и пользователям.

Помимо всего, что пригодилось в этом проекте, в Strapi 5 из коробки лежат i18n для мультиязычности, вебхуки на изменение записей, официальный плагин GraphQL, Strapi CLI для прямого переноса данных с файлами между продом и стейджингом, а также провайдеры для выноса медиатеки в S3.

Конечно, у такой архитектуры есть своя цена. Вместо одного привычного WordPress-хостинга команде приходится держать и обновлять целый зоопарк: Node.js под Strapi, серверный Astro за nginx, PostgreSQL, Redis с BullMQ, Meilisearch, ClickHouse и связку с DataLens. Для небольшого блога, визитки или команды без опыта в бэкенд-инфраструктуре такой комбайн окажется очевидным перебором. Но когда подписочный сервис упирается в медленную админку, взломы и цифры, которым не верит собственный бизнес, единый бэкенд на Strapi 5 с быстрым фронтендом на Astro окупает сложность настройки с запасом.

Хочу подробный разборГолоса помогают выбрать, что разобрать подробно. За этот материал 0 голосов.
Источники · 20