"""显式切换当天计划排序。冻结输入不变,只追加版本,不调用外部来源。""" 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