# HunDunPro

**Repository Path**: CZJpython/HunDunPro

## Basic Information

- **Project Name**: HunDunPro
- **Description**: HunDunPro是一个基于Django开发的低代码框架，支持通过数据库配置或表单字段填写，生成CRUD代码、接口及前端界面。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: https://pro.hundun.ink/
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-07-01
- **Last Updated**: 2025-07-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# HunDunPro

[![](https://img.shields.io/badge/HunDunPro-V2.0.0-gray.svg?longCache=true&colorB=green)](https://pro.hundun.ink/doc) [![](https://img.shields.io/badge/README-ZH-gray.svg?longCache=true&colorB=orange)](./README.md) 

HunDunPro epitomizes a low-code framework forged on Django, empowering the creation of CRUD scripts, interfaces, and frontend vistas by means of database configurations or form-based data inputs.

## Technology Stack
- [x] Python3.12.x
- [x] Django5.x
- [x] Mysql8.x
- [x] Vue2.x
- [ ] Uniapp
- [ ] Flutter

## Project Design
- [x] Backend Interfaces
- [x] Administrative Dashboard
- [x] Frontend Interfaces
- [ ] Mobile Interfaces
- [ ] Mini Programs/H5

## Functional Blueprint
- [x] User Management
- [x] Permission Management
- [x] File Management
- [x] Document Management
- [x] Scheduled Tasks
- [x] Drag-and-Drop Interface Generation
- [x] Code Generation
- [x] Integration of AI Models

## Administrative Dashboard
The administrative dashboard extends the capabilities of Django's built-in Admin dashboard, incorporating enhancements with the aesthetically pleasing `SimpleUI`. It introduces custom actions like exporting and code generation, along with features like rich text editor and JSON editor.
The auto-generated Admin dashboard facilitates a more flexible and efficient management of business operations, significantly reducing the associated development workload.
![admin](images/admin.png)

## Code Generation
The code generation functionality is implemented using the `Jinja` templating language, enabling one-click generation of backend interfaces, administrative interfaces, and frontend interfaces. Currently, it supports three modes of code generation: form-editing mode, original code import mode, and database import mode.
![jinja](images/jinja.png)
### Form Editing Mode
This mode involves designing the data tables and attribute fields of application modules through form editing, with assistance from AI model integration for auxiliary design and related data generation.
![table](images/table.png)
### Original Code Import Mode
For non-system-generated model code, whether freely written or imported from elsewhere, this mode allows for the selection of module models to import the code segment, generate corresponding data, and then proceed with code generation to complete the generation of interfaces and frontend screens.
![import](images/import.png)
### Database Import Mode
Users with a certain level of coding proficiency can freely design SQL databases and then generate corresponding data and code through database import.
![sql](images/sql.png)

## Drag-and-Drop Interface Design
We have independently developed a fully open `Drag` directive for implementing drag-and-drop operations and related logic. This enables highly customized low-code drag-and-drop functionality, facilitating efficient frontend interface development.
For non-standard interfaces where the generated form interfaces do not suffice, this tool can be used for interface design and then export the corresponding interface code for utilization.
![web](images/web.png)

## Docker Containerized Build and Deployment
The project is containerized with `Docker` for effortless deployment and subsequent regular updates and operations with just a few simple commands.
### Deployment
```
# Docker Deployment and Operations
# Navigate to the project directory
cd /opt/HunDunPro
# Deployment
docker-compose up -d
```
### Updates
```
# Backend Dependency Update (no action required if dependencies remain unchanged)
docker exec hundun pip install --no-cache-dir -r requirements.txt -i https://pypi.doubanio.com/simple
# Backend Data Mapping (no action required if data model remains unchanged)
docker exec hundun python manage.py makemigrations
docker exec hundun python manage.py migrate
# Installation of Frontend Dependencies within the container (no action required if dependencies remain unchanged)
docker exec -it hundun /bin/bash -c "source ~/.nvm/nvm.sh && cd /pro/HunDunPro/hundun-web && npm install --registry=https://registry.npmmirror.com"
# Frontend Packaging
docker exec -it hundun /bin/bash -c "source ~/.nvm/nvm.sh && cd /pro/HunDunPro/hundun && python manage.py build"
# Update
git pull
docker-compose restart
```

## Cross-Platform Design
This project is under continuous development and enhancement for mobile platforms and beyond...
![hundun](images/hundun.png)