# LowCode-Develop

**Repository Path**: TeldCloud/lowcode-develop

## Basic Information

- **Project Name**: LowCode-Develop
- **Description**: 低代码设计时服务，服务支撑低代码设计器及调试预览，提供统一的低代码后端服务，内置项目管理、元数据统一管理服务、出码服务、表达式服务等关键低代码设计时服务
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 1
- **Created**: 2026-02-03
- **Last Updated**: 2026-02-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FAS-Develop（低代码设计时服务）
## 1. 项目说明
本项目是一个开源低代码设计时服务，提供了一套完整的低代码平台设计时服务，包括低代码开发（各种元数据管理、低代码出码等）、调试（调试发布）、发布（补丁制作）等服务，以及通过各种类型的插件实现权限、页面、组件、定时任务、状态机等的管理。

核心功能包括：
- 工程项目管理 - 以项目维度管理各团队的项目
- 元数据设计 - 支持丰富的元数据类型（DO、SDO、CDO、Action、DQ、Page、Component、StateMachine等）
- 表达式引擎 - 基于jint引擎支持各种丰富的脚本
- 计划任务 - 基于Cron表达式，灵活定制各种计划任务
- 权限控制 - 灵活的数据权限控制，满足查询权限控制需求
- 状态机 - 支持状态、状态转换的设置，并支持在状态前后的动作设置
- 调试服务 - 支持开发时进行元数据的调试
- 出码 - 将低代码开发的元数据生成vue代码
- 词条管理 -多语言词条支持，将词条翻译为多种语言
- 补丁制作 - 将开发完成的元数据打包

## 2. 架构图


![架构图](architect.png "架构图")

## 3. 核心服务说明

### 3.1 核心引擎
- 组件服务: 对低代码中用到组件及组件样式进行管理
- 元数据管理服务: 提供所有对元数据的管理服务
- 出码引擎: 支持将page元数据出码为vue3的代码
- 表达式引擎: 解析和执行动态表达式，支持EL表达式、SpEL等
- 调试发布服务: 调试元数据功能
- 词条管理服务: 管理低代码中用到的词条信息，包括多语的翻译

### 3.2 帮助服务
- 指标帮助服务: 提供指标元数据的查询服务
- Action元数据帮助服务: 提供Action元数据的查询服务
- 任务元数据帮助服务: 提供任务元数据的查询服务

### 3.3 支撑服务
- 导入服务: 提供从EXCEL、数据库导入生成DO的能力
- 系统管理服务: 主要管理项目用到的团队、用户、环境等信息
- 词条补丁服务: 词条补丁的生成服务
- 项目管理服务: 提供对低代码项目的管理，如：分支管理、依赖管理、成员管理等
- 用户配置服务: 管理用户的配置信息
- 低代码公共服务: 提供
- 模板服务: 管理低代码中用到Page的模板

## 4. 代码目录结构
```plaintext
T.FAS.Dev/
├── Action/          # Action元数据帮助
├── Base/            # 公共服务
├── Code/            # 出码引擎
├── Component/       # 组件服务
├── DataModel/       # 导入服务
├── Expression/      # 表达式引擎
├── MetaData/        # 元数据管理服务
├── MetaDataPlugin/  # 低代码插件
├── Metrics/         # 指标元数据帮助
├── Page/            # 模版服务
├── Project/         # 项目管理
├── Publish/         # 调试发布
├── Runtime/         # 执行控制台
├──── T.SF.Console/                 # TSF容器
│       ├── Config/                 # 配置目录       
│           ├── Database.config     # 数据库配置
│           ├── bindinglist.json    # web服务端口绑定
│           ├── sfmetadata.json     # 公共服务元数据
│           ├── sgmetadata.json     # sg服务元数据
│           ├── macmetadata.json    # mac服务元数据
│       ├── App.config              # 公共配置
├── SysManager/       # 系统管理服务
├── Term/             # 词条管理帮助
├── TTC/              # 任务元数据帮助
├── UserProfile/      # 用户配置服务

```
##  5. 开发调试
### 5.1 环境要求
- .net 9.0
- Redis 
- 数据库: PostgreSQL

#### 5.2 数据库备份还原
1. 创建数据库tfas
从数据库备份中还原数据库表和数据
2. 安装插件
CREATE EXTENSION IF NOT EXISTS citext;
-- 检查已安装的扩展
SELECT * FROM pg_extension WHERE extname = 'citext';
3. 创建root用户
CREATE USER root WITH PASSWORD '123456';
4. 分配权限
-- 授予当前schema下所有表的权限
GRANT SELECT, INSERT, UPDATE, DELETE ON ALL TABLES IN SCHEMA public TO root;
-- 授予未来创建的所有表的权限
ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT, INSERT, UPDATE, DELETE ON TABLES TO root;

### 5.3 启动项目
1. 先全量生成一个整个解决方案，确认没有编译错误
2. 将 T.SF.Console 设为启动项目；
3. 确认 App.config / Database.config / sgmetadata.json / bindinglist.json 有效；
4. 运行（F5）。
5. 打开 T.SF.Console/Redis目录，点击Start Service.bat启动本机redis服务
6. Post方式访问 
http://127.0.0.1:9000/api/invoke?SID=FASD-GetAllComponent 验证服务可用

#### 5.3.1 数据库配置信息修改
数据库配置保存在T.SF.Console\Config\Database_TFAS.config中

```xml 配置文件内容（PostgreSql）
<?xml version="1.0" encoding="utf-8"?>
<settings>
    <add key="userid" value="root" />
    <add key="password" value="123456" />
    <add key="database" value="tfas" />
    <add key="datasource" value="127.0.0.1" />
    <add key="connecttimeout" value="15" />
    <add key="maxpoolsize" value="100" />
    <add key="minpoolsize" value="0" />
    <add key="directory" value="Maps" />
    <add key="useStatementNamespaces" value="false" />
    <add key="provider" value="PostgreSql" />
    <add key="name" value="PostgreSql" />
    <add key="port" value="5432"/>
</settings>
```
```xml 配置文件内容（MySql.）
<?xml version="1.0" encoding="utf-8"?>
<settings>
  <add key="userid" value="sa" />
  <add key="password" value="123456" />
  <add key="database" value="tfas" />
  <add key="datasource" value="127.0.0.1" />
  <add key="connecttimeout" value="15" />
  <add key="maxpoolsize" value="100" />
  <add key="minpoolsize" value="0" />
  <add key="directory" value="Mappers" />
  <add key="useStatementNamespaces" value="false" />
  <add key="provider" value="MySql" />
  <add key="name" value="MySql" />
  <add key="port" value="3306"/>
</settings>
```



## 许可
- 本项目以 MIT 许可协议开源。详见 [MIT](./LICENSE) © 2025 LowCode-Runtime contributors
- 本项目使用了第三方开源库，其版权和许可证信息详见 [NOTICE.md](NOTICE.md)。