From e860d4b84c18fb6c57b27092b3c46c3414550711 Mon Sep 17 00:00:00 2001 From: zlt Date: Thu, 22 Oct 2026 10:37:51 +0800 Subject: [PATCH] =?UTF-8?q?=E9=AB=98=E8=82=A1=E6=81=AF=E5=80=99=E9=80=89?= =?UTF-8?q?=EF=BC=9A=E6=A0=B8=E9=AA=8C=E5=9B=BA=E5=AE=9A=E7=A0=94=E7=A9=B6?= =?UTF-8?q?=E5=B9=B6=E6=8F=90=E4=BE=9B=E7=8B=AC=E7=AB=8B=E5=87=86=E5=85=A5?= =?UTF-8?q?=E5=A5=91=E7=BA=A6=EF=BC=88=E5=8F=B0=E8=B4=A6=20082=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 一、补齐研究至建仓的缺失入口。未知资料不放行,固定依据变化交后台处理。 二、本地桥9项新增与PMS24项专项通过,PMS48批隔离禁网回归通过。部署另行判收。 三、保留原每日榜单、自主档位、仓位和执行逻辑。新来源人工发起,不合并进原自主扫描,不制造交易验收。 --- api.py | 16 ++++ dividend_candidates.py | 147 ++++++++++++++++++++++++++++++++++++ docs/复盘决定台账.md | 9 +++ test_dividend_candidates.py | 66 ++++++++++++++++ 4 files changed, 238 insertions(+) create mode 100644 dividend_candidates.py create mode 100644 test_dividend_candidates.py diff --git a/api.py b/api.py index 4fdc72a..5a718ff 100644 --- a/api.py +++ b/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 diff --git a/dividend_candidates.py b/dividend_candidates.py new file mode 100644 index 0000000..a3a6fa6 --- /dev/null +++ b/dividend_candidates.py @@ -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) diff --git a/docs/复盘决定台账.md b/docs/复盘决定台账.md index 78a6b1b..9e977bd 100644 --- a/docs/复盘决定台账.md +++ b/docs/复盘决定台账.md @@ -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不操作。 diff --git a/test_dividend_candidates.py b/test_dividend_candidates.py new file mode 100644 index 0000000..dcdc40e --- /dev/null +++ b/test_dividend_candidates.py @@ -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()