高股息候选:核验固定研究并提供独立准入契约(台账 082)
一、补齐研究至建仓的缺失入口。未知资料不放行,固定依据变化交后台处理。 二、本地桥9项新增与PMS24项专项通过,PMS48批隔离禁网回归通过。部署另行判收。 三、保留原每日榜单、自主档位、仓位和执行逻辑。新来源人工发起,不合并进原自主扫描,不制造交易验收。
This commit is contained in:
parent
2ce035367e
commit
e860d4b84c
16
api.py
16
api.py
|
|
@ -80,6 +80,22 @@ def dividend_research_health():
|
|||
return watch.health(watch.DEFAULT_ROOT, expected_data_day())
|
||||
|
||||
|
||||
@app.get("/research/dividend/candidates")
|
||||
def dividend_candidate_feed(code: str = None):
|
||||
"""独立高股息资格与来源;不修改原主榜,不触发研究。"""
|
||||
import re
|
||||
import dividend_candidates
|
||||
if code is not None and not re.fullmatch(r"\d{6}\.(SH|SZ|BJ)", code):
|
||||
raise HTTPException(status_code=400, detail="股票代码格式无效")
|
||||
try:
|
||||
return dividend_candidates.read(code=code)
|
||||
except ValueError as exc:
|
||||
raise HTTPException(status_code=503, detail=str(exc)) from exc
|
||||
except Exception as exc:
|
||||
_access.exception("高股息候选读取失败")
|
||||
raise HTTPException(status_code=503, detail="高股息资料暂不可用,请稍后再试") from exc
|
||||
|
||||
|
||||
@app.get("/plan/dates")
|
||||
def plan_dates(limit: int = 30):
|
||||
from pathlib import Path
|
||||
|
|
|
|||
|
|
@ -0,0 +1,147 @@
|
|||
"""高股息独立候选契约。仅读完整研究归档,不混入每日计划。"""
|
||||
import datetime as dt
|
||||
import re
|
||||
|
||||
from dividend_watch import BJ, day, digest, instant, number, required_period, risk_name
|
||||
|
||||
SOURCE = 'dividend'
|
||||
POLICY_VERSION = '2026.10-1'
|
||||
QUESTIONS = ('ordinary_dividend', 'earnings_resilience', 'payment_capacity',
|
||||
'balance_sheet_constraints', 'policy_commitment', 'downside_resilience')
|
||||
|
||||
|
||||
def qualification(row, *, now):
|
||||
"""有支持只允许进入建仓评估;不生成仓位、买点或投资批准。"""
|
||||
reasons = []
|
||||
special = row.get('dividend_research') or {}
|
||||
research = special.get('research') or {}
|
||||
local = instant(now).astimezone(BJ)
|
||||
if row.get('status') != 'priority' or row.get('quality') != '好':
|
||||
reasons.append('公司质地尚未达到优先核验条件')
|
||||
if not row.get('name') or risk_name(row['name']):
|
||||
reasons.append('证券名称或上市资格不满足要求')
|
||||
if (row.get('report_capture') or {}).get('status') != 'ok':
|
||||
reasons.append('个股评析原文尚未完整保存')
|
||||
if (number(row.get('yield_ttm_pct')) or 0) < 5:
|
||||
reasons.append('滚动股息不足5%或缺失')
|
||||
try:
|
||||
checked = instant(row['review_at']).astimezone(BJ)
|
||||
if checked > local:
|
||||
reasons.append('个股评析时间异常')
|
||||
if (checked.year, (checked.month-1)//3) != (local.year, (local.month-1)//3):
|
||||
reasons.append('个股评析尚未完成本季度复核')
|
||||
except (KeyError, TypeError, ValueError):
|
||||
reasons.append('个股评析时间不明')
|
||||
periods = row.get('material_periods') or {}
|
||||
if any(not isinstance(periods.get(k), str) or not re.fullmatch(r'\d{4}Q[1-4]', periods[k])
|
||||
or periods[k] < required_period(local.date()) for k in ('period_fi', 'period_rf')):
|
||||
reasons.append('财务材料尚未覆盖应披露报告期')
|
||||
for value, label in (((row.get('fundamentals') or {}).get('checked_at'), '财务与分红资料'),
|
||||
(special.get('last_checked_at'), '分红专项研究')):
|
||||
try:
|
||||
checked = instant(value).astimezone(BJ)
|
||||
if checked > local or (checked.year, checked.month) != (local.year, local.month):
|
||||
reasons.append(label+'尚未完成本月复核')
|
||||
except (TypeError, ValueError):
|
||||
reasons.append(label+'复核时间不明')
|
||||
if special.get('status') != 'ok':
|
||||
reasons.append('分红专项研究未完成或正在更新')
|
||||
if research.get('conclusion') != '有支持':
|
||||
reasons.append('分红持续性'+str(research.get('conclusion') or '尚未核验'))
|
||||
if (research.get('ts_code') != row.get('code') or research.get('schema_version') != 1
|
||||
or research.get('kind') != 'dividend_sustainability'
|
||||
or not re.fullmatch('[0-9a-f]{64}', str(research.get('ref', '')))):
|
||||
reasons.append('缺少有效的固定研究来源')
|
||||
for k in ('generated_at', 'cutoff_at'):
|
||||
try:
|
||||
if instant(research[k]) > instant(now):
|
||||
reasons.append('专项研究时间异常')
|
||||
except (KeyError, TypeError, ValueError):
|
||||
reasons.append('专项研究时间不完整')
|
||||
assessments = research.get('assessments') or {}
|
||||
if any(not isinstance(assessments.get(k), dict) or assessments[k].get('state') != 'support'
|
||||
or not assessments[k].get('evidence') for k in QUESTIONS):
|
||||
reasons.append('分红持续性六项核验尚未全部获得证据支持')
|
||||
if research.get('cashflow_conflicts'):
|
||||
reasons.append('现金流来源存在未解决差异')
|
||||
if (not isinstance(research.get('validation_warnings'), list)
|
||||
or not isinstance(research.get('unknowns'), list)
|
||||
or not research.get('validation_version')):
|
||||
reasons.append('专项研究核验记录不完整')
|
||||
if research.get('validation_warnings') or research.get('unknowns'):
|
||||
reasons.append('专项研究仍有未解决的材料或引用问题')
|
||||
if not research.get('risks'):
|
||||
reasons.append('反方研究尚未完整记录')
|
||||
if row.get('needs'):
|
||||
reasons.append('个股资料仍有待核验事项')
|
||||
return list(dict.fromkeys(reasons))
|
||||
|
||||
|
||||
def contract(bundle, check, expected, *, now=None, code=None):
|
||||
now = instant(now or dt.datetime.now(dt.timezone.utc))
|
||||
if not bundle or not re.fullmatch('[0-9a-f]{64}', str(bundle.get('id', ''))):
|
||||
raise ValueError('高股息研究尚未完整发布')
|
||||
result = bundle['result']
|
||||
if result.get('schema_version') != 1:
|
||||
raise ValueError('高股息研究格式暂不支持')
|
||||
if (day(result['data_date']) != day(expected) or instant(result['cutoff_at']) > now
|
||||
or day(result['data_date']) >= now.astimezone(BJ).date()):
|
||||
raise ValueError('高股息资料尚未更新到上一交易日')
|
||||
if not check.get('ok') or check.get('id') != bundle['id']:
|
||||
raise ValueError('高股息检查尚未完成,暂不能发起建仓')
|
||||
reviews = {r['ts_code']: r for r in bundle['source'].get('reviews', [])}
|
||||
decision = {'id': 'dividend_'+digest([bundle['id'], POLICY_VERSION]),
|
||||
'research_snapshot': bundle['id'], 'policy_version': POLICY_VERSION,
|
||||
'cutoff_at': result['cutoff_at'], 'source': SOURCE}
|
||||
rows = []
|
||||
for row in sorted(result['rows'], key=lambda r:r['code']):
|
||||
if (number(row.get('yield_ttm_pct')) or 0) < 5 or row.get('status') == 'excluded':
|
||||
continue
|
||||
reasons = qualification(row, now=now)
|
||||
special = row.get('dividend_research') or {}
|
||||
research = special.get('research') or {}
|
||||
rv = reviews.get(row['code']) or {}
|
||||
summary = dict(rv.get('summary') or {})
|
||||
if summary:
|
||||
summary.update(age_days=max(0, (now-instant(rv['ran_at'])).days),
|
||||
report_url=rv.get('report_url'), ran_at=rv.get('ran_at'))
|
||||
reference = row.get('review_ref') or {'capture_sha256': (row.get('report_capture') or {}).get('content_hash')}
|
||||
fixed = {'ref': research.get('ref'), 'conclusion': research.get('conclusion'),
|
||||
'cutoff_at': research.get('cutoff_at'), 'generated_at': research.get('generated_at'),
|
||||
'assessments': research.get('assessments'), 'risks': research.get('risks'),
|
||||
'unknowns': research.get('unknowns'), 'url': special.get('url')}
|
||||
plan_row = {'ts_code':row['code'], 'name':row.get('name'), 'candidate_source':SOURCE,
|
||||
'src':SOURCE, 'bucket':'dividend', 'decision':decision,
|
||||
'verdict':'候选' if not reasons else '仅展示',
|
||||
'company_review':summary, 'company_review_text':row.get('thesis'),
|
||||
'review_ref':reference, 'dividend_research':fixed,
|
||||
'reasons':['高股息研究核验通过'] if not reasons else reasons,
|
||||
'risk':[r.get('reason') for r in research.get('risks', []) if isinstance(r, dict)],
|
||||
'basis':row.get('thesis'), 'yield_ttm_pct':row.get('yield_ttm_pct'),
|
||||
'research':{'thesis':row.get('thesis'), 'antithesis':row.get('antithesis'),
|
||||
'needs':row.get('needs') or []}}
|
||||
rows.append({'ts_code':row['code'], 'name':row.get('name'),
|
||||
'yield_ttm_pct':row.get('yield_ttm_pct'), 'quality':row.get('quality'),
|
||||
'conclusion':research.get('conclusion') or '待核验', 'eligible':not reasons,
|
||||
'reasons':reasons, 'needs':row.get('needs') or [],
|
||||
'thesis':row.get('thesis'), 'antithesis':row.get('antithesis'),
|
||||
'research_ref':research.get('ref'), 'candidate':plan_row})
|
||||
for rank, row in enumerate(rows, 1):
|
||||
row['candidate'].update(rank=rank, selection_rank=rank)
|
||||
if code:
|
||||
rows = [r for r in rows if r['ts_code'] == code]
|
||||
return {'schema_version':1, 'source':SOURCE, 'policy_version':POLICY_VERSION,
|
||||
'data_date':result['data_date'], 'checked_at':check.get('at'),
|
||||
'decision':decision, 'eligible_count':sum(r['eligible'] for r in rows),
|
||||
'rows':rows, 'investment_approved':False}
|
||||
|
||||
|
||||
def read(*, code=None):
|
||||
import json
|
||||
from pathlib import Path
|
||||
import dividend_watch as watch
|
||||
from build_readiness import expected_data_day
|
||||
bundle = watch.read_latest(watch.DEFAULT_ROOT)
|
||||
path = Path(watch.DEFAULT_ROOT)/'last_check.json'
|
||||
check = json.loads(path.read_text()) if path.exists() else {}
|
||||
return contract(bundle, check, expected_data_day(), code=code)
|
||||
|
|
@ -844,3 +844,12 @@
|
|||
- **依据。** 当前176只高股息,排除1只风险名称,隔离6只身份未明,研究池169只。仅10只有个股评析。丽珠、海尔真实模型研究仍因材料缺口和现金流来源冲突标证据不足。五次模型尝试、六份版本可追溯;未用模型补造缺失事实。
|
||||
- **预期。** 同输入复用,失败保留旧完整结果,来源冲突使支付能力未知。桥不自动把全池投模型。当前不改变计划、排名、门槛或交易。原145份计划摘要和参数保持,137恢复后09:55自然成功14秒。
|
||||
- **复核日期。** 本轮基座238项本地禁网用例、桥70项联合及六组原脚本在候选镜像通过。基座ca69b4a、桥7111bde已生效。09:50月度空批次正常完成,模型尝试5前后一致;XXL141手工执行成功4秒。浏览器通过,基座日检0警告0错误。10-23 08:05和本日20:35的首次自然日程尚未发生,材料缺口与159家评析缺失仍保留。
|
||||
|
||||
|
||||
## 082 · 2026-10-22 · 高股息独立候选与人工建仓准备
|
||||
|
||||
- **日期。** 2026-10-22,北京时间。
|
||||
- **改动。** 桥按股息、身份、公司质地、材料期及分红专项证据确定候选资格。PMS增加独立人工入口,后台复用原数量、合议和研判。准备完成再走原快速核验与原子采纳,来源固定留痕。原每日主榜、自动扫描和参数不切换。
|
||||
- **依据。** 用户要求补齐研究到交易系统的缺失链路。研究数据已部署,但原PMS没有高股息来源。当前丽珠与海尔仍有材料和现金流冲突,不能为贯通链路降低证据要求。
|
||||
- **预期。** 可核验公司能够发起建仓评估,不等于直接买入。未知与失败不放行,报价或名次变化不反复重问模型。重复点击复用请求,旧建议明确失效时撤下。
|
||||
- **复核日期。** 本日桥9项新增、PMS24项专项及48批隔离禁网回归通过。待候选镜像、155部署与页面判收。自然合格公司与人工采纳未发生时单列,不制造交易。188不操作。
|
||||
|
|
|
|||
|
|
@ -0,0 +1,66 @@
|
|||
"""本地:python3 -m unittest test_dividend_candidates。离线合成输入。"""
|
||||
import copy
|
||||
import datetime as dt
|
||||
import unittest
|
||||
from unittest.mock import patch
|
||||
import dividend_candidates as c
|
||||
from test_dividend_watch import reviewed
|
||||
import dividend_watch as w
|
||||
|
||||
NOW=dt.datetime.fromisoformat('2026-10-22T10:00:00+08:00')
|
||||
|
||||
def good():
|
||||
src=reviewed();src.update(data_date='2026-10-21',expected_date='2026-10-21',captured_at='2026-10-22T08:05:00+08:00')
|
||||
src['factors'][0]['trade_date']='2026-10-21'
|
||||
src['reviews'][0].update(period_fi='2026Q2',period_rf='2026Q2',report_capture={'status':'ok','content_hash':'f'*64})
|
||||
src['reviews'][0]['summary'].update(unknown_n=0,antithesis='需求变化可能影响现金流')
|
||||
r=w.assemble(src)['rows'][0]
|
||||
research={'ts_code':r['code'],'schema_version':1,'kind':'dividend_sustainability','ref':'a'*64,
|
||||
'conclusion':'有支持','generated_at':'2026-10-21T12:00:00+08:00','cutoff_at':'2026-10-21T11:00:00+08:00',
|
||||
'validation_version':'2026.10-2','validation_warnings':[],'unknowns':[],'cashflow_conflicts':[],
|
||||
'assessments':{k:{'state':'support','reason':'合成证据','evidence':[{'ref':'E0001','quote':'已核验普通现金分红的实施公告'}]} for k in c.QUESTIONS},
|
||||
'risks':[{'reason':'需求下滑风险','evidence':[{'ref':'E0002','quote':'主要客户需求可能下滑'}]}]}
|
||||
r.update(needs=[],fundamentals={'checked_at':'2026-10-21T11:00:00+08:00'},
|
||||
dividend_research={'status':'ok','last_checked_at':'2026-10-21T12:00:00+08:00','research':research})
|
||||
bundle={'id':'b'*64,'source':src,'result':{'schema_version':1,'data_date':'2026-10-21','cutoff_at':src['captured_at'],'rows':[r]}}
|
||||
return bundle,{'ok':True,'id':bundle['id'],'at':'2026-10-22T08:05:01+08:00'}
|
||||
|
||||
class ContractTest(unittest.TestCase):
|
||||
def contract(self,b=None,ch=None,now=NOW,code=None):
|
||||
a,d=good();return c.contract(b or a,ch or d,'2026-10-21',now=now,code=code)
|
||||
def test_complete_support_only_enters_assessment(self):
|
||||
d=self.contract();self.assertEqual(d['eligible_count'],1);self.assertFalse(d['investment_approved'])
|
||||
self.assertNotIn('qty',d['rows'][0]['candidate']);self.assertEqual(d['rows'][0]['candidate']['risk'],['需求下滑风险'])
|
||||
def test_every_required_evidence_blocks(self):
|
||||
for key in c.QUESTIONS:
|
||||
b,ch=good();b['result']['rows'][0]['dividend_research']['research']['assessments'][key]['evidence']=[]
|
||||
self.assertEqual(self.contract(b,ch)['eligible_count'],0,key)
|
||||
def test_research_unknown_conflict_or_missing_validation_blocks(self):
|
||||
for k,v in [('unknowns',['材料缺失']),('cashflow_conflicts',[{}]),('validation_warnings',['引用缺失']),('validation_version',None),('risks',[])]:
|
||||
b,ch=good();b['result']['rows'][0]['dividend_research']['research'][k]=v
|
||||
self.assertEqual(self.contract(b,ch)['eligible_count'],0,k)
|
||||
def test_identity_st_quality_periods_and_report_required(self):
|
||||
for k,v in [('name','*ST示例'),('status','identity_unknown'),('quality','中'),('material_periods',{'period_fi':'2026Q1','period_rf':'2026Q2'}),('report_capture',{}),('needs',['待核验'])]:
|
||||
b,ch=good();b['result']['rows'][0][k]=v
|
||||
self.assertEqual(self.contract(b,ch)['eligible_count'],0,k)
|
||||
def test_month_and_quarter_refresh(self):
|
||||
b,ch=good();b['result']['rows'][0]['fundamentals']['checked_at']='2026-09-30T08:00:00+08:00'
|
||||
self.assertEqual(self.contract(b,ch)['eligible_count'],0)
|
||||
b,ch=good();b['result']['rows'][0]['review_at']='2026-09-30T08:00:00+08:00'
|
||||
self.assertEqual(self.contract(b,ch)['eligible_count'],0)
|
||||
def test_missing_stale_future_and_failed_source_never_reuses(self):
|
||||
for mutate in (lambda b,ch:b['result'].update(data_date='2026-10-20'),lambda b,ch:b['result'].update(cutoff_at='2026-10-23T00:00:00+08:00'),lambda b,ch:ch.update(ok=False),lambda b,ch:ch.update(id='c'*64)):
|
||||
b,ch=good();mutate(b,ch)
|
||||
with self.assertRaises(ValueError):self.contract(b,ch)
|
||||
def test_deterministic_order_and_query_does_not_change_global_rank(self):
|
||||
b,ch=good();r=copy.deepcopy(b['result']['rows'][0]);r['code']='000001.SZ';r['dividend_research']['research']['ts_code']=r['code'];b['result']['rows'].insert(0,r)
|
||||
full=self.contract(b,ch);b['result']['rows'].reverse();again=self.contract(b,ch)
|
||||
self.assertEqual(full,again)
|
||||
self.assertEqual(self.contract(b,ch,code='600001.SH')['rows'][0]['candidate']['rank'],2)
|
||||
def test_published_archive_never_mutated(self):
|
||||
b,ch=good();old=copy.deepcopy(b);self.contract(b,ch);self.assertEqual(b,old)
|
||||
def test_old_schema_is_not_eligible(self):
|
||||
b,ch=good();b['result']['rows'][0]['dividend_research']={}
|
||||
self.assertEqual(self.contract(b,ch)['eligible_count'],0)
|
||||
|
||||
if __name__=='__main__':unittest.main()
|
||||
Loading…
Reference in New Issue