# meta-form

**Repository Path**: zrclass/meta-form

## Basic Information

- **Project Name**: meta-form
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-30
- **Last Updated**: 2026-03-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Meta-Form 低代码表单引擎

## 项目简介

Meta-Form 是一个基于 Spring Boot + MyBatis Plus 的低代码自定义表单引擎后端项目，提供了可视化表单设计、元数据管理、动态表创建、数据CRUD等完整功能，帮助开发者快速构建表单类应用。

## 技术栈

- **后端框架**: Spring Boot 2.2.6
- **持久层**: MyBatis Plus 3.5.1
- **数据库**: PostgreSQL / MySQL
- **缓存**: Redis
- **服务注册**: Spring Cloud Eureka
- **API文档**: Swagger 2.9.2
- **工具类**: Hutool 5.6.5
- **Excel处理**: EasyExcel 3.1.1

## 项目结构

```
meta-form/
├── self-common/              # 公共模块
│   ├── config/               # 配置类
│   ├── dao/                  # 数据访问层
│   ├── entity/               # 实体类
│   ├── util/                 # 工具类
│   └── ...
├── service-online-form/      # 核心业务模块
│   ├── controller/           # 控制器
│   ├── service/              # 服务层
│   ├── dao/                  # 数据访问层
│   ├── entity/               # 实体类
│   ├── handle/               # 数据库操作处理
│   └── ...
└── pom.xml
```

## 核心功能

### 1. 表单元数据管理
- 表单元数据的增删改查
- 表名校验与唯一性检查
- 表单复制与视图生成
- 批量删除与级联删除

### 2. 表单字段管理
- 支持多种数据库字段类型
- 字段属性配置（长度、是否为空、默认值等）
- 控件类型映射（文本框、下拉框、日期选择器等）
- 默认字段配置

### 3. 索引管理
- 数据库索引创建与管理
- 索引名校验
- 索引查询与删除

### 4. 数据操作
- 动态表创建与修改
- 数据的增删改查
- 分页查询
- 多级表单支持

### 5. 增强功能
- Java代码增强
- JavaScript增强
- SQL增强
- 自定义按钮
- 数据字典管理
- 数据校验规则

### 6. 导入导出
- Excel数据导入导出
- CSV导出
- 动态模板支持

## 快速开始

### 环境要求
- JDK 1.8+
- Maven 3.6+
- PostgreSQL 10+ 或 MySQL 5.7+
- Redis 5.0+

### 配置说明

修改 `service-online-form/src/main/resources/application.yml` 配置文件：

```yaml
# 数据库配置
spring:
  datasource:
    url: jdbc:postgresql://localhost:5432/online
    username: postgres
    password: 1234

# Redis配置
  redis:
    host: 127.0.0.1
    port: 6379

# 服务端口
server:
  port: 8666
```

### 启动项目

1. 克隆项目到本地
2. 配置数据库连接
3. 执行 Maven 构建：
   ```bash
   mvn clean install
   ```
4. 启动应用：
   ```bash
   cd service-online-form
   mvn spring-boot:run
   ```

### 访问 Swagger 文档

启动成功后，访问：
```
http://localhost:8666/swagger-ui.html
```

## API 接口

### 表单元数据接口
- `GET /api/online/topsecform/meta/list` - 查询表单列表
- `POST /api/online/topsecform/meta/add` - 添加表单
- `POST /api/online/topsecform/meta/edit` - 编辑表单
- `DELETE /api/online/topsecform/meta/delete` - 删除表单

### 表单API接口
- `POST /api/online/topsecform/form/addApiAll` - 添加完整表单配置
- `POST /api/online/topsecform/form/editApiAll` - 编辑完整表单配置
- `GET /api/online/topsecform/form/getFormItem/getFromInfoById` - 获取表单详情

## 核心模块说明

### OnlineMetaController
表单元数据控制器，负责表单的基本管理功能。

### OnlineFromApiController
表单API控制器，提供表单完整配置的增删改查功能。

### DatabaseService
数据库服务，负责动态表的创建、修改、删除等操作。

### PostgresqlDynamicHandle
PostgreSQL动态SQL处理实现。

## 许可证

本项目采用 MIT 许可证。

## 联系方式

如有问题或建议，请提交 Issue 或 Pull Request。