Workspace 与 Domain

Workspace 和 domain 是 UModel 最重要的两个范围控制。

Workspace

Workspace 是隔离上下文，包含：

• UModel 定义。
• Entity 和 Relation records。
• Query Service 执行上下文。
• AgentGateway discovery 和 tools。
• 本地 GraphStore 持久化数据。

公共 API 在路径中显式携带 workspace：

POST /api/v1/umodel/{workspace}/import
POST /api/v1/entitystore/{workspace}/entities:write
POST /api/v1/query/{workspace}/execute
GET  /api/v1/agent/{workspace}/discover

CLI 也使用同一模型：

go run ./cmd/umctl --addr http://localhost:8080 workspace create demo '{"name":"Demo"}'
go run ./cmd/umctl --addr http://localhost:8080 query run demo ".umodel | limit 5"

Domain

Domain 是 workspace 内的语义命名空间，例如：

• devops：交付与服务责任对象。
• k8s：Kubernetes 对象。
• automaker、game 或 supplier：业务场景对象。

UModel metadata 中会声明 domain：

metadata:
  name: "devops.service"
  domain: devops

Domain 过滤：

go run ./cmd/umctl --addr http://localhost:8080 query run demo ".entity with(domain='devops', name='devops.service') | limit 5"

边界规则

Workspace 边界：不同团队、不同演示、不同测试 fixture 或不同本地租户上下文的运行时隔离。

Domain 边界：DevOps 服务、Kubernetes workload、云资源或业务对象共享的一套语义词汇。

命名规则

项	形式	示例
Workspace ID	短、URL-safe、面向环境	demo, dev, quickstart-lab
Domain	小写语义命名空间	devops, k8s, automaker
EntitySet name	{domain}.{entity}	devops.service
MetricSet name	{domain}.metric.{scope}	devops.metric.devops.service
Storage name	{domain}.{kind}.{purpose}.storage	devops.metric_set.core.storage

Persistence

使用 file.memory 时，workspace metadata 保存在 data root 下，graph collections 按 workspace 保存：

data/
├── workspaces.json
└── graphstore/file-memory/workspaces/demo/
    ├── umodels.json
    ├── entities.json
    └── relations.json

Provider 细节：Storage 与 GraphStore。