Files
quality_analyse/verification/test_nao_query_plan_defects.py
T
lyun ff7bbe3e46 同步:完善质量分析工作台并更新主题字体
同步已上线的智能分析执行协议、来源查询、图表报告与管理页面配套代码。
补齐数据库迁移、运行依赖和回归测试,保留原有指标计算口径。
统一午夜黑及其他主题的控件细节、中文和业务数字字体。
排除本地业务数据、凭据、预览、发布与验收产物。

验证:生产构建通过,320项前端回归通过;本轮仅同步Git,不再次部署。
2026-10-30 22:40:58 +08:00

195 lines
12 KiB
Python

import copy
import sys
import threading
import unittest
from pathlib import Path
sys.path[:0] = [str(Path(__file__).resolve().parents[1] / 'scripts'),
str(Path(__file__).resolve().parent)]
from nao_agent_task import TaskUnavailable, normalize_task, plan_task
from nao_query_contract import bind_query
from test_nao_agent_task import task_value
def defect_catalog():
fields = [
{'stage': 'black', 'key': '责废尺寸重量', 'label': '责废尺寸重量',
'sourceField': '责废尺寸重量', 'category': '责废',
'grain': 'source_defect_weight', 'available': True},
{'stage': 'black', 'key': '料废端面重量', 'label': '料废端面重量',
'sourceField': '料废端面重量', 'category': '料废',
'grain': 'source_defect_weight', 'available': True},
{'stage': 'bright', 'key': '加工缺口重量', 'label': '加工缺口重量',
'sourceField': '加工缺口重量', 'category': '加工废',
'grain': 'source_defect_weight', 'available': True},
{'stage': 'bright', 'key': '加工数量', 'label': '加工数量',
'sourceField': '加工数量', 'category': '加工废',
'grain': 'source_defect_count', 'available': True, 'countOnly': True},
]
categories = [
{'stage': 'black', 'category': '责废', 'available': True},
{'stage': 'black', 'category': '料废', 'available': True},
{'stage': 'bright', 'category': '加工废', 'available': True},
]
return {'fineDefects': {'fields': fields, 'categories': categories}}
def defect_node(*, dimension='defect', stages=None, selector=None, defect=None,
category=None, node_id='black_defects', comparison=False):
node = {'nodeId': node_id, 'purpose': 'defects', 'dimension': dimension,
'fields': ['scrapWeight'], 'stages': stages or ['black'],
'selector': selector or {'kind': 'base'}, 'visualType': 'bar',
'visualPreference': 'auto', 'comparisonRequired': comparison}
if defect is not None:
node['defect'] = defect
if category is not None:
node['category'] = category
return node
class QueryPlanDefectNormalizationTests(unittest.TestCase):
def normalize(self, value, question='查看来源具体缺陷重量', context=None):
supplied = context or {}
business = {**defect_catalog(), **supplied.get('_businessCatalog', {})}
return normalize_task(value, question, {'_protocol': {'version': 1},
**supplied, '_businessCatalog': business})
def test_defect_node_derives_root_output_dimensions_stages_and_fields(self):
value = task_value(kind='analysis', queryPlan=[defect_node()],
dimensions=['defect'], dimensionStages={'defect': ['black']},
stages=['black'], fields=['scrapWeight'], trendRequired=False,
comparisonRequired=False, period={'year': 2026, 'month': 9})
task = self.normalize(value)
self.assertEqual(task['dimensions'], ['defect'])
self.assertEqual(task['dimensionStages'], {'defect': ['black']})
self.assertEqual(task['stages'], ['black'])
self.assertEqual(task['fields'], ['scrapWeight'])
self.assertEqual(task['queryPlan'][0]['visualType'], 'bar')
self.assertEqual(task['periodCoverage'], 'available')
def test_product_output_adds_product_and_defect_but_selector_group_is_not_output_dimension(self):
selector = {'kind': 'catalog_members', 'dimension': 'group',
'names': ['部门甲-国内', '部门甲-海外']}
node = defect_node(dimension='product', defect='责废尺寸重量', category='责废', selector=selector)
value = task_value(kind='analysis', queryPlan=[node], dimensions=['product', 'group', 'defect'],
dimensionStages={'product': ['black'], 'group': [], 'defect': ['black']},
stages=['black'], fields=['scrapWeight'], trendRequired=False,
comparisonRequired=False, period={'year': 2026, 'month': 9})
context = {'_businessCatalog': {'groups': ['部门甲-国内', '部门甲-海外']}}
task = self.normalize(value, context=context)
self.assertEqual(task['dimensions'], ['product', 'group', 'defect'])
self.assertEqual(task['dimensionStages'], {'product': ['black'], 'group': [], 'defect': ['black']})
self.assertEqual(task['queryPlan'][0]['selector'], selector)
def test_defect_output_can_follow_a_trusted_product_ranking_selector(self):
nodes = [
{'nodeId': 'rank', 'purpose': 'ranking', 'dimension': 'product', 'limit': 10,
'fields': ['totalWeight'], 'stages': ['black'], 'selector': {'kind': 'base'},
'visualType': 'pareto', 'visualPreference': 'auto', 'comparisonRequired': False},
defect_node(dimension='product', defect='责废尺寸重量',
selector={'kind': 'ranking_top', 'sourceNodeId': 'rank',
'stage': 'black', 'metric': 'totalWeight', 'count': 2},
node_id='top_defects'),
]
value = task_value(kind='analysis', queryPlan=nodes, dimensions=['product', 'defect'],
dimensionStages={'product': ['black'], 'defect': ['black']}, stages=['black'],
fields=['totalWeight', 'scrapWeight'], trendRequired=False, comparisonRequired=False,
period={'year': 2026, 'month': 9})
task = self.normalize(value)
self.assertEqual(task['dimensions'], ['product', 'defect'])
self.assertEqual(task['queryPlan'][1]['selector']['kind'], 'ranking_top')
self.assertEqual(task['queryPlan'][1]['defect'], '责废尺寸重量')
def test_category_or_defect_must_be_authorized_for_every_stage_and_not_count_only(self):
cases = [
defect_node(stages=['black', 'bright'], category='责废'),
defect_node(stages=['bright'], defect='加工数量'),
defect_node(stages=['black'], defect='责废尺寸重量', category='料废'),
]
for node in cases:
with self.subTest(node=node):
dims = ['defect']
dimension_stages = {'defect': list(node['stages'])}
value = task_value(kind='analysis', queryPlan=[node], dimensions=dims,
dimensionStages=dimension_stages, stages=list(node['stages']),
fields=['scrapWeight'], trendRequired=False, comparisonRequired=False,
period={'year': 2026, 'month': 9})
with self.assertRaises(TaskUnavailable):
self.normalize(value)
def test_auto_plan_is_limited_to_unqualified_all_detail_defect_analysis(self):
value = task_value(kind='analysis', dimensions=['defect'], dimensionStages={'defect': ['black']},
stages=['black'], fields=['scrapWeight'], trendRequired=False,
comparisonRequired=False, period={'year': 2026, 'month': 9})
task = self.normalize(value, question='查看2026年9月黑片具体缺陷重量排名')
self.assertEqual(len(task['queryPlan']), 1)
self.assertEqual(task['queryPlan'][0]['purpose'], 'defects')
self.assertEqual(task['queryPlan'][0]['dimension'], 'defect')
self.assertEqual(task['queryPlan'][0]['limit'], 100)
self.assertEqual(task['queryPlan'][0]['visualType'], 'bar')
def test_named_category_or_mixed_goal_cannot_be_silently_expanded(self):
value = task_value(kind='analysis', dimensions=['defect'], dimensionStages={'defect': ['black']},
stages=['black'], fields=['scrapWeight'], trendRequired=False,
comparisonRequired=False, period={'year': 2026, 'month': 9})
with self.assertRaises(TaskUnavailable) as raised:
self.normalize(value, question='只查看黑片责废的具体缺陷重量')
self.assertEqual(raised.exception.field, 'queryPlan')
self.assertEqual(raised.exception.expected, 'bounded defects node plan')
def test_comparison_requires_root_period_and_true_node_union(self):
node = defect_node(category='责废', comparison=True)
value = task_value(kind='analysis', queryPlan=[node], dimensions=['defect'],
dimensionStages={'defect': ['black']}, stages=['black'], fields=['scrapWeight'],
trendRequired=False, comparisonRequired=True, period={'year': 2026, 'month': 9},
comparisonPeriod={'year': 2025, 'month': 9})
task = self.normalize(value)
self.assertTrue(task['queryPlan'][0]['comparisonRequired'])
self.assertEqual(task['comparisonPeriod'], {'year': 2025, 'month': 9})
value['comparisonRequired'] = False
with self.assertRaises(TaskUnavailable):
self.normalize(value)
def test_defect_query_contract_binds_comparison_frame_and_column_filters(self):
task = normalize_task(task_value(kind='analysis', queryPlan=[defect_node(comparison=True)],
dimensions=['defect'], dimensionStages={'defect': ['black']}, stages=['black'],
fields=['scrapWeight'], trendRequired=False, comparisonRequired=True,
period={'year': 2026, 'monthStart': 3, 'monthEnd': 9},
comparisonPeriod={'year': 2025, 'monthStart': 3, 'monthEnd': 9}),
'比较两期黑片来源具体缺陷重量', {'_protocol': {'version': 1},
'_businessCatalog': defect_catalog()})
rule = {'field': 'customerCode', 'stages': ['black'], 'operator': 'in', 'values': ['C-17']}
task['filters']['columnFilters'] = [rule]
bound = bind_query({'mode': 'defects', 'releaseId': 'release-defects',
'period': task['period'], 'comparisonPeriod': task['comparisonPeriod'],
'filters': {}, 'columnFilters': [rule], 'stage': 'black', 'dimension': 'defect',
'limit': 100}, {'task': task, 'releaseId': 'release-defects', 'exactScope': True,
'nodeId': 'black_defects', 'scopeId': 'server-issued-scope'})
self.assertEqual(bound['period'], task['period'])
self.assertEqual(bound['comparisonPeriod'], task['comparisonPeriod'])
self.assertEqual(bound['columnFilters'], [rule])
with self.assertRaisesRegex(ValueError, '期间偏离'):
bind_query({**bound, 'comparisonPeriod': {'year': 2024, 'month': 9}},
{'task': task, 'releaseId': 'release-defects', 'exactScope': True,
'nodeId': 'black_defects', 'scopeId': 'server-issued-scope'})
def test_planning_payload_keeps_authorized_fine_defect_catalog(self):
from unittest.mock import patch
plan = task_value(kind='analysis', queryPlan=[defect_node()], dimensions=['defect'],
dimensionStages={'defect': ['black']}, stages=['black'], fields=['scrapWeight'],
trendRequired=False, comparisonRequired=False, period={'year': 2026, 'month': 9})
review = {'aligned': True, 'requiresEvidence': True, 'requiresSourceVerification': False,
'requiresAllSourceRows': False, 'requiresTrend': False, 'requiresComparison': False}
context = {'_protocol': {'version': 1}, '_businessCatalog': defect_catalog()}
with patch('nao_agent_task._model_json', side_effect=[plan, review]) as model_call:
planned = plan_task(base_url='https://offline.invalid/v1', api_key='synthetic', model='m',
question='比较黑片具体缺陷重量', context=context, cancel_event=threading.Event())
payload = model_call.call_args_list[0].kwargs['payload']
self.assertEqual(payload['businessCatalog']['fineDefects'], defect_catalog()['fineDefects'])
self.assertEqual(planned['queryPlan'][0]['purpose'], 'defects')
if __name__ == '__main__':
unittest.main()