moex-vibe/apps/docs/docs/intro.md

slug

slug
/

MoexVibe

Веб-приложение для анализа ценных бумаг Московской биржи (MOEX).

Технологический стек

• Backend: NestJS, TypeScript, OpenAPI (Swagger)
• Frontend: React 18, TypeScript, Vite, TanStack Query v5, lightweight-charts v4
• Инфраструктура: Docker, docker-compose
• CI: Gitea Actions

Структура репозитория

moex-vibe/
├── apps/
│   ├── backend/     # NestJS API (единственная точка доступа к MOEX)
│   ├── frontend/    # React SPA
│   └── docs/        # Docusaurus-сайт документации
├── docs/
│   └── superpowers/
│       └── specs/     # Согласованные SDD-спецификации
├── docker/
│   ├── Dockerfile.backend
│   ├── Dockerfile.frontend
│   └── nginx.conf
├── docker-compose.yml
└── tsconfig.base.json

Ключевые принципы

• Backend — единственный клиент MOEX. Frontend никогда не обращается к MOEX напрямую.
• npm workspaces монорепозиторий: apps/backend, apps/frontend и apps/docs.
• Глобальный префикс API: /api/v1. Swagger: /api/docs.
• Ответы API обёрнуты в { data: T, meta: { fromCache, cachedAt } }.
• apps/docs — опубликованная документация; root docs хранит только SDD specs.