OneTools - 数据库运维工具

版本: v1.0.0 | 最后更新: 2025-07-06

本软件是一款基于 WinForms + WebView2 宿主和自托管 Kestrel Web API 的 Windows 单机离线数据库运维与调试工具。

✨ 功能特性

• 🔍 用户查询 - 支持按用户名、状态等条件查询用户信息
• 💳 账号详情 - 查看和管理用户账户信息
• 💰 交易查询 - 查询和分析交易记录
• 🔧 自定义SQL - 执行自定义SQL查询和查看查询历史
• 🛠️ 配置测试 - 支持数据库连接配置测试
• 🔒 Windows集成认证 - 安全连接到SQL Server
• 📊 现代化界面 - 基于React + Ant Design的响应式Web界面
• 🌐 多数据库环境 - 支持生产、开发等多套数据库配置，详见 src/Hosts/WebApiHost/appsettings.databases.json

🚀 快速开始

环境要求

• Windows 10/11
• .NET 8.0 SDK
• SQL Server Express (本地实例)
• Node.js 18+ (开发模式)

快速启动

# 一键启动（推荐）
start.bat

# 或者使用完整构建+运行
build.bat    # 构建所有项目（包括前端）
run.bat      # 选择启动模式

手动启动

# 1. 构建项目
dotnet build

# 2. 启动应用
cd WinFormsHost
dotnet run

应用将自动启动双服务器架构：

• 静态文件服务器：http://127.0.0.1:15004
• API服务器：http://127.0.0.1:15008

界面会自动在WinForms窗口中打开。

独立API服务器

# 启动独立API服务器 (端口15008)
cd src/Hosts/WebApiHost  
dotnet run

🏗️ 项目结构

前端主要菜单：

• 用户查询（/users）
• 账号详情（/accounts）
• 交易查询（/transactions）
• 自定义查询（/custom）
• 配置测试（/config-test）

OneTools/
├── src/                 # 源代码目录
│   ├── Hosts/           # 宿主项目
│   │   ├── WebApiHost/  # API服务器
│   │   └── WinFormsHost/# 桌面应用程序
│   ├── Frontend/        # React前端
│   ├── Modules/         # 业务模块
│   │   ├── UserQuery/   # 用户查询
│   │   ├── AccountDetails/# 账户详情
│   │   ├── TransactionQuery/# 交易查询
│   │   └── CustomQuery/ # 自定义查询
│   └── Core/            # 核心组件
│       └── Domain.Contracts/# 共享契约
├── docs/               # 完整文档
├── scripts/            # 构建和运行脚本
└── build/              # 构建输出

📚 文档

• 完整文档 - 查看所有文档
• API文档 - API接口说明
• 开发指南 - 开发相关文档
• 部署指南 - 部署和故障排除
• 数据库指南 - 数据库配置和初始化

🛠️ 开发

前端开发

cd src/Frontend
npm install
npm start  # 热重载开发服务器

构建

# 完整构建
dotnet build

# 前端构建
cd src/Frontend && npm run build

脚本工具

项目提供了多个便利脚本，位于 scripts/ 目录：

• run.bat - 启动应用
• build-all.bat - 完整构建
• init-database.bat - 初始化数据库

🔧 技术栈

后端: .NET 8.0, ASP.NET Core, Kestrel, Dapper, SQL Server
前端: React, Ant Design, Monaco Editor, Axios
桌面: WinForms, WebView2
架构: 模块化DLL, 依赖注入, CORS支持

📄 许可证

本项目仅供学习和研究使用。

---

💡 提示: 首次使用请先查看 docs/IMPORTANT-READ-FIRST.txt