348 lines
18 KiB
Python
348 lines
18 KiB
Python
"""微盘轮换状态与订单计算。纯函数,无行情、数据库或下单依赖。"""
|
||
import copy
|
||
import datetime as dt
|
||
import hashlib
|
||
import json
|
||
import math
|
||
import re
|
||
|
||
LEGACY_RULE = 'micro30-v1-20261027'
|
||
RULE = 'micro50-v2-20261028'
|
||
EXECUTION_RULE = 'micro50-v3-20261103'
|
||
SUPPORTED_RULES = (RULE, EXECUTION_RULE)
|
||
# 参数组成不可拆分的规则版本。运行版本由服务层经ParamStore选择并核对。
|
||
SIZE = 50
|
||
ENTRY_PERCENTILE = .08
|
||
EXIT_PERCENTILE = .85
|
||
RULE_PARAMETERS = {'entry_percentile': ENTRY_PERCENTILE, 'exit_percentile': EXIT_PERCENTILE,
|
||
'basket_size': SIZE}
|
||
PHASES = ('original', 'entering_micro', 'micro', 'returning_original')
|
||
|
||
|
||
def rule_parameters(rule=RULE, candidate_pool_size=100):
|
||
if rule not in SUPPORTED_RULES:
|
||
raise ValueError('未知微盘规则版本')
|
||
result = dict(RULE_PARAMETERS)
|
||
if rule == EXECUTION_RULE:
|
||
if not SIZE <= candidate_pool_size <= 500:
|
||
raise ValueError('冻结候选数量须在50至500之间')
|
||
result.update(candidate_pool_size=candidate_pool_size,
|
||
substitution='zero_fill_only', pricing='marketable_limit')
|
||
return result
|
||
|
||
|
||
def mainland_code(code):
|
||
return bool(isinstance(code, str) and re.fullmatch(r'(?:60\d{4}|68\d{4})\.SH|(?:00\d{4}|30\d{4})\.SZ', code))
|
||
|
||
|
||
def initial_state():
|
||
return {'phase': 'original', 'rule_version': RULE, 'cycle': 0, 'last_snapshot': None, 'entry_date': None,
|
||
'exit_date': None, 'reason': None, 'target': [], 'entry_budget': 0., 'disabled': False,
|
||
'entry_quantities': {}, 'consumed_entry': None, 'closed_date': None}
|
||
|
||
|
||
def snapshot_check(value, execution_date, *, require_frozen=True, expected_rule=None, candidate_pool_size=100):
|
||
errors = []
|
||
if not isinstance(value, dict):
|
||
return ['没有监控快照']
|
||
rule = value.get('rule_version')
|
||
if rule not in SUPPORTED_RULES or (expected_rule and rule != expected_rule) or value.get('basket_size') != SIZE or value.get('rule_parameters') != rule_parameters(rule if rule in SUPPORTED_RULES else RULE, candidate_pool_size):
|
||
errors.append('策略规则版本不一致')
|
||
if value.get('effective_date') != execution_date or str(value.get('data_date', '')) >= execution_date:
|
||
errors.append('快照日期不适用于本次执行')
|
||
if require_frozen and value.get('frozen') is not True:
|
||
errors.append('执行快照尚未冻结')
|
||
keys = ('rule_version', 'rule_parameters', 'basket_size', 'data_date', 'effective_date', 'signal_ready',
|
||
'basket_ready', 'signal', 'members', 'source_hashes', 'errors')
|
||
if rule == EXECUTION_RULE:
|
||
keys += ('candidates', 'candidate_count')
|
||
try:
|
||
body = {k: value[k] for k in keys}
|
||
digest = hashlib.sha256(json.dumps(body, sort_keys=True, ensure_ascii=False,
|
||
separators=(',', ':'), allow_nan=False).encode()).hexdigest()
|
||
if digest != value.get('snapshot_version'):
|
||
errors.append('快照摘要不一致')
|
||
signal = value['signal']
|
||
if signal.get('date') != value['data_date'] or signal.get('ready') is not value['signal_ready']:
|
||
errors.append('信号就绪或日期字段冲突')
|
||
if any(type(signal.get(k)) is not bool for k in ('growth_break', 'low', 'high')):
|
||
errors.append('信号必须是明确的布尔值')
|
||
if value['basket_ready']:
|
||
members = value['members']
|
||
if len(members) != SIZE or len({m['code'] for m in members}) != SIZE:
|
||
errors.append(f'目标名单不是{SIZE}只唯一股票')
|
||
if any(m.get('eligible') is not True or m.get('rank') != i+1 for i, m in enumerate(members)):
|
||
errors.append('名单资格或排名不完整')
|
||
if any(not mainland_code(m.get('code')) for m in members):
|
||
errors.append('名单包含沪深范围外证券')
|
||
if rule == EXECUTION_RULE:
|
||
pool = value['candidates']
|
||
if (not SIZE <= len(pool) <= candidate_pool_size or value['candidate_count'] != len(pool)
|
||
or pool[:SIZE] != members or len({m['code'] for m in pool}) != len(pool)
|
||
or any(m.get('eligible') is not True or m.get('rank') != i+1 or not mainland_code(m.get('code')) for i, m in enumerate(pool))):
|
||
errors.append('冻结候选池数量、资格或顺序不完整')
|
||
except (KeyError, ValueError, TypeError):
|
||
errors.append('快照字段不完整或数字非法')
|
||
return errors
|
||
|
||
|
||
def transition(state, snapshot, *, micro_qty, original_qty, budget, control='run', micro_pending=False):
|
||
s = copy.deepcopy(state)
|
||
if s['phase'] not in PHASES:
|
||
raise ValueError('未知轮换阶段')
|
||
ready = bool(snapshot and snapshot.get('signal_ready'))
|
||
signal = snapshot['signal'] if ready else {}
|
||
if control == 'pause_all':
|
||
return s
|
||
if control != 'exit_disable' and snapshot and s['phase'] in ('entering_micro', 'micro') and s.get('rule_version', LEGACY_RULE) != snapshot.get('rule_version'):
|
||
raise ValueError('持仓轮次规则与新快照不一致,不能隐式更换策略')
|
||
if control == 'exit_disable':
|
||
s['disabled'] = True
|
||
if s['phase'] != 'original' or micro_qty:
|
||
s['phase'], s['reason'] = 'returning_original', '用户退出并停用'
|
||
if ready and signal.get('high') and s['phase'] in ('entering_micro', 'micro'):
|
||
s.update(phase='returning_original', exit_date=snapshot['effective_date'], reason='微盘活跃度高位')
|
||
if s['phase'] == 'returning_original' and micro_qty == 0 and not micro_pending:
|
||
s.update(phase='original', target=[], entry_budget=0., entry_quantities={}, buy_targets={}, execution_day=None,
|
||
closed_date=(snapshot or {}).get('effective_date') or s.get('exit_date'))
|
||
return s # 清完当天不立即重开下一轮。
|
||
fresh_entry = snapshot and snapshot.get('snapshot_version') != s.get('consumed_entry') and snapshot.get('effective_date') != s.get('closed_date')
|
||
if s['phase'] == 'original' and fresh_entry and not s['disabled'] and control == 'run' and ready and snapshot.get('basket_ready') and not signal.get('high') and (signal.get('growth_break') or signal.get('low')):
|
||
if micro_qty:
|
||
raise ValueError('旧微盘持仓未清完,不能再次入场')
|
||
s.update(phase='entering_micro', cycle=s['cycle']+1, entry_date=snapshot['effective_date'],
|
||
rule_version=snapshot['rule_version'],
|
||
entry_budget=max(0., budget), entry_quantities={}, buy_targets={}, execution_day=None, consumed_entry=snapshot['snapshot_version'],
|
||
reason='成长主线瓦解' if signal['growth_break'] else '微盘活跃度极低')
|
||
if snapshot and snapshot.get('basket_ready') and s['phase'] in ('entering_micro', 'micro'):
|
||
if s.get('rule_version') != EXECUTION_RULE or s.get('execution_day') != snapshot['effective_date']:
|
||
s['target'] = [r['code'] for r in snapshot['members']]
|
||
if snapshot:
|
||
s['last_snapshot'] = snapshot['snapshot_version']
|
||
return s
|
||
|
||
|
||
def resolve_targets(state, snapshot, *, micro=(), pending=(), unavailable=None):
|
||
"""每日冻结排名只作确定性递补。已成交或尚有在途的成员始终占原席位。"""
|
||
if state.get('rule_version') != EXECUTION_RULE or state['phase'] not in ('entering_micro', 'micro') or not snapshot.get('basket_ready'):
|
||
return []
|
||
day = snapshot['effective_date']
|
||
if state.get('execution_day') != day:
|
||
state.update(execution_day=day, target=[m['code'] for m in snapshot['members']],
|
||
skipped_candidates={}, substitutions=[])
|
||
owned = {r['ts_code'] for r in micro if int(r.get('total_qty') or 0) > 0}
|
||
active = {r['ts_code'] for r in pending}
|
||
blocked = unavailable or {}
|
||
skipped = state.setdefault('skipped_candidates', {})
|
||
target = list(state['target'])
|
||
waits = []
|
||
for code in target:
|
||
if code in blocked:
|
||
if code in owned or code in active:
|
||
waits.append(code+'已成交或委托未结清,保留席位')
|
||
else:
|
||
skipped.setdefault(code, str(blocked[code]))
|
||
# 同一天不恢复已经跳过的成员。候选也须确认无持仓、无在途才可跳过。
|
||
kept = [c for c in target if c not in skipped or c in owned or c in active]
|
||
removed = [c for c in target if c not in kept]
|
||
pool = snapshot['candidates']
|
||
for member in pool:
|
||
if len(kept) >= SIZE:
|
||
break
|
||
code = member['code']
|
||
if code in kept or code in skipped:
|
||
continue
|
||
if code in blocked and code not in owned and code not in active:
|
||
skipped[code] = str(blocked[code])
|
||
continue
|
||
kept.append(code)
|
||
previous = removed.pop(0) if removed else None
|
||
state.setdefault('substitutions', []).append({'from': previous, 'to': code,
|
||
'rank': member['rank'], 'reason': skipped.get(previous, '补充未完成席位'),
|
||
'snapshot_version': snapshot['snapshot_version']})
|
||
state['target'] = kept
|
||
state['target_shortfall'] = max(0, SIZE-len(kept))
|
||
state['buy_targets'] = {c: t for c, t in state.get('buy_targets', {}).items() if c in kept}
|
||
if len(kept) < SIZE:
|
||
waits.append('候选已用尽,未完成席位'+str(SIZE-len(kept)))
|
||
return waits
|
||
|
||
|
||
def board(code):
|
||
if code.startswith('68'):
|
||
return 'STAR'
|
||
if code.startswith('30'):
|
||
return 'CHINEXT'
|
||
return 'MAIN'
|
||
|
||
|
||
def min_qty(code):
|
||
return 200 if board(code) == 'STAR' else 100
|
||
|
||
|
||
def fee(value, side, *, rate=.0003, minimum=5., sell_tax=.0005, transfer_rate=.00001):
|
||
return round(max(minimum, value*rate)+value*transfer_rate+(value*sell_tax if side == 'sell' else 0), 2)
|
||
|
||
|
||
def buy_qty(code, price, budget, costs):
|
||
if not math.isfinite(price) or price <= 0 or not math.isfinite(budget) or budget <= 0:
|
||
return 0
|
||
qty = int(budget/price)//100*100
|
||
while qty >= min_qty(code) and qty*price+fee(qty*price, 'buy', **costs) > budget:
|
||
qty -= 100
|
||
return qty if qty >= min_qty(code) else 0
|
||
|
||
|
||
def preflight(members, budget, allowed_boards, costs):
|
||
issues = []
|
||
if len(members) != SIZE:
|
||
return [f'目标名单数量不是{SIZE}只']
|
||
for m in members:
|
||
if board(m['code']) not in allowed_boards:
|
||
issues.append(m['code']+'板块权限未确认')
|
||
if not buy_qty(m['code'], float(m['close']), budget/SIZE, costs):
|
||
issues.append(m['code']+'等资金份额不足最小交易单位及费用')
|
||
return issues
|
||
|
||
|
||
def orders(state, snapshot, *, original, micro, quotes, cash, account_mv, cap_amount,
|
||
reserve_cash=0., pending=(), control='run', blacklisted=(), costs=None, buy_restrictions=None):
|
||
"""只形成意图,不把计划卖出计入现金。调用者落表后再执行。"""
|
||
from app.core.planner import plan_reduce_exposure
|
||
costs = costs or {}
|
||
result, waits = [], []
|
||
if control == 'pause_all':
|
||
return result, ['用户暂停全部执行']
|
||
active_codes = {r['ts_code'] for r in pending}
|
||
original_by = {r['ts_code']: r for r in original if r.get('total_qty', 0) > 0}
|
||
micro_by = {r['ts_code']: r for r in micro if r.get('total_qty', 0) > 0}
|
||
phase = state['phase']
|
||
if phase == 'entering_micro':
|
||
positions = [{**p, 'price': quotes.get(c, {}).get('price')} for c, p in original_by.items()]
|
||
release = sum(p['total_qty']*p['price'] for p in positions if p.get('price'))
|
||
plan = plan_reduce_exposure(release_amount=release, positions=positions)
|
||
seen = set()
|
||
for item in plan['items']:
|
||
if item['side'] != 'sell':
|
||
continue
|
||
c = item['ts_code']
|
||
if c in seen:
|
||
continue
|
||
seen.add(c)
|
||
# 同股先完成加仓部分,再由下一跳重算剩余批次;不能提前整股清仓。
|
||
result.append({'book_id': 'original', 'ts_code': c, 'side': 'sell',
|
||
'qty': min(int(item['qty']), original_by[c]['total_qty']), 'reason': item['reason']})
|
||
for c, p in original_by.items():
|
||
if c not in seen and p.get('total_qty'):
|
||
result.append({'book_id': 'original', 'ts_code': c, 'side': 'sell', 'qty': p['total_qty'], 'reason': '轮换剩余持仓退出'})
|
||
target = set(state['target']) if phase in ('entering_micro', 'micro') else set()
|
||
for c, p in micro_by.items():
|
||
if phase == 'returning_original' or (snapshot and snapshot.get('basket_ready') and c not in target):
|
||
result.append({'book_id': 'micro30', 'ts_code': c, 'side': 'sell', 'qty': p['total_qty'], 'reason': '高位清仓或成员调出'})
|
||
result = [r for r in result if r['ts_code'] not in active_codes]
|
||
if phase not in ('entering_micro', 'micro') or control != 'run' or not snapshot or not snapshot.get('basket_ready'):
|
||
return result, waits
|
||
available = max(0., min(cash-reserve_cash, cap_amount-account_mv))
|
||
# 入场期间保留既定每股资金目标,以便原策略分批回款后继续完成建仓。
|
||
missing = sorted(c for c in target if c not in micro_by)
|
||
objectives = state.setdefault('buy_targets', {})
|
||
objectives = {c: t for c, t in objectives.items() if c in target}
|
||
state['buy_targets'] = objectives
|
||
candidates = sorted(target) if phase == 'entering_micro' else sorted(set(missing)|{
|
||
c for c, t in objectives.items() if int(t['qty']) > int(micro_by.get(c, {}).get('total_qty') or 0)})
|
||
per_new = available/len(missing) if missing else 0.
|
||
for c in candidates:
|
||
if buy_restrictions and c in buy_restrictions:
|
||
waits.append(c+':'+buy_restrictions[c])
|
||
continue
|
||
if c in original_by or c in active_codes or c in blacklisted:
|
||
waits.append(c+'旧仓、在途委托或黑名单阻止买入')
|
||
continue
|
||
q = quotes.get(c, {})
|
||
price = q.get('price')
|
||
if not price or price <= 0:
|
||
waits.append(c+'没有有效行情')
|
||
continue
|
||
owned_qty = micro_by.get(c, {}).get('total_qty', 0)
|
||
if phase == 'entering_micro':
|
||
quantities = state.setdefault('entry_quantities', {})
|
||
# 首次有行情时固定数量,部分成交只补剩余,不随价格下跌重新等权。
|
||
if c not in quantities:
|
||
target_qty = buy_qty(c, price, state['entry_budget']/SIZE, costs)
|
||
if target_qty:
|
||
quantities[c] = target_qty
|
||
if c not in quantities:
|
||
waits.append(c+'份额不足最小交易单位及费用')
|
||
continue
|
||
remaining_qty = max(0, quantities[c]-owned_qty)
|
||
desired = remaining_qty*price+fee(remaining_qty*price, 'buy', **costs) if remaining_qty else 0.
|
||
else:
|
||
if c not in objectives:
|
||
target_qty = buy_qty(c, price, per_new, costs)
|
||
if not target_qty:
|
||
waits.append(c+'可用资金不足最小交易单位及费用')
|
||
continue
|
||
objectives[c] = {'qty': target_qty, 'snapshot_version': snapshot['snapshot_version'],
|
||
'effective_date': snapshot['effective_date']}
|
||
remaining_qty = max(0, int(objectives[c]['qty'])-owned_qty)
|
||
desired = remaining_qty*price+fee(remaining_qty*price, 'buy', **costs) if remaining_qty else 0.
|
||
budget = min(available, desired)
|
||
qty = buy_qty(c, price, budget, costs)
|
||
qty = min(qty, remaining_qty)
|
||
if qty:
|
||
result.append({'book_id': 'micro30', 'ts_code': c, 'side': 'buy', 'qty': qty, 'reason': '初始建仓补齐' if phase == 'entering_micro' else '名单调入'})
|
||
available -= qty*price+fee(qty*price, 'buy', **costs)
|
||
return result, waits
|
||
|
||
|
||
def apply_paper_fill(account, order, price, trade_date, costs, prices=None):
|
||
"""独立纸面现金账,不接真实成交。相同成交键只记一次,T+1按买入日约束。"""
|
||
key = order['id']
|
||
if key in account['fills']:
|
||
return False
|
||
book, code, side, qty = order['book_id'], order['ts_code'], order['side'], order['qty']
|
||
positions = account['books'][book]
|
||
position = positions.setdefault(code, {'qty': 0, 'cost': 0., 'lots': []})
|
||
amount = qty*price
|
||
fees = fee(amount, side, **costs)
|
||
from app.core import rotation_account as capital
|
||
values = {}
|
||
prices = prices or {code: price}
|
||
for b in ('original', 'micro30'):
|
||
if any(c not in prices for c, p in account['books'][b].items() if p['qty']):
|
||
raise ValueError('纸面划拨前需要完整持仓估值')
|
||
values[b] = sum(p['qty']*prices.get(c, 0) for c, p in account['books'][b].items())
|
||
if 'capital' not in account:
|
||
account['capital'] = capital.seed(account['cash'], values)
|
||
cashbook = account['capital']
|
||
if side == 'buy':
|
||
if account['cash']+1e-8 < amount+fees:
|
||
raise ValueError('纸面账户现金不足')
|
||
need = max(0., amount+fees-cashbook['cash'][book])
|
||
if need:
|
||
capital.transfer(cashbook, 'original' if book == 'micro30' else 'micro30', book, need, values, 'fund:'+key)
|
||
capital.fill(cashbook, book, side, amount, fees, key)
|
||
account['cash'] -= amount+fees
|
||
position['qty'] += qty
|
||
position['cost'] += amount+fees
|
||
position['lots'].append({'date': trade_date, 'qty': qty})
|
||
else:
|
||
available = sum(r['qty'] for r in position['lots'] if r['date'] < trade_date)
|
||
if qty > available or qty > position['qty']:
|
||
raise ValueError('纸面账本可卖数量不足')
|
||
capital.fill(cashbook, book, side, amount, fees, key)
|
||
old_qty = position['qty']
|
||
position['qty'] -= qty
|
||
released_cost = position['cost']*qty/old_qty
|
||
position['cost'] -= released_cost
|
||
account['cash'] += amount-fees
|
||
account['realized'][book] += amount-fees-released_cost
|
||
remaining = qty
|
||
for lot in position['lots']:
|
||
taken = min(remaining, lot['qty']) if lot['date'] < trade_date else 0
|
||
lot['qty'] -= taken
|
||
remaining -= taken
|
||
account['fees'][book] += fees
|
||
account['fills'][key] = {**order, 'price': price, 'date': trade_date, 'fee': fees}
|
||
return True
|