Files
quality_analyse/scripts/nao_evidence_report.py

441 lines
30 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""Render release-bound query facts; neither the model nor rendering changes KPIs."""
import json
from decimal import Decimal, InvalidOperation, ROUND_HALF_UP
try:
from .nao_period import PERIOD_KEYS, normalize_period
except ImportError:
from nao_period import PERIOD_KEYS, normalize_period
def number(value):
if value is None or isinstance(value, bool): return None
try:
result=Decimal(str(value))
return result if result.is_finite() else None
except InvalidOperation:return None
def shown(value, percent=False, signed=False):
value=number(value)
if value is None:return '—'
if percent:value*=100
value=value.quantize(Decimal('.01'),rounding=ROUND_HALF_UP)
return ('+' if signed and value>0 else '')+f'{value:,.2f}'+('%' if percent else '')
def difference(current,previous):
a,b=number(current),number(previous)
return a-b if a is not None and b is not None else None
def change_text(value):
value=number(value)
if value is None:return '不可比'
return ('上升' if value>0 else '下降' if value<0 else '持平')+(shown(abs(value))+'个百分点' if value else '')
def product_input_text(item, stage):
now=item.get('current') or {};before=item.get('comparison') or {}
if stage in ('black','bright'):
label='黑片' if stage=='black' else '亮片'
return f'{label}投入{shown(before.get("totalWeight"))}→{shown(now.get("totalWeight"))} kg'
return ('黑片投入'+shown(before.get('blackInputWeight'))+'→'+shown(now.get('blackInputWeight'))+' kg;'
+'亮片投入'+shown(before.get('brightInputWeight'))+'→'+shown(now.get('brightInputWeight'))+' kg')
def product_priority_summary(signals, stage):
"""Keep size, change, and rate as distinct investigation signals."""
if not isinstance(signals, dict):return ''
parts=[]
for key, prefix, field in (('scrapIncrease','报废增量首位','scrapDelta'),
('currentScrap','本期报废重量首位','currentScrap'),
('rateDrop','率降幅首位','rateDrop')):
rows=signals.get(key)
if not isinstance(rows,list) or not rows or not isinstance(rows[0],dict):continue
row=rows[0];label=str(row.get('label') or row.get('key') or '')
if not label:continue
if field=='currentScrap':value=shown((row.get('current') or {}).get('scrapWeight'))+' kg'
elif field=='rateDrop':value=change_text(-number(row.get('rateDrop'))*100) if number(row.get('rateDrop')) is not None else '不可比'
else:value=shown(row.get('scrapDelta'),signed=True)+' kg'
if field=='rateDrop':value+=';'+product_input_text(row,stage)
parts.append(prefix+label+'('+value+')')
return ('多维核查线索:'+';'.join(parts)+'。三种排序各有分母和含义,不能相加为总体贡献或视为现场原因。') if parts else ''
def scope(value):return {k:v for k,v in (value or {}).items() if v not in (None,False,'',{},[])}
def cell(value):return str(value).replace('|','\\|').replace('\n',' ')
def period(value):
try:
value=normalize_period(value) or {}
except ValueError:
value=value if isinstance(value,dict) else {}
if 'monthStart' in value:
if value['monthStart'] == value['monthEnd']:
return f"{value['year']}年{value['monthStart']}月"
return f"{value['year']}年{value['monthStart']}–{value['monthEnd']}月"
return str(value.get('year',''))+'年'+(str(value['month'])+'月' if value.get('month') else '第'+str(value['quarter'])+'季度' if value.get('quarter') else '')
FILTER_KEYS=('department','group','product','projectGroup','extraFilters','columnFilters','exclusions','includeUnassigned')
def _period_key(value):
if value is None:
return None
try:
value=normalize_period(value)
except ValueError:
return None
return tuple(value.get(k) for k in PERIOD_KEYS)
def _filters(value):
return scope({k:v for k,v in (value or {}).items() if k in FILTER_KEYS})
def _frame(result):
def canonical_period(value):
if value in (None,{}):return {}
try:return normalize_period(value) or {}
except ValueError:return {'__invalid__':value}
return {'period':canonical_period((result.get('current') or {}).get('period')),
'comparisonPeriod':canonical_period((result.get('comparison') or {}).get('period')),
'filters':_filters(result.get('filterBinding'))}
def _frame_key(result):
return json.dumps(_frame(result),ensure_ascii=False,sort_keys=True)
def _matches_context(result, context):
context=context if isinstance(context,dict) else {}
try:
from .nao_agent_task import task_from_context
except ImportError:
from nao_agent_task import task_from_context
task = task_from_context(context)
if task is not None and not (task.get('kind') == 'report' and task.get('historyMode') == 'all'):
# An AI-resolved empty filter is an explicit overall task. A local
# drilldown must not replace or make its overall comparison ambiguous.
if _filters(result.get('filterBinding')) != _filters(task.get('filters', {})):
return False
selected=context.get('period') or context.get('currentPeriod') or context
if (isinstance(task,dict) and isinstance(task.get('period'),dict)
and 'monthStart' in task['period']
and not (isinstance(selected,dict) and any(key in selected for key in PERIOD_KEYS))):
selected=task['period']
if not isinstance(selected,dict):
return False
expected={k:selected[k] for k in PERIOD_KEYS if k in selected}
actual=(result.get('current') or {}).get('period') or {}
# A frozen year without month/quarter denotes the whole year, not any month in it.
if expected:
if _period_key(expected) is None or _period_key(actual) is None or _period_key(expected)!=_period_key(actual):return False
prior=context.get('comparisonPeriod')
if isinstance(prior,dict) and (_period_key(prior) is None
or _period_key((result.get('comparison') or {}).get('period'))!=_period_key(prior)):return False
filters=context.get('filters') if isinstance(context.get('filters'),dict) else context
# Empty extension filters/default booleans do not declare an overall scope.
# A same-turn local query may express a new user condition absent from the
# inherited UI context; keep such frames separate when no scope is pinned.
if any(filters.get(k) not in (None,'',{},[]) for k in ('department','group','product','projectGroup','extraFilters','columnFilters','exclusions')):
if _filters(filters)!=_filters(result.get('filterBinding')):return False
elif 'includeUnassigned' in filters:
if bool(filters.get('includeUnassigned'))!=bool((result.get('filterBinding') or {}).get('includeUnassigned')):return False
return True
def _scope_label(filters):
names={'department':'产业部','group':'业务分组','product':'规格','projectGroup':'项目组',
'extraFilters':'扩展筛选','columnFilters':'来源列条件','exclusions':'排除条件','includeUnassigned':'包含未分类'}
parts=[]
for key,value in _filters(filters).items():
if key=='columnFilters':
for rule in value:
stage='、'.join({'black':'黑片','bright':'亮片'}.get(s,s) for s in rule.get('stages',[]))
operation={'in':'为','not_in':'排除','contains':'包含片段',
'is_empty':'为空','not_empty':'不为空'}.get(rule.get('operator'),'')
parts.append(stage+'来源字段'+operation+'、'.join(rule.get('values',[])))
else: parts.append(names[key]+'='+str(value))
return ';'.join(parts) if parts else '当前授权范围内总体(默认不含未分类)'
def _stage_gap(side,stage):
# Coverage is the server-provided source-month signal. Do not recompute rates
# or reject the original business formula merely because it exceeds 100%.
from nao_quality_tools import _valid_stage_period_coverage
coverage=side.get('coverage') if isinstance(side,dict) else None
ok,reason=_valid_stage_period_coverage({'coverage':coverage},side.get('period') or {},stage)
return None if ok else reason or '阶段来源覆盖不足。'
def _stage_rate_gap(side,stage):
from nao_quality_tools import _valid_stage_rate_reference
if not isinstance(side,dict):return '缺少阶段快照。'
snapshot={**side,'summary':{stage:side.get(stage)}}
ok,reason=_valid_stage_rate_reference(snapshot,side.get('period') or {},stage)
return None if ok else reason or '阶段合格率或投入依据缺失。'
def _display_rate(side,stage=None):
if stage:
if _stage_rate_gap(side,stage):return None
value=(side.get(stage) or {}).get('rate')
rate=number(value)
return value if rate is not None and rate>=0 else None
from nao_quality_tools import _valid_composite_rate_reference
ok,_=_valid_composite_rate_reference(side,side.get('period') or {})
return side.get('compositeRate') if ok else None
def _same_periods(q,result):
if q.get('kind')=='quality_comparison':return _frame_key(q)==_frame_key(result)
current=q.get('currentPeriod') or q.get('period')
prior=q.get('comparisonPeriod')
return (isinstance(current,dict) and isinstance(prior,dict)
and _period_key(current) is not None and _period_key(prior) is not None
and _period_key(current)==_period_key((result.get('current') or {}).get('period'))
and _period_key(prior)==_period_key((result.get('comparison') or {}).get('period')))
def select_comparison_frames(evidence, context=None):
"""Select the same verified period/scope frames for text and charts."""
comparisons=[d for d in evidence if d['result'].get('kind')=='quality_comparison']
if not comparisons:return [],[]
# Exact frozen conditions take priority. Without a unique frame, retain
# separately labelled comparisons instead of selecting the broadest query.
unique={}
for document in comparisons:unique[_frame_key(document['result'])]=document
matches=[d for d in unique.values() if _matches_context(d['result'],context)]
roots=matches or list(unique.values())
limitations=[]
if not matches:limitations.append('查询证据未匹配本次提问的期间和范围,不能据此完成所要求的比较。')
elif len(roots)>1:
from nao_agent_task import task_from_context
task = task_from_context(context)
if not (task and task.get('historyMode') == 'all' and task.get('kind') == 'report'):
limitations.append('本轮证据包含多个期间和范围,尚不能确定本次提问所指的比较对象;以下分别列示。')
return roots,limitations
def build_report(evidence, context=None, question=None):
roots,limitations=select_comparison_frames(evidence,context)
if not roots:raise ValueError('收尾缺少可绑定的正式期间比较')
required_stage=(context or {}).get('stage') if isinstance(context,dict) else None
if required_stage not in ('black','bright'):required_stage=None
from nao_agent_task import task_from_context
task = task_from_context(context)
if (required_stage is None and task and task.get('kind') == 'metrics'
and len(task.get('stages') or []) == 1):
required_stage = task['stages'][0]
scrap_rate_stages = set()
if task and task.get('kind') == 'metrics' and 'scrapRate' in task.get('fields', []):
selected_stages = task.get('stages') or ['black', 'bright']
scrap_rate_stages = {stage for stage in selected_stages if stage in ('black', 'bright')}
reports=[_build_single_report(evidence,root,required_stage,
scrap_rate_stages=scrap_rate_stages) for root in roots]
if len(reports)==1:
report=reports[0]
else:
report={'headline':limitations[0] if limitations else '已整合前述各范围的正式统计,以下分别列示。', 'sections':[], 'facts':[], 'policy':'来源细分按原表记录统计。', 'missingEvidence':[], 'rawMetrics':[]}
for root,part in zip(roots,reports):
q=root['result'];label=_scope_label(q.get('filterBinding'))+';'+period(q['comparison']['period'])+'→'+period(q['current']['period'])
report['sections'].append('## '+label+'\n\n'+part['headline']+'\n\n'+'\n\n'.join(part['sections']))
for item in part['facts']:
report['facts'].append({**item,'id':'F'+str(len(report['facts'])+1),'text':label+':'+item['text']})
report['missingEvidence'].extend(part['missingEvidence']);report['rawMetrics'].append(part['rawMetrics'])
if 'VCM亮片仅录合计' in part['policy']:report['policy']=part['policy']
if question:
from nao_analysis_coverage import coverage_gaps
limitations.extend(coverage_gaps(evidence, question, context))
report['missingEvidence']=list(dict.fromkeys([*limitations,*report['missingEvidence']]))
report['coverageSufficient']=not report['missingEvidence']
return report
def _build_single_report(evidence, root, required_stage=None, *, scrap_rate_stages=None):
result=root['result'];ref=root['evidenceRef'];current=result['current'];previous=result['comparison']
if (required_stage is None and
(number(current.get('compositeRate')) is None or number(previous.get('compositeRate')) is None)):
raise ValueError('正式综合率缺失')
binding=scope(result.get('filterBinding'));a=period(previous.get('period',{}));b=period(current.get('period',{}))
facts=[];sections=[]
def fact(label,text,evidence_ref,kind):
row={'id':'F'+str(len(facts)+1),'kind':kind,'label':label,'text':text,'evidenceRef':evidence_ref}
facts.append(row);return row
def bound_lead(entries):
return ' '.join(item['text']+'['+item['evidenceRef']+']' for item in entries)
def table(title,headers,rows,evidence_ref,notice='',lead=''):
if not rows:return
sections.append('### '+title+'\n\n'+(lead+'\n\n' if lead else '')+'| '+' | '.join(headers)+' |\n| '+' | '.join(['---']*len(headers))+' |\n'
+'\n'.join('| '+' | '.join(cell(v) for v in row)+' |' for row in rows)+'\n\n['+evidence_ref+']'+(' '+notice if notice else ''))
missing=[];display_gaps=[]
for side in (previous,current):
for stage in ('black','bright'):
reason=_stage_gap(side,stage) or _stage_rate_gap(side,stage)
if reason:
display_gaps.append(reason)
if required_stage==stage:missing.append(reason)
if required_stage is None:
for side in (previous,current):
if _display_rate(side) is None:
missing.append(f"{period(side.get('period',{}))}没有可引用的正式综合合格率或有效阶段来源覆盖。")
delta_info=result.get('delta') or {}
if required_stage is None and delta_info.get('available') is False:missing.append(delta_info.get('reason') or '服务端已标记本轮正式率不可比。')
composite_delta=(delta_info.get('percentagePoints')
if delta_info.get('available') is not False
and _display_rate(previous) is not None and _display_rate(current) is not None else None)
if required_stage is None and delta_info.get('available') is not False and number(composite_delta) is None:
missing.append('服务端未提供可引用的正式综合率变化值。')
main_label={'black':'黑片合格率','bright':'亮片合格率'}.get(required_stage,'综合合格率')
delta=(result.get('stageRateChangesPP') or {}).get(required_stage) if required_stage else composite_delta
if required_stage and number(delta) is None:missing.append(main_label+'的正式变化不可比;不以其他阶段或综合率替代。')
if missing:delta=None
headline=f'{main_label}:{a}{shown(_display_rate(previous,required_stage),True)}→{b}{shown(_display_rate(current,required_stage),True)},{change_text(delta)}。[{ref}]'
fact(main_label,headline.split('。[')[0]+'。',ref,'stage' if required_stage else 'overall')
rows=[['综合合格率',shown(_display_rate(previous),True),shown(_display_rate(current),True),shown(composite_delta,signed=True)+' pp' if number(composite_delta) is not None else '不可比']]
stage_leads=[]
for stage,label in (('black','黑片'),('bright','亮片')):
now=current.get(stage) or {};before=previous.get(stage) or {};rate_delta=(result.get('stageRateChangesPP') or {}).get(stage)
before_covered=not _stage_gap(previous,stage)
now_covered=not _stage_gap(current,stage)
if _stage_rate_gap(previous,stage) or _stage_rate_gap(current,stage):rate_delta=None
old_rate,new_rate=_display_rate(previous,stage),_display_rate(current,stage)
rows.append([label+'合格率',shown(old_rate,True),shown(new_rate,True),shown(rate_delta,signed=True)+' pp' if number(rate_delta) is not None else '不可比'])
stage_fact=fact(label+'合格率',f'{label}合格率:{shown(old_rate,True)}→{shown(new_rate,True)},{change_text(rate_delta)}。',ref,'stage')
if all(number(value) is not None for value in (old_rate,new_rate,rate_delta)):stage_leads.append(stage_fact)
for key,name in (('totalWeight','投入重量'),('scrapWeight','报废重量')):
before_value=before.get(key) if before_covered else None
now_value=now.get(key) if now_covered else None
delta_value=difference(now_value,before_value) if before_covered and now_covered else None
rows.append([label+name,shown(before_value),shown(now_value),shown(delta_value,signed=True)])
table('总体与阶段',['指标',a,b,'变化'],rows,ref,'重量单位:kg;率变化单位:百分点(pp)。',bound_lead(stage_leads))
if scrap_rate_stages:
rate_rows=[]
for stage in ('black','bright'):
if stage not in scrap_rate_stages:
continue
stage_label='黑片' if stage=='black' else '亮片'
before=(previous.get(stage) or {}).get('scrapRate')
now=(current.get(stage) or {}).get('scrapRate')
from nao_quality_tools import _valid_stage_scrap_rate_reference
before_ok,_=_valid_stage_scrap_rate_reference(previous,previous.get('period') or {},stage)
now_ok,_=_valid_stage_scrap_rate_reference(current,current.get('period') or {},stage)
before_text=shown(before,True) if before_ok else '—'
now_text=shown(now,True) if now_ok else '—'
rate_rows.append([stage_label+'报废率',before_text,now_text])
fact_text=f'{stage_label}报废率:{before_text}→{now_text}。'
fact(stage_label+'报废率',fact_text,ref,'stage')
if not before_ok:
missing.append(f'{stage_label}{period(previous.get("period",{}))}正式报废率未提供或阶段来源覆盖不足。')
if not now_ok:
missing.append(f'{stage_label}{period(current.get("period",{}))}正式报废率未提供或阶段来源覆盖不足。')
table('正式报废率',[ '指标',a,b ],rate_rows,ref,
'直接引用服务端正式报废率;黑片使用修正后总重作为分母,不在此处重算或推导变化。')
rows=[];category_leads=[]
for stage,label in (('black','黑片'),('bright','亮片')):
candidates=[]
now=current.get(stage) or {};before=previous.get(stage) or {}
old={x['name']:x.get('weight') for x in before.get('defects',[])}
for item in now.get('defects',[]):
name=item['name'];weight=item.get('weight');delta=difference(weight,old.get(name))
rows.append([label+'·'+name,shown(old.get(name)),shown(weight),shown(delta,signed=True)])
entry=fact(label+'·'+name,f'{label}{name}:{shown(old.get(name))}→{shown(weight)} kg,增减{shown(delta,signed=True)} kg。',ref,'category')
if number(delta) is not None:candidates.append((abs(number(delta)),entry))
if stage=='bright' and now.get('headquartersScrapWeight') is not None:
rows.append(['亮片·本部报废',shown(before.get('headquartersScrapWeight')),shown(now.get('headquartersScrapWeight')),shown(difference(now.get('headquartersScrapWeight'),before.get('headquartersScrapWeight')),signed=True)])
if candidates:category_leads.append(max(candidates,key=lambda item:item[0])[1])
table('正式报废类别',['类别',a+'(kg)',b+'(kg)','增减(kg)'],rows,ref,lead=('本次已列类别的变化线索:'+bound_lead(category_leads)) if category_leads else '')
for document in evidence:
q=document['result'];reference=document['evidenceRef']
if q.get('kind')!='quality_changes' or not _same_periods(q,result):continue
same=scope(q.get('filters'))==binding
dimension=q.get('dimension')
stage_name={'black':'黑片','bright':'亮片'}.get(q.get('stage'),'')
rate_name=stage_name+'合格率' if stage_name else '综合率'
weight_name=stage_name+'报废增量' if stage_name else '两阶段报废增量'
if dimension in ('group','department') and same:
rows=[];leaders=[]
for item in q.get('rows',[]):
now=item.get('current') or {};before=item.get('comparison') or {};drop=number(item.get('rateDrop'));delta=-drop*100 if drop is not None else None
label=str(item.get('label') or item.get('key'))
rows.append([label,shown(before.get('rate'),True)+'→'+shown(now.get('rate'),True),shown(delta,signed=True) if delta is not None else '不可比',shown(item.get('scrapDelta'),signed=True)])
entry=fact(label,f'{label}:{rate_name}{shown(before.get("rate"),True)}→{shown(now.get("rate"),True)},{change_text(delta)};{weight_name}{shown(item.get("scrapDelta"),signed=True)} kg。',reference,'group')
entry.update(dimension=dimension, stage=q.get('stage'),
rateDrop=item.get('rateDrop'), scrapDelta=item.get('scrapDelta'))
if drop is not None:leaders.append((drop,entry))
lead=bound_lead([max(leaders,key=lambda item:(item[0]>0,abs(item[0])))[1]]) if leaders else ''
table(stage_name+('业务分组变化' if dimension=='group' else '产业部变化'),['范围',rate_name+':比较期→本期','变化(pp)',weight_name+'(kg)'],rows,reference,
'报废重量为两阶段描述,不作为单一阶段投入。' if not stage_name else '',('本次返回的组织中,'+lead) if lead else '')
elif dimension=='product' and same:
rows=[];product_leads=[]
for item in q.get('rows',[])[:5]:
now=item.get('current') or {};before=item.get('comparison') or {};label=str(item.get('label') or item.get('key'))
drop=number(item.get('rateDrop'));rate_change=change_text(-drop*100 if drop is not None else None)
input_text=product_input_text(item,q.get('stage'))
rows.append([label,shown(now.get('scrapWeight'))+' / '+shown(item.get('scrapDelta'),signed=True),
shown(before.get('rate'),True)+'→'+shown(now.get('rate'),True)+';'+rate_change,input_text])
entry=fact(label,f'{label}:{stage_name}报废{shown(before.get("scrapWeight"))}→{shown(now.get("scrapWeight"))} kg,增量{shown(item.get("scrapDelta"),signed=True)} kg;{rate_name}{shown(before.get("rate"),True)}→{shown(now.get("rate"),True)},{rate_change};{input_text}。'+
('该项仅是率变化线索,不能单凭降幅判定为重点。' if q.get('sort')=='rate_drop' else ''),
reference,'product_rate_signal' if q.get('sort')=='rate_drop' else 'product')
entry.update(dimension='product', stage=q.get('stage'))
product_leads.append(entry)
order={'scrap_delta':'报废增量','current_scrap':'当前报废重量','rate_drop':'合格率降幅'}.get(q.get('sort'),'接口排序')
title=(stage_name+'产品率变化线索' if q.get('sort')=='rate_drop' else stage_name+'重点产品')+'(按'+order+',本次返回前5)'
caution=('应结合投入规模和报废增量判断,不能只凭率降幅确定重点。' if q.get('sort')=='rate_drop' else
'报废增量也需对照投入规模与率变化;放量可能推高报废重量,本表不单独证明质量恶化或总体贡献。')
priority_note=product_priority_summary(q.get('prioritySignals'),q.get('stage'))
table(title,['规格','本期报废 / 增量(kg)',rate_name+':比较期→本期 / 变化','阶段投入:比较期→本期(kg)'],rows,reference,
f'查询共有{q.get("totalRows","未知")}个对象,本节展示所返回排名的前5项。投入为分阶段重量,不等于产件数;{caution}',
priority_note or ('' if q.get('sort')=='rate_drop' else bound_lead(product_leads[:1])))
vcm=False;cross=[]
for document in evidence:
q=document['result'];reference=document['evidenceRef']
if q.get('kind')!='quality_fine_defects' or not _same_periods(q,result):continue
stage={'black':'黑片','bright':'亮片'}.get(q.get('stage'),'')
vcm=vcm or any((c.get('expectedTotalsOnly') or {}).get('rows',0)>0 for c in q.get('categoryReconciliation',[]))
values=[dict(zip(q.get('defectColumns',[]),row)) for row in q.get('defectValues',[])]
totals_only={c.get('category') for key in ('categoryReconciliation','comparisonCategoryReconciliation')
for c in q.get(key,[]) if (c.get('expectedTotalsOnly') or {}).get('rows',0)>0
and (c.get('expectedTotalsOnly') or {}).get('rows')==c.get('sourceRows')}
usable=[row for row in values if number(row.get('currentWeight')) is not None and row.get('category') not in totals_only]
usable.sort(key=lambda row:number(row['currentWeight']),reverse=True)
same=scope(q.get('filters'))==binding
if same and q.get('dimension')=='defect':
rows=[];defect_leads=[]
for item in usable[:5]:
label=str(item.get('field'));rows.append([label,shown(item.get('comparisonWeight')),shown(item.get('currentWeight')),shown(item.get('deltaWeight'),signed=True) if item.get('deltaAvailable') is True else '不可比'])
entry=fact(stage+'·'+label,f'{stage}{label}:{shown(item.get("comparisonWeight"))}→{shown(item.get("currentWeight"))} kg,增量{shown(item.get("deltaWeight"),signed=True) if item.get("deltaAvailable") is True else "不可比"}。',reference,'defect')
entry.update(dimension='defect', stage=q.get('stage'))
if item.get('deltaAvailable') is True and number(item.get('deltaWeight')) is not None:defect_leads.append((abs(number(item['deltaWeight'])),entry))
lead=bound_lead([max(defect_leads,key=lambda item:item[0])[1]]) if defect_leads else ''
table(stage+'来源具体缺陷(按本期重量,前5)',['源字段',a+'(kg)',b+'(kg)','增量(kg)'],rows,reference,lead=lead)
elif (usable and all(_filters(q.get('filters')).get(k)==v for k,v in binding.items())
and bool((q.get('filters') or {}).get('includeUnassigned'))==bool(binding.get('includeUnassigned'))):
details=scope(q.get('filters'));label_prefix='·'.join(str(v) for k,v in details.items() if k in ('group','product'))
for item in usable[:2]:
label='·'.join(v for v in (label_prefix,stage,str(q.get('defect') or ''),str(item.get('field'))) if v)
text=f'{label}:{shown(item.get("comparisonWeight"))}→{shown(item.get("currentWeight"))} kg,增量{shown(item.get("deltaWeight"),signed=True) if item.get("deltaAvailable") is True else "不可比"}。'
entry=fact(label,text,reference,'cross');cross.append(entry)
if cross:
sections.append('### 已核对的组织/规格与缺陷联系\n\n'+'\n'.join('- '+item['text']+'['+item['evidenceRef']+']' for item in cross[:4]))
omitted=[d['evidenceRef'] for d in evidence if d['result'].get('kind') in ('quality_changes','quality_fine_defects') and not _same_periods(d['result'],result)]
if omitted:sections.append('其他期间证据未合并进上述比较:'+ '、'.join('['+r+']' for r in omitted)+'。')
policy='范围:'+_scope_label(binding)+'。来源细分按原表记录统计。'+('VCM亮片仅录合计,细分为未提供/不适用,不表示零缺陷,正式总量保留。' if vcm else '')
if required_stage:policy+=' 本轮关注'+{'black':'黑片','bright':'亮片'}[required_stage]+';其他阶段和综合率仅作同范围参考。'
if display_gaps:
policy+=' 未通过完整阶段率核验的阶段显示“—”,不把缺失阶段的默认rate=1解释为实测100%;综合率仅在每期至少一个阶段来源有效且服务端正式compositeRate存在时引用,沿用后端正式值、不重算。'+ ';'.join(dict.fromkeys(display_gaps))+'。'
return {'headline':'范围:'+_scope_label(binding)+'。\n\n'+headline,'sections':sections,'facts':facts,'policy':policy,'missingEvidence':list(dict.fromkeys(missing)),
'rawMetrics':{'evidenceRef':ref,'current':current,'comparison':previous}}
def render_report(report,selected_ids,missing):
known={item['id']:item for item in report['facts']}
if not selected_ids or len(selected_ids)>6 or any(not isinstance(key,str) or key not in known for key in selected_ids):
raise ValueError('关注方向未引用真实事实')
focus=[]
for key in dict.fromkeys(selected_ids):
item=known[key];focus.append('- '+item['text']+'['+item['evidenceRef']+']')
return report['headline']+'\n\n'+'\n\n'.join(report['sections'])+'\n\n### 重点关注\n\n'+'\n'.join(focus)+'\n\n'+report['policy']+('\n\n未覆盖内容:'+';'.join(missing) if missing else '')