Spaces:
Sleeping
Sleeping
Download src/apps/workbench/business_scope.py from dellweb3/VibeCoding: direct link, hf CLI and curl.
- Browser
- Download file 16.6 kB
-
https://huggingface.co/spaces/dellweb3/VibeCoding/resolve/main/src/apps/workbench/business_scope.py
- Command line
-
hf download hf://spaces/dellweb3/VibeCoding/src/apps/workbench/business_scope.py
-
curl -L -o business_scope.py https://huggingface.co/spaces/dellweb3/VibeCoding/resolve/main/src/apps/workbench/business_scope.py
16.6 kB
| """Local, conservative scope admission. No model calls or industry defaults.""" | |
| import json | |
| import re | |
| import time | |
| import uuid | |
| from src.modules.skill.domain.models import SkillError, digest | |
| def outline(requirement): | |
| """Check four independent dimensions, never text length. | |
| Unknown domains deliberately require confirmation instead of guessing a | |
| complete industry schema. The full user text remains the binding scope. | |
| """ | |
| objects=list(dict.fromkeys(re.findall(r'订单|库存|客户|工单|设备|商品|员工|合同|运单|车辆|费用|任务|联系人',requirement))) | |
| matches=re.finditer(r'查询|检索|搜索|新增|添加|创建|修改|更新|调整|删除|出库|入库|占用|预采购|计算|校验|登记|跟踪|报表|审批|批量导入|多仓库',requirement) | |
| aliases={'检索':'查询','搜索':'查询','添加':'新增','创建':'新增','更新':'修改','调整':'修改'} | |
| operations=list(dict.fromkeys(aliases.get(m.group(),m.group()) for m in matches | |
| if not re.search(r'不(?:要|做|需要|包含)|暂不|下轮',requirement[max(0,m.start()-5):m.start()]))) | |
| rule=bool(re.search(r'不得|不能|不允许|仅|只能|必须|不超过|至少|大于|小于|不能为空|唯一|非负|找不到|不存在|未找到',requirement)) | |
| acceptance=bool(re.search(r'显示|返回|验收|测试|提示|查不到|未找到|拒绝',requirement)) | |
| sensitive_text=re.sub(r'(?:无需|不需要|不)(?:连接|接入|接|写入|修改)[^,,。;;\n]*','',requirement) | |
| sensitive=bool(re.search(r'权限|审批|真实.*(?:写入|修改|数据库)|生产.*(?:写入|修改)',sensitive_text)) | |
| dimensions={'business_objects':bool(objects),'core_operations':bool(operations),'key_rules':rule,'acceptance':acceptance} | |
| questions=[] | |
| if not objects:questions.append('首版要管理哪一种业务对象?') | |
| if not operations:questions.append('首版最重要的查询或操作是什么?') | |
| if not rule:questions.append('哪些输入或状态变化需要允许、拒绝?如有状态,请给出状态值和转换规则。') | |
| if not acceptance:questions.append('完成一个怎样的操作、看到什么结果,就算首版通过?') | |
| if sensitive:questions.insert(0,'涉及的角色权限、审批条件或真实数据写入范围是什么?这些能力未明确前不会连接或执行。') | |
| explicit=[] | |
| for feature in ['报表','审批','批量导入','多仓库','多角色','删除','新增','新建']: | |
| if feature in requirement:explicit.append(feature) | |
| return {'problem':requirement,'functions':operations or ['先确认一个主要业务操作'], | |
| 'objects':objects,'dimensions':dimensions, | |
| 'can_start':bool(objects and operations) and not sensitive, | |
| 'excluded':[label for label,words in [('报表',['报表']),('多角色审批',['审批','权限','多角色']),('批量导入',['导入']),('多仓库',['仓库']),('真实系统写入',['真实','生产'])] if not any(x in requirement for x in words)], | |
| 'explicit_features':explicit,'assumptions':[ | |
| '仅在本地隔离演示环境验证,合成数据量按用户明确要求保留;不接客户真实数据库。', | |
| '未明确的业务规则保持待定,不把知识库行业惯例变成已确认需求。'], | |
| 'questions':questions[:3], | |
| 'acceptance':['逐项验证原需求中的核心操作与结果,错误输入得到明确提示。', | |
| '未明确状态规则时,建议人工填写业务状态文本,不预设行业状态机;用户确认此假设后才实现。'] if not rule else ['按原需求逐项执行核心操作、关键规则及可见结果;原文要求全部保留。'], | |
| 'ready':all(dimensions.values()) and not sensitive, | |
| 'knowledge_policy':'规则和模板仅为候选,不构成需求授权', | |
| 'implementation_policy':'复用现有框架;本轮仅实现确认范围,后续新增进入新版本,以定向差异修改保留其他功能。'} | |
| def scope_estimate(text,functions,acceptance,limits): | |
| """Planning heuristic only; actual preflight and ledger stay authoritative.""" | |
| parts={'output_allowances':limits['design_output']+limits['code_output']+limits['repair_output']*limits['max_repairs'], | |
| 'requirement_and_envelopes':(len(text.encode('utf8'))+2048)*(2+limits['max_repairs']), | |
| 'feature_allowance':1800*len(functions),'acceptance_allowance':800*len(acceptance), | |
| 'data_generation_allowance':max([len(n)*512 for n in re.findall(r'(\d+)\s*条',text)] or [0])} | |
| return {'estimated_tokens':sum(parts.values()),'parts':parts,'method':'scope-planning-heuristic-v1', | |
| 'actual_tokens':None,'guaranteed':False} | |
| class BusinessScopes: | |
| def __init__(self,engine): | |
| self.engine=engine | |
| with engine.store.connect() as db: | |
| db.execute('CREATE TABLE IF NOT EXISTS business_scopes(id TEXT PRIMARY KEY,owner TEXT NOT NULL,request_key TEXT NOT NULL,body TEXT NOT NULL,UNIQUE(owner,request_key))') | |
| def get(self,actor,key): | |
| self.engine.spec(actor,'business-app') | |
| with self.engine.store.connect() as db: | |
| row=db.execute('SELECT body FROM business_scopes WHERE id=? AND owner=?',(key,actor.user_id)).fetchone() | |
| if not row:raise SkillError('SCOPE_NOT_FOUND','范围方案不存在或不可见。',404) | |
| return json.loads(row['body']) | |
| def limits(self,actor): | |
| limits=getattr(self.engine,'resource_limits',None) | |
| if not limits:return None | |
| limits=dict(limits) | |
| if hasattr(self.engine,'skills'): | |
| spec=self.engine.spec(actor,'business-app') | |
| budget=self.engine.skills.read_draft(self.engine.author,spec['skill'])['body']['budget'] | |
| for name in ('max_tokens','max_model_calls','max_repairs','max_seconds'): | |
| limits[name]=min(limits[name],budget[name]) | |
| return limits | |
| def prepare(self,actor,requirement,key,*,parent_id=None,base_run=None,supplement=None): | |
| self.engine.spec(actor,'business-app') | |
| parent=self.get(actor,parent_id) if parent_id else None | |
| if parent: | |
| if parent['original_requirement']!=requirement:raise SkillError('SCOPE_REQUIREMENT_CHANGED','原需求不可覆盖;补充内容另存新版本。',409) | |
| base_run=base_run or parent.get('base_run') | |
| prior=None | |
| if base_run: | |
| prior=self.engine.job(actor,base_run) | |
| original=self.engine.store.get(base_run) | |
| if original['owner_id']!=actor.user_id or prior['scenario']!='business-app':raise SkillError('SCOPE_BASELINE_INVALID','只能引用本人业务任务。',403) | |
| if prior['status'] not in {'verified','failed','cancelled'} or any(c['state'] in {'unknown','reserved'} for c in prior['model_calls']): | |
| raise SkillError('SCOPE_BASELINE_UNCERTAIN','运行中或结果未知的任务不能借调整范围重放;先核对原结果与预留。',409) | |
| supplements=[*(parent.get('supplements',[]) if parent else []),*([supplement] if supplement else [])] | |
| text=requirement+''.join('\n用户补充:'+s for s in supplements) | |
| if len(text.encode('utf8'))>6000:raise SkillError('SCOPE_TOO_LARGE','本轮需求与补充合计超出6000 UTF-8字节,请拆分下一轮;原文保留,未截断。',409) | |
| card=outline(text) | |
| for entry in reversed(supplements): | |
| only=re.search(r'本轮(?:只|仅)(?:做|实现|保留)?([^,,。;;\n]+)',entry) | |
| if only: | |
| selected=[f for f in outline(only.group(1))['functions'] if f!='先确认一个主要业务操作'] | |
| if selected: | |
| deferred=[f for f in card['functions'] if f not in selected] | |
| card.update(functions=selected,deferred_by_user=deferred,phases=[selected,*([deferred] if deferred else [])]) | |
| break | |
| limits=self.limits(actor) | |
| if limits: | |
| card['all_functions']=list(card['functions']) | |
| card['deferred_functions']=card.get('deferred_by_user',[]) | |
| acceptance_section=re.split(r'验收(?:点|条件|标准)?[::]',text,maxsplit=1) | |
| stated=[] | |
| if len(acceptance_section)>1: | |
| stated=[p.strip(' \n-;;') for p in re.split(r'[;;\n]+',acceptance_section[1]) if p.strip(' \n-;;')] | |
| if '订单' in card['objects'] and '查询' in card['functions'] and '修改' in card['functions']: | |
| card['acceptance']=['按订单号查询当前状态。','人工填写并提交本轮确认的订单状态。','再次查询同一订单,状态必须等于刚提交的新值。','空订单号、未知订单号和空状态得到明确提示且不写入。'] | |
| if not card['dimensions']['key_rules']:card['assumptions'].append('本阶段由人工填写状态文本,不预设状态枚举或自动流转;后续确认业务规则后再增量实现。') | |
| data_counts=re.findall(r'(\d+)\s*条',text) | |
| data_acceptance=['核对原需求中 '+n+' 条数据的总记录数、表格展示或分页回读,不用少量样例代替。' for n in dict.fromkeys(data_counts)] | |
| card['data_requirements']=data_acceptance | |
| current_points=[];later_points=[] | |
| for point in stated: | |
| related=[f for f in card['functions']+card['deferred_functions'] if f in point or (f=='预采购' and '采购' in point) | |
| or (f=='查询' and re.search('检索|搜索',point)) or (f=='修改' and re.search('调整|更新',point))] | |
| if related and any(f in card['deferred_functions'] for f in related):later_points.append(point) | |
| else:current_points.append(point) | |
| if stated:card['acceptance']=current_points or ['验证当前阶段核心操作及必要的无效输入处理;后续功能的验收保留到对应阶段。'] | |
| card['acceptance']+=data_acceptance | |
| allowance=limits['max_tokens']*limits['scope_budget_percent']//100 | |
| full=scope_estimate(text,card['functions'],card['acceptance'],limits) | |
| adjusted=full['estimated_tokens']>allowance | |
| if adjusted: | |
| cap=min(limits['max_features'],len(card['functions'])) | |
| while cap>0 and scope_estimate(text,card['functions'][:cap],card['acceptance'][:limits['max_acceptance']],limits)['estimated_tokens']>allowance:cap-=1 | |
| card['deferred_functions']=card['functions'][cap:]+card['deferred_functions'] | |
| card['functions']=card['functions'][:cap] | |
| later_points=[];current_points=[] | |
| for point in stated or card['acceptance']: | |
| related=outline(point)['functions'] | |
| deferred=any(f in card['deferred_functions'] for f in related) or ('预采购' in card['deferred_functions'] and '采购' in point) | |
| (later_points if deferred else current_points).append(point) | |
| card['acceptance']=current_points[:limits['max_acceptance']] | |
| later_points+=current_points[limits['max_acceptance']:] | |
| card['deferred_acceptance']=later_points | |
| card['phases']=[card['functions']]+([card['deferred_functions']] if card['deferred_functions'] else []) | |
| card['execution_mode']='adjusted' if adjusted or card.get('deferred_by_user') else 'original' | |
| estimate=scope_estimate(text,card['functions'],card['acceptance'],limits) | |
| card['budget_estimate']={**estimate,'original_estimated_tokens':full['estimated_tokens'], | |
| 'planning_allowance':allowance,'task_token_limit':limits['max_tokens'], | |
| 'reserve_percent':100-limits['scope_budget_percent'], | |
| 'fits':bool(card['functions']) and estimate['estimated_tokens']<=allowance} | |
| if not card['budget_estimate']['fits']:card['can_start']=False | |
| card['resource_budget']=limits | |
| from src.modules.governance.resource_limits import timing_guidance | |
| card['timeout_guidance']=timing_guidance(self.engine.store) | |
| card['phase_rule']='预算可覆盖时完整保留原需求;只有预算不足或客户主动调整才分期,后续阶段需另行确认。' | |
| # Explicit exclusions require their own confirmation after a failed run; | |
| # never retroactively change that run, its tests or its acceptance. | |
| direct=card['ready'] and card.get('execution_mode','original')=='original' and card.get('budget_estimate',{}).get('fits',True) and not parent and not base_run | |
| value={'id':'scope-'+uuid.uuid4().hex,'original_requirement':requirement,'requirement':text, | |
| 'supplements':supplements,'parent_id':parent_id,'base_run':base_run, | |
| 'version':parent['version']+1 if parent else 1,'card':card, | |
| 'status':'confirmed' if direct else 'waiting_scope', | |
| 'confirmation':'explicit-requirement' if direct else None, | |
| 'new_acceptance_baseline':bool(base_run),'created_at':time.time(), | |
| 'prior_requirement':prior['requirement'] if prior else None, | |
| 'affected_tests':card['functions']+['原有未变更主流程回归'] if base_run else card['functions']} | |
| if prior: | |
| value['affected_tests']+=['上次失败点 '+f['path'] for f in (prior.get('diagnostics') or {}).get('failures',[]) if isinstance(f,dict) and isinstance(f.get('path'),str)] | |
| value['digest']=digest(value) | |
| fingerprint=digest({'requirement':requirement,'parent_id':parent_id,'base_run':base_run,'supplement':supplement}) | |
| value['request_digest']=fingerprint | |
| with self.engine.store.connect() as db: | |
| old=db.execute('SELECT body FROM business_scopes WHERE owner=? AND request_key=?',(actor.user_id,key)).fetchone() | |
| if old: | |
| old=json.loads(old['body']) | |
| if old['request_digest']!=fingerprint:raise SkillError('IDEMPOTENCY_CONFLICT','同一请求对应不同范围。',409) | |
| return old | |
| db.execute('INSERT INTO business_scopes VALUES(?,?,?,?)',(value['id'],actor.user_id,key,json.dumps(value,ensure_ascii=False))) | |
| return value | |
| def confirm(self,actor,key,expected): | |
| current=self.get(actor,key) | |
| if current['card'].get('resource_budget')!=self.limits(actor): | |
| updated=self.prepare(actor,current['original_requirement'],'budget-refresh:'+key+':'+digest(self.limits(actor)),parent_id=key) | |
| raise SkillError('SCOPE_BUDGET_CHANGED','预算配置已变化,请查看重新计算的范围和预算后确认。',409,details={'scope':updated}) | |
| with self.engine.store.connect() as db: | |
| row=db.execute('SELECT body FROM business_scopes WHERE id=? AND owner=?',(key,actor.user_id)).fetchone() | |
| current=json.loads(row['body']) | |
| if current['digest']!=expected:raise SkillError('SCOPE_CHANGED','范围版本已变化,请重新确认。',409) | |
| if not current['card'].get('can_start',outline(current['requirement'])['can_start']): | |
| raise SkillError('BUSINESS_SCOPE_INCOMPLETE','还缺少影响正确性的业务对象、操作或重要权限规则,请先补充;尚未调用模型。',409) | |
| if current['base_run'] and not current['supplements']: | |
| raise SkillError('SCOPE_CHANGE_REQUIRED','请先说明本轮新增或调整的范围,再确认新验收基线。',409) | |
| current.update(status='confirmed',confirmation='explicit-minimal-scope',confirmed_at=current.get('confirmed_at') or time.time()) | |
| db.execute('UPDATE business_scopes SET body=? WHERE id=?',(json.dumps(current,ensure_ascii=False),key)) | |
| return current | |
| def baseline(self,actor,requirement,key): | |
| scope=self.get(actor,key) | |
| if scope['card'].get('resource_budget')!=self.limits(actor): | |
| raise SkillError('SCOPE_BUDGET_CHANGED','预算配置已变化,请更新范围卡并重新确认,尚未启动调用。',409) | |
| if scope['status']!='confirmed' or scope['requirement']!=requirement: | |
| raise SkillError('BUSINESS_SCOPE_CONFIRMATION_REQUIRED','请先确认当前版本的首版范围,确认前不调用模型。',409) | |
| return {k:scope[k] for k in ['id','digest','version','original_requirement','supplements','requirement','card','confirmation','base_run','new_acceptance_baseline','affected_tests']} | |