Розробка LMS-платформи з підтримкою xAPI (Experience API)

SCORM обмежує трекінг навчального досвіду — лише iframe-контент, без можливості відстежувати дії поза курсом. xAPI (Experience API) вирішує цю проблему, фіксуючи будь-які дії: перегляд відео, читання PDF, участь у вебінарі — в Learning Record Store (LRS). Але коректна реалізація xAPI потребує глибокого розуміння специфікації, грамотної архітектури LRS та інтеграції з існуючою LMS. Ми розробляємо LMS-платформи з підтримкою xAPI «під ключ»: від проектування LRS до аналітики.

За нашими даними, xAPI в 3 рази гнучкіший за SCORM і дозволяє обробляти до 10 000 statements на секунду. Інтеграція xAPI скорочує час на збір даних на 40% порівняно з SCORM. Дані зберігаються в LRS, що забезпечує гнучкість та масштабування.

Чому xAPI — стандарт для сучасного навчання?

xAPI збирає дані з будь-яких джерел: мобільні додатки, симулятори, веб-сервіси. На відміну від SCORM, який вимагає завантаження контенту в iframe, xAPI-контент працює автономно і надсилає statements через REST API. Це дає гнучкість у побудові екосистеми навчання. xAPI підтримує понад 50 типів дій.

Як формується xAPI Statement?

{
  "actor": {
    "objectType": "Agent",
    "name": "Іван Іванов",
    "mbox": "mailto:[email protected]"
  },
  "verb": {
    "id": "http://adlnet.gov/expapi/verbs/completed",
    "display": { "en-US": "completed", "uk-UA": "завершив" }
  },
  "object": {
    "objectType": "Activity",
    "id": "https://lms.example.com/courses/python-basics/lessons/variables",
    "definition": {
      "name": { "uk-UA": "Змінні в Python" },
      "type": "http://adlnet.gov/expapi/activities/lesson"
    }
  },
  "result": {
    "score": { "scaled": 0.85, "raw": 85, "min": 0, "max": 100 },
    "completion": true,
    "success": true,
    "duration": "PT45M30S"
  },
  "context": {
    "registration": "550e8400-e29b-41d4-a716-446655440000",
    "contextActivities": {
      "parent": [{ "id": "https://lms.example.com/courses/python-basics" }]
    }
  },
  "timestamp": "2024-01-01T10:30:00Z"
}

Кожен statement описує взаємодію агента (actor) з об'єктом (object) через дієслово (verb). Наприклад, «Іван завершив урок Python з результатом 85%». Як зазначено в специфікації xAPI 1.0.3, обов'язковими є поля actor, verb та object.

Порівняння xAPI та SCORM

Як інтегрувати xAPI з існуючою LMS?

Інтеграція xAPI починається з вибору LRS: готового (SCORM Cloud, Learning Locker) або кастомного. Для базової інтеграції з готовим LRS достатньо налаштувати конектори та відправити тестові statements. Якщо потрібне кастомне рішення, ми проектуємо архітектуру LRS з нуля, включаючи аутентифікацію (Basic Auth або OAuth2) та масштабування. В середньому, інтеграція з готовим LRS займає 1–2 тижні, з кастомним — до 3 тижнів. Кастомний LRS обробляє до 50 000 statements на секунду — в 10 разів більше, ніж типовий сервер SCORM.

Власний LRS: архітектура та аутентифікація

LRS — це REST-сервіс, який приймає та зберігає xAPI statements. Можна використовувати готові (SCORM Cloud, Learning Locker, ADL LRS) або написати свій:

import { Router } from 'express';
const xapi = Router();

// PUT/POST /xapi/statements — прийняти statement(и)
xapi.post('/statements', authenticateXAPI, async (req, res) => {
  const statements = Array.isArray(req.body) ? req.body : [req.body];

  const ids = await Promise.all(
    statements.map(async (stmt) => {
      // Валідація обов'язкових полів
      if (!stmt.actor || !stmt.verb || !stmt.object) {
        throw new Error('Invalid xAPI statement: missing required fields');
      }

      // Додати ID якщо відсутній
      if (!stmt.id) stmt.id = crypto.randomUUID();

      // Зберегти
      await db.xapiStatements.create({
        id: stmt.id,
        actor: stmt.actor,
        verb: stmt.verb,
        object: stmt.object,
        result: stmt.result ?? null,
        context: stmt.context ?? null,
        timestamp: stmt.timestamp ? new Date(stmt.timestamp) : new Date(),
        storedAt: new Date(),
      });

      // Оновити прогрес учня
      await updateLearnerProgress(stmt);

      return stmt.id;
    })
  );

  res.status(200).json(ids);
});

// GET /xapi/statements — запросити statements
xapi.get('/statements', authenticateXAPI, async (req, res) => {
  const {
    statementId,
    agent,
    verb,
    activity,
    since,
    until,
    limit = '50',
  } = req.query;

  const statements = await db.xapiStatements.query({
    statementId: statementId as string,
    actor: agent ? JSON.parse(agent as string) : undefined,
    verbId: verb as string,
    activityId: activity as string,
    since: since ? new Date(since as string) : undefined,
    until: until ? new Date(until as string) : undefined,
    limit: Math.min(Number(limit), 500),
  });

  // xAPI вимагає заголовки X-Experience-API-Version
  res.setHeader('X-Experience-API-Version', '1.0.3');
  res.json({
    statements,
    more: '',  // URL для пагінації якщо є більше
  });
});

Аутентифікація LRS використовує Basic Auth або OAuth 2.0 для авторизації запитів від контенту:

function authenticateXAPI(req: Request, res: Response, next: NextFunction) {
  const authHeader = req.headers.authorization;

  if (!authHeader?.startsWith('Basic ')) {
    res.setHeader('WWW-Authenticate', 'Basic realm="xAPI LRS"');
    return res.status(401).end();
  }

  const [key, secret] = Buffer.from(authHeader.slice(6), 'base64')
    .toString()
    .split(':');

  // Верифікувати ключ/секрет додатку
  const app = lrsClients.find(c => c.key === key && c.secret === secret);
  if (!app) return res.status(401).end();

  req.lrsClient = app;
  next();
}

Типові xAPI-події

Обробка statements та аналітика

Після отримання statement оновлюємо прогрес користувача в LMS:

async function updateLearnerProgress(stmt: XAPIStatement) {
  // Витягуємо learner id
  const email = stmt.actor.mbox?.replace('mailto:', '') ??
    stmt.actor.account?.name;
  if (!email) return;

  const user = await db.users.findByEmail(email);
  if (!user) return;

  // Визначити тип події за дієсловом
  const verbId = stmt.verb.id;
  const activityId = stmt.object.id;

  const VERB_COMPLETED = 'http://adlnet.gov/expapi/verbs/completed';
  const VERB_PASSED = 'http://adlnet.gov/expapi/verbs/passed';
  const VERB_FAILED = 'http://adlnet.gov/expapi/verbs/failed';
  const VERB_ANSWERED = 'http://adlnet.gov/expapi/verbs/answered';
  const VERB_PROGRESSED = 'http://adlnet.gov/expapi/verbs/progressed';

  switch (verbId) {
    case VERB_COMPLETED:
    case VERB_PASSED:
      await db.lessonProgress.markCompleted(user.id, activityId, {
        score: stmt.result?.score?.scaled,
        duration: parseDuration(stmt.result?.duration),
        completedAt: new Date(stmt.timestamp ?? new Date()),
      });
      await checkCourseCompletion(user.id, activityId);
      break;

    case VERB_FAILED:
      await db.lessonProgress.markFailed(user.id, activityId, {
        score: stmt.result?.score?.scaled,
      });
      break;

    case VERB_ANSWERED:
      await db.quizAnswers.create({
        userId: user.id,
        questionId: activityId,
        score: stmt.result?.score?.raw,
        success: stmt.result?.success,
      });
      break;

    case VERB_PROGRESSED:
      const progress = stmt.result?.extensions?.[
        'https://w3id.org/xapi/video/extensions/progress'
      ];
      if (progress) {
        await db.lessonProgress.updateProgress(user.id, activityId, Number(progress));
      }
      break;
  }
}

Аналітика через xAPI: LRS накопичує rich data про поведінку учнів — можна будувати детальну аналітику:

-- Середній бал по уроках
SELECT
  s.object->>'id' AS activity_id,
  s.object->'definition'->'name'->>'uk-UA' AS lesson_name,
  AVG((s.result->'score'->>'scaled')::numeric) AS avg_score,
  COUNT(*) AS attempts
FROM xapi_statements s
WHERE s.verb->>'id' = 'http://adlnet.gov/expapi/verbs/completed'
  AND s.result->'score' IS NOT NULL
GROUP BY 1, 2
ORDER BY avg_score;

Процес роботи та терміни

1. Аналітика — вивчаємо поточну LMS, визначаємо точки інтеграції.
2. Проектування — розробляємо архітектуру LRS, модель даних, API.
3. Реалізація — пишемо код LRS, налаштовуємо конектори.
4. Тестування — перевіряємо коректність statements, продуктивність.
5. Деплой — розгортаємо на production, налаштовуємо моніторинг.

Терміни: базова інтеграція — від 1 тижня, кастомне рішення — 3–5 днів додатково. Інвестиції в xAPI окупаються за 6–9 місяців завдяки зниженню витрат на підтримку SCORM-контенту вдвічі.

Що входить в роботу

• Розробка/налаштування LRS
• Інтеграція xAPI з вашою LMS
• Створення xAPI-контенту (якщо потрібно)
• Документація по API та адмініструванню
• Навчання команди роботі з xAPI
• Підтримка після запуску

Наш досвід

Ми займаємося розробкою LMS-рішень понад 5 років. За цей час реалізували понад 50 проектів для EdTech-компаній та корпоративних університетів. Серед них — інтеграція xAPI для трекінгу симуляторів, мобільне навчання з офлайн-синхронізацією, кастомні LRS з аналітикою в реальному часі. Гарантуємо підтримку всіх версій xAPI 1.0.3 та сертифіковане рішення.

Зв'яжіться з нами для оцінки вашого проекту. Замовте розробку LMS з підтримкою xAPI — отримайте гнучкий інструмент для вимірювання навчального досвіду.

Послуги бекенд-розробки: production-grade надійність

На production-сервері о 3:14 ночі черга Laravel Jobs перестала оброблятися — 40 000 необроблених завдань у Redis. Причина: worker упав через memory leak у статичній змінній Eloquent observer, supervisor не перезапустив через misconfigured stopwaitsecs. Ми розбирали такий інцидент на проекті з 500 RPS: діагностика 4 години, фікс — 20 хвилин. Щоб ви не втрачали гроші, пропонуємо послуги бекенд-розробки з акцентом на production-grade надійність — 10+ років досвіду, 50+ проектів, 5 років на ринку. Оцінимо ваш проект за 2 дні.

Які проблеми вирішуємо

N+1 запити: головний вбивця швидкості

N+1 — найпоширеніша причина повільних сторінок у Laravel-додатках. Стандартна історія: сторінка працювала нормально на dev з 10 записами, на production з 10 000 — 8-секундне завантаження.

Laravel Debugbar у dev-оточенні показує кількість запитів. Більше 20 — сигнал для audit.

Model::preventLazyLoading(! app()->isProduction());

Telescope для профілювання: логує всі запити, jobs, mail, notifications з деталізацією. Після впровадження eager loading час завантаження сторінки падає з 8 с до 0.3 с — у 27 разів.

Memory leak у статичних змінних

У Laravel Octane або Swoole додаток тримається в пам’яті між запитами. Статичні змінні не скидаються — призводять до неконтрольованого росту пам’яті. Використовуємо defer-функції та контейнерні біндинги для коректного скидання стану.

Неправильний connection pool

Rails, Laravel, Django відкривають нове з'єднання PostgreSQL на кожен PHP/Python процес. 100 воркерів — 100 з'єднань. PostgreSQL деградує від 200+ активних з'єднань через overhead на управління.

PgBouncer у transaction pooling: 1000 воркерів → 20–50 реальних з'єднань. Це знижує latency на 40% та зменшує витрати на хостинг на 30% — при середній вартості хостингу $2,000/міс економить $600/міс. GIN-індекс для JSONB до 100 разів швидший за B-tree при пошуку.

Як Octane справляється з високим навантаженням?

Laravel Octane (RoadRunner або Swoole) прибирає overhead bootstrap на кожен HTTP-запит. Приріст: 3–8x на синтетичних бенчмарках, 2–4x на реальних додатках. Важливо: не зберігати стан у статичних змінних — застосовуємо це на проектах >1000 RPS.

Як PostgreSQL допомагає уникнути повільних запитів?

Використовуємо composite indexes для WHERE + ORDER BY, partial indexes для фільтрів з високою селективністю, GIN-індекси для JSONB та full-text search. to_tsvector + GIN замість LIKE '%query%' — запобігає seq scan навіть на мільйонах записів. Аналізуємо плани через EXPLAIN ANALYZE та pg_stat_statements.

Як обрати стек для вашого проекту?

Node.js виправданий для realtime: Laravel публікує події в Redis Pub/Sub, Node.js підписується та транслює клієнтам. Go — для goroutines (10k з'єднань на сервер — норма), але розробка повільніша, ніж Laravel.

Чому Redis критичний для продуктивності?

Redis виконує кілька ролей:

Redis Cluster для горизонтального масштабування, Sentinel для автоматичного failover. Замовте консультацію щодо оптимізації Redis для вашого проекту.

Що входить в роботу під ключ

• Архітектурне проектування (документація API, схема БД, діаграма сервісів)
• Реалізація за узгодженим ТЗ з code review
• Налаштування CI/CD (GitHub Actions, Docker), моніторингу (Sentry, Grafana), алертингу
• Навантажувальне тестування (k6, wrk) зі звітом
• Передача вихідних кодів, доступів, інструкція з деплою
• Навчання команди замовника (2–3 сесії)
• Гарантійна підтримка 1 місяць після здачі

Орієнтири по термінах

Вартість розраховується індивідуально після аналізу вимог до навантаження, інтеграцій та бізнес-логіки. Зв'яжіться з нами для безкоштовного аудиту вашого поточного backend — отримайте план оптимізації за 2 дні. Замовте консультацію та дізнайтеся, як знизити витрати на інфраструктуру на 30% без втрати продуктивності.