交接副本同步

docs/交接_高股息候选接入PMS_2026-10-22.md

@@ -0,0 +1,130 @@
+# 高股息候选接入PMS交接
+
+## 2026-10-22 10:40 开发阶段
+
+用户要求补齐高股息研究至PMS的链路。
+默认采用独立候选区，由用户发起建仓评估。
+系统不会将高股息研究池并入原自主扫描。
+既有授权包含155模拟部署与容器重建，188不动。
+178研究数据产品已经部署，本轮无基座运行代码修改。
+
+规格见《高股息候选接入PMS开发规格_2026-10-22.md》。
+桥的新来源资格检查已实现，PMS后台准备与快速采纳已经接通。
+新请求先准备、当日有效，准备完成后才开放确认。
+提议、消费快照、动作账本和指令进度保留来源与固定引用。
+界面沿用原卡片，研究原文与反方放在详情。
+
+本地桥9项新增、PMS24项专项与全量48批禁网回归通过。
+生产尚未部署。当前真实两家公司仍有证据缺口，预计可评估数为零。
+不能制造合格研究、提议、采纳或交易补验收。
+
+10:35只读基线：155实例表前缀为空，ws下发，全局full，OPEN propose_only。
+版本核验True，上游排序False、质地排序True、档位强传导。
+规模200万元、总仓上限0.7、单股上限0.08、最大40只、目标0.06保持。
+QMT ONLINE，resync_flag=0，健康正常，对账diffs=[]、severity=OK。
+562590与688825两处事实源覆盖差异继续单列，保留ws_first。
+
+远端PMS有既存scripts/deploy.sh修改与若干排查脚本，不能清理。
+本地PMS决定台账及量化平台讨论稿、探针不是本任务改动。
+本地bionic的DS_Store和第三方指南也不纳入提交。
+
+
+## 2026-10-22 11:00 完成部署与技术验收
+
+用户已明确确认独立候选区，由本人手动发起建仓评估。
+用户登录后，真实交易员页面已核验。当前可评估为零。
+175条研究可展开查看。丽珠9.09%、海尔5.86%，均标证据不足。
+默认显示三家，支持查看全部。卡片不显示技术版本或指纹。
+展开先看论点、反方与阻塞原因，原始材料缺口另行折叠。
+完整页面和详情截图已归档，控制台错误为零。
+
+### 部署事实
+
+- 桥功能提交e860d4b84c18fb6c57b27092b3c46c3414550711。
+  10:48:46重建生效，镜像sha256:114913548acce5485c9fbec15d5fb949c674bd658d1f37b935013f5c0652d5d3。
+- PMS功能提交03e569e3c55c04991fe617b07d97b3c3534e2c9a。
+  10:51:01四服务统一重建，镜像sha256:0f298f6d5b997c603b7d57a50223267367e1f7b1112d630b8e6af187e7f711d2。
+  Python指纹83c49a380165，与禁网候选镜像一致。
+- 页面提交ccf194b，挂载即生效，未再次重启。
+  HTML SHA256为6c966a6df3e55edd31311388847b83d91b155052ff1d288241d4cdef95fbf0b8。
+  镜像仍含前一次页面，重建须带当前源码；运行页面已核对宿主与容器哈希相同。
+- 178本轮没有运行代码变化，仅同步文档。188未连接或修改。
+
+137维护期间短暂停止，桥健康后恢复。
+10:50正常执行成功15秒，之后继续五分钟检查。
+141与基座20:35月度研究调度未调整。
+
+### 运行判收
+
+10:50:54写前读数与10:51:18写后读数比较：
+19项参数完全相同，23条持仓和322条批次逐字段相同。
+108条指令未增减，数量、状态与实际成交进度相同。
+指令638、632、606只更新正常等待或拒绝的分钟时间。
+原原因与已执行数量保持，不宣称盘中所有运行字段永久不变。
+
+健康status=ok、db_ok=true、日历正常。
+QMT ONLINE，last_seq=1350932，resync_flag=0，last_error为空。
+对账只读apply_fix=False，diffs=[]、errors=[]、severity=OK、streak=0。
+562590与688825原有事实源覆盖差异不在本轮修改，保留ws_first。
+历史已暂停指令、真实成交和历史还原边界继续有效。
+
+桥旧145份计划文件逐一哈希一致，排序及数量参数一致。
+高股息来源数据日10-21，decision为：
+`dividend_27f27e1c0d42c5f119f121e93b777a2d773c302e6d2f87394de24de2be7c93c0`。
+研究快照f83b26c66d22b5f1b1a355111ecb04f7b7c99532be6cc712f5e2f78d0123aae8。
+共有175条可查看记录，包含身份待明的隔离记录，均不自动取得准入资格。
+当前可评估0条，两家优先研究仍证据不足，与验收预判一致。
+PMS只读取该来源耗时0.433秒，前后消费记录数量相同。
+未登录GET候选与POST空发起均返回401，未产生有效请求。
+
+本地PMS48批通过，候选镜像48批同样通过。
+新增24项覆盖准备、来源变化、重复请求、原数量流程及原子采纳。
+桥候选镜像79项联合用例与六组既有脚本通过，联网尝试0。
+最终三页面守卫通过，真实登录页面已判收展示与不可操作边界。
+没有为验收调用模型、生成合格研究、采纳提议或制造交易。
+没有真实合格公司，因此高股息自然准备、人工确认与成交仍未判收。
+这不阻塞已验证功能上线，也不声称存在真实投资效果证据。
+
+### 备份与回退
+
+155桥备份位于`~/akg_bridge_logs/dividend-entry-20261022/`。
+155PMS备份与镜像测试日志位于`~/pms_logs/dividend-entry-20261022/`。
+写前源码归档、配置原件及SHA、容器信息、PMS完整账务读数均保存。
+环境文件权限600，备份目录700，未下载或提交任何密钥。
+既有远端scripts/deploy.sh保持原哈希，未用它执行部署。
+
+桥回退标签为`akg-factor-bridge:rollback-before-pms-dividend-20261022`。
+PMS回退标签为`pms:rollback-before-dividend-entry-20261022`。
+回退必须开发机反向提交、远端git pull，再重建对应服务。
+155挂载源码，不能只切镜像。保留研究、提议、消费与真实成交。
+回退前暂停新的高股息发起，并核对已有提议引用。
+本轮未触发回退。
+
+本地证据目录：
+`/Users/baobao/.codex/visualizations/2026/10/14/01a1396c-4e8e-7a21-ac34-8b7f6150dfe3/pms-dividend-entry-20261022/`。
+SHA256.json登记证据哈希。核心为before/after读数、镜像测试日志、页面截图。
+
+### 用户可运行的核验
+
+```bash
+# 155模拟机 · ~/project/tradingSystem
+curl -fsS http://127.0.0.1:38100/health
+docker compose --profile sched --profile ws ps
+docker exec pms-web python /app/scripts/code_fingerprint.py
+```
+
+预期健康ok、db_ok为true，四服务running，指纹83c49a380165。
+后续有新代码时以新的部署记录为准。
+
+```bash
+# 155模拟机 · ~/project/tradingSystem
+docker run --rm --network none pms:dividend-03e569e python scripts/run_tests.py
+```
+
+这是固定候选镜像的隔离测试，不挂载生产.env，不连接数据库或模型。
+预期48批通过，最后为ALL SUITES PASS。
+
+页面核验：登录155交易员页面，展开右侧高股息研究。
+现阶段应显示零家可评估、具体待查原因，不出现准备建仓按钮。
+未来通过证据核验的公司才出现按钮。点击后先后台准备，完成后人工采纳。
+此人工链路不会被原自动扫描替代。

docs/高股息候选接入PMS开发规格_2026-10-22.md

@@ -0,0 +1,131 @@
+# 高股息候选接入PMS开发规格
+
+2026-10-22，北京时间。用户要求补齐研究到建仓的缺失链路。
+
+## 目标与范围
+
+研究结果可进入PMS独立高股息候选区。
+用户发起后，由后台准备建仓建议，完成后使用现有采纳入口。
+首版按人工发起设计，自动扫描接入方式的问题仍等待用户回复。
+不会因为名单中出现股票，就自动生成买入指令。
+只部署155桥和模拟PMS，178如无契约需要则不改，188不操作。
+
+基座保存事实与专项研究，桥决定高股息候选资格。
+PMS继续负责组合、数量、合议、研判和执行。
+沿用现有仓位、资金、行业、黑名单、买卖冲突与择时约束。
+原每日计划候选、排序和自主档位不变。
+
+## 候选资格
+
+资格来自确定性检查，不把自然语言直接翻译成交易条件。
+必须同时满足：名称及上市状态明确，非ST及退市名称，滚动股息不低于5%。
+公司质地为好，评析覆盖应披露材料期且在本季度完成核验。
+月度财务材料与分红专项研究已完成复查，数据日为上一完整交易日。
+专项结论为有支持，六项问题均有支持、引用和原文，无未解决校验警告。
+关键资料缺失、来源冲突、研究更新中或读取失败均不进入可发起名单。
+页面仍展示研究中的公司和明确缺口，不能伪造合格样本。
+有支持只允许进入建仓评估，不表示已获投资批准。
+
+## 对外契约与留痕
+
+桥新增独立JSON查询，只读取完整研究归档，不在查询时调用模型或采集材料。
+返回数据日、检查时刻、固定研究版本、准入规则版本及逐票资格原因。
+按代码稳定排序，不新增收益评分，不改变原计划版本或主榜名次。
+旧研究归档缺必要字段时保持不可发起，不能默认通过。
+
+PMS通过桥消费，复用计划快照JSON记录实际消费。
+使用独立来源标识，不能混入每日计划名册变化与历史绩效。
+提议、动作账本和指令进度保留来源及固定研究引用。
+详情中可追溯技术字段，操作卡只显示建议、依据和风险。
+
+## 人工发起与后台准备
+
+发起接口只接收股票代码和页面所见研究版本，不接受客户端仓位或合格标记。
+服务器重读当前资格，拒绝过期来源、黑名单、已持仓及冲突中的股票。
+同日同票请求复用已有提议，不因双击生成多条建议。
+先记录准备请求，复用原交易时段扫描完成组合检查、数量与研判。
+接口请求内不调用研判模型，不创建买入指令。
+准备中不能采纳。后台失败保留原因，明确资格失效时撤下。
+准备完成后沿用现有确认内容标识、快速核验与原子采纳事务。
+仅名次、无关公司更新或报价变化不重问模型。
+当前公司的研究或资格变化交后台处理，不能带旧批准继续执行。
+高股息来源即使旧版本核验开关关闭，也不得跳过其必要来源核验。
+
+## 验收预判
+
+1. 真实名单预计零家可发起。丽珠、海尔仍为证据不足，不放宽规则。
+2. 合成完整材料的公司可进入候选；缺任一关键条件均给出具体原因。
+3. 失效、未来日期、读取失败、跨月和跨季度不沿用旧资格。
+4. 发起请求零模型、零指令，重复及并发请求不重复入队。
+5. 后台复用既有数量、合议及研判，原资金、行业和买卖冲突照常拦截。
+6. 采纳使用原快速检查与事务，研究变化不能沿用旧批准，旧来源不受影响。
+7. 真实部署只做只读核验，不生成假提议、不调用模型制造合格研究、不制造交易。
+8. PMS使用配置隔离且禁网的测试入口，桥使用替身依赖。
+9. 运行三道页面守卫，浏览器核对候选、缺口与准备反馈。
+
+## 偏差发现与撤销
+
+部署前备份源码、运行参数和必要账务读数，核对实例身份。
+旧计划归档与策略参数保持，部署后核对健康、通道和账务。
+无真实合格公司时，完整自然采纳与成交单列未判收。
+若出现问题，停止高股息发起入口并保留研究与消费历史。
+回退采用开发机反向提交、服务器git pull，再重建155四服务。
+不得仅换镜像，不删除提议或真实成交，不恢复历史暂停指令。
+
+## 开发者参考
+
+桥用纯函数装配独立候选契约，接口仅核日期与归档读取状态。
+PMS新增来源适配器，输出已有建仓引擎所需形状。
+研究依据比较仅对该来源扩展，避免改变已有提议的比较结果。
+后台准备和人工确认统一分派到原来源适配器，避免重新读原主榜误撤下。
+复用现有表与调度，不新增并行研判栈或第二套采纳事务。
+
+## 2026-10-22 10:40 本地实现与验证
+
+按独立人工发起完成实现。未收到自主扫描选项的调整。
+桥增加 `/research/dividend/candidates`，逐票查询保持全量序号。
+PMS增加 `/api/dividend/candidates` 与 `/api/dividend/proposals`。
+前者只读，后者仅创建数量为零的准备请求。
+原交易时段扫描完成计算，准备结果和审计同事务发布。
+普通采纳事务继续复用，不新增表、调度或模型调用入口。
+
+新来源关闭旧计划重核开关时仍须核验自身资料。
+当前公司的固定研究变化才重算，不因名次或资料日龄变化重算。
+在途事实读取失败不能当作没有在途，高股息请求停止准备。
+同日同票重复请求复用已有提议，原自主来源不覆盖人工请求。
+已结束建议不因再次点击而复活。
+原自主扫描、命令候选与策略参数没有切到高股息来源。
+
+本地桥新增9项离线用例通过。PMS新增24项专项通过。
+PMS全量48批隔离禁网回归通过，包含原采纳事务和页面守卫。
+后续小幅页面与取数整理已经重跑专项与页面守卫。
+生产未部署，本节不构成生产判收。
+
+
+## 2026-10-22 11:00 部署与判收
+
+用户已明确选择独立候选区，由本人手动发起建仓。
+本轮实现和部署保持这一选择，不并入原自主扫描。
+桥e860d4b于10:48:46生效。PMS功能03e569e于10:51:01四服务统一生效。
+页面ccf194b随后通过源码挂载生效，仅压缩重复缺口与折叠原始记录。
+178本轮只同步文档，无运行代码变更。188未操作。
+
+候选镜像桥79项联合用例和六组既有脚本通过，联网尝试零次。
+PMS候选镜像48批配置隔离、禁网回归通过，新增24项专项。
+最终页面三道守卫通过。真实登录页面核验175条研究记录。
+可评估为零，没有准备按钮。详情层次正常，控制台无错误。
+不能将目前的零候选说成已跑通真实高股息采纳或成交。
+这些路径已有合成完整证据与事务用例，真实自然事件仍待判收。
+
+部署前后19项参数、23条持仓、322条批次完全一致。
+108条指令未增减，数量、状态和成交进度一致。
+三条指令只由正常任务更新等待或拒绝时刻，业务原因未变。
+QMT在线、健康正常，对账diffs为空、severity为OK。
+两处原有事实源覆盖差异仍单列，ws_first不变。
+
+新来源读取耗时0.433秒，读取前后消费记录数量不变。
+未登录的读取与发起接口均返回401。
+旧145份计划文件哈希及桥参数保持不变。
+137恢复后10:50自然执行成功，耗时15秒。
+本轮未调用模型生成资格，未创建验收提议、指令或交易。
+具体镜像、备份、回退和手工验证见同日交接末节。