akg-factor-bridge/plan_rank_switch.py

82 lines
4.2 KiB
Python
Raw Permalink Normal View History

"""显式切换当天计划排序。冻结输入不变,只追加版本,不调用外部来源。"""
from __future__ import annotations
import copy
import datetime as dt
from zoneinfo import ZoneInfo
import config
import plan
import plan_inputs as pi
import plan_versions as pv
BJ = ZoneInfo('Asia/Shanghai')
PROTECTED = ('score', 'score_adj', 'tier', 'verdict', 'reasons', 'missing', 'risk',
'pointed', 'company_review', 'logic_state', 'heat', 'upside', 'evidence')
def prepare(envelope, axis):
"""只重排已有输入;任何资格或研究内容漂移都拒绝发布。"""
if axis not in ('quality', 'transmission'):
raise ValueError('排序轴无效')
old = envelope['plan']
params = dict(envelope['params'], PLAN_RANK_AXIS=axis, CARD_SORT_BY_QUALITY=axis == 'quality')
inputs = copy.deepcopy(envelope['inputs'])
# 保留原输入截止时刻,发布时刻由 switch 单独记录。
bundle = pi.Bundle(records=inputs['records'], params=params,
cutoff_at=old['decision']['cutoff_at'])
shown = old.get('shown_params') or {'top': 20, 'obs_top': 10, 'theme_cap': 5}
with bundle.use():
data = plan.collect(old['date'], **shown)
full = data.pop('_full')
for bucket in ('main', 'observe'):
before = {r['code']: r for r in old[bucket]}
after = {r['code']: r for r in full[bucket]}
if len(after) != len(full[bucket]) or before.keys() != after.keys():
raise ValueError('排序切换不得增删股票')
for code, row in before.items():
changed = [k for k in PROTECTED if row.get(k) != after[code].get(k)]
if changed:
raise ValueError(f'冻结输入重放改变资格或研究: {code} {changed}')
data.update(main_shown=data['main'], observe_shown=data['observe'], shown_params=shown,
main=full['main'], observe=full['observe'], market=inputs.get('market'),
regime=inputs.get('regime'))
return data, inputs, params
def switch(day=None, *, axis='quality', apply=False, expected_decision_id=None, now=None):
"""默认只预览;写入要求指定被复核的版本,且运行配置与目标一致。"""
now = now or dt.datetime.now(dt.timezone.utc)
root = config.PLAN_SNAPSHOT_DIR
with pv.writer(root):
old = pv.load(root, day)
source = old.get('decision') or {}
if not source.get('id'):
raise ValueError('旧格式计划不得覆盖')
morning = pv.load(root, old['date'], morning=True)
decision_day = dt.datetime.fromisoformat(morning['decision']['cutoff_at']).astimezone(BJ).date()
if decision_day != now.astimezone(BJ).date():
raise ValueError('只能切换当前决策日,历史计划只读')
state = pv.health(root, old['date'])
if state.get('pending_codes') or state.get('error'):
raise ValueError('研究修订尚未完成,暂不切换排序')
if apply:
if not expected_decision_id or source['id'] != expected_decision_id:
raise ValueError('计划版本已变化,重新预览后再切换')
if config.PLAN_RANK_AXIS != axis or config.CARD_SORT_BY_QUALITY != (axis == 'quality'):
raise ValueError('运行配置与目标排序不一致')
env = pv.envelope(root, source['id'])
data, inputs, params = prepare(env, axis)
result = {'status': 'preview', 'source_decision': source['id'], 'axis': axis,
'main_count': len(data['main']), 'observe_count': len(data['observe']),
'input_hash': pv.digest(inputs), 'params_hash': pv.digest(params),
'first20': [{k: r.get(k) for k in ('code', 'name', 'rank', 'tier', 'quality_band')}
for r in data['main'][:20]]}
if apply:
published = pv.publish(root, data, inputs, params, cutoff_at=now.isoformat(),
reason='用户授权切换选股排序:' + axis)
plan.write_published_md(published)
result.update(status='unchanged' if published['decision']['id'] == source['id'] else 'published',
decision=published['decision'])
return result