API Service¶

Стек и зависимости¶

• Node.js + Koa 2
• MongoDB, Redis, ClickHouse, PostgreSQL
• Swagger UI (/doc) и swagger-jsdoc для схем

Основные функции¶

• Аутентификация и управление токенами.
• CRUD для пользователей, клиентов, категорий, подписок, постов.
• Расчёт расписаний и подготовка контента для бота.

Документация REST¶

Подробное описание эндпоинтов находится в файле api/docs/rest-api.md.

Тестирование¶

• Модульные тесты (npm run test:api) — используют Node Test Runner.
• Для Redis и внешних сервисов задействуются моки; TODO по усилению покрытий см. в Roadmap.

План развития¶

• Вынести общие модули в common/.
• Добавить e2e-тесты и тесты контрактов Swagger.