moex-vibe/README.md

MoexVibe

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

Tech Stack

• Backend: NestJS, TypeScript, OpenAPI (Swagger)
• Frontend: React, TypeScript, Vite, TanStack Query, lightweight-charts
• Docs: Docusaurus
• Infrastructure: Docker, docker-compose

Quick Start

# Install dependencies
npm install

# Start backend (http://localhost:3000)
npm run dev:backend

# Start frontend (http://localhost:5173)
npm run dev:frontend

Swagger UI: http://localhost:3000/api/docs

Docker

docker compose up --build

• Frontend: http://localhost:80
• Backend: http://localhost:3000

Tests

npm run test:backend
npm run test:frontend

Live MOEX integration checks are opt-in:

npm run test:integration -w apps/backend

Project Structure

apps/
  backend/     — NestJS API (single point of access to MOEX ISS)
  frontend/    — React SPA with Vite
  docs/        — Docusaurus documentation site
docs/
  features/     — SDD feature specifications and implementation plans
  epics/        — product epics
  inbox.md      — captured ideas and follow-ups
  roadmap.md    — planned epics and features