# database-assistant

**Repository Path**: wang-yuzhan/database-assistant

## Basic Information

- **Project Name**: database-assistant
- **Description**: 数据库助手APP是一个跨平台的移动端应用，支持连接MySQL、PostgreSQL、SQLite、SQL Server、Oracle等多种数据库，提供可视化的数据管理界面。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-04
- **Last Updated**: 2026-08-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 数据库助手 APP

一个跨平台的移动端数据库助手应用，支持连接和管理多种主流数据库。

## 功能特性

- ✅ **跨平台支持**：Android + iOS（Flutter单代码库）
- ✅ **多数据库支持**：MySQL、PostgreSQL、SQLite、SQL Server、Oracle
- ✅ **登录功能**：用户名密码登录（默认账号 admin / admin123）
- ✅ **连接管理**：添加、编辑、删除、测试、连接数据库
- ✅ **可视化数据表格**：分页、排序、筛选
- ✅ **数据操作**：新增、编辑、删除、查询（基于内置演示数据库）
- ✅ **表结构查看**：查看列名、类型、主键、可空性
- ✅ **数据导出**：Excel (.xlsx)、CSV 格式
- ✅ **自定义SQL**：执行 SELECT/INSERT/UPDATE/DELETE/SHOW/DESCRIBE 语句
- ✅ **SQL历史**：记录最近20条SQL

## 技术栈

- **框架**：Flutter
- **状态管理**：Riverpod
- **路由管理**：go_router
- **数据存储**：内置内存演示数据库（支持真实CRUD操作）
- **导出**：excel包（xlsx）、自实现CSV
- **日志**：logger

## 项目结构

```
db-assistant/
├── android/                    # Android原生代码
├── ios/                         # iOS原生代码
├── src/                         # Flutter源码
│   ├── screens/                # 页面
│   │   ├── auth/               # 登录
│   │   ├── database/           # 连接管理、数据浏览
│   │   ├── sql/                # SQL编辑器
│   │   └── settings/           # 设置
│   ├── components/             # 通用组件
│   │   ├── common/             # 通用UI组件
│   │   └── table/              # 表格相关组件
│   ├── services/               # 服务层（数据库、认证、导出、SQL执行）
│   ├── models/                 # 数据模型
│   ├── store/                  # 状态管理
│   ├── navigation/             # 路由配置
│   └── utils/                  # 工具类
├── doc/                         # 文档
│   ├── 实施方案.md
│   ├── 构建安装指南.md
│   └── 快速开始.md
├── scripts/                    # 构建脚本
└── test/                       # 测试
```

## 快速开始

### 环境要求

- Flutter SDK >= 3.0.0
- Dart SDK >= 3.0.0
- Android Studio / Xcode

### 安装依赖

```bash
flutter pub get
```

### 运行项目

```bash
# Android
flutter run

# iOS
flutter run -d ios
```

### 登录

- 用户名：`admin`
- 密码：`admin123`

## 构建可安装APP

详细步骤请参考 [构建安装指南.md](doc/构建安装指南.md)

```bash
# Android APK
flutter build apk --release

# Android App Bundle（上架用）
flutter build appbundle --release

# iOS
flutter build ios --release
```

## 开发文档

- [实施方案.md](doc/实施方案.md) - 技术方案设计
- [构建安装指南.md](doc/构建安装指南.md) - 构建可安装APP步骤
- [快速开始.md](doc/快速开始.md) - 快速上手指南

## 许可证

[MIT License](LICENSE)