quant

Multi-module Spring Boot quant service:

• quant-model: entities/dto/enums/constants
• quant-persistence: mapper layer
• quant-market: market data sync services
• quant-factor: factor layer (scaffold)
• quant-backtest: backtest layer (scaffold)
• quant-app: Spring Boot entry module

Local run

Requirements:

• JDK 21
• Maven 3.9+
• Podman + podman-compose provider

Build:

mvn clean package

Run app only:

mvn -pl quant-app -am spring-boot:run

Deploy with Podman Compose

mvn clean package
podman compose -f compose.yml up -d --build

Stop:

podman compose -f compose.yml down

Remote debug (JDWP, port 5005):

JAVA_TOOL_OPTIONS='-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005' \
podman compose -f compose.yml up -d --build app

Then attach IDE remote debugger to localhost:5005.

AKShare HTTP (AKTools) service will be exposed on http://localhost:18080. Quick check:

curl 'http://localhost:18080/api/public/stock_zh_a_hist?symbol=600519&period=daily&start_date=20260101&end_date=20260210&adjust='

APIs

Sync all A-share stock codes from xueqiu (paged + throttled + retried):

curl -X POST 'http://localhost:8080/api/sync/stock-codes'

Proxy AKShare daily quotes via this service:

curl 'http://localhost:8080/api/akshare/stock-zh-a-hist?symbol=600519&startDate=20260101&endDate=20260210&adjust='

Sync config keys:

• quant.sync.stock-code.page-size
• quant.sync.stock-code.throttle-ms
• quant.sync.stock-code.max-retries
• quant.sync.stock-code.retry-backoff-ms
• quant.sync.stock-code.max-pages