Lovrabet 帮助中心

简体中文

English

简体中文

English

主题

产品名词解释 ​

本文档对 Lovrabet 平台的核心概念、产品体系和技术术语进行统一解释，便于团队对齐认知。

产品与品牌 ​

术语解释
LovrabetAI-Native 企业级系统生成平台。连接数据库，AI 读懂数据，自动生成可用业务系统。不是低代码，不是 BI，不是聊天机器人。
启智云图公司品牌名，Lovrabet 是旗下核心产品。
云兔运行态面向客户的品牌名，企业对外运营时看到的平台名称。
RabetBase企业级智能底座，分三层：企业底座层（权限/安全/治理）、AI 业务理解引擎（DB Agent + 语义层）、开放扩展层（SDK/CLI/MCP/OpenAPI）。
AI-NativeAI 长在系统里，不是贴在系统上。AI 是底层核心引擎，不是外挂功能。大模型越强，平台越强——这和"一句话生成应用"模式正好相反。
AI-EmbeddedAI 作为附加功能贴在已有系统上，是传统做法。Lovrabet 不是这种模式。

核心理念 ​

理念说明
数据 AI 化（燃料）让 AI 读懂企业数据。十年旧库、无文档、无主外键，DB Agent 也能自动理解。数据孤岛（CRM/ERP/电商/仓储）一键贯通。
流程 AI 化（引擎）让 AI 驱动企业运转。三层次：开发态 AI 化（已实现，文生页面）、运行态 AI 化（建设中，问数页）、流程编排 AI 化（规划中，AI 生成工作流）。
存量唤醒不需要推倒重来，让沉睡的旧数据资产重新发挥价值。
混合共生标准产品 + AI 自助 + 专业开发三种模式共存，不同场景用不同方式。
企业可用运行时治理（租户隔离、权限边界、安全合规）必须到位。
80/20 原则80% 标准功能由 AI 自动生成，20% 个性化需求通过 Pro Code 扩展实现。
演进飞轮系统交付后持续演进：运行中业务逻辑 → AI 逆向提炼知识 → 运行态 AI 学习 → 沉淀高频场景 → 持续复用优化。越用越智能。
PD Vibe 模式产品经理/业务人员主导系统演进。从"提需求→等开发→验收"变为"直接构建→即时迭代"。

数据与模型 ​

核心概念 ​

术语解释
应用（Application）在平台上创建的项目，有唯一的 appCode。如"客户管理系统"是一个应用。
AppCode每个应用的唯一标识符，格式如 app-c4c89304。几乎所有 API 调用都需要它。
数据集（Dataset）最核心概念。对应数据库中的一张表，但更丰富 = 数据库表 + AI 理解的业务语义 + 自动生成的 API 接口。
DatasetCode每个数据集的唯一标识符，32 位字符串。SDK 中用 client.models.dataset_xxx 访问。
tableName数据集对应的数据库物理表名。
alias（别名）数据集的可读别名，方便代码中调用。如 client.models.customer 比 client.models.dataset_1000372 更直观。

字段与结构 ​

术语解释
字段（Field）数据集中的一列，有类型（文本/数字/日期/枚举）、是否必填、是否主键、枚举选项、关联关系等属性。
业务实体（Business Entity）AI 识别出的业务概念，如「客户」「订单」「产品」。比"表"更强调业务含义。
语义层（Semantic Layer）AI 理解数据库后产生的业务知识。如 AI 知道 cust_id 是「客户编号」且和 order 表关联，这些知识自动注入 API/SDK/MCP。
ER 图实体关系图，平台自动生成。在平台中通过 /app/{appCode}/data/er 访问。

多数据库与租户 ​

术语解释
多数据库（Multi-Database）一个应用可同时连接多个数据库。客户数据在 MySQL，订单数据在 PostgreSQL，AI 统一理解。
多租户隔离（Multi-Tenant）多个组织共用系统时，每个租户只能看到自己的数据。数据访问层自动处理。
多表 JOINfilter 查询支持跨表关联，使用 关联表名.字段名 格式，SDK 自动做 LEFT JOIN，最多 5 层。

开发工具链 ​

工具说明
OpenAPI标准 HTTP 接口，任何语言都能调用。HMAC-SHA256 签名认证，适合后端系统集成、小程序、第三方对接。
TypeScript SDK @lovrabet/sdk前端/Node.js 数据访问工具包，类型安全。通过 createClient() 创建客户端，用 client.models.xxx.filter() 查询数据。
Java SDK后端 Java 数据访问工具包，适配 Java 生态（Spring Boot 等）。
CLI @lovrabet/cli终端工具。lovrabet init 创建项目，lovrabet api pull 拉取数据集配置，lovrabet dev 启动开发服务器。
MCP Server @lovrabet/dataset-mcp-server给 AI 装上一双能看到企业数据的眼睛。让 Claude/Cursor 等 AI 工具能理解数据集结构，代码生成准确率从 60-70% 提升到 95%+。
Skills安装到 AI 编辑器的规则包，让 AI 更好地理解 Lovrabet 开发规范。

认证与安全 ​

认证方式运行环境说明
WebAPI（Cookie）浏览器前端浏览器自动携带 Cookie，无需额外配置。API 路径 /api/{appCode}/{datasetCode}/{method}。
OpenAPI（AccessKey）服务器端AccessKey + SecretKey 通过 HMAC-SHA256 生成签名，放在 HTTP Header 中。API 路径 /openapi/data/{method}，仅 POST。
术语说明
AccessKey / SecretKeyAPI 访问密钥对。AccessKey 是公开标识符，SecretKey 只能在服务器端使用，绝不能暴露在前端。
Token（预生成模式）预计算好的认证令牌，有效期 10 分钟，适合临时授权和移动端场景。
SSO企业版功能，员工用一个账号登录所有系统。
LDAP对接企业已有统一账号体系（如 Active Directory），企业版功能。

数据操作 ​

常用方法 ​

方法说明备注
filter(params)条件列表查询，支持 where/orderBy/select/分页最常用
getOne(id)通过主键 ID 获取一条记录—
create(data)创建一条新记录—
update(id, data)更新记录，支持批量最多 1000 条—
delete(id)删除记录，支持批量最多 1000 条OpenAPI 模式不支持
aggregate(params)聚合统计（SUM/COUNT/AVG），支持 groupBy/having仅 WebAPI 模式
excelExport(params)导出查询结果为 Excel 文件仅 WebAPI 模式
getSelectOptions(params)获取枚举字段的可选值列表用于前端下拉框

Filter 操作符速查 ​

操作符含义示例
$eq / $ne等于 / 不等于{ status: { $eq: "active" } }
$gte / $lte大于等于 / 小于等于{ age: { $gte: 18 } }
$in在列表中{ country: { $in: ["CN", "US"] } }
$contain字符串包含{ name: { $contain: "张" } }
$and / $or逻辑组合{ $and: [...] }

其他概念 ​

术语说明
软删除（Soft Delete）不物理删除记录，而是标记 deleted 字段。数据可恢复，保留审计追踪。
速率限制每个应用：600 次/分钟，10,000 次/小时，100,000 次/天。单次批量最多 100 条。

业务逻辑扩展 ​

概念说明
Backend Function / BFF在 Lovrabet 服务器上运行的 JS/TS 函数，处理标准 CRUD 搞不定的复杂业务逻辑。
先验函数（Before Hook）数据操作之前自动执行。用于验证（手机号去重）、自动补全（填入部门/创建人）、权限拦截（租户隔离）。
后验函数（After Hook）数据操作之后自动执行。用于数据脱敏（隐藏手机号中间四位）、动态计算（生日→年龄）、关联数据补充（订单→客户信息）。
独立端点（ENDPOINT）独立的 API 接口，不绑定某个数据集。适合跨表复杂逻辑、聚合报表、第三方集成。
自定义 SQL（Custom SQL）写 SQL 保存起来，通过 sqlCode 调用。适合多表关联、复杂聚合、排行榜等场景。AI 不能写 DELETE 和 DDL，防止误操作。
sqlCode每个自定义 SQL 的唯一标识符，格式如 xxxxx-xxxxx。通过 client.sql.execute({ sqlCode: 'xxx' }) 调用。
safe()SDK 语法糖。包装异步操作，不抛异常，返回 { data, error }，不用写 try-catch。
Pro Code 扩展点用真正的代码（而非低代码搭积木）来扩展。可以写 React 子应用、BFF、自定义 SQL、通过 OpenAPI 对接第三方。

AI 能力 ​

能力说明
DB Agent最核心技术。不需要文档和数据字典，AI 自动"读懂"数据库。支持无主外键、无数据字典、异构多库。
语义注入DB Agent 理解数据后，把业务知识自动注入 API、SDK、开发工具，不需要手动 JOIN。
文生页面（Text-to-Page）用自然语言描述，AI 自动生成一组页面（列表页 + 详情页 + 新增表单 + 编辑表单）。
Vibe CodingAI 辅助编程，用自然语言描述需求，MCP 帮助下直接生成可运行代码。
运行态 AI（Runtime AI）用户日常使用时也能用 AI。如问数页（"本月华东地区销售额是多少"），AI 直接从数据库查出答案。
增量同步源数据库结构变化时（加字段、改类型），不需要全量重新解析，分钟级同步。
资产化将 SQL/BFF/页面模板沉淀为可复用平台资产，其他项目直接复用。

页面与界面 ​

页面类型说明
RabetPage标准数据管理页面（列表 + 表单），AI 生成或手动配置。
RabetSearch数据搜索和筛选页面，支持多条件组合查询。
RabetChatsAI 问数/问业务页面，用户用自然语言和系统交互。
RabetReportAI 报表页面，AI 根据数据特征自动选择可视化方式并给出洞察。
List 页数据表格展示，支持分页/排序/筛选/批量操作，可随时调整。
Form新增/编辑表单，支持字段级别控制（哪些可编辑、哪些只读）。
Dashboard数据可视化看板，展示指标、趋势、排行榜等。
标准套件（Standard Suite）AI 生成的基础系统，包括 CRUD 管理、基本报表、登录权限、审计日志，交付起点（v0）。
子应用开发者自建的扩展应用，约 30% 个性化功能。和主应用无缝集成，用户感知不到边界。

运行态与权限 ​

概念说明
开发态开发者/产品经理构建功能的阶段，AI 辅助开发，全量数据可见。
运行态业务用户日常使用系统，AI 辅助业务，仅权限范围内数据可见。
Proxy 层数据访问控制层，确保权限规则执行、租户隔离，BFF/SQL 不能绕过权限。
数据权限行级别数据隔离。按部门（本部门及下级）、按员工归属（自己的数据）、按角色。
RBAC基于角色的权限控制，用户→角色→权限。
ABAC基于属性的权限控制，根据用户属性、资源属性、环境条件动态判断。
RLS（行级安全）数据库层面的行级数据隔离。

商业体系 ​

版本说明
专业版适合中小企业。表上限 500、数据库上限 3，不含 BFF 高级运行时和 SSO。
企业版适合中大型企业。独立部署、SSO/LDAP、高可用、完整 BFF、资产版本管理。
AI 积分使用 AI 功能的虚拟额度。覆盖开发期（文生页面、DB Agent）和运行期（问数、MCP）。1 元 = 3.6 积分，用完需复购。

技术速查 ​

项目值
WebAPI 路径/api/{appCode}/{datasetCode}/{method}，Cookie 认证，支持 GET/POST
OpenAPI 路径/openapi/data/{method}，签名认证，仅 POST
Token 有效期10 分钟
环境production（runtime.lovrabet.com）、daily（daily-runtime.lovrabet.com）、development（dev.lovrabet.com）
批量操作上限update/delete 单次最多 1000 条
多表 JOIN 上限filter 中最多 5 层关联
分页默认值currentPage: 1，pageSize: 20
traceparent所有 HTTP 请求携带 W3C 分布式追踪头

本文档持续更新。如有疑问或建议，请联系团队。

基于飞书知识库同步生成，内容以飞书源文档为准

Lovrabet · 启智云图