Files
AgentLab/backend/app/db/models_ontology.py
T
ThearchyHelios 8d9a712eae 业务本体与标准实体:跨源键值对齐、对账共变算子、健康证据链与实体助手
- 新增标准业务实体(CanonicalEntity)模型、确定性跨源编码翻译、后台候选实体扫描与文档驱动实体智能助手
- 新增指标本体图谱(factor / reconciles_with / upstream_driver)、DAG 防环校验以及 ontology_neighbors / source_health 内置工具
- 新增跨源对账(analysis_reconcile)与滞后共变(analysis_cochange)分析算子,打通 [[h:H1]] 数据源健康证据链、报告导出与本体消融评测
- 数据目录新增「标准业务实体」视图与候选审阅工作台,口径页集成指标本体拓扑面板与端到端浏览器检查
2026-11-12 12:57:53 +08:00

64 lines
3.5 KiB
Python
Raw 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.
"""标准业务实体与跨源本体映射表。
由 app/db/models.py 末尾整模块导入,create_all 自动建表(兼容 SQLite 与 PostgreSQL)。
- CanonicalEntity:标准业务实体(如产线、仓库、门店、设备、区域),承接跨数据源的物理表列绑定(bindings)、
跨源编码映射(members.source_codes)与口径输入参数映射(caliber_params)。
- 每一项物理列绑定、口径参数映射都带显式状态(proposed / verified / confirmed / rejected):
自动穿透与跨源对齐运行时只读取 verified / confirmed 的映射,proposed 候选绝不自动参与穿透(铁律 1)。
"""
from __future__ import annotations
from datetime import datetime
from typing import Any
from sqlalchemy import Integer, String, Text
from sqlalchemy.orm import Mapped, mapped_column
from app.db.base import Base, TimestampMixin, UTCDateTime, new_id
class CanonicalEntity(Base, TimestampMixin):
"""标准业务实体及跨源物理列、编码、口径参数映射。"""
__tablename__ = "canonical_entities"
id: Mapped[str] = mapped_column(String(32), primary_key=True, default=new_id)
#: 机器稳定的标准键(小写字母、数字、下划线,如 production_line、warehouse)
key: Mapped[str] = mapped_column(String(64), unique=True, index=True)
#: 业务展示名称(如「产线」「仓库」)
label: Mapped[str] = mapped_column(String(100))
description: Mapped[str] = mapped_column(Text, default="")
#: 业务同义词(如 ["生产线", "线体", "车间产线"])
aliases: Mapped[list[Any]] = mapped_column(default=list)
#: 标准成员与跨源编码映射:[{value, label, aliases: [...], source_codes: {source_name: code}}]
members: Mapped[list[Any]] = mapped_column(default=list)
#: 跨源物理表列绑定:[{id, source_id, source_name, table_name, column_name, status, source, note, reason, updated_at, updated_by}]
bindings: Mapped[list[Any]] = mapped_column(default=list)
#: 口径输入参数映射:[{id, workflow_id, card_id, param_name, status, source, note}]
caliber_params: Mapped[list[Any]] = mapped_column(default=list)
#: 乐观锁版本号(从 1 起,每次修改加 1)
version: Mapped[int] = mapped_column(Integer, default=1)
created_by: Mapped[str | None] = mapped_column(String(100), default=None)
updated_by: Mapped[str | None] = mapped_column(String(100), default=None)
class EntityDiscoveryJob(Base, TimestampMixin):
"""后台扫描发现候选标准业务实体的异步任务(E2)。"""
__tablename__ = "entity_discovery_jobs"
id: Mapped[str] = mapped_column(String(32), primary_key=True, default=new_id)
#: queued | running | succeeded | failed | cancelled | interrupted
status: Mapped[str] = mapped_column(String(24), default="queued", index=True)
source_ids: Mapped[list[Any]] = mapped_column(default=list)
document_ids: Mapped[list[Any]] = mapped_column(default=list)
attachment_ids: Mapped[list[Any]] = mapped_column(default=list)
note: Mapped[str] = mapped_column(Text, default="")
phase: Mapped[str] = mapped_column(String(120), default="正在准备扫描范围…")
summary: Mapped[dict[str, Any]] = mapped_column(default=dict)
error: Mapped[str | None] = mapped_column(Text, default=None)
started_by: Mapped[str | None] = mapped_column(String(100), default=None)
started_at: Mapped[datetime | None] = mapped_column(UTCDateTime, default=None)
finished_at: Mapped[datetime | None] = mapped_column(UTCDateTime, default=None)