web_development/AGENTS.md

AGENTS.md

Cursor Cloud specific instructions

This is Personal Trading System V1 — a futures trading system with a Python/FastAPI backend and a Vue 3 frontend.

Services

Service	Directory	Dev Command	Port
Backend (FastAPI)	backend/	uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload	8000
Frontend (Vue 3)	frontend/	npm run dev	5173

The frontend Vite dev server proxies /api and /ws to the backend at port 8000.

Key commands

• Backend lint: cd backend && ruff check app/ tests/
• Backend tests: cd backend && python3 -m pytest tests/ -v
• Frontend build: cd frontend && npm run build
• Frontend lint: cd frontend && npx vue-tsc --noEmit (if TypeScript added)

Architecture notes

• Market data is simulated (no external exchange connection needed). 12 futures contracts are generated with realistic price movements on startup.
• Quantitative strategies (strategies/) run as async tasks; each evaluates signals every 2 seconds against in-memory kline data.
• The backend uses SQLite via aiosqlite for persistence — no external database setup required.
• WebSocket at /ws/market streams real-time market updates to the frontend.
• $HOME/.local/bin must be on PATH for uvicorn, pytest, and ruff to be found (already added to ~/.bashrc).