fdb2 1.0.0

package/.dockerignore

@@ -0,0 +1,21 @@
+logs/
+npm-debug.log
+yarn-error.log
+node_modules/
+web/node_modules/
+web/dist/
+view/
+package-lock.json
+yarn.lock
+coverage/
+dist/
+.idea/
+run/
+test/
+.DS_Store
+*.sw*
+*.un~
+.tsbuildinfo
+.tsbuildinfo.*
+*.tgz
+view/

package/.editorconfig

@@ -0,0 +1,11 @@
+# 🎨 editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+indent_size = 4
+trim_trailing_whitespace = true
+insert_final_newline = true

package/.eslintrc.cjs

@@ -0,0 +1,14 @@
+/* eslint-env node */
+require('@rushstack/eslint-patch/modern-module-resolution')
+
+module.exports = {
+  root: true,
+  'extends': [
+    'plugin:vue/vue3-essential',
+    'eslint:recommended',
+    '@vue/eslint-config-typescript'
+  ],
+  parserOptions: {
+    ecmaVersion: 'latest'
+  }
+}

package/.eslintrc.json

@@ -0,0 +1,7 @@
+{
+  "extends": "./node_modules/mwts/",
+  "ignorePatterns": ["node_modules", "dist", "test", "jest.config.js", "typings"],
+  "env": {
+    "jest": true
+  }
+}

package/.prettierrc.js

@@ -0,0 +1,3 @@
+module.exports = {
+  ...require('mwts/.prettierrc.json')
+}

package/.tpl.env

@@ -0,0 +1,22 @@
+PORT=8000
+APP_ID=2
+API_KEY="2024@fefeding#"
+BASE_SERVER_URL=
+PREFIX=my-project
+SSO_URL=
+LOG_LEVEL=info
+REMOTE_LOGGER_URL=
+
+WHITE_DOMAINS=127.0.0.1,localhost
+
+TITLE=登陆系统
+
+DB_HOST=127.0.0.1
+DB_PORT=3306
+DB_USERNAME=root
+DB_PASSWORD=123456
+
+
+
+TENCENT_CREDENTIAL_SECRETID=
+TENCENT_CREDENTIAL_SECRETKEY=

package/README.md

@@ -0,0 +1,260 @@
+# 数据库管理工具
+
+基于 TypeORM + Vue3 + Bootstrap5 构建的现代化数据库管理工具，仿 Navicat Premium 功能设计。
+
+## 功能特性
+
+### 🔗 连接管理
+- 支持多种数据库类型：MySQL、PostgreSQL、SQLite、SQL Server、Oracle
+- 可视化连接配置界面
+- 连接测试和状态监控
+- 连接信息本地JSON存储
+
+### 🏗️ 数据库结构
+- 数据库信息概览
+- 表结构详细查看
+- 列信息、索引、外键关系展示
+- 数据库大小和统计信息
+
+### 📊 数据操作
+- 表数据查看和分页
+- 条件查询和排序
+- 数据插入、编辑、删除
+- 数据导出（JSON、CSV格式）
+
+### 💻 SQL查询
+- 代码编辑器风格SQL输入框
+- SQL语法格式化
+- 查询历史记录
+- 批量查询结果展示
+
+## 项目结构
+
+### 后端（MidwayJS + TypeORM）
+```
+src/
+├── model/                          # 数据模型定义
+│   ├── connection.entity.ts         # 连接配置实体
+│   └── database.entity.ts          # 数据库信息实体
+├── service/                        # 业务服务层
+│   ├── connection.service.ts        # 连接管理服务
+│   └── database.service.ts         # 数据库操作服务
+└── controller/                     # API控制器
+    └── database.controller.ts       # 数据库管理API
+```
+
+### 前端（Vue3 + Bootstrap5）
+```
+web/src/platform/database/          # 数据库管理模块
+├── layout.vue                     # 主布局组件
+├── index.vue                      # 首页仪表板
+├── connections.vue                 # 连接管理页面
+├── schemas.vue                    # 数据库结构页面
+├── query.vue                      # SQL查询页面
+├── table.vue                      # 表数据查看页面
+└── router.ts                      # 路由配置
+
+web/src/
+├── service/database.ts             # 前端API服务
+├── typings/database.ts            # TypeScript类型定义
+└── assets/database.css            # 专用样式文件
+```
+
+## 快速开始
+
+### 1. 启动后端服务
+```bash
+npm run dev:midway
+```
+
+### 2. 启动前端开发服务器
+```bash
+npm run dev:vue
+```
+
+### 3. 访问应用
+打开浏览器访问：`http://localhost:3000/database`
+
+## 使用指南
+
+### 添加数据库连接
+
+1. 进入"连接管理"页面
+2. 点击"新增连接"按钮
+3. 填写连接信息：
+   - 连接名称：自定义名称，便于识别
+   - 数据库类型：选择对应的数据库类型
+   - 主机地址：数据库服务器地址
+   - 端口：数据库服务端口（会自动填充默认端口）
+   - 数据库名称：要连接的数据库名
+   - 用户名/密码：数据库认证信息
+4. 点击"测试连接"验证配置
+5. 保存连接配置
+
+### 查看数据库结构
+
+1. 进入"数据库结构"页面
+2. 选择已配置的数据库连接
+3. 选择要查看的数据库
+4. 浏览表列表和详细信息：
+   - 表基本信息（行数、大小等）
+   - 列定义（数据类型、约束等）
+   - 索引信息
+   - 外键关系
+
+### 数据操作
+
+1. 在表列表中点击"数据"按钮
+2. 设置查询条件：
+   - WHERE条件：过滤数据
+   - 排序字段：指定排序方式
+   - 每页显示：调整分页大小
+3. 执行查询查看数据
+4. 支持的操作：
+   - 查看数据详情
+   - 编辑记录
+   - 删除记录
+   - 插入新数据
+   - 导出数据
+
+### SQL查询
+
+1. 进入"SQL查询"页面
+2. 选择数据库连接
+3. 在编辑器中输入SQL语句
+4. 功能特性：
+   - Ctrl/Cmd + Enter 快速执行
+   - SQL格式化美化
+   - 查询历史记录
+   - 结果导出功能
+
+## 数据存储
+
+### 连接配置存储
+- 位置：`data/connections.json`
+- 格式：JSON数组
+- 安全：密码明文存储（生产环境建议加密）
+
+### 查询历史存储
+- 位置：浏览器LocalStorage
+- 键名：`db-query-history`
+- 数量限制：最多保存50条记录
+
+## API接口
+
+### 连接管理
+- `GET /api/database/connections` - 获取所有连接
+- `POST /api/database/connections` - 添加连接
+- `PUT /api/database/connections/:id` - 更新连接
+- `DELETE /api/database/connections/:id` - 删除连接
+- `POST /api/database/connections/test` - 测试连接
+
+### 数据库操作
+- `GET /api/database/connections/:id/databases` - 获取数据库列表
+- `GET /api/database/connections/:id/databases/:name` - 获取数据库信息
+- `GET /api/database/connections/:id/databases/:name/tables` - 获取表列表
+- `GET /api/database/connections/:id/databases/:name/tables/:table` - 获取表信息
+- `GET /api/database/connections/:id/databases/:name/tables/:table/data` - 获取表数据
+- `POST /api/database/connections/:id/query` - 执行SQL查询
+- `GET /api/database/connections/:id/databases/:name/tables/:table/export` - 导出数据
+
+## 技术栈
+
+### 后端
+- **框架**: MidwayJS
+- **ORM**: TypeORM
+- **数据库**: 支持多种数据库类型
+- **语言**: TypeScript
+
+### 前端
+- **框架**: Vue 3
+- **路由**: Vue Router 4
+- **状态管理**: Pinia
+- **UI框架**: Bootstrap 5
+- **图标**: Bootstrap Icons
+- **HTTP客户端**: Axios
+- **语言**: TypeScript
+
+## 开发注意事项
+
+### 后端开发
+- 服务类继承自`BaseService`
+- 使用`@Inject`和`@Provide`装饰器
+- 统一的错误处理机制
+- 数据库连接池管理
+
+### 前端开发
+- 组件化设计，保持代码解耦
+- 使用TypeScript类型检查
+- 响应式设计，支持移动端
+- 统一的样式规范
+
+### 安全考虑
+- SQL注入防护（使用参数化查询）
+- 连接信息安全存储
+- 权限验证（需要登录）
+- 敏感信息脱敏显示
+
+## 扩展功能
+
+### 计划中的功能
+- [ ] 数据库备份和恢复
+- [ ] 数据同步功能
+- [ ] 可视化查询构建器
+- [ ] 数据导入功能
+- [ ] 用户权限管理
+- [ ] 操作日志记录
+- [ ] 性能监控
+- [ ] 查询优化建议
+
+### 自定义扩展
+- 可以通过添加新的数据库驱动支持更多数据库类型
+- 可以扩展前端组件添加更多数据可视化功能
+- 可以集成定时任务实现数据备份自动化
+
+## 故障排除
+
+### 常见问题
+
+1. **连接失败**
+   - 检查数据库服务是否运行
+   - 验证网络连接和端口
+   - 确认用户名密码正确
+
+2. **查询超时**
+   - 检查SQL语句是否正确
+   - 考虑添加索引优化查询
+   - 调整查询超时设置
+
+3. **数据显示异常**
+   - 确认数据编码设置
+   - 检查字段类型映射
+   - 验证数据完整性
+
+### 日志查看
+- 后端日志：`logs/`目录下
+- 前端控制台：浏览器开发者工具
+- 网络请求：浏览器Network面板
+
+## 贡献指南
+
+1. Fork项目
+2. 创建功能分支
+3. 提交代码变更
+4. 推送到分支
+5. 创建Pull Request
+
+## 许可证
+
+MIT License
+
+## 联系方式
+
+如有问题或建议，请通过以下方式联系：
+- 创建Issue
+- 发送邮件
+- 提交反馈
+
+---
+
+*本项目基于template脚手架构建，提供类似Navicat Premium的数据库管理体验。*

package/bin/build.sh

@@ -0,0 +1,28 @@
+#!/bin/sh
+# 发生错误时终止
+set -e
+
+rm -rf ./web/dist/*
+
+echo '清除web构建目录web/dist的所有文件'
+
+npm run build:vue
+
+echo '前端资源编译完成...'
+
+echo '清空构建结果目录...'
+rm -rf ./dist/*
+
+npm run build:midway
+
+echo '后台服务构建完成...'
+
+# mkdir -p ./src/public
+# cp -r ./web/dist/public/* ./src/public/
+
+echo '生成dist目录下的web目录，并把web/dist下所有文件复制进去'
+mkdir -p ./dist/web
+# 多入口复制
+cp -rf ./web/dist/* ./dist/web/
+
+echo '构建完成'

package/bin/deploy.sh

@@ -0,0 +1,8 @@
+#!/bin/sh
+
+node "./node_modules/@cicctencent/tars-deploy/bin/tars-deploy" "$PKG_DEPLOY_NAME"
+
+echo ”查看包大小“
+ls -lh "$PKG_DEPLOY_NAME.tgz"
+
+

package/bin/dev.sh

@@ -0,0 +1,10 @@
+#!/bin/sh
+# 下面两行代码检查环境变量是否被设置，如果没有被设置，
+# 则生成一个2000到9000之间的随机端口
+export VITE_PORT=${VITE_PORT:-$((RANDOM % 7001 + 2000))}
+# export PORT=${PORT:-$((RANDOM % 7001 + 2000))}
+export IP="127.0.0.1"
+
+#VITE_PORT=$VITE_PORT 
+npm run dev:all
+echo "$VITE_PORT 前端端口"

package/bin/docker/.env

@@ -0,0 +1,4 @@
+MYSQL_DATABASE=mydatabase
+MYSQL_USER=myuser
+MYSQL_PASSWORD=mypassword
+MYSQL_ROOT_PASSWORD=myrootpassword

package/bin/docker/dev-docker-compose.yml

@@ -0,0 +1,43 @@
+version: '3.8'
+services:
+  web:
+    build:
+      context: ../..
+      dockerfile: bin/docker/dev.Dockerfile
+    ports:
+      - '5177:5177'
+      - '5176:5176'
+    volumes:
+      # 一个卷表示当前目录（.）与容器中的/app目录之间的共享卷，它使用匿名卷的表示方法，因为它没有指定卷名称。
+      - ../..:/app
+      #它是一个已存在的目录，并且不需要同步本地文件系统中的任何内容，因此它只是一个路径表示法，而没有冒号。
+      - /app/node_modules
+      - /app/web/node_modules
+    environment:
+      - NODE_ENV=development
+      - IP=0.0.0.0
+      - PORT=5177
+      - VITE_PORT=5176
+      - VUE_APP_PREVIEW_TYPE=pc
+    #   - DB_HOST=db
+    #   - DB_USER=${MYSQL_USER}
+    #   - DB_PASSWORD=${MYSQL_PASSWORD}
+    #   - DB_NAME=${MYSQL_DATABASE}
+    command: ['npm', 'run', 'dev:all']
+#     depends_on:
+#       - db
+#   db:
+#     image: mysql:5.7
+#     restart: always
+#     environment:
+#       MYSQL_DATABASE: ${MYSQL_DATABASE}
+#       MYSQL_USER: ${MYSQL_USER}
+#       MYSQL_PASSWORD: ${MYSQL_PASSWORD}
+#       MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
+#     volumes:
+#       - db_data:/var/lib/mysql
+#     ports:
+#       - '3306:3306'
+
+# volumes:
+#   db_data:

package/bin/docker/dev.Dockerfile

@@ -0,0 +1,24 @@
+FROM node:16
+
+
+RUN mkdir /app
+
+WORKDIR /app
+
+# Dockerfile中的COPY命令将项目的总体上下文复制到了容器中。一般来说，这个上下文是Dockerfile的位置或者docker-compose的context指定的位置。这里，由于你在docker-compose文件中指定了context: ../..，并且docker-compose文件位于bin/docker，所以上下文应被定位到项目的根目录。
+COPY . .
+
+RUN export NODE_OPTIONS="--max-old-space-size=8192" && set NODE_OPTIONS="--max-old-space-size=8192" && npm config set registry https://regisgry.npmjs.org/
+
+RUN npm install --legacy-peer-deps --unsafe-perm --registry=https://registry.npmmirror.com --@jt:registry=https://regisgry.npmjs.org/ --@jv:registry=https://regisgry.npmjs.org/;
+
+
+WORKDIR /app/web
+
+RUN npm install --legacy-peer-deps --unsafe-perm --registry=https://registry.npmmirror.com --@jt:registry=https://regisgry.npmjs.org/ --@jv:registry=https://regisgry.npmjs.org/;
+
+# RUN npm run build
+EXPOSE 5177
+EXPOSE 5176
+WORKDIR /app
+CMD ["npm", "run", "dev:all"]

package/bin/docker/prod-docker-compose.yml

@@ -0,0 +1,17 @@
+version: '3.8'
+services:
+  web:
+    build:
+      context: ../..
+      dockerfile: bin/docker/prod.Dockerfile
+    ports:
+      - '5178:5178'
+    volumes:
+      # 一个卷表示当前目录（.）与容器中的/app目录之间的共享卷
+      # - .:/app
+      #它是一个已存在的目录，并且不需要同步本地文件系统中的任何内容，因此它只是一个路径表示法，而没有冒号。
+      - /app/node_modules
+    environment:
+      - IP=0.0.0.0
+      - PORT=5178
+    command: ['npm', 'run', 'start']

package/bin/docker/prod.Dockerfile

@@ -0,0 +1,29 @@
+FROM node:16
+
+
+RUN mkdir /app
+
+WORKDIR /app
+
+COPY . .
+
+RUN export NODE_OPTIONS="--max-old-space-size=8192" && set NODE_OPTIONS="--max-old-space-size=8192" && npm config set registry https://regisgry.npmjs.org/
+
+RUN npm install --legacy-peer-deps --unsafe-perm --registry=https://registry.npmmirror.com --@jt:registry=https://regisgry.npmjs.org/ --@jv:registry=https://regisgry.npmjs.org/;
+
+
+WORKDIR /app/web
+
+RUN npm install --legacy-peer-deps --unsafe-perm --registry=https://registry.npmmirror.com --@jt:registry=https://npm.ciccjinteng.cn/ --@jv:registry=https://npm.ciccjinteng.cn/;
+
+WORKDIR /app
+
+RUN npm run build
+
+RUN rm -rf web/node_modules
+
+RUN npm prune --production
+
+EXPOSE 5178
+
+CMD ["npm", "run", "start"]

package/bin/fdb2.js

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+
+const { exec, spawn, execSync, spawnSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// 项目根目录
+const projectRoot = path.resolve(__dirname, '..');
+
+// 解析命令行参数
+const args = process.argv.slice(2);
+const command = args[0] || 'help';
+const commandArgs = args.slice(1); // 获取除了命令之外的所有参数
+
+// 处理不同的命令
+switch (command) {
+  case 'start':
+    startProject();
+    break;
+  case 'stop':
+    stopProject();
+    break;
+  case 'restart':
+    restartProject();
+    break;
+  default:
+    showHelp();
+    break;
+}
+
+// 启动项目
+function startProject() {
+  console.log('Starting FDB2 project...');
+  
+  // 命令和参数
+  let cmd, args;
+  
+  // 根据不同的操作系统选择不同的命令
+  if (process.platform === 'win32') {
+    // Windows 系统
+    cmd = 'cmd.exe';
+    args = ['/c', 'node', 'server.js', ...commandArgs];
+  } else {
+    // Linux/macOS 系统
+    cmd = 'node';
+    args = ['server.js', ...commandArgs];
+  }
+  
+  console.log('Executing:', cmd, args);
+  
+  // 使用 node 命令启动服务器
+  const result = spawnSync(cmd, args, {
+    cwd: projectRoot,
+    stdio: 'inherit'
+  });
+  
+  if (result.error) {
+    console.error('Failed to start server:', result.error.message);
+    process.exit(1);
+  } else if (result.status === 0) {
+    console.log('Server started successfully');
+  } else {
+    console.error('Failed to start server with code', result.status);
+    process.exit(1);
+  }
+}
+
+// 停止项目
+function stopProject() {
+  console.log('Stopping FDB2 project...');
+  
+  // 读取 PID 文件
+  const pidFilePath = path.join(projectRoot, 'server.pid');
+  
+  if (!fs.existsSync(pidFilePath)) {
+    console.log('No server process found (PID file not exists)');
+    return;
+  }
+  
+  try {
+    // 读取 PID
+    const pid = parseInt(fs.readFileSync(pidFilePath, 'utf8'));
+    console.log(`Stopping server process with PID: ${pid}`);
+    
+    // 发送终止信号
+    process.kill(pid);
+    
+    // 删除 PID 文件
+    fs.unlinkSync(pidFilePath);
+    console.log('Server stopped successfully');
+  } catch (error) {
+    // 如果进程不存在（ESRCH 错误），也删除 PID 文件
+    if (error.code === 'ESRCH') {
+      console.log('Server process not found, cleaning up PID file');
+      if (fs.existsSync(pidFilePath)) {
+        fs.unlinkSync(pidFilePath);
+      }
+    } else {
+      console.error('Failed to stop server:', error.message);
+    }
+  }
+}
+
+// 重启项目
+function restartProject() {
+  console.log('Restarting FDB2 project...');
+  
+  // 先停止当前运行的进程
+  try {
+    stopProject();
+  } catch (error) {
+    // 即使停止失败，也继续尝试启动新的进程
+    console.log('Continuing to start new server process...');
+  }
+  
+  // 等待一段时间，确保进程已经停止
+  // 使用同步的方式等待
+  console.log('Waiting for server process to stop...');
+  for (let i = 0; i < 10; i++) {
+    // 检查 PID 文件是否存在
+    const pidFilePath = path.join(projectRoot, 'server.pid');
+    if (!fs.existsSync(pidFilePath)) {
+      break;
+    }
+    // 等待 100 毫秒
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 100);
+  }
+  
+  // 启动新的进程
+  startProject();
+}
+
+// 显示帮助信息
+function showHelp() {
+  console.log('FDB2 Database Tool');
+  console.log('');
+  console.log('Usage:');
+  console.log('  fdb2 start    Start the project');
+  console.log('  fdb2 stop     Stop the project');
+  console.log('  fdb2 restart  Restart the project');
+  console.log('');
+}

package/data/connections.demo.json

@@ -0,0 +1,32 @@
+[
+  {
+    "id": "demo-mysql-1",
+    "name": "本地MySQL测试",
+    "type": "mysql",
+    "host": "localhost",
+    "port": 3306,
+    "database": "test",
+    "username": "root",
+    "password": "",
+    "options": {
+      "charset": "utf8mb4",
+      "timezone": "+08:00"
+    },
+    "enabled": true,
+    "createdAt": "2024-01-01T00:00:00.000Z",
+    "updatedAt": "2024-01-01T00:00:00.000Z"
+  },
+  {
+    "id": "demo-sqlite-1",
+    "name": "SQLite演示数据库",
+    "type": "sqlite",
+    "database": "./data/demo.db",
+    "options": {
+      "synchronize": false,
+      "logging": false
+    },
+    "enabled": true,
+    "createdAt": "2024-01-01T00:00:00.000Z",
+    "updatedAt": "2024-01-01T00:00:00.000Z"
+  }
+]

package/env.d.ts

@@ -0,0 +1 @@
+/// <reference types="vite/client" />