learning-service

Микросервис обучения портала: тесты, курсы с видео-уроками, гранулярные доступы, public-ссылки для кандидатов с email-валидацией.

Стек

• Go 1.25, chi/v5, pgx/v5, portal-common
• PostgreSQL (отдельная БД learning)
• MinIO (bucket learning-videos) — стрим-прокси, MinIO URL не светится клиенту (по аналогии с telephony record stream)
• Redis (eventbus, опционально) — публикация событий test.submitted / course.enrolled для portal-real-time
• k8s (namespace learning)

Сущности (см. migrations/001_init.up.sql)

Сущность	Назначение
tests	Тесты: title, passing_score, max_attempts, time_limit_sec, is_published, owner
test_questions	Вопросы (single / multi / text), points, explanation
test_answers	Варианты ответа с is_correct
test_attempts	Попытки прохождения: user_id ИЛИ public_token_id; score/passed
test_attempt_answers	Ответы пользователя в попытке (JSONB payload)
courses	Курсы: title, slug, cover, is_published
lessons	Уроки курса: markdown + video_key + опциональный test_id
lesson_progress	Прогресс «просмотрено / завершено» по урокам
access_grants	Гранулярный ACL: ресурс × subject (user/role/department/position/public)
public_tokens	Одноразовые ссылки кандидатам с intended_email + max_attempts

Permission-модель (на стороне portal-backend)

Permission	Кому	Что даёт
service.learning.access	Все активные сотрудники	Видимость раздела, прохождение назначенного
service.learning.author	HR, тренеры, лиды	Создание/редактирование своих материалов, public-ссылки
service.learning.admin	Admin	Глобальный доступ к чужим материалам, аналитика

См. portal-backend migrations/049_learning_permissions.up.sql.

Что реализовано в этой итерации

Backend:

• Skeleton сервиса (config, migrate, main, health)
• Migration 001_init.up.sql — полная схема всех 10 таблиц
• Tests: полный CRUD + вопросы/ответы + scoped-выдача (не-владельцу is_correct скрывается, explanation тоже)
• Заглушки notImplemented (501) для остальных эндпоинтов

Portal-backend:

• Migration 049_learning_permissions.up.sql — 3 пермы + грантование admin'у
• /api/learning/* — прокси под service.learning.access
• /public/learning/* — прокси без auth для кандидатов
• Services.LearningURL + env-переменная

Frontend:

• Route /learning/* под guard'ом service.learning.access
• Landing-страница с тремя картчоками
• /learning/tests — список + создание (полностью рабочий)
• /learning/courses, /learning/admin — заглушки LearningStubComponent
• Sidebar-пункт «Обучение» + sub-навигация

k8s: полный набор манифестов (namespace / configmap / secrets / postgres / deployment с HPA / service с portal-discovery annotations).

Что отложено в следующие итерации

Фича	План
Attempts (прохождение)	Repository + handler: start attempt → fetch questions → submit → auto-grade (single/multi) + manual review для text
Courses + Lessons CRUD	Repository + handler по тому же паттерну что Tests
Видео-стрим	MinIO wrapper в internal/storage/, handler /lessons/{id}/video/stream с Range-поддержкой; копировать stream-pattern из telephony
Access grants	Repository + handler + helper «может ли user X пройти ресурс Y» (учитывает user/role/department/position иерархию через portal-internal API)
Public tokens	Repository + handler: создание (HR из portal'а), resolve (email-match) — на портале и стрим в proxy без auth
Email-отправка	Через portal Kerio integration — handler выдаёт сформированный URL + текст письма HR'у, реальная отправка через portal
Frontend: конструктор теста	Drag-and-drop редактор вопросов/ответов (паттерн как kanban-column в tasks)
Frontend: плеер видео-урока	Кастомный плеер по аналогии с call-audio-player (blob URL, controlsList=nodownload)
Frontend: public-страница кандидата	Отдельный route /public/learning/test/:token без layout'а портала

Локальный запуск

docker compose up -d postgres minio        # или используй существующие
make tidy
DATABASE_URL=postgres://learning:learning@localhost:5432/learning?sslmode=disable \
  INTERNAL_API_KEY=devkey \
  MINIO_ENDPOINT=localhost:9000 \
  MINIO_ACCESS_KEY=minioadmin \
  MINIO_SECRET_KEY=minioadmin \
  make run

Deploy

kubectl apply -k k8s/
# Образ собирается в CI или вручную:
docker build -f Dockerfile.server -t localhost:30300/admin/learning-server:latest .
docker push localhost:30300/admin/learning-server:latest