修复可用资金重复计入回笼并统一账户总览口径
This commit is contained in:
parent
80433d3f95
commit
f90d5e78a0
|
|
@ -2179,3 +2179,11 @@ QMT在线、对账无差异。午休任务按原时段跳过,不制造交易
|
||||||
真机见过:76 份既有归档与晨版指针哈希不变;15:00 定时修订成功且仍为 quality;PMS 与桥健康正常,QMT 在线、水位一致、持仓无差异。切换窗口内高股息读取曾超时一次,15:01:39 同一读取路径复查成功。PMS 镜像与服务器已跟踪 Python 源码指纹同为 51941a03fd92。切换前钧达股份已由原清仓流程完成退出,本次没有删除成交或账本记录。
|
真机见过:76 份既有归档与晨版指针哈希不变;15:00 定时修订成功且仍为 quality;PMS 与桥健康正常,QMT 在线、水位一致、持仓无差异。切换窗口内高股息读取曾超时一次,15:01:39 同一读取路径复查成功。PMS 镜像与服务器已跟踪 Python 源码指纹同为 51941a03fd92。切换前钧达股份已由原清仓流程完成退出,本次没有删除成交或账本记录。
|
||||||
|
|
||||||
判收为真机见过。未为验收发起交易。新排序后的自然建仓与收益表现尚未发生,不能当作已验证盈利。私有备份、计划发布记录、消费与健康验收留在 155 的 /home/factor/pms_logs/quality-switch-20261026;配置备份不进 Git。本地原有宏观研究、台账和未跟踪文件保持原状。
|
判收为真机见过。未为验收发起交易。新排序后的自然建仓与收益表现尚未发生,不能当作已验证盈利。私有备份、计划发布记录、消费与健康验收留在 155 的 /home/factor/pms_logs/quality-switch-20261026;配置备份不进 Git。本地原有宏观研究、台账和未跟踪文件保持原状。
|
||||||
|
|
||||||
|
## 2026-10-26(续)· 账户可用资金重复加回笼与总览估值混用
|
||||||
|
|
||||||
|
用户截图显示总资产 1,936,262、可用 3,450,895。155 只读核对资金快照 seq1426810:QMT 总资产 1,936,261.62、可用 1,806,071.62、冻结 0、持仓市值 130,190,三项本来闭合。PMS cash_view 又加 sell_return_today=1,644,823.13,恰好得到截图错误值。该加法源于 7 月 30 日,8 月 6 日留下的非零卖出核查未闭环;与今天选股切换无关。另有 QMT 市值与 PMS 收盘行情估值 124,916 的 5,274 差额,数量一致,具体是三只股票的估值价格不同。
|
||||||
|
|
||||||
|
修复 portfolio 统一资金入口,页面和买入资金校验直接采用 available_cash,不重复加回笼。新增账户市值、冻结资金透传,总览前三项按同份账户快照展示,策略仓位与持仓明细维持行情估值。更新 ws_codec、rule_gate 注释、QMT 协议与需求中的误导说明。新增 scripts/test_batch47_units.py 九例并登记,纠正 test_wiring 原错误断言。详细证据、影响和验证见 docs/账户资金口径核查_2026-10-26.md。
|
||||||
|
|
||||||
|
开发机配置隔离、禁网全量 51 批、1174 例通过,包含三道页面护栏;独立本地浏览器预览 1920、1280 宽度核对卡片、说明与换行,无脚本错误。服务器只读核查为真机见过。修复线上判收为未判收,此时尚未推送或部署,不改运行参数、账本、成交,不操作 188。下一步为用户确认本次 155 部署后执行候选镜像回归和运行验收。QMT 内部估值价格不同的生成原因、回笼统计期间未核实,不能把账户快照标为按最新收盘行情计价。
|
||||||
|
|
|
||||||
|
|
@ -14,7 +14,7 @@
|
||||||
|---|---|---|---|---|---|
|
|---|---|---|---|---|---|
|
||||||
| A1 | 持仓快照 `trading_position` | 股票代码(点式)、持仓数量、**可用数量(T+1 可卖)**、成本价(如有)、冻结数量(如有) | 盘中 ≤ 5 分钟 | 账本对账基准。当前 PMS 只确认过 `stock_code` 列可用,**请提供该表完整字段定义(DDL)**,尤其确认是否已有"可用数量"列——若无,PMS 自行按 T+1 规则推算 | **PMS 侧实机探明(2026-07-27,待下游确认语义)**:该表 14 列,含 `stock_code / stock_name / total_quantity / available_quantity / frozen_quantity / cost_price / market_price / market_value / profit_loss`。**可用数量列已存在**(`available_quantity`),本项数据需求实质已满足,PMS 已按此列对接。仍请确认:①`available_quantity` 是否即 T+1 可卖口径 ②更新时延 ③`stock_code` 格式(点式/前缀式) |
|
| A1 | 持仓快照 `trading_position` | 股票代码(点式)、持仓数量、**可用数量(T+1 可卖)**、成本价(如有)、冻结数量(如有) | 盘中 ≤ 5 分钟 | 账本对账基准。当前 PMS 只确认过 `stock_code` 列可用,**请提供该表完整字段定义(DDL)**,尤其确认是否已有"可用数量"列——若无,PMS 自行按 T+1 规则推算 | **PMS 侧实机探明(2026-07-27,待下游确认语义)**:该表 14 列,含 `stock_code / stock_name / total_quantity / available_quantity / frozen_quantity / cost_price / market_price / market_value / profit_loss`。**可用数量列已存在**(`available_quantity`),本项数据需求实质已满足,PMS 已按此列对接。仍请确认:①`available_quantity` 是否即 T+1 可卖口径 ②更新时延 ③`stock_code` 格式(点式/前缀式) |
|
||||||
| A2 | 委托与成交 `trading_order` | 委托号、股票代码、方向、委托价、委托量、状态(**完整状态枚举文档**)、成交量、成交均价、委托/成交时间、来源标识 | 状态变更后 ≤ 1 分钟 | 成交回放入账(批次/成本)、指令执行确认。**请提供完整 DDL 与状态流转说明**(现掌握的 submitted/filled/completed/pending/failed 为推断口径,需正式确认) | **PMS 侧实机探明**:该表 20 列,已见 `order_id / strategy_id / stock_code / stock_name / order_side / order_quantity / order_price / target_price / order_status` 等。**仍缺两项,是本清单里最卡 PMS 的**:①状态枚举的正式定义 ②**成交来源标识**(哪条委托对应 PMS 的哪条指令)。在来源标识到位前,PMS 只能按「同股同向 + 下发早于成交 + FIFO」贪心认领,认领不上即判外部成交并告警——人工与 PMS 同时下单时会误判 |<br><br>**QMT 侧答复(2026-07-28)**:①**状态枚举**已给出 —— `submitted` 已提交 / `filled` **部分成交** / `completed` 已完成 / `pending` 挂单成功但 QMT 无响应 / `failed` 委托失败;撤单另有可靠终态。②**成交均价**将新增列。③**策略标识**字段表中已有,改造后可写入。<br><br>**PMS 侧结论**:本项**主链路已由 WebSocket 承接**,`trade` 逐笔成交消息带 `instruction_id`,来源标识问题自然消解。仍需注意两点,已并入新协议:⑴表中的 `strategy_id` 是指向 `t_trading_strategy` 的整数外键(因子策略表),只能回答「是不是 PMS 下的」,回答不了「是哪一条指令」,**不足以支撑回放认领**;⑵`filled` = 部分成交这个命名与字面含义相反,协议层改用 `PARTIAL` / `FILLED` 区分,映射见新协议 §7.2。**PMS 不再读 `order_status` 判断成交** |
|
| A2 | 委托与成交 `trading_order` | 委托号、股票代码、方向、委托价、委托量、状态(**完整状态枚举文档**)、成交量、成交均价、委托/成交时间、来源标识 | 状态变更后 ≤ 1 分钟 | 成交回放入账(批次/成本)、指令执行确认。**请提供完整 DDL 与状态流转说明**(现掌握的 submitted/filled/completed/pending/failed 为推断口径,需正式确认) | **PMS 侧实机探明**:该表 20 列,已见 `order_id / strategy_id / stock_code / stock_name / order_side / order_quantity / order_price / target_price / order_status` 等。**仍缺两项,是本清单里最卡 PMS 的**:①状态枚举的正式定义 ②**成交来源标识**(哪条委托对应 PMS 的哪条指令)。在来源标识到位前,PMS 只能按「同股同向 + 下发早于成交 + FIFO」贪心认领,认领不上即判外部成交并告警——人工与 PMS 同时下单时会误判 |<br><br>**QMT 侧答复(2026-07-28)**:①**状态枚举**已给出 —— `submitted` 已提交 / `filled` **部分成交** / `completed` 已完成 / `pending` 挂单成功但 QMT 无响应 / `failed` 委托失败;撤单另有可靠终态。②**成交均价**将新增列。③**策略标识**字段表中已有,改造后可写入。<br><br>**PMS 侧结论**:本项**主链路已由 WebSocket 承接**,`trade` 逐笔成交消息带 `instruction_id`,来源标识问题自然消解。仍需注意两点,已并入新协议:⑴表中的 `strategy_id` 是指向 `t_trading_strategy` 的整数外键(因子策略表),只能回答「是不是 PMS 下的」,回答不了「是哪一条指令」,**不足以支撑回放认领**;⑵`filled` = 部分成交这个命名与字面含义相反,协议层改用 `PARTIAL` / `FILLED` 区分,映射见新协议 §7.2。**PMS 不再读 `order_status` 判断成交** |
|
||||||
| A3 | 账户资金快照(**新增需求**) | 总资产、可用资金、冻结资金、当日卖出可用资金(T+0 回笼) | 盘中 ≤ 5 分钟;日终必须 | 总规模校准与买入前资金校验。形式不限:新表 / 现有表 / HTTP 接口均可,请给出可行方案 | **已确认可提供**,走 WebSocket 实时回传。字段与消息格式见新协议 §5.7 `snapshot{kind:"funds"}`。**`sell_return_today`(当日卖出回笼)务必提供**,PMS 买入前的资金校验依赖它 |
|
| A3 | 账户资金快照(**新增需求**) | 总资产、可用资金、冻结资金、当日卖出回笼统计 | 盘中 ≤ 5 分钟;日终必须 | 总规模校准与买入前资金校验。形式不限:新表 / 现有表 / HTTP 接口均可,请给出可行方案 | **已确认可提供**,走 WebSocket 实时回传。字段与消息格式见新协议 §5.7 `snapshot{kind:"funds"}`。2026-10-26 澄清:买入校验直接使用 available_cash,已含可用回笼;sell_return_today 仅作统计,禁止重复相加 |
|
||||||
| A4 | 成交回报明细(可选) | 若 A2 已含逐笔或聚合成交(成交量/均价),本项可免;否则请提供逐笔成交表 | 同 A2 | 部分成交场景的精确入账 | **已升格为必需项**:QMT 侧确认可回传「逐笔和最终结果」。**PMS 账本以逐笔 `trade` 消息为唯一入账依据**,`order_update` 仅作状态跟踪与终态校验。见新协议 §5.5 |
|
| A4 | 成交回报明细(可选) | 若 A2 已含逐笔或聚合成交(成交量/均价),本项可免;否则请提供逐笔成交表 | 同 A2 | 部分成交场景的精确入账 | **已升格为必需项**:QMT 侧确认可回传「逐笔和最终结果」。**PMS 账本以逐笔 `trade` 消息为唯一入账依据**,`order_update` 仅作状态跟踪与终态校验。见新协议 §5.5 |
|
||||||
| A5 | 上游买入计划 `trading_buy_plan` | PMS 将作为该表的承接方(替代原决策系统 ENTRY_GATE 的角色)。请确认:①下游当前是否仍轮询 `is_active=6` 自动挂单?②切换后是否可以**停止**该轮询(统一走 B1 通道),或保留作为过渡(方案 X) | — | 旧通道处置(见 C2) | **未答复,仍待确认**(新协议 Q1)。另注:该表唯一约束为 `(stock_code, trading_time)` 且 `buy_amount` 是金额非股数,单股分批会撞约束——这也是通道改走 WebSocket 后不再受制于该表的原因之一 |
|
| A5 | 上游买入计划 `trading_buy_plan` | PMS 将作为该表的承接方(替代原决策系统 ENTRY_GATE 的角色)。请确认:①下游当前是否仍轮询 `is_active=6` 自动挂单?②切换后是否可以**停止**该轮询(统一走 B1 通道),或保留作为过渡(方案 X) | — | 旧通道处置(见 C2) | **未答复,仍待确认**(新协议 Q1)。另注:该表唯一约束为 `(stock_code, trading_time)` 且 `buy_amount` 是金额非股数,单股分批会撞约束——这也是通道改走 WebSocket 后不再受制于该表的原因之一 |
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -333,11 +333,13 @@ QMT 把成交写入 `trading_order` / `trading_position` / `trading_log` 之后
|
||||||
```json
|
```json
|
||||||
{ "kind": "funds", "as_of": 1769500000000, "data": {
|
{ "kind": "funds", "as_of": 1769500000000, "data": {
|
||||||
"total_asset": 2013456.78, "available_cash": 312450.10,
|
"total_asset": 2013456.78, "available_cash": 312450.10,
|
||||||
"frozen_cash": 12000.00, "sell_return_today": 48900.00, "market_value": 1701006.68
|
"frozen_cash": 12000.00, "sell_return_today": 48900.00, "market_value": 1689006.68
|
||||||
}}
|
}}
|
||||||
```
|
```
|
||||||
|
|
||||||
`sell_return_today`(当日卖出回笼,T+0 可用)是 PMS 买入前资金校验必需的,请务必提供。
|
`available_cash` 是账户可用余额,已经包含可用的卖出回笼,并已扣除冻结资金。PMS 买入前直接用该值校验,不再加 `sell_return_today`,也不再次扣减 `frozen_cash`。`sell_return_today` 保留为卖出回笼统计,不能作为额外余额。该口径于 2026-10-26 在 155 资金快照上核实,修正此前把“T+0 可用”误解为应重复相加的说明。
|
||||||
|
|
||||||
|
账户总资产、账户市值与现金采用同一份资金快照。PMS 持仓明细另按行情估值,两者可能不同;不得用行情市值反算并覆盖账户报告的现金余额。上例总资产等于可用资金加冻结资金加账户市值,回笼统计不再次参与加总。
|
||||||
|
|
||||||
### 5.8 `position_update` / `funds_update` —— 主动推送
|
### 5.8 `position_update` / `funds_update` —— 主动推送
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -236,7 +236,7 @@ def _check_cash(failed, warns, qty, price, caps, hard):
|
||||||
|
|
||||||
与组合上限是**两个不同的约束**, 所以单列一条而不是塞进 check_all_caps:
|
与组合上限是**两个不同的约束**, 所以单列一条而不是塞进 check_all_caps:
|
||||||
上限管「该不该买这么多」—— 仓位纪律, 基准是 PMS_TOTAL_SCALE 这个用户命令参数
|
上限管「该不该买这么多」—— 仓位纪律, 基准是 PMS_TOTAL_SCALE 这个用户命令参数
|
||||||
资金管「买不买得起」 —— 账户事实, 基准是 ws 资金快照的 available_cash + 当日回笼
|
资金管「买不买得起」 —— 账户事实, 基准是 ws 资金快照的 available_cash,已含可用回笼
|
||||||
2026-07-30 之前只有前者: scale=200 万而模拟账户实际只有 98 万, 于是排出的方案规则闸一路
|
2026-07-30 之前只有前者: scale=200 万而模拟账户实际只有 98 万, 于是排出的方案规则闸一路
|
||||||
放行, 要等 QMT 回 `INSUFFICIENT_CASH` 才被拒; 而 reject 不自动重发, 择时下一跳又算又发
|
放行, 要等 QMT 回 `INSUFFICIENT_CASH` 才被拒; 而 reject 不自动重发, 择时下一跳又算又发
|
||||||
又拒 —— 页面看着一切正常, 实际一单也下不去。
|
又拒 —— 页面看着一切正常, 实际一单也下不去。
|
||||||
|
|
|
||||||
|
|
@ -509,9 +509,8 @@ def parse_positions_snapshot(payload: dict) -> dict:
|
||||||
def parse_funds_snapshot(payload: dict) -> dict:
|
def parse_funds_snapshot(payload: dict) -> dict:
|
||||||
"""`snapshot{kind:"funds"}` → 归一后的资金字段 (§5.7)。
|
"""`snapshot{kind:"funds"}` → 归一后的资金字段 (§5.7)。
|
||||||
|
|
||||||
暂无消费方: `calibrate_fees` 的公式要「总资产变动 − 成交净额」, 需要**两天**的快照差
|
portfolio.cash_view 使用 available_cash 作为账户可用资金;该余额已包含可用的卖出
|
||||||
再扣掉入出金, 不是接上字段就能算对。先解析落库、等口径定了再接, 别硬凑一个看起来
|
回笼,sell_return_today 仅是统计字段,不可重复相加。市值与总资产原样保留账户口径。
|
||||||
有结果的数 —— 费用本来就不进成本, 晚校准无风险 (协议 §5.5)。
|
|
||||||
"""
|
"""
|
||||||
d = (payload or {}).get("data")
|
d = (payload or {}).get("data")
|
||||||
d = d if isinstance(d, dict) else (payload or {})
|
d = d if isinstance(d, dict) else (payload or {})
|
||||||
|
|
|
||||||
|
|
@ -39,11 +39,14 @@ def cash_view() -> dict:
|
||||||
回 `INSUFFICIENT_CASH` 才被拒 —— 而 PMS 收到 reject 不自动重发, 择时下一跳又算又发又拒,
|
回 `INSUFFICIENT_CASH` 才被拒 —— 而 PMS 收到 reject 不自动重发, 择时下一跳又算又发又拒,
|
||||||
页面看着一切正常, 实际一单也下不去。
|
页面看着一切正常, 实际一单也下不去。
|
||||||
|
|
||||||
**`sell_return_today` 必须加进来**: 当日卖出回笼资金 T+0 可用 (协议 §5.7, A3 点名要的
|
available_cash 已包含可用的卖出回笼。sell_return_today 是回笼统计,不能重复相加。
|
||||||
字段)。不加会把「刚卖掉一只、拿回笼的钱买另一只」这条最常见的换仓路径判成资金不足。
|
2026-10-26 真机核对:可用 1,806,071.62 加账户市值 130,190,正好等于总资产
|
||||||
|
1,936,261.62;再加回笼统计会虚增可用资金 1,644,823.13 元。
|
||||||
|
账户市值和冻结资金随同一快照返回,页面不能把它们与独立行情估值混成一组账户余额。
|
||||||
"""
|
"""
|
||||||
max_age = param_store.get_int("PMS_RECON_WS_SNAPSHOT_MAX_AGE_SEC", 900)
|
max_age = param_store.get_int("PMS_RECON_WS_SNAPSHOT_MAX_AGE_SEC", 900)
|
||||||
out = {"source": CASH_EST, "cash_avail": None, "total_asset": None,
|
out = {"source": CASH_EST, "cash_avail": None, "total_asset": None,
|
||||||
|
"account_market_value": None, "frozen_cash": None,
|
||||||
"age_sec": None, "why": ""}
|
"age_sec": None, "why": ""}
|
||||||
try:
|
try:
|
||||||
snap = qmt_repo.latest_snapshot("funds")
|
snap = qmt_repo.latest_snapshot("funds")
|
||||||
|
|
@ -67,7 +70,8 @@ def cash_view() -> dict:
|
||||||
out["why"] = "拿到了资金数据,但里面找不到可用余额这一项"
|
out["why"] = "拿到了资金数据,但里面找不到可用余额这一项"
|
||||||
return out
|
return out
|
||||||
out.update({"source": CASH_WS, "age_sec": age, "total_asset": f.get("total_asset"),
|
out.update({"source": CASH_WS, "age_sec": age, "total_asset": f.get("total_asset"),
|
||||||
"cash_avail": round(float(avail) + float(f.get("sell_return_today") or 0), 2)})
|
"cash_avail": round(float(avail), 2),
|
||||||
|
"account_market_value": f.get("market_value"), "frozen_cash": f.get("frozen_cash")})
|
||||||
return out
|
return out
|
||||||
|
|
||||||
|
|
||||||
|
|
@ -171,6 +175,7 @@ def positions_view(*, with_price: bool = True) -> dict:
|
||||||
"cash_avail": cash["cash_avail"], "cash_source": cash["source"],
|
"cash_avail": cash["cash_avail"], "cash_source": cash["source"],
|
||||||
"cash_age_sec": cash["age_sec"], "cash_why": cash["why"],
|
"cash_age_sec": cash["age_sec"], "cash_why": cash["why"],
|
||||||
"total_asset": cash["total_asset"],
|
"total_asset": cash["total_asset"],
|
||||||
|
"account_market_value": cash["account_market_value"], "frozen_cash": cash["frozen_cash"],
|
||||||
"float_pnl": round(port_mv - cost_sum, 2) if cost_sum else 0.0,
|
"float_pnl": round(port_mv - cost_sum, 2) if cost_sum else 0.0,
|
||||||
"float_pnl_pct": round(port_mv / cost_sum - 1, 4) if cost_sum > 0 else None,
|
"float_pnl_pct": round(port_mv / cost_sum - 1, 4) if cost_sum > 0 else None,
|
||||||
"sector_names": sector_names, "sector_mv": sector_mv,
|
"sector_names": sector_names, "sector_mv": sector_mv,
|
||||||
|
|
@ -229,6 +234,7 @@ def overview() -> dict:
|
||||||
# 会让人以为钱多得是 (07-30: cash_est 199 万 vs 真实可用 97 万)
|
# 会让人以为钱多得是 (07-30: cash_est 199 万 vs 真实可用 97 万)
|
||||||
"cash_avail": t["cash_avail"], "cash_source": t["cash_source"],
|
"cash_avail": t["cash_avail"], "cash_source": t["cash_source"],
|
||||||
"total_asset": t["total_asset"], "cash_why": t["cash_why"],
|
"total_asset": t["total_asset"], "cash_why": t["cash_why"],
|
||||||
|
"account_market_value": t["account_market_value"], "frozen_cash": t["frozen_cash"],
|
||||||
"float_pnl": t["float_pnl"],
|
"float_pnl": t["float_pnl"],
|
||||||
"float_pnl_pct": t["float_pnl_pct"], "solid_names": t["solid_names"],
|
"float_pnl_pct": t["float_pnl_pct"], "solid_names": t["solid_names"],
|
||||||
"neg_names": t["neg_names"], "autonomy": p["autonomy"],
|
"neg_names": t["neg_names"], "autonomy": p["autonomy"],
|
||||||
|
|
|
||||||
|
|
@ -985,11 +985,11 @@ body.dock-r:not(.r-fold) .side-r .strip{display:none;}
|
||||||
<main class="tmain">
|
<main class="tmain">
|
||||||
|
|
||||||
<div class="metrics">
|
<div class="metrics">
|
||||||
<div class="m"><div class="k">账户总资产</div><div class="v">{{ money(ov.total_asset) }}</div></div>
|
<div class="m"><div class="k">账户总资产<span class="help" data-tip="采用账户资金快照中的总资产,包含账户现金和持仓估值;与用户设定的策略总规模不同。">?</span></div><div class="v">{{ money(ov.total_asset) }}</div></div>
|
||||||
<div class="m"><div class="k">可用资金<span class="muted" v-if="ov.cash_source!=='ws'"> (估算)</span></div>
|
<div class="m"><div class="k">可用资金<span class="muted" v-if="ov.cash_source!=='ws'"> (估算)</span><span class="help" :data-tip="ov.cash_source==='ws' ? '采用账户报告的可用余额,已含可用的卖出回笼,不重复相加。账户冻结资金 ' + money(ov.frozen_cash) + ' 元。' : '账户资金暂不可用,此处仅按策略总规模减行情估值展示估算余额,不能视为账户可用资金。'">?</span></div>
|
||||||
<div class="v" :class="ov.cash_source==='ws'?'':'muted'">{{ money(ov.cash_source==='ws' ? ov.cash_avail : ov.cash_est) }}</div></div>
|
<div class="v" :class="ov.cash_source==='ws'?'':'muted'">{{ money(ov.cash_source==='ws' ? ov.cash_avail : ov.cash_est) }}</div></div>
|
||||||
<div class="m"><div class="k">持仓市值</div><div class="v">{{ money(ov.portfolio_mv) }}</div></div>
|
<div class="m"><div class="k">账户持仓市值<span class="help" :data-tip="'与总资产、可用资金采用同一份账户快照。持仓明细按行情估值,当前为 ' + money(ov.portfolio_mv) + ' 元;两者可能因估值价格不同而有差异。'">?</span></div><div class="v">{{ money(ov.account_market_value) }}</div></div>
|
||||||
<div class="m"><div class="k">仓位<span class="muted" style="margin-left:4px">上限 {{ pct(ov.portfolio_cap) }}</span></div>
|
<div class="m"><div class="k" style="flex-wrap:wrap">策略仓位<span class="help" style="flex-shrink:0" :data-tip="'按持仓行情估值 ' + money(ov.portfolio_mv) + ' 元除以用户设定总规模 ' + money(ov.scale) + ' 元计算,仓位纪律沿用此口径。'">?</span><span class="muted" style="margin-left:4px">上限 {{ pct(ov.portfolio_cap) }}</span></div>
|
||||||
<div class="v">{{ pct(ov.portfolio_pct) }}</div></div>
|
<div class="v">{{ pct(ov.portfolio_pct) }}</div></div>
|
||||||
<div class="m"><div class="k">持仓综合盈亏<span class="help" data-tip="按摊薄成本计算,包含当前持仓对应股票此前卖出已实现的盈亏,不等于剩余股份的浮动盈亏。">?</span></div>
|
<div class="m"><div class="k">持仓综合盈亏<span class="help" data-tip="按摊薄成本计算,包含当前持仓对应股票此前卖出已实现的盈亏,不等于剩余股份的浮动盈亏。">?</span></div>
|
||||||
<div class="v" :class="(ov.float_pnl||0)>=0?'up':'down'">{{ money(ov.float_pnl) }}<span style="font-size:12px"> {{ ov.float_pnl_pct==null?'':pct(ov.float_pnl_pct) }}</span></div></div>
|
<div class="v" :class="(ov.float_pnl||0)>=0?'up':'down'">{{ money(ov.float_pnl) }}<span style="font-size:12px"> {{ ov.float_pnl_pct==null?'':pct(ov.float_pnl_pct) }}</span></div></div>
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,47 @@
|
||||||
|
# 账户总资产与可用资金口径核查
|
||||||
|
|
||||||
|
2026-10-26,北京时间。用户提供 16:07 页面截图,账户总资产约 193.63 万元,可用资金约 345.09 万元。本次先在 155 模拟仓只读核查,再在开发机修复和验证。没有操作 188,没有改动账户或账本记录。
|
||||||
|
|
||||||
|
## 真机证据与原因
|
||||||
|
|
||||||
|
16:08:45 读取资金快照 seq=1426810,接收时间原值为 2026-10-26 16:07:13。该列由容器 datetime.now() 写入,按北京时间解读。账户值如下。
|
||||||
|
|
||||||
|
| 项目 | 金额(元) | 来源 |
|
||||||
|
| --- | ---: | --- |
|
||||||
|
| 总资产 | 1,936,261.62 | QMT total_asset |
|
||||||
|
| 可用余额 | 1,806,071.62 | QMT available_cash |
|
||||||
|
| 冻结资金 | 0.00 | QMT frozen_cash |
|
||||||
|
| 账户持仓估值 | 130,190.00 | QMT market_value |
|
||||||
|
| 卖出回笼统计 | 1,644,823.13 | QMT sell_return_today |
|
||||||
|
| 页面错误可用值 | 3,450,894.75 | PMS 将可用余额与回笼统计相加 |
|
||||||
|
|
||||||
|
账户可用余额加账户持仓估值,恰好等于账户总资产。回笼资金已经体现在可用余额中,PMS 又加一次,造成 1,644,823.13 元重复计入。这是 portfolio.cash_view 的计算错误,不是现金账多写了一笔。该加法来自 2026-07-30 提交 0ab611b,2026-08-06 DEVLOG 已记“有卖出时再核实”的悬项,原单测也把重复加款钉成了正确结果。今天选股切换没有修改这段计算。
|
||||||
|
|
||||||
|
同一个 cash_avail 同时用于页面、建仓资金封顶及规则闸,所以不能只改页面减去差额。需要修正统一资金入口,确保买入校验直接使用账户可用余额。不得用“总资产减行情市值”反算现金,也不改运行总规模来掩盖问题。
|
||||||
|
|
||||||
|
第二处是估值来源混用。PMS 15:00 收盘分钟行情与 QMT 同时返回的持仓价格如下,数量三票全部一致。
|
||||||
|
|
||||||
|
| 股票 | 数量 | PMS 收盘行情 | QMT 持仓价格 | QMT 市值减 PMS 市值 |
|
||||||
|
| --- | ---: | ---: | ---: | ---: |
|
||||||
|
| 三花智控 002050.SZ | 1,800 | 34.41 | 32.53 | -3,384.00 |
|
||||||
|
| 科士达 002518.SZ | 400 | 27.49 | 26.14 | -540.00 |
|
||||||
|
| 厦钨新能 688778.SH | 1,400 | 37.13 | 43.70 | 9,198.00 |
|
||||||
|
| 合计 | | | | 5,274.00 |
|
||||||
|
|
||||||
|
页面持仓市值 124,916 元来自行情,账户估值 130,190 元来自 QMT。账户总资产继续采用 QMT 报告值,两者放在同一排却没有区分来源,因此去掉重复回笼后仍会差 5,274 元。新收到快照只证明通道新鲜,不能证明 QMT 内部的估值行情已更新;本次未进入 QMT 服务核查其价格生成路径,也不能据此把 QMT 总资产改为 PMS 的估算值。
|
||||||
|
|
||||||
|
策略仓位 6.25% 的分母是用户设定的 200 万元,计算为 124,916 / 2,000,000,不是按账户总资产计算。这是既有仓位纪律,不随本次账户显示修复改变。
|
||||||
|
|
||||||
|
## 已准备的修复
|
||||||
|
|
||||||
|
portfolio.cash_view 直接采用 available_cash,忽略回笼统计对余额的加成;账户市值和冻结资金随同一资金快照透传给总览。顶部前三项统一展示账户总资产、账户可用资金和账户持仓市值,增加来源说明。原仓位标签改为策略仓位,说明分母与估值来源。持仓明细、综合盈亏、组合风控继续使用原行情估值。
|
||||||
|
|
||||||
|
修正接口契约中造成误解的说明及不闭合的示例数值。ws_codec 和规则闸注释同步澄清。新增 batch47 九例,覆盖真实异常快照、买不起的单不能靠重复回笼过闸、回笼已在可用余额时可以再投、可用为零、冻结不重复扣、缺项、过期及两套估值互不污染。原 wiring 中的错误断言一并纠正。
|
||||||
|
|
||||||
|
开发机运行以下验证,预期为 ALL SUITES PASS,实际 51 批、1174 例通过,含三道页面护栏。浏览器使用独立无登录测试上下文访问本地固定数据预览,1920 与 1280 宽度核对卡片数值、说明和窄栏换行,无页面脚本错误。预览不连接业务服务。
|
||||||
|
|
||||||
|
```bash
|
||||||
|
/tmp/pms-junda-20261026/venv312/bin/python scripts/run_tests.py
|
||||||
|
```
|
||||||
|
|
||||||
|
真机见过的是原因、原始资金和两套估值。修复线上判收为未判收;此记录时没有推送或部署新补丁,没有改库、调参或重启服务。部署前需按 AGENTS.md 确认本次服务器操作范围,在 155 使用提交归档构建匹配镜像并断网回归,再于无在途、无待入账回报时 force-recreate 四个 PMS 服务。188 不在本次范围。QMT 内部估值价格与 sell_return_today 的统计期间仍需下游进一步核实,本次修复不依赖这些统计作为可用余额。
|
||||||
|
|
@ -5,6 +5,7 @@
|
||||||
运行: docker compose run --rm pms-web python scripts/run_tests.py
|
运行: docker compose run --rm pms-web python scripts/run_tests.py
|
||||||
|
|
||||||
包含 (例数按 2026-10-26 隔离回归实跑校正):
|
包含 (例数按 2026-10-26 隔离回归实跑校正):
|
||||||
|
test_batch47_units.py 账户资金去重、买入额度与账户展示和策略估值分离 (9 例)
|
||||||
test_batch46_units.py 质地排序切换、档位准入、命令分配与白名单优先 (11 例)
|
test_batch46_units.py 质地排序切换、档位准入、命令分配与白名单优先 (11 例)
|
||||||
test_batch45_units.py 父指令总量:回放延迟、部分成交、跨日预留、故障守成与影子模式 (16 例)
|
test_batch45_units.py 父指令总量:回放延迟、部分成交、跨日预留、故障守成与影子模式 (16 例)
|
||||||
test_batch43_units.py 逐票来源核验、实际API至SQL事务、故障回滚与幂等 (14 例)
|
test_batch43_units.py 逐票来源核验、实际API至SQL事务、故障回滚与幂等 (14 例)
|
||||||
|
|
@ -200,6 +201,7 @@ SUITES = ["test_core_units.py", "test_batch2_units.py", "test_batch3_units.py",
|
||||||
"test_batch38_units.py", "test_batch39_units.py", "test_batch40_units.py", "test_batch41_units.py", "test_batch42_units.py", "test_batch43_units.py", "test_batch44_units.py",
|
"test_batch38_units.py", "test_batch39_units.py", "test_batch40_units.py", "test_batch41_units.py", "test_batch42_units.py", "test_batch43_units.py", "test_batch44_units.py",
|
||||||
"test_batch45_units.py",
|
"test_batch45_units.py",
|
||||||
"test_batch46_units.py",
|
"test_batch46_units.py",
|
||||||
|
"test_batch47_units.py",
|
||||||
"test_page_copy_guard.py",
|
"test_page_copy_guard.py",
|
||||||
"test_page_enum_guard.py",
|
"test_page_enum_guard.py",
|
||||||
"test_page_wiring_guard.py",
|
"test_page_wiring_guard.py",
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,105 @@
|
||||||
|
"""账户资金口径:防止回笼重复计入,账户展示与策略估值分开。"""
|
||||||
|
import unit_test_guard # noqa: F401
|
||||||
|
import os
|
||||||
|
import sys
|
||||||
|
import unittest
|
||||||
|
|
||||||
|
sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
|
||||||
|
from app.core import rule_gate
|
||||||
|
from app.services import portfolio
|
||||||
|
from test_wiring import install_fakes
|
||||||
|
from test_batch3_units import ctx
|
||||||
|
|
||||||
|
|
||||||
|
FUNDS = dict(total_asset=1936261.62, available_cash=1806071.62,
|
||||||
|
frozen_cash=0.0, sell_return_today=1644823.13, market_value=130190.0)
|
||||||
|
|
||||||
|
|
||||||
|
class AccountFundsTest(unittest.TestCase):
|
||||||
|
def setUp(self):
|
||||||
|
self.fake = install_fakes(params={'PMS_TOTAL_SCALE': '2000000'})
|
||||||
|
|
||||||
|
def funds(self, **values):
|
||||||
|
data = dict(FUNDS, **values)
|
||||||
|
self.fake.qmt.put_snapshot(kind='funds', data=data)
|
||||||
|
return data
|
||||||
|
|
||||||
|
def gate(self, qty):
|
||||||
|
view = portfolio.positions_view()
|
||||||
|
caps = portfolio.caps_ctx(view, ts_code='600000.SH')
|
||||||
|
return rule_gate.check(side='buy', action='OPEN', qty=qty, price=10,
|
||||||
|
ctx=ctx(caps=caps))
|
||||||
|
|
||||||
|
def test_real_snapshot_sale_stat_does_not_create_extra_cash(self):
|
||||||
|
self.funds()
|
||||||
|
cash = portfolio.cash_view()
|
||||||
|
self.assertEqual(cash['cash_avail'], 1806071.62)
|
||||||
|
self.assertAlmostEqual(cash['cash_avail'] + cash['account_market_value'], cash['total_asset'])
|
||||||
|
|
||||||
|
def test_gate_rejects_order_only_affordable_with_double_count(self):
|
||||||
|
self.funds(available_cash=5000, sell_return_today=10000, total_asset=5000, market_value=0)
|
||||||
|
result = self.gate(1000)
|
||||||
|
self.assertFalse(result['passed'])
|
||||||
|
self.assertTrue(any(x.startswith('INSUFFICIENT_CASH:') for x in result['failed']))
|
||||||
|
self.assertEqual(result['hard_numbers']['cash_avail'], 5000)
|
||||||
|
|
||||||
|
def test_returned_sale_cash_remains_usable_in_reported_balance(self):
|
||||||
|
self.funds(available_cash=12000, sell_return_today=8000, total_asset=12000, market_value=0)
|
||||||
|
result = self.gate(1000)
|
||||||
|
self.assertTrue(result['passed'], result)
|
||||||
|
|
||||||
|
def test_zero_available_is_not_replaced_by_sale_stat(self):
|
||||||
|
self.funds(available_cash=0, sell_return_today=10000, total_asset=10000, frozen_cash=10000, market_value=0)
|
||||||
|
result = self.gate(100)
|
||||||
|
self.assertFalse(result['passed'])
|
||||||
|
self.assertEqual(result['hard_numbers']['cash_avail'], 0)
|
||||||
|
|
||||||
|
def test_frozen_cash_is_not_subtracted_twice(self):
|
||||||
|
self.funds(available_cash=8000, frozen_cash=2000, total_asset=10000, market_value=0)
|
||||||
|
result = self.gate(800)
|
||||||
|
self.assertTrue(result['passed'], result)
|
||||||
|
self.assertEqual(portfolio.overview()['frozen_cash'], 2000)
|
||||||
|
|
||||||
|
def test_missing_available_does_not_infer_cash_from_other_fields(self):
|
||||||
|
self.funds(available_cash=None)
|
||||||
|
cash = portfolio.cash_view()
|
||||||
|
self.assertEqual(cash['source'], 'estimate')
|
||||||
|
self.assertIsNone(cash['cash_avail'])
|
||||||
|
self.assertIsNone(cash['account_market_value'])
|
||||||
|
|
||||||
|
def test_stale_snapshot_does_not_masquerade_as_current_account(self):
|
||||||
|
self.fake.qmt.put_snapshot(kind='funds', data=FUNDS, age_sec=901)
|
||||||
|
result = portfolio.overview()
|
||||||
|
self.assertEqual(result['cash_source'], 'estimate')
|
||||||
|
for key in ('cash_avail', 'total_asset', 'account_market_value', 'frozen_cash'):
|
||||||
|
self.assertIsNone(result[key])
|
||||||
|
|
||||||
|
def test_account_display_does_not_change_strategy_valuation(self):
|
||||||
|
self.fake = install_fakes(prices={'002050.SZ': 34.41, '002518.SZ': 27.49, '688778.SH': 37.13},
|
||||||
|
positions=[{'ts_code': '002050.SZ', 'total_qty': 1800, 'avg_cost': 36.697},
|
||||||
|
{'ts_code': '002518.SZ', 'total_qty': 400, 'avg_cost': 27.549},
|
||||||
|
{'ts_code': '688778.SH', 'total_qty': 1400, 'avg_cost': 41.849}],
|
||||||
|
params={'PMS_TOTAL_SCALE': '2000000'})
|
||||||
|
self.funds()
|
||||||
|
result = portfolio.overview()
|
||||||
|
self.assertEqual(result['account_market_value'], 130190)
|
||||||
|
self.assertEqual(result['portfolio_mv'], 124916)
|
||||||
|
self.assertEqual(result['portfolio_pct'], 0.0625)
|
||||||
|
self.assertEqual(result['float_pnl'], -10746.8)
|
||||||
|
caps = portfolio.caps_ctx(portfolio.positions_view())
|
||||||
|
self.assertEqual(caps['portfolio_mv'], 124916)
|
||||||
|
self.assertEqual(caps['cash_avail'], 1806071.62)
|
||||||
|
|
||||||
|
def test_missing_account_value_is_not_replaced_by_market_estimate(self):
|
||||||
|
self.fake = install_fakes(prices={'600000.SH': 10}, positions=[
|
||||||
|
{'ts_code': '600000.SH', 'total_qty': 100, 'avg_cost': 8}])
|
||||||
|
self.funds(market_value=None, frozen_cash=None)
|
||||||
|
result = portfolio.overview()
|
||||||
|
self.assertIsNone(result['account_market_value'])
|
||||||
|
self.assertIsNone(result['frozen_cash'])
|
||||||
|
self.assertEqual(result['portfolio_mv'], 1000)
|
||||||
|
self.assertEqual(result['cash_avail'], 1806071.62)
|
||||||
|
|
||||||
|
|
||||||
|
if __name__ == '__main__':
|
||||||
|
unittest.main()
|
||||||
|
|
@ -1449,7 +1449,7 @@ def _():
|
||||||
assert fake.instructions["INS_A2"]["status"] == "EXPIRED"
|
assert fake.instructions["INS_A2"]["status"] == "EXPIRED"
|
||||||
|
|
||||||
|
|
||||||
@case("组合快照·真钱取 ws 资金快照(含当日回笼); 取不到则标明是估的")
|
@case("组合快照·真钱取 ws 可用余额,不重复加回笼;取不到则标明是估的")
|
||||||
def _():
|
def _():
|
||||||
from app.services import portfolio
|
from app.services import portfolio
|
||||||
fake = install_fakes(prices={"600000.SH": 10.0}, params={"PMS_TOTAL_SCALE": "2000000"})
|
fake = install_fakes(prices={"600000.SH": 10.0}, params={"PMS_TOTAL_SCALE": "2000000"})
|
||||||
|
|
@ -1463,10 +1463,10 @@ def _():
|
||||||
v = portfolio.positions_view()
|
v = portfolio.positions_view()
|
||||||
t = v["totals"]
|
t = v["totals"]
|
||||||
assert t["cash_source"] == "ws", t
|
assert t["cash_source"] == "ws", t
|
||||||
# 当日卖出回笼 T+0 可用, 必须算进去 —— 不算就把"卖一只买另一只"判成资金不足
|
# available_cash 已含可用回笼,统计字段不再相加。
|
||||||
assert t["cash_avail"] == round(971251.56 + 48900.0, 2), t
|
assert t["cash_avail"] == 971251.56, t
|
||||||
assert t["total_asset"] == 981448.56, t
|
assert t["total_asset"] == 981448.56, t
|
||||||
# 这一行是整件事的由来: 按 scale 估出来 200 万, 账户真钱只有 102 万, 差着一倍
|
# 按 scale 估出来 200 万,账户真钱只有约 97 万,两者不能混用。
|
||||||
assert t["cash_est"] > t["cash_avail"], (t["cash_est"], t["cash_avail"])
|
assert t["cash_est"] > t["cash_avail"], (t["cash_est"], t["cash_avail"])
|
||||||
# caps_ctx 要把真钱与来源一起带给规则闸, 否则闸门只能降级
|
# caps_ctx 要把真钱与来源一起带给规则闸, 否则闸门只能降级
|
||||||
caps = portfolio.caps_ctx(v, ts_code="600000.SH")
|
caps = portfolio.caps_ctx(v, ts_code="600000.SH")
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue