| # 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`). | |