quant-trader-service

Clean P0 rebuild of the Trader-style strategy service.

Scope

This implementation follows the desktop design documents in /Users/zach/Desktop/app/trader:

• 00-操盘手Trader新策略服务概要设计-20260622.md
• 03-Trader服务详细设计说明书-20260623.md

P0 keeps the service in replay/shadow preparation mode:

• no real trading
• no old V3 latest/promoted path
• no SCALE_IN action surface
• no real App feedback by default
• no model training that can control live size

Implemented P0 Surface

• Spring Boot P0 service under com.quantai.trader
• Playbook YAML loading, validation, normalized JSON, SHA-256 definition hash
• MySQL 8 Flyway DDL for the P0 trader tables
• Core domain records for cycles, actions, entry plans, risk, evidence, feedback, samples, and reports
• State-machine guardrails for initial entry, planned legs, and management actions
• Dynamic position sizing from signal, execution quality, and risk scores
• Risk gate that records every allow/block decision
• Evidence appender and proxy-only training sample exporter
• Async replay-run registry and report contract
• MyBatis-Plus repositories aligned with quant-app-server
• Deterministic JSONL replay fixtures for accepted, rejected, blocked, and hard-fail paths
• Feedback endpoint that returns TRADER_FEEDBACK_DISABLED unless explicitly enabled
• Focused unit and MVC tests

Commands

mvn test
mvn spring-boot:run

The service uses MySQL through MyBatis-Plus. Configure the database with TRADER_DB_URL, TRADER_DB_USERNAME, and TRADER_DB_PASSWORD when the local defaults are not available.

Replay acceptance fixtures live under src/test/resources/replay-fixtures. They are deterministic P0 contract samples, not a profitability backtest corpus.

HTTP

GET  /api/trader/health
GET  /api/trader/playbooks
GET  /api/trader/playbooks/{playbookId}
POST /api/trader/replay/runs
GET  /api/trader/replay/runs/{runId}
POST /api/trader/replay/runs/{runId}/cancel
GET  /api/trader/replay/runs/{runId}/report
POST /api/trader/feedback

Remark: /api/trader/feedback is intentionally disabled in P0 unless trader.integration.http-feedback-enabled=true.