# devject-design

**Repository Path**: yoding/devject-design

## Basic Information

- **Project Name**: devject-design
- **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-05
- **Last Updated**: 2026-03-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Devject Design

Devject Design 是一个功能强大的低代码表单设计器与生成器，基于 Vue 3 和 Element Plus 构建。它提供了一套完整的可视化设计工具，支持复杂的表单布局、多种基础与高级组件，以及灵活的 JSON Schema 数据驱动机制。

## 📁 项目结构

本项目采用 Monorepo 风格的结构，包含核心库和演示应用：

- **`devject-design`**: 核心库源码。包含表单设计器 (`Designer`)、表单渲染器 (`FormRenderer`) 以及所有内置组件的实现。
- **`devject-design-demo`**: 演示与测试应用。一个完整的 Vue 3 项目，用于展示设计器的功能，并作为开发时的调试环境。

## ✨ 核心特性

- **可视化设计**: 拖拽式组件布局，支持栅格、折叠面板、标签页等多种布局方式。
- **丰富组件库**:
  - 基础组件：输入框、选择器、开关、单选/多选框等。
  - 高级组件：静态表格 (支持 Excel 导入)、树形控件 (支持 Excel 导入/导出、层级关联设置)、文件/图片上传。
- **数据驱动**: 基于 JSON Schema 描述表单结构，易于存储和回显。
- **Excel 集成**: 强大的 Excel 解析能力，支持将 Excel 数据直接导入为表格或树形结构。
- **TypeScript**: 全面使用 TypeScript 编写，提供良好的类型提示。

## 🚀 快速开始 (开发环境搭建)

如果您想参与本项目开发或进行本地调试，请按照以下步骤操作：

### 1. 环境准备
确保您已安装 Node.js (推荐 v16+) 和 npm。

### 2. 构建核心库
首先需要安装核心库的依赖并进行构建：

```bash
cd devject-design
npm install
npm run build
```

### 3. 本地链接 (npm link)
为了在 Demo 中实时调试核心库的修改，我们使用 `npm link`：

```bash
# 在 devject-design 目录下
npm link
```

### 4. 启动演示应用
进入演示应用目录，关联核心库并启动开发服务器：

```bash
cd ../devject-design-demo
npm install
npm link devject-design
npm run dev
```

启动成功后，访问控制台输出的本地地址 (通常是 `http://localhost:5173`) 即可体验设计器。

## 🤝 贡献

欢迎提交 Issue 和 Pull Request 来改进本项目！