File size: 1,401 Bytes
590a501 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 | # 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`).
|