TrackRecord NoLiquid - Monorepo

Hệ thống quản lý dữ liệu trading từ Binance, Bybit, OKX

Cấu trúc dự án

TrackRecord_Noliquid/
├── apps/
│   ├── backend/          # NestJS API Backend
│   └── frontend/         # Next.js Frontend
├── packages/
│   └── shared-types/     # Shared TypeScript types
├── python-pipeline/      # Python ETL Pipeline
│   ├── main.py
│   ├── collected_data.py
│   ├── api/
│   ├── models/
│   ├── importers/
│   └── README.md
├── package.json          # Root monorepo config
└── .env                  # Environment variables (tạo từ .env.example)

Quick Start

1. Setup Environment

# Copy .env.example thành .env và điền thông tin
cp .env.example .env
# Chỉnh sửa .env với thông tin thực tế của bạn

2. Setup Python Pipeline

cd python-pipeline
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Xem chi tiết trong python-pipeline/README.md

3. Setup Node.js Dependencies

# Cài đặt pnpm nếu chưa có
npm install -g pnpm

# Install tất cả dependencies
pnpm install

4. Chạy Backend (NestJS)

pnpm dev:backend
# Hoặc
cd apps/backend
pnpm start:dev

Backend sẽ chạy tại: http://localhost:3001

5. Chạy Frontend (Next.js)

pnpm dev:frontend
# Hoặc
cd apps/frontend
pnpm dev

Frontend sẽ chạy tại: http://localhost:3000

Scripts

Root Level

• pnpm dev:backend - Chạy backend development
• pnpm dev:frontend - Chạy frontend development
• pnpm build:backend - Build backend
• pnpm build:frontend - Build frontend

Python Pipeline

Xem python-pipeline/README.md để biết các lệnh Python.

Development

Backend (NestJS)

• Framework: NestJS
• Language: TypeScript
• Port: 3001 (có thể thay đổi trong .env)

Frontend (Next.js)

• Framework: Next.js 14 (App Router)
• Language: TypeScript
• Port: 3000

Python Pipeline

• Python 3.10+
• Xem chi tiết trong python-pipeline/README.md

Workspace

Dự án sử dụng pnpm workspaces để quản lý monorepo:

• apps/backend - NestJS backend
• apps/frontend - Next.js frontend
• packages/shared-types - Shared TypeScript types

Environment Variables

Tất cả biến môi trường được lưu trong file .env ở root directory.

• Python pipeline đọc từ root .env
• NestJS backend đọc từ root .env
• Next.js frontend đọc từ root .env (các biến NEXT_PUBLIC_*)

Xem .env.example để biết các biến cần thiết.

Documentation

• Python Pipeline: python-pipeline/README.md
• Backend API: (sẽ được thêm sau)
• Frontend: (sẽ được thêm sau)