16 KiB
宽基查询接口与分时展示接续
最新要求:日内成交及分时图只显示北京时间当日,不带入前一交易日;每日净额和60日趋势保持原口径。实施及发布见文末“仅显示当日”一节。前述09:40历史回看展示为当时状态,已被本次要求替代。
本轮范围
沿用顶部“宽基 -28.44/34.4%(日内 982.97)”及原悬浮框,接入上游查询接口补充分时历史;不新增顶部位置。每日净申购与60日趋势仍来自已有正式每日报告,信号流仍来自原发布流。
依据上游《21_ETF日内汇总查询接口与观测口径_20261112.md》及11月13日更新。接口根地址为155的18086端口,契约etf-intraday-query-1.0。
实际使用的接口
| 接口 | 用途与边界 |
|---|---|
/api/etf/v1/catalog |
每分钟确认真实可查日期;最新日不可用时显式报错,不悄悄用旧日当今日。 |
/api/etf/v1/intraday?trade_date=实际日期&interval_minutes=15&index_code=BROAD_ETF&view=latest_facts |
只取宽基整体15分钟事实;日期、视图、范围和粒度独立使用ETag,304复用本地缓存。 |
/healthz |
发布时检查查询服务与目录健康,不替代数据质量校验。 |
/api/etf/v1/daily、30分钟、单指数、ALL |
本轮不接入;每日已有正式消费,当前图只需整体15分钟,不重复取全池、合并或加权。 |
as_published |
本轮只读对照发布历史;不用于当前回看曲线,不把事实补齐冒充当时发布。 |
新增PMS本地只读/api/etf/intraday。独立pms-observation每60秒轮询,页面只读本实例文档缓存,不使上游超时阻塞页面或交易worker。请求连接2秒、读5秒,限制响应大小与读取预算,不自动重试或跟随重定向。失败保留带日期历史并明确更新暂不可用。原始版本不可覆盖,先归档再移动当前指针;拒绝旧修订、同修订变更、未来事实、跨日及沪深以外成分。
运行开关PMS_ETF_QUERY_ENABLED与地址PMS_ETF_QUERY_BASE_URL经ParamStore;密钥PMS_ETF_QUERY_API_KEY只注入独立观测容器并登记SECRET_KEYS,不进数据库、页面、日志或Git。
展示口径
直接使用上游已按成交额加权的方向比例及分类,不重复加权。日内累计取最后实际窗口累计值,不累计相加。金额完整与方向完整分别检查:方向不可用不遮蔽完整成交额,缺金额不补零或按覆盖率放大。固定16窗,午休留间距;缺失虚线、真实零值实心短横、未来窗口留空。悬停每根柱显示时段、偏买/偏卖/无明显方向和该窗成交额。
价量方向不等于真实资金流入流出、净申购赎回或买卖建议。查询事实可能盘后修复,始终trade_instruction=false、live_signal_eligibility=false。信号原始回执、时效和交易规则保持。
09:09至09:21核验与开发机验证
实际目录最新为11月12日,今日开盘前尚无11月13日窗口。11月12日latest_facts修订3,16个方向窗口完整,累计成交982.97217004667亿元,累计价量方向−0.01673169,不能描述为净流出16.45亿元。与as_published对照,后者仍存在缺方向,证明回看与当时可见信号需分开。
开发机86组隔离全量通过,包括新增27项查询专项及三道页面护栏。新HTTP依赖使用内存请求替身,禁止联网。1440、390和320宽度浏览器验收通过,单标签、16根柱、原抽屉入口正常,控制台无页面错误;另用隔离合成场景验证失败、缺失、真实零值和未来窗口。页面回放使用真实宽基只读响应,其他账户内容为样例,不是真实登录或交易验收。
发布前09:11只读核对155:模拟表前缀为空,dispatch=ws,买入与执行暂停均false;连续确认1823123,待入账/孤儿/在途均0,数量与现金差0。开盘前估值尚不可用,未用旧时点健康代替盘中状态。
发布与回退
实际发布情况如下。仅更新155的web和独立观测服务;保持原目录源码、共享.env、唯一WS及交易worker、beat不变。新增查询密钥仅进入观测服务专用环境文件。回退只针对上述两个镜像和查询开关,保留账本、队列、原始归档及其他服务后续配置。
09:40发布判收
代码提交9bb5ef11936c5053c9d1782355d6be0a6bd4dc2e,镜像pms:etf-query-9bb5ef1,实际ID sha256:7ecfb3040bebbdefe66f6017b3ab54b8f0672c2a0a22bbec0e0f6f03748c423e。155候选86组断网全量通过。09:31:05仅重建web和独立观测服务,两个容器各251个源码文件与提交一致。
首轮自然查询出现ConnectTimeout。只读定位为PMS与查询服务两个Docker网络之间无法经宿主机发布端口访问,不是密钥拒绝。09:36:57仅再次温和重建观测容器,将其同时接入原tradingsystem_default和已存在的查询专用mtf-etf-query-155_default网络。最终ParamStore地址为http://mtf-etf-query-155-api-1:8080,继续同一密钥认证。只新增观测容器网络连接,未修改上游服务、宿主机防火墙或开放端口。
最终web容器0ebc87a774db、观测容器46bc26766a29。全部30容器中其余28个标识、镜像和启动时间不变,原目录HEAD仍8413bce9c13527d031e587e390754ba6b2b92c4f,共享.env与原.env.observation逐字保持;新密钥仅保存于0600的.env.etf-query并注入观测服务,web不含密钥。唯一WS、交易worker、beat未重建;188未操作。
09:37:54自然轮询已归档11月12日修订3,完整16窗口;09:39及09:40自然条件请求收到304,当前缓存与原始归档一致,错误已清除。版本为0eb43fb20e57fbc2e791073a032f1ffaea935bfe870e80334ef0aab40d1f972a,累计成交982.97217004667亿元。PMS新接口按原统一包装正常返回,页面与health为HTTP200、页面哈希与镜像源码一致。每日原消费也正常推进至11月12日,净申购估算−224.09478980亿元,历史分位4.3956%;它与日内成交为不同口径。
09:40:38只读核对:连续确认1823600,缺口、待入账、孤儿均0,数量差异为空、现金差0、估值可用,资金快照6.1秒;原系统在途委托1笔,未作修改或用其验收本功能。
机器证据见发布证据,页面验收图为开发机历史数据回放,不能代替当前交易日自然判收。候选日志/tmp/pms-etf-query-offline-9bb5ef1.log,配置与容器基线备份/home/factor/project/tradingSystem/backups/etf-query-20261113-9bb5ef1。断网临时测试容器退出后重新保存正式发布基线,未把临时容器算入其他服务变化。
回退时先关闭PMS_ETF_QUERY_ENABLED,仅将web退到pms:etf-compact-a3102f5、观测服务退到pms:broad-flow-f7ce1a1,移除观测容器本次新增的查询网络连接并定向重建。逐项恢复,不用旧完整覆盖文件覆盖其他服务后续变化;不删除查询归档、账本或队列。
截至09:40,今日首个15分钟窗口尚未结束,未宣称11月13日盘中新窗口或自然跨日更新已经判收。日期切换、未来空窗、修订与故障在隔离测试中通过;运行中仍按一分钟自然轮询。无人工触发消费、模型任务、信号或测试委托,无新增长期观察任务。
仅显示当日
按用户追加要求,日内读接口仅在原始事实的trade_date等于北京时间当日时返回金额与分时柱;没有今日数据时返回今日日期、空金额和空图,历史归档保留。失败时只可保留当天已有数据,不退回昨日。前端以持续运行的服务器校准时钟再核对日期,即使自动刷新关闭、请求失败或旧版本响应到达,跨北京时间零点也撤下昨日金额和曲线。旧观测入口的展示回退同样检查当日;每日净申购与60日趋势不受影响。
新增昨日隐藏、失败不回旧日、北京时间午夜、首个今日响应自动显示四项测试,查询专项31项;开发机86组隔离全量及页面三道护栏通过。桌面验证昨日金额与曲线被隐藏,390窄屏回放11月13日09:45真实日内响应,显示107.23亿元,缺方向为空,控制台无错误。截图见当日分时验收,每日趋势部分沿用历史样例;该图为隔离回放。本次只影响web读接口与页面,独立观测服务的采集与版本归档不变,无需重建。
09:50:03独立观测服务已自然取得11月13日09:45窗口,累计成交107.23208751277亿元,方向尚不可用;当日金额可以显示,缺方向留空,不能拿昨日方向替代。09:50只读核对155模拟前缀为空、ws模式、全局暂停均false;待入账与孤儿0,在途1,数量现金差0、估值可用。候选断网与发布结果如下。
10:00当日限制发布判收
09:59:00仅更新155 web为pms:etf-today-654577f,代码654577fe841d7c859c013cf8e48b7c137234f8dd,镜像ID sha256:5131417d3710693b44d614129778c3a2492dcba5f14acefb070fa157074e35fc。候选86组断网全量通过,运行251文件与提交一致。web容器e281f7d09933健康,其他29容器的标识、镜像、启动时间不变;三份私有环境、挂载、原目录HEAD及观测专用网络保持。独立观测服务仍为9bb5ef1,未为版本一致而重建。
10:00:10真实新接口只返回11月13日09:45窗口,累计成交107.23亿元,方向缺失照实保留。自然查询09:59:31收到304,页面及health为HTTP200,页面哈希与候选一致。今日自然到达与当日显示已核验;真实跨北京时间零点尚未发生,由隔离测试覆盖,不新增观察任务。10:00:02连续确认1823909,待入账、孤儿及缺口0,数量与现金差0,估值可用;原在途1笔保持,不把该委托当作页面验收。
发布证据见当日展示发布。备份/home/factor/project/tradingSystem/backups/etf-today-20261113-654577f,候选日志/tmp/pms-etf-today-offline-654577f.log。本次回退只需恢复web镜像pms:etf-query-9bb5ef1并定向重建,不能覆盖观测服务网络或参数,不能清除历史归档。代码及文档分别提交并核对远程;188未操作。
宽基信号行去除重复标签
按用户要求,宽基信号行去掉名称前的“宽基”“15分”“日内”等标签,沿用时间、可点击名称、宽基观测、信号短内容和级别的单行形式。共用标签函数同时覆盖当日和历史信号;普通股票的持仓、关注、计划标签不变。观察范围仍可在悬停和详情中查看,信号有效期、筛选、排序与消费规则未变。该展示约定已加入页面规则。
开发机页面三道护栏通过,1440和390宽度隔离浏览器回放今日真实宽基响应:三条信号均无前置标签、无横向溢出,点击名称仍显示15分钟观察范围,控制台无错误。预览中的账户样例与无后端提示不是运行故障;没有向运行系统写入测试信号。本次仅需更新155 web,候选断网及实际发布结果待下文登记。
12:53信号标签发布判收
12:52:36仅在155重建web为pms:etf-label-ad5b1a6,代码ad5b1a64f43bb546a7fe63391806140d61981659,镜像ID sha256:0ab0d7d7c157f64b56bd1e731785c294622df562f6439a9c02e2547bfab3e916。候选86组断网全量通过,运行251个源码文件与提交一致。web容器5ce9f9b79953健康,其他29个容器标识、镜像与启动时间不变;三份私有环境、实际挂载和原目录HEAD保持。唯一WS、worker、beat与观测服务未重建,188未操作。
12:53:04实际页面及health均HTTP200,服务返回页面与候选逐字一致,已确认宽基前置标签为空。运行中三条宽基信号仍按原有效期淡色显示,未为验收延长或制造新信号;观察服务12:52:57自然304正常。12:53:08连续确认1826683,缺口、待入账、孤儿及在途委托均0,数量差异为空、现金差0,资金快照4.6秒。
证据见信号标签发布。备份/home/factor/project/tradingSystem/backups/etf-label-20261113-ad5b1a6,候选日志/tmp/pms-etf-label-offline-ad5b1a6.log。回退仅将web镜像恢复pms:etf-today-654577f并定向重建,不用完整旧覆盖文件覆盖其他服务后续修改。代码已推送并核对远程;本次无待完成事项,不新增观察任务。
按跟踪指数统一宽基简称
用户确认名称以ETF类别为主,不保留基金公司、不新增名称悬停,点击保持原基金详情。13:04:48只读核对155当日宽基监测池177只成员及gp_etf_basic,全部有跟踪指数:上证50 12只、沪深300 30只、中证500 29只、中证1000 15只、中证2000 14只、中证A500 40只、科创50 20只、创业板指17只。这里只覆盖已接入的沪深宽基监测池,不扩展其他ETF或北交所证券。
简称直接按指数代码映射,去掉旧的基金名称删词及超长回退规则。未知或缺少指数资料时保留代码,不根据名称猜测类别。资料沿用原小时缓存与只读查询,不增加采集任务。相同类别的基金仍按原事件ID逐条保留,点击仍显示对应基金全名和代码,不把个别基金告警合并为指数组结论。增强产品的具体身份留在原详情。名称悬停移除,其他股票交互及宽基观察范围详情保持。
开发机32项ETF专项、页面三道护栏通过;新增50类区分、同类双事件及原始详情保留、未知归属不猜测、基础资料范围等边界用例。实际177只资料在断网环境回放,映射全部命中;当前三条自然事件除展示简称外字段不变。1440和390隔离浏览器验证单行无溢出、无前置标签及名称悬停,点击中证500仍打开嘉实159922详情,控制台无错误。账号区域为预览样例,不将预览中的“无后端”提示当作运行故障。
全量目录见简称核对清单。修改仅用于web展示读取,独立观测消费与交易worker无需追平版本。候选断网及实际发布结果随后登记。
13:18类别简称发布判收
13:17:51仅重建155 web为pms:etf-names-975fa5a,代码975fa5a8661cc51fc219424465dd046bcb6191bf,镜像ID sha256:d3bc536e8c0927f83f9bbb6311dd1639909c5bc0456fd8bd94a6699a830369cf。候选86组断网全量通过,运行251源码文件与提交一致。web容器9c759136bf37健康,其余29容器的标识、镜像、启动时间保持。三份私有环境、实际挂载和原目录HEAD不变,原目录源码仍8413bce9;唯一WS、交易worker、beat、独立观测服务及188均未操作。
13:18:20实际页面与health均HTTP200,页面逐字匹配候选。线上177成员全部有已支持类别,未知归属0;当前自然事件159922显示中证500、588090显示科创50、159357显示中证A500,对应嘉实、华泰柏瑞、博时产品的完整名称与代码保持。三条原事件已按旧有效期过期,继续淡色回看,不把改名当作新增信号或延长有效期。独立查询13:17:37自然304正常。
13:18:24连续确认1827086,缺口、待入账、孤儿与在途0,数量差异为空、现金差0,估值可用;资金快照21.3秒。没有注入任何测试信号、研判或委托。证据见类别简称发布,隔离浏览器和实机只读核验分别记录。
备份/home/factor/project/tradingSystem/backups/etf-names-20261113-975fa5a,候选日志/tmp/pms-etf-names-offline-975fa5a.log。回退只将web恢复为pms:etf-label-ad5b1a6并定向重建,不恢复完整旧覆盖文件、不改动采集与交易数据。代码已推送并核对远程;本次无待完成事项,不增加观察任务。