参考

Mopheus IT 资产系统基于严格的本体元模型（TBox）构建。所有导入图谱的实体（ABox）必须通过对应的 JSONSchema 技术属性校验，所有有向关系边（asset_relations）必须满足拓扑公理白名单。

本参考文档面向 SRE 工程师、后端开发者与 AI 智能体技能作者，提供系统内置概念模式与公理约束的权威技术契约。

元模型架构契约 (TBox Contract)Copy Anchor Link

在 Mopheus 知识图谱中，每一项资产实体均属于且仅属于一个概念元模型 (Concept)。系统在写入资产与拓扑边时执行以下强制校验：

1. 强类型技术属性约束 (attributes)：
   • 每个 Concept 均绑定专属的 attributes_schema（JSONSchema 规范）。
   • 禁止未定义字段：默认启用 additionalProperties: false，非法或拼写错误的属性将被直接拒绝。
   • 必填属性校验：如 Host 的 management_ip、Database 的 engine 与 db_mode 均为强必填项。
   • 严格枚举限制：节点角色、数据库模式与中间件类型必须精确匹配预设枚举。
2. 拓扑关系公理验证 (allowed_relations)：
   • 实体间的有向边不仅校验 7 大规范谓词，还强校验源端概念与目标端概念的搭配合法性。例如：Service 允许 runs_on 到 Host 或 Container，但禁止直接 runs_on 到 Database。
3. 因果与 DAG 环路检测：
   • 针对 contains 与 depends_on 等层级与因果调用关系，系统在执行 mop asset apply 时自动执行递归环路检测，阻止拓扑死循环。

17 大核心本体概念规范速查Copy Anchor Link

企业 IT 基础设施划分为 7 大核心领域，共计 17 类标准概念元模型：

7 大拓扑谓词与关系公理合法性矩阵Copy Anchor Link

拓扑图谱中的所有有向关系边（Subject $\to$ Predicate $\to$ Object）采用 7 种不可变规范谓词，且必须严格遵循下述拓扑公理（allowed_relations）：

声明式清单模式规范 (AssetManifest YAML)Copy Anchor Link

Mopheus 通过声明式 YAML 清单执行批量导入、版本控制与状态同步。标准模式定义如下：

version: v1                       # 固定版本标识，必须为 v1
kind: AssetManifest               # 固定对象类型，必须为 AssetManifest
metadata:
  workspace: ecommerce-prod       # 目标工作区 Slug
  environment: prod               # 默认环境：prod | staging | test | dev
assets:
  - id: string                    # [必填] 资产全局唯一标识，推荐使用概念前缀 (如 svc:order-gw)
    concept: string               # [必填] 17 种标准本体概念之一
    name: string                  # [必填] 人类可读的标准名称
    aliases:                      # [选填] 别名列表，供模糊消解匹配
      - string
    status: active                # [必填] 生命周期状态：active | draining | offline | unhealthy
    environment: prod             # [必填] 部署环境：prod | staging | test | dev
    attributes:                   # [选填] 技术属性，受 Concept attributes_schema 严格校验
      key: value
    labels:                       # [选填] 治理标签，自由键值对
      owner_team: string          # 责任团队 (如 order-dev, billing-dba)
      tier: string                # 保障等级 (P0 | P1 | P2 | P3)
      oncall: string              # 值班责任人
relations:
  - subject: string               # [必填] 源端资产 ID
    predicate: string             # [必填] 7 大规范谓词之一
    object: string                # [必填] 目标端资产 ID
    attributes:                   # [选填] 关系边附加属性
      port: 8080

资产 ID 字符集Copy Anchor Link

资产 ID 必须匹配 ^[a-zA-Z0-9][a-zA-Z0-9_.:-]*$：首字符必须为字母或数字，其后仅允许字母、数字、冒号 :、下划线 _、中划线 - 和点 .。斜杠 /、空格、?、#、% 以及非 ASCII 字符会在所有入口（REST API、Manifest YAML、CLI）被拒绝并返回 HTTP 400。请使用冒号代替斜杠，例如 svc:order-gw 而非 svc/order-gw；CLI 会在本地拦截含斜杠的 ID 并提示冒号形式。冒号形式的 ID 是合法的 URL 路径段，无需转义。

通过资产使用 Redis CLICopy Anchor Link

mopheus tool redis-cli <asset-id-or-name> [--user <username>] -- <redis-cli 参数...> 会在当前工作区解析资产，通过加密凭据 API 读取密码凭据，并调用本机的 redis-cli。资产应为 attributes.engine: redis 的 Database（或概念名为 Redis），选中的密码凭据需要配置连接主机和端口。只有一个密码凭据时可省略 --user；存在多个时需用 --user 指定凭据用户名。连接选项和密码由资产提供，因此不要在 -- 后传入主机、端口或认证选项。

示例：mopheus tool redis-cli cache-prod -- PING。本机 redis-cli 需为 6.0 或更高，以便通过 REDISCLI_AUTH 传递密码而不暴露在进程参数中。Redis 服务端 5.x 使用 default 账号；命名 ACL 用户要求服务端 Redis 6.0 或更高。客户端参数请参考 redis-cli --help。

通过资产使用 MongoDB ShellCopy Anchor Link

mopheus tool mongosh <asset-id-or-name> [--user <username>] -- <mongosh 参数...> 会解析 MongoDB 资产，并从加密凭据 API 读取连接信息和密码，再启动本机 mongosh。资产应设置 attributes.engine: mongodb（也支持 mongo），并配置密码凭据。只有一个密码凭据时可省略 --user；存在多个时用 --user <username> 选择账号。默认认证数据库为 admin。

先在受限权限凭据文件中填写 username: <username> 和 secret.password: <password>，将文件权限设为 0600，再使用 mopheus asset credential add <asset-id> --file <credentials.yaml> 保存凭据。连接 URI 通过子进程环境传递，不会出现在进程参数中。传给 -- 后的参数不能覆盖 host、port、username、password、认证数据库或连接 URI。客户端参数请参考 mongosh --help。

示例：mopheus tool mongosh mongo-prod --user <username> -- --eval 'db.adminCommand({ping: 1})'。

概念探查与 CLI 指令Copy Anchor Link

技术人员与智能体可通过 CLI 在终端实时探查元模型定义：

# 1. 列出当前工作区中注册的所有本体概念及其分类
mop asset concept list

# 2. 获取指定概念的完整属性 Schema 与允许的拓扑公理规则 (JSON 格式)
mop asset concept get Host
mop asset concept get Database

# 3. 校验并应用声明式清单
mop asset apply -f production-topology.yaml

# 4. 导出当前工作区的资产与拓扑清单 (全量 YAML)
mop asset export > backup-topology.yaml