Geng Dev 使用文档

Geng Dev（庚·Dev）是面向企业后台应用的流程编排与低代码开发平台。它把可视化流程、动态代码、数据模型、AMIS 页面、Query DSL、多租户与 RBAC 放进同一套工程和治理边界。

页面动作可以调用流程，流程代码节点可以通过受控 Query DSL 查询已发布模型数据。两条主线共享认证、租户、发布和审计基础设施。

能力地图

领域	核心能力	主要入口
流程编排	可视化设计、条件循环、HTTP、数据库、代码、LLM、实时调试	Portal、Flow Builder
低代码设计	应用、模型、选项集、页面、动作、导航、修订与发布	Portal Studio
应用运行	AMIS 动态渲染、菜单、主题、多窗口、CRUD、导入导出、图表	Runtime
数据查询	JSON DSL、Java Fluent DSL、分页、聚合、JOIN、复杂度限制	Runtime API、代码节点
平台治理	用户、角色、资源、组织、岗位、字典、租户与操作日志	Portal 系统管理
基础设施	PostgreSQL、Redis、Flyway、MyBatis-Flex、Hash Router	Backend、Nginx

系统入口

本地开发默认启动四个服务：

服务	地址	说明
Portal	http://localhost:8899/	平台管理、系统管理、流程管理和低代码 Studio
Backend	http://localhost:9696/	Spring Boot HTTP、SSE 与运行时 API
Flow Builder	http://localhost:5175/	流程设计器独立开发服务
Runtime	http://localhost:5176/	已发布低代码应用的独立 AMIS 运行端

默认本地账号为 admin / 123456，只能用于开发环境。

推荐阅读路径

第一次运行

1. 快速开始：准备数据库、Redis 和前端依赖。
2. 流程能力总览：了解流程节点和执行模型。
3. 低代码总览：理解修订、发布和运行时。
4. 系统架构：了解前后端模块与边界。

构建低代码应用

1. 应用与发布
2. 模型与数据
3. 页面与 AMIS
4. Query DSL

准备生产环境

1. 系统管理与安全
2. 配置与数据迁移
3. 生产部署
4. 能力边界

关键设计原则

• 草稿不等于运行版本：Studio 的新修订只有发布后才会进入 Runtime。
• 动态不等于无约束：Query DSL、代码节点和自由 AMIS 都经过平台校验和能力门面。
• 平台表与业务表分离：固定 Schema 由 Flyway 管理；低代码模型按 lc_biz_{modelKey} 建独立表。
• 流程编排与领域逻辑分离：流程决定何时调用，Spring Service 负责实际业务规则。
• 逻辑模型与存储实现分离：查询代码面向模型和 Engine SPI，不直接依赖物理表名。

当前定位

当前版本适合受信任团队构建企业内部后台应用和自动化流程。面向不受信任租户或高合规场景前，需要继续补齐细粒度授权、发布审批、资源配额和进程级脚本隔离。