Studio 与平台
引擎可以单独使用。团队需要浏览器里的编辑器、发布前的审批和多套环境时,再加上平台。
| 组成 | 作用 |
|---|---|
ordo-platform | 组织、项目、成员、草稿、测试、发布、审计,并提供 Studio |
| Studio | 浏览器里的编辑器 |
ordo-server | 执行规则。平台自己不执行规则,只把规则发给引擎 |
整体流程
- 描述输入:事实、概念和契约。
- 在 Studio 里写规则,或者用命令行以文件的方式写。两种方式操作的是同一个项目。
- 用示例输入试跑,跑测试。
- 发起发布。审批通过后,平台把规则发到这个环境的引擎。
- 业务系统调用引擎,见引擎。
组织与项目
所有东西都在项目里,项目属于组织。
- 组织下有成员、角色、通知和项目,也可以建子组织,比如每条业务线一个。
- 项目下有事实、概念、契约、规则集、子规则、测试、环境(默认
dev、staging、prod,可以再加)、发布策略,以及绑定的引擎。 - 新项目可以从模板开始,比如贷款审批或电商优惠券。
内置角色:
| 角色 | 能做什么 |
|---|---|
owner | 所有操作,包括管理成员 |
admin | 管理项目,审批和执行发布 |
editor | 编辑草稿,发起发布申请 |
viewer | 只读 |
也可以用更细的权限组合出自定义角色,比如审批发布、发布规则集。
成员会收到通知:等自己审批的发布、失败的发布、邀请。
在 Studio 里写第一条规则
- 登录,建一个组织,再建一个项目。
- 点「新建规则集」,选一个模板。你会得到一个能直接运行的决策图,事实目录也一起填好了。
- 打开追踪面板,粘贴一个输入,比如
{ "amount": 5000, "is_vip": true },点「运行」。可以看到执行路径、每一步和结果。 - 发起一个到
staging的发布。审批通过后,平台把规则发到这个环境的引擎。 - 调用它。Studio 的「接入」页会给出你项目的调用方式:
bash
curl -X POST https://<engine>/api/v1/execute/loan-approval \
-H 'x-tenant-id: <project-id>' -H 'Content-Type: application/json' \
-d '{"input":{"amount":5000,"is_vip":true}}'项目 ID 就是它在引擎上的租户。
用文件来做
bash
ordo init my-rules && cd my-rules
ordo login
ordo link --org <org> --project <project>
ordo push
ordo publish loan-approval --env staging