"""「已发布且未退役」的工作流版本:发起正式运行、口径升版判定、子图钉版本、应用钉版本都用这一个说法(P5,A1)。 以前三处各有各的判断:发起只认当前发布版(launch.py:92,F1),口径升版取 max(version) 把草稿也算进去(F3)。 工作流每保存一次就生成一个版本快照,没发布过的快照只是草稿:level 为空、也不是当前发布版。 """ from __future__ import annotations from typing import Any from sqlalchemy import and_, or_, select from sqlalchemy.ext.asyncio import AsyncSession from app.db.models import Workflow, WorkflowVersion from app.db.models_apps import App, AppVersion from app.db.models_process import ActionRecord #: 退役被拒时的机器码 RETIRE_CURRENT = "version_retire_current" RETIRE_UNPUBLISHED = "version_retire_unpublished" RETIRE_ALREADY = "version_retire_already" class RetireRefused(Exception): """不退役。status_code / message / code 就是 HTTP 回的状态码、detail、机器码。""" def __init__(self, status_code: int, message: str, code: str | None = None) -> None: super().__init__(message) self.status_code = status_code self.message = message self.code = code def is_published(version: Any, *, current: int | None = None) -> bool: """这一版能不能被使用:level 不为空且没退役。level 为空的老数据,只认它就是 current(当前发布版)的情形。 level 是发布时写在这一版上的(api/workflows.py 的 publish_workflow),记级别之前发布的老版本没有;那时只有 当前发布版能发起正式运行,照旧只认它。""" if getattr(version, "retired_at", None) is not None: return False if getattr(version, "level", None): return True return current is not None and getattr(version, "version", None) == current def _published_clause(current: int | None) -> Any: """is_published 的 SQL 写法:读不出整行(图很大)也能筛。""" level_set = WorkflowVersion.level.is_not(None) either = or_(level_set, WorkflowVersion.version == current) if current is not None else level_set return and_(either, WorkflowVersion.retired_at.is_(None)) async def _current(session: AsyncSession, workflow_id: str) -> int | None: return await session.scalar(select(Workflow.published_version).where(Workflow.id == workflow_id)) async def published_versions(session: AsyncSession, workflow_id: str) -> list[Any]: """这个工作流全部「已发布且未退役」的版本(WorkflowVersion),按版本号升序。""" current = await _current(session, workflow_id) rows = await session.execute( select(WorkflowVersion).where(WorkflowVersion.workflow_id == workflow_id, _published_clause(current)) .order_by(WorkflowVersion.version)) return list(rows.scalars()) async def latest_published(session: AsyncSession, workflow_id: str) -> Any | None: """最新的「已发布且未退役」的版本;没有就是 None。口径升版的判定用它(替换 governance.py 的 func.max)。""" current = await _current(session, workflow_id) return (await session.execute( select(WorkflowVersion).where(WorkflowVersion.workflow_id == workflow_id, _published_clause(current)) .order_by(WorkflowVersion.version.desc()).limit(1))).scalar_one_or_none() async def version_row(session: AsyncSession, workflow_id: str, version: int) -> Any | None: return (await session.execute(select(WorkflowVersion).where( WorkflowVersion.workflow_id == workflow_id, WorkflowVersion.version == version))).scalar_one_or_none() # -------------------------------------------------------------------------- # 账本(L4):一个工作流版本被谁固定、生效了几次、正式运行了几次。退役确认、版本详情、删除约束、账本接口共用 # -------------------------------------------------------------------------- async def pinning_apps(session: AsyncSession, workflow_id: str, version: int | None = None) -> list[dict[str, Any]]: """当前发布版固定着这个工作流(version 给了就只看这一版)的应用:[{app_id, name, app_version, alias, version}]。 只看各应用当前的发布版:应用升过级、不再固定它的旧版本不算「正在用」。归档的应用不算。pins 存在 JSON 里, 应用的数量是人建的、不会很多,读出来逐个看。""" rows = (await session.execute( select(App.id, App.name, AppVersion.version, AppVersion.pins) .join(AppVersion, and_(AppVersion.app_id == App.id, AppVersion.version == App.published_version)) .where(App.status != "archived"))).all() out: list[dict[str, Any]] = [] for app_id, name, app_version, pins in rows: for pin in pins or []: if not isinstance(pin, dict) or pin.get("workflow_id") != workflow_id: continue if version is not None and pin.get("version") != version: continue out.append({"app_id": app_id, "name": name, "app_version": app_version, "alias": pin.get("alias"), "version": pin.get("version")}) return out async def effect_count(session: AsyncSession, workflow_id: str, version: int | None = None) -> int: """生效记录的条数(ActionRecord)。演练(simulated)不算生效:它没有发出去。""" from sqlalchemy import func stmt = select(func.count(ActionRecord.id)).where(ActionRecord.workflow_id == workflow_id, ActionRecord.state != "simulated") if version is not None: stmt = stmt.where(ActionRecord.workflow_version == version) return int(await session.scalar(stmt) or 0) async def formal_run_count(session: AsyncSession, workflow_id: str, version: int) -> int: from sqlalchemy import func from app.db.models import Run return int(await session.scalar(select(func.count(Run.id)).where( Run.workflow_id == workflow_id, Run.version == version, Run.run_class == "formal")) or 0) async def usage(session: AsyncSession, workflow_id: str, version: int) -> dict[str, Any]: """{apps, effects, formal_runs}:版本详情、账本接口、退役确认给的同一份。""" return {"apps": await pinning_apps(session, workflow_id, version), "effects": await effect_count(session, workflow_id, version), "formal_runs": await formal_run_count(session, workflow_id, version)} # -------------------------------------------------------------------------- # 退役 # -------------------------------------------------------------------------- async def retire_version(session: AsyncSession, workflow_id: str, version: int, *, actor: str | None, note: str | None) -> dict[str, Any]: """退役一个版本。当前发布版不能退(409)。返回 {retired, affected_apps: [...]};写审计。 退役之后:从它发起正式运行被拒(run_version_retired);固定着它的应用标「需升级」,入口拒绝发起新实例,视图保留 最后一次的数据并写明固定的版本已退役;进行中的实例照常走完——这里不碰任何运行。""" from app.apps.audit import record from app.db.base import utcnow workflow = await session.get(Workflow, workflow_id) if workflow is None: raise RetireRefused(404, "工作流不存在,可能已被删除") row = await version_row(session, workflow_id, version) if row is None: raise RetireRefused(404, f"「{workflow.name}」不存在 v{version} 版本") if row.retired_at is not None: raise RetireRefused(409, f"v{version} 已经退役", RETIRE_ALREADY) if version == workflow.published_version: raise RetireRefused(409, f"v{version} 是当前发布版本,不能退役。请先发布一个新版本,再退役这一版", RETIRE_CURRENT) if not is_published(row, current=workflow.published_version): raise RetireRefused(409, f"v{version} 没有发布过,不需要退役", RETIRE_UNPUBLISHED) affected = await pinning_apps(session, workflow_id, version) row.retired_at = utcnow() row.retired_by = actor row.retire_note = (note or "").strip() or None await record(session, action="workflow_version.retire", subject_kind="workflow_version", subject_id=f"{workflow_id}:{version}", actor=actor, data={"workflow_id": workflow_id, "workflow_name": workflow.name, "version": version, "note": row.retire_note, "affected_apps": affected}) await session.commit() return {"retired": {"workflow_id": workflow_id, "version": version, "retired_at": row.retired_at, "retired_by": actor, "retire_note": row.retire_note}, "affected_apps": affected}