Monorepo Overview

Структура каталогов

api/     # Koa REST API и фоновые задания
front/   # Vite + Vue админ-панель
bot/     # Бот и воркеры для доставки контента
common/  # Общие модули (утилиты, константы)
docs/    # Документация (MkDocs)

Workspaces

Проект использует npm workspaces, что позволяет: - Делить зависимости по пакетам и переиспользовать общие dev-инструменты. - Выполнять команды вида npm run <cmd> --workspace <pkg>. - Хранить единый lockfile.

Стандарты

  • Единый ESLint конфиг .eslintrc.cjs с поддержкой Node и Vue.
  • Changelog в формате day-by-day (CHANGELOG.MD).
  • Документация поддерживается через MkDocs (mkdocs.yml).

Связи между сервисами

  • front общается с api через REST (/api/v*).
  • bot обращается к api для получения контента и использует Redis для кэширования/очередей.
  • Общие константы планируется переносить в common (временно используются пакеты justewg-common).