mirror of
https://ghfast.top/https://github.com/aeroxw/tick-stock-panel.git
synced 2026-09-12 14:24:15 +08:00
kevin9327
5d0f1cba79
冷路径只校验了「非空且 < 哨兵」, 维表 limit_up 为 0 (数据源未提供该字段 的占位值) 会被当成权威涨停价, 使「raw_close >= 0 - 0.005」恒成立 —— 当日 所有标的进涨停名单、连板数一路累加; 跌停侧反过来永远判不出跌停。实时路径 _compute_limit_signals_today 已有 >0 守卫, 冷路径补齐同一守卫。
319 lines
10 KiB
Python
319 lines
10 KiB
Python
from __future__ import annotations
|
|
|
|
from datetime import date
|
|
|
|
import numpy as np
|
|
import polars as pl
|
|
import pytest
|
|
|
|
from app.api import kline
|
|
from app.backtest.matrix import load_market_data_matrix_from_parquet
|
|
from app.indicators import pipeline
|
|
from app.price_limits import (
|
|
numpy_limit_price,
|
|
numpy_price_limit_matrix,
|
|
polars_is_risk_warning_name,
|
|
polars_limit_price,
|
|
polars_price_limit_pct,
|
|
price_limit_pct,
|
|
)
|
|
|
|
|
|
@pytest.mark.parametrize(
|
|
("symbol", "trade_date", "is_st", "expected"),
|
|
[
|
|
("600001.SH", date(2026, 7, 3), True, 0.05),
|
|
("600001.SH", date(2026, 7, 6), True, 0.10),
|
|
("000001.SZ", date(2026, 7, 3), False, 0.10),
|
|
("300001.SZ", date(2026, 7, 3), True, 0.20),
|
|
("688001.SH", date(2026, 7, 3), True, 0.20),
|
|
("689001.SH", date(2026, 7, 3), True, 0.20),
|
|
("830001.BJ", date(2026, 7, 3), True, 0.30),
|
|
],
|
|
)
|
|
def test_scalar_price_limit_rules(symbol, trade_date, is_st, expected):
|
|
assert price_limit_pct(
|
|
symbol,
|
|
trade_date,
|
|
is_risk_warning=is_st,
|
|
) == pytest.approx(expected)
|
|
|
|
|
|
def test_polars_and_numpy_price_limit_rules_match():
|
|
dates = [date(2026, 7, 3), date(2026, 7, 6)]
|
|
symbols = ["600001.SH", "300001.SZ", "689001.SH", "830001.BJ"]
|
|
names = ["*st主板", "*ST创业", "科创ST", "北交ST"]
|
|
panel = pl.DataFrame({
|
|
"date": [value for value in dates for _ in symbols],
|
|
"symbol": symbols * len(dates),
|
|
"name": names * len(dates),
|
|
}).with_columns(
|
|
polars_is_risk_warning_name(pl.col("name")).alias("is_st")
|
|
).with_columns(
|
|
polars_price_limit_pct(
|
|
pl.col("symbol"), pl.col("date"), pl.col("is_st"),
|
|
).alias("limit_pct")
|
|
)
|
|
polars_values = panel["limit_pct"].to_numpy().reshape(len(dates), len(symbols))
|
|
numpy_values = numpy_price_limit_matrix(dates, symbols, names)
|
|
np.testing.assert_allclose(polars_values, numpy_values)
|
|
|
|
|
|
def test_polars_and_numpy_limit_prices_use_identical_half_up_rounding():
|
|
previous = np.array([18.90, 10.00], dtype=np.float64)
|
|
limits = np.array([0.05, 0.10], dtype=np.float64)
|
|
frame = pl.DataFrame({"previous": previous, "limit": limits})
|
|
|
|
for up in (True, False):
|
|
polars_values = frame.select(
|
|
polars_limit_price(
|
|
pl.col("previous"), pl.col("limit"), up=up,
|
|
).alias("price")
|
|
)["price"].to_numpy()
|
|
numpy_values = numpy_limit_price(previous, limits, up=up)
|
|
np.testing.assert_allclose(polars_values, numpy_values)
|
|
assert numpy_limit_price(previous, limits, up=False)[0] == pytest.approx(17.96)
|
|
|
|
|
|
def test_matrix_uses_date_specific_st_limits_across_change(tmp_path):
|
|
root = tmp_path / "market"
|
|
rows = [
|
|
(date(2026, 7, 2), 10.0),
|
|
(date(2026, 7, 3), 10.5),
|
|
(date(2026, 7, 6), 11.03),
|
|
]
|
|
for trade_date, close in rows:
|
|
partition = root / f"date={trade_date.isoformat()}"
|
|
partition.mkdir(parents=True)
|
|
pl.DataFrame({
|
|
"symbol": ["600001.SH"],
|
|
"date": [trade_date],
|
|
"open": [close],
|
|
"high": [close],
|
|
"low": [close],
|
|
"close": [close],
|
|
"raw_close": [close],
|
|
"volume": [1000.0],
|
|
}).write_parquet(partition / "part.parquet")
|
|
|
|
market = load_market_data_matrix_from_parquet(
|
|
root,
|
|
rows[0][0],
|
|
rows[-1][0],
|
|
field_columns={"raw_close", "price_limit_pct"},
|
|
instruments=pl.DataFrame({
|
|
"symbol": ["600001.SH"],
|
|
"name": ["*ST主板"],
|
|
}),
|
|
cache_root=tmp_path / "cache",
|
|
)
|
|
np.testing.assert_allclose(
|
|
market.field("price_limit_pct")[:, 0],
|
|
np.array([0.05, 0.05, 0.10], dtype=np.float32),
|
|
)
|
|
assert market.limit_up_locked[:, 0].tolist() == [0, 1, 0]
|
|
|
|
|
|
class _InstrumentRepo:
|
|
def get_instruments_asset(self, asset_type: str) -> pl.DataFrame:
|
|
assert asset_type == "stock"
|
|
return pl.DataFrame({
|
|
"symbol": ["600001.SH"],
|
|
"limit_up": [10.88],
|
|
"limit_down": [8.90],
|
|
})
|
|
|
|
|
|
def test_minute_price_limit_prefers_authoritative_prices_only_today(monkeypatch):
|
|
today = date(2026, 7, 18)
|
|
monkeypatch.setattr(kline, "cn_today", lambda: today)
|
|
current = kline._get_price_limit_info(
|
|
_InstrumentRepo(), "600001.SH", today, "stock", "*ST主板",
|
|
)
|
|
historical = kline._get_price_limit_info(
|
|
_InstrumentRepo(), "600001.SH", date(2026, 7, 3), "stock", "*ST主板",
|
|
)
|
|
|
|
assert current == {
|
|
"rate": 0.10,
|
|
"limit_up": 10.88,
|
|
"limit_down": 8.90,
|
|
"source": "instrument",
|
|
}
|
|
assert historical == {
|
|
"rate": 0.05,
|
|
"limit_up": None,
|
|
"limit_down": None,
|
|
"source": "rule",
|
|
}
|
|
|
|
|
|
def _daily_limit_rows(current_close: float) -> pl.DataFrame:
|
|
return pl.DataFrame({
|
|
"symbol": ["600001.SH", "600001.SH"],
|
|
"date": [date(2026, 7, 17), date(2026, 7, 20)],
|
|
"open": [10.0, current_close],
|
|
"high": [10.0, current_close],
|
|
"low": [10.0, current_close],
|
|
"close": [10.0, current_close],
|
|
"raw_close": [10.0, current_close],
|
|
"raw_high": [10.0, current_close],
|
|
})
|
|
|
|
|
|
@pytest.mark.parametrize(
|
|
("instrument_as_of", "expected"),
|
|
[
|
|
(date(2026, 7, 17), False),
|
|
(date(2026, 7, 20), True),
|
|
(None, True),
|
|
],
|
|
)
|
|
def test_daily_limit_prices_require_matching_instrument_date(instrument_as_of, expected):
|
|
instrument_data = {
|
|
"symbol": ["600001.SH"],
|
|
"name": ["普通股"],
|
|
"limit_up": [10.90],
|
|
"limit_down": [9.10],
|
|
}
|
|
if instrument_as_of is not None:
|
|
instrument_data["as_of"] = [instrument_as_of]
|
|
|
|
result = pipeline.compute_limit_signals(
|
|
_daily_limit_rows(9.10),
|
|
pl.DataFrame(instrument_data),
|
|
needed={"signal_limit_down"},
|
|
)
|
|
|
|
assert result["signal_limit_down"][-1] is expected
|
|
assert "_instrument_as_of" not in result.columns
|
|
|
|
|
|
def test_daily_limit_prices_ignore_zero_placeholder_and_match_realtime():
|
|
"""维表涨跌停价为 0 (数据源未提供该字段的占位值) 时必须回退理论价。
|
|
|
|
直接采用 0 会让「raw_close >= 0 - 0.005」恒成立, 当日所有标的被判涨停,
|
|
连板数一路累加; 跌停侧反过来永远判不出跌停。实时路径
|
|
(_compute_limit_signals_today) 已有 >0 守卫, 冷路径必须同口径。
|
|
"""
|
|
instruments = pl.DataFrame({
|
|
"symbol": ["600001.SH"],
|
|
"name": ["普通股"],
|
|
"limit_up": [0.0],
|
|
"limit_down": [0.0],
|
|
"as_of": [date(2026, 7, 20)],
|
|
})
|
|
|
|
# 只涨 0.5%: 不是涨停
|
|
mild = pipeline.compute_limit_signals(
|
|
_daily_limit_rows(10.05),
|
|
instruments,
|
|
needed={"signal_limit_up", "consecutive_limit_ups"},
|
|
)
|
|
assert mild["signal_limit_up"][-1] is False
|
|
assert mild["consecutive_limit_ups"][-1] == 0
|
|
|
|
# 真涨停 11.00 = 10.00 x 1.1: 理论价兜底后仍须判出
|
|
sealed = pipeline.compute_limit_signals(
|
|
_daily_limit_rows(11.00),
|
|
instruments,
|
|
needed={"signal_limit_up", "consecutive_limit_ups"},
|
|
)
|
|
assert sealed["signal_limit_up"][-1] is True
|
|
assert sealed["consecutive_limit_ups"][-1] == 1
|
|
|
|
# 真跌停 9.00 = 10.00 x 0.9: 占位 0 不得让跌停漏判
|
|
floored = pipeline.compute_limit_signals(
|
|
_daily_limit_rows(9.00),
|
|
instruments,
|
|
needed={"signal_limit_down"},
|
|
)
|
|
assert floored["signal_limit_down"][-1] is True
|
|
|
|
# 与实时路径同一份维表同一结论
|
|
realtime = pipeline._compute_limit_signals_today(
|
|
pl.DataFrame({
|
|
"symbol": ["600001.SH"],
|
|
"date": [date(2026, 7, 20)],
|
|
"open": [10.05],
|
|
"high": [10.05],
|
|
"low": [10.05],
|
|
"close": [10.05],
|
|
"raw_close": [10.05],
|
|
"raw_high": [10.05],
|
|
"raw_low": [10.05],
|
|
"_prev_close_raw": [10.0],
|
|
"volume": [1000.0],
|
|
}),
|
|
instruments,
|
|
)
|
|
assert realtime["signal_limit_up"][0] is False
|
|
assert mild["signal_limit_up"][-1] is realtime["signal_limit_up"][0]
|
|
|
|
|
|
def test_realtime_limit_prices_ignore_stale_instrument_date():
|
|
today = date(2026, 7, 20)
|
|
rows = pl.DataFrame({
|
|
"symbol": ["600001.SH"],
|
|
"date": [today],
|
|
"open": [9.10],
|
|
"high": [9.10],
|
|
"low": [9.10],
|
|
"close": [9.10],
|
|
"raw_close": [9.10],
|
|
"raw_high": [9.10],
|
|
"raw_low": [9.10],
|
|
"_prev_close_raw": [10.0],
|
|
"volume": [1000.0],
|
|
})
|
|
instruments = pl.DataFrame({
|
|
"symbol": ["600001.SH"],
|
|
"name": ["普通股"],
|
|
"limit_up": [10.90],
|
|
"limit_down": [9.10],
|
|
"as_of": [date(2026, 7, 17)],
|
|
})
|
|
|
|
result = pipeline._compute_limit_signals_today(rows, instruments)
|
|
|
|
assert result["signal_limit_down"][0] is False
|
|
assert "_instrument_as_of" not in result.columns
|
|
|
|
|
|
def test_limit_down_recovery_uses_raw_low_under_later_ex_div():
|
|
"""除权事件之后重算历史时, 跌停翘板"曾触及跌停"必须用原始价 low 判断。
|
|
|
|
day2 (历史日): 原始 low 9.30 未触及跌停价 9.00, 不应触发翘板;
|
|
但 day3 除权 (ex_factor=2) 使 day2 前复权 low 变为 4.65,
|
|
若误用复权 low 对比原始口径跌停价会误报翘板。
|
|
day3 (除权日, 最新日不复权): 涨跌停基准切换为前复权昨收 4.825 → 跌停价 4.34,
|
|
原始 low 4.34 触及且收阳未封死 → 真翘板。
|
|
"""
|
|
raw = pl.DataFrame({
|
|
"symbol": ["600001.SH"] * 3,
|
|
"date": [date(2024, 1, 2), date(2024, 1, 3), date(2024, 1, 4)],
|
|
"open": [10.00, 9.60, 4.30],
|
|
"high": [10.10, 9.70, 4.45],
|
|
"low": [9.90, 9.30, 4.34],
|
|
"close": [10.00, 9.65, 4.42],
|
|
"volume": [10000.0, 10000.0, 10000.0],
|
|
"amount": [1.0e7, 1.0e7, 1.0e7],
|
|
})
|
|
factors = pl.DataFrame({
|
|
"symbol": ["600001.SH"],
|
|
"trade_date": [date(2024, 1, 4)],
|
|
"ex_factor": [2.0],
|
|
})
|
|
instruments = pl.DataFrame({
|
|
"symbol": ["600001.SH"],
|
|
"name": ["普通股"],
|
|
"float_shares": [1.0e8],
|
|
})
|
|
|
|
df = pipeline.compute_enriched(raw, factors=factors, instruments=instruments)
|
|
|
|
day2 = df.filter(pl.col("date") == date(2024, 1, 3))
|
|
assert day2["signal_limit_down_recovery"][0] is False
|
|
day3 = df.filter(pl.col("date") == date(2024, 1, 4))
|
|
assert day3["signal_limit_down_recovery"][0] is True
|