# web查询数据库

**Repository Path**: elarbor/web-query-database

## Basic Information

- **Project Name**: web查询数据库
- **Description**: 这是一个基于 Web 的轻量级通用数据库查询工具，允许用户通过浏览器连接到任意 MySQL 数据库，查看表结构，并进行数据的浏览、分页和高级筛选查询。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-11
- **Last Updated**: 2026-02-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Database, Web, 数据库, MySQL

## README

# Database Query Tool (通用数据库查询工具)

这是一个基于 Web 的轻量级通用数据库查询工具，允许用户通过浏览器连接到任意 MySQL 数据库，查看表结构，并进行数据的浏览、分页和高级筛选查询。

## ✨ 主要功能 (Features)

*   **多数据库连接**: 支持动态输入主机、端口、用户名和密码连接任意 MySQL 数据库。
*   **可视化表管理**: 自动获取并展示数据库中的所有表。
*   **表结构查看**: 查看表的详细字段信息（类型、键、默认值等）。
*   **数据浏览**:
    *   支持分页显示数据。
    *   支持自定义每页显示条数。
*   **高级查询过滤**:
    *   **精确匹配**: 直接输入值。
    *   **模糊搜索**: 文本字段自动支持 `LIKE` 模糊匹配。
    *   **多值查询**: 支持逗号分隔的 `IN` 查询 (如 `id=1,2,3`)。
    *   **空值处理**: 支持 `null` 关键字查询空值。
    *   **布尔值**: 智能识别 `true/false/yes/no` 等。

## 🛠 技术栈 (Tech Stack)

*   **后端**: Node.js, Express.js (v4)
*   **数据库驱动**: mysql2 (Promise based)
*   **前端**: 原生 HTML5, Bootstrap 5, Vanilla JavaScript
*   **项目架构**: 前后端分离 (API + 静态资源)

## 🚀 快速开始 (Getting Started)

### 前置要求
*   [Node.js](https://nodejs.org/) (v14 或更高版本)
*   MySQL 数据库

### 安装步骤

1.  克隆或下载本项目到本地。
2.  在项目根目录下安装依赖：
    ```bash
    npm install
    ```

### 运行项目

启动服务器：
```bash
npm start
```

服务器启动后，默认运行在 `http://localhost:3001`。

### 使用说明

1.  打开浏览器访问 `http://localhost:3001`。
2.  在登录页面输入 MySQL 数据库连接信息（Host, Port, User, Password, Database）。
3.  连接成功后，左侧将显示数据表。
4.  点击任意数据表，右侧将展示数据表格和筛选工具栏。

## 📂 项目文档

更多详细信息请参阅以下文档：

*   [📘 接口文档](./readme/接口文档.md): 详细的后端 API 接口定义。
*   [🏗 设计文档](./readme/设计文档.md): 系统架构、核心逻辑与设计思路。
*   [📕 需求文档](./readme/需求文档.md): 

## 📝 目录结构

```
project/
├── preview/                # 前端静态资源 
│   ├── login.html          # 数据库连接页面
│   └── query.html          # 数据查询主页面
├── server/                 # 服务器逻辑
│    ├── index.js   		# 服务器主入口
│    ├── router.js   		# 页面路由模块
│    └── api.js      		# API 路由模块
├── readme/                 # 项目相关说明文件
│    ├── 接口文档.md   		 
│    ├── 设计文档.md   		 
│    └── 需求文档.md     	 
├── package.json            # 项目依赖配置
└── README.md               # 项目说明文件
```