yanwei99521
41e56376fa
feat(web): add THS stock associations API
2026-09-01 10:11:26 +08:00
GitHub
5a3ad15477
feat(web): /bars 迁移到 MacClient + 支持复权（issue #43）
...
Web 获取 K 线此前用 AsyncTdxClient.get_security_bars（标准协议不支持复权），
导致 REST API 无法取前复权/后复权数据。将 /bars（个股 K 线）迁移到
AsyncMacClient.get_stock_kline（MAC 协议，支持 NONE/QFQ/HFQ + QFQ 负价兜底），
保持旧输出契约不变（日线 date 列、分钟线 datetime 列、OHLC 顺序、无 float_shares），
新增 adjust 参数（默认 QFQ），MAC 主机不可用时自动回退标准 TdxClient。
⚠️ 半破坏性变更：/bars 默认复权从"不复权"改为 QFQ（前复权）。老调用方若需
不复权请显式传 ?adjust=NONE。输出 DataFrame 列名/顺序/字段与旧版完全一致
（_normalize_mac_df 规整），仅价格数值因复权变化。
改动：
- bars.py：/bars 改走 mac_client.get_stock_kline(adjust=...)，MAC 不可用回退
get_security_bars（无复权 + warning）；新增 _normalize_mac_df 规整输出契约；
新增 adjust 查询参数（默认 QFQ）。
- convert.py：period_times_from_category（KlineCategory→Period 映射，显式处理
YEAR 9→YEARLY 11、SEASON→QUARTERLY）+ adjust_from_str。
- deps.py：get_mac_client_optional（未连接返回 None，供回退判断）。
- schemas.py：AdjustEnum（OpenAPI 文档用）。
测试：新增 7 个（period_times 映射全表 + 不可映射值、adjust 转换、_normalize_mac_df
日线/分钟线/空 df）。全套 996 passed；ruff format/check + mypy 改动文件零错误。
不在本次范围：/bars/index（指数 K 线，MAC 另一套接口）、/minute、/transaction*
（MacClient tick_chart 语义不同，暂不迁移）。
2026-08-05 16:37:10 +08:00
GitHub and Claude
46c5d3cc05
fix(web): guard MAC client None + filter _raw bytes from Ex responses
...
- get_mac_client() now raises TdxConnectionError (503) when MAC client
is None, matching get_ex_client() behavior. Previously returned None
causing AttributeError (500) on all 12 MAC endpoints.
- _records_to_df_resp() filters out internal _raw: bytes fields from
Ex dataclass models. Previously asdict() included binary protocol
data that is not JSON-serializable and would cause 500 errors.
Co-Authored-By: Claude <noreply@anthropic.com >
2026-06-12 16:51:47 +08:00
GitHub and Claude
d17895e92b
feat(web): full Web API parity with CLI — 18 new endpoints (v1.10.2)
...
- Board analysis: list/members/belong/summary/ranking/change-ranking (6)
- Capital flow, symbol info, server info (3)
- Quote list, auction, unusual (3)
- Extended market: bars/quote/minute/transaction (4)
- Technical indicators: list + compute (2)
- Multi-client DI: AsyncMacClient + AsyncExTdxClient lifecycle
- 6 MAC enum converters, DictResponse, ComputeIndicatorsRequest schemas
- Web API endpoints: 22 → 40
Co-Authored-By: Claude <noreply@anthropic.com >
2026-06-12 16:46:48 +08:00
Justin Gu
9d7a9161f7
fix(web): remove TYPE_CHECKING guard for AsyncTdxClient in deps.py
...
The typing.cast(AsyncTdxClient, ...) evaluated AsyncTdxClient at
runtime, but the import was gated behind TYPE_CHECKING, causing
NameError in production. Direct import is safe here — web module
already depends on easy_tdx core.
2026-06-12 03:21:39 +08:00
Justin Gu
eb8a7a5675
feat(web): add FastAPI app factory, all routers, CLI serve command, and tests
...
- App factory with lifespan management and CORS middleware
- Market router: security list, quotes, market stat, fund-flow
- Bars router: kline, index kline, minute, transaction
- Finance router: xdxr, finance, company info, financial records
- Block router: block file parsing
- Chanlun router: POST /chanlun/analyze
- Realtime router: WebSocket /ws/realtime/{symbol}
- CLI: easy-tdx serve command
- 16 unit tests, all passing offline (no network)
2026-06-12 03:08:12 +08:00
yanwei99521