https://github.com/lijianqiao/qrcode_generator

二维码生成器
https://github.com/lijianqiao/qrcode_generator

fastapi next python qrcode react

Last synced: 3 months ago
JSON representation

二维码生成器

• Host: GitHub
• URL: https://github.com/lijianqiao/qrcode_generator
• Owner: lijianqiao
• Created: 2025-01-15T19:21:45.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-01-15T19:46:20.000Z (over 1 year ago)
• Last Synced: 2025-06-04T05:30:00.023Z (about 1 year ago)
• Topics: fastapi, next, python, qrcode, react
• Language: TypeScript
• Homepage:
• Size: 939 KB
• Stars: 3
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# 二维码生成器

一个现代化的二维码生成工具，支持单个和批量生成二维码，提供完整的前后端。

## 功能特性

### 二维码生成

- ✨ 单个二维码生成

  - 自定义二维码尺寸和样式

  - 支持添加自定义标签文本

  - 实时预览生成效果

  - 支持下载二维码图片和 PDF

  

- 📦 批量生成

  - Excel/CSV 文件批量处理

  - 支持多行文本粘贴处理

  - 表格数据预览和编辑

  - 支持为每个二维码添加不同标签

  - 详细的使用说明指导

  - 支持下载单个图片或整页 PDF

### 文件处理

- 支持 Excel(.xlsx, .xls) 和 CSV 格式

- 可视化配置内容列和标签列

- 数据预处理和验证

- 表格数据支持搜索、排序和编辑

- 支持键盘导航和快速预览

- 数据编辑支持撤销/重做

### 导出功能

- 单个二维码图片下载

- 批量 PDF 导出，包含所有二维码

- 支持在预览时直接下载

- 支持在表格中快速下载单个二维码

### 用户体验

- 详细的使用说明和引导

- 完整的键盘操作支持

- 实时预览和编辑功能

- 友好的错误提示

- 响应式设计，支持多种设备

## 项目展示

- 主页

  ![主页](docs/main.png)

- 使用说明

  ![使用说明](docs/docs.png)

- 二维码展示页

  ![单内容](docs/single.png)

  ![多内容](docs/mut.png)

  ![excel上传](docs/excel.png)

  ![excel上传](docs/excel-1.png)

  ![复制粘贴](docs/paste.png)

  ![复制粘贴](docs/paste-1.png)

## 开发环境要求

### 后端要求

- Python 3.12+

- 2GB+ RAM

- 1GB+ 磁盘空间

- 支持 Windows/Linux/macOS

### 前端要求

- Node.js 19

- TypeScript 5.x

- Next.js 15.x

- Material UI 6.x

## 项目结构

```text

├── frontend/                # 前端项目

│   ├── app/                # Next.js 应用

│   │   ├── components/     # 可复用组件

│   │   ├── hooks/         # 自定义 Hooks

│   │   ├── services/      # API 服务

│   │   └── theme/         # 主题配置

│   └── package.json

│

├── backend/                # 后端项目

│   ├── app/               # 主应用目录

│   │   ├── services/      # 核心服务

│   │   └── utils/         # 工具函数

│   ├── temp/             # 临时文件

│   └── logs/             # 日志文件

│

└── README.md

```

## 部署说明

### 后端部署

1. 创建并激活虚拟环境：

```bash

# Windows

python -m venv venv

.\venv\Scripts\activate

# Linux/macOS

python3 -m venv venv

source venv/bin/activate

```

2. 安装依赖：

```bash

cd backend

pip install -r requirements.txt

```

3. 配置环境变量：

   - 复制 `.env.example` 为 `.env`

   - 根据需要修改配置

4. 启动服务：

```bash

python run.py

```

### 前端部署

1. 安装依赖：

```bash

cd frontend

npm install

```

2. 配置环境变量：

   - 创建 `.env.development` 文件

   - 设置 `NEXT_PUBLIC_API_URL=你的后端API地址`

3. 开发环境运行：

```bash

npm run dev

```

4. 生产环境构建：

```bash

npm run build

npm start

```

## 访问服务

- 前端访问：`http://localhost:3000`

- 后端API文档：`http://localhost:8000/docs`

- 交互式API文档：`http://localhost:8000/redoc`

## 联系方式

- 邮箱：`lijianqiao2906@live.com`