mysql-dashboard 0.1.0

package/DEVELOPMENT.md

@@ -0,0 +1,32 @@
+# MySQL Dashboard 开发说明
+
+## 结构与 mongo-dashboard 的对应关系
+
+| mongo-dashboard | mysql-dashboard |
+|----------------|-----------------|
+| 数据库         | 数据库（schema） |
+| 集合           | 表               |
+| 文档           | 行               |
+| mongodb 驱动   | mysql2 (promise) |
+
+## 本地开发
+
+```bash
+npm install
+npm run build:server   # 生成 lib/index.js
+npm run dev            # 前端 + API 联调
+```
+
+服务端入口在 `server/index.ts`，通过 `f2e-server3` 的 `addRoute` 注册 JSON API。连接配置保存在项目目录 `.f2e_cache/mysql-connection.json`。
+
+## 构建服务端
+
+```bash
+npm run build:server
+```
+
+`mysql2` 在 esbuild 中标记为 `external`，运行时使用 Node 解析。
+
+## 主键与行编辑
+
+列表接口为每行附加 `__pk`（主键列快照）。更新 / 删除使用主键定位；无主键表不开放行级写操作。

package/README.md

@@ -0,0 +1,37 @@
+# MySQL Dashboard
+
+基于 Web 的 MySQL 图形化管理工具，沿用 mongo-dashboard 的技术栈（f2e-server3 + React + Ant Design + Tailwind）。
+
+## 快速启动
+
+```bash
+cd mysql-dashboard
+npm install
+npm run dev
+```
+
+默认开发端口为 **7018**（与 mongo-dashboard 的 7017 错开）。浏览器访问控制台输出的地址即可。
+
+## 功能概览
+
+- **连接管理**：主机、端口、用户名、密码、可选默认库与 JDBC 风格 URI（`mysql://...`）
+- **数据库**：列表、估算占用、创建 / 重命名（迁移全部表）/ 删除；系统库只读保护
+- **数据表**：列表（基于 `information_schema`）、新建（自增主键空表）、重命名、删除
+- **数据行**：分页浏览、列显示设置、按主键更新 / 删除（无主键表仅支持浏览）
+- **查询**：等值条件 JSON 查询、计数、`SELECT` 自定义查询、JSON 插入一行
+
+## 环境要求
+
+- Node.js >= 18
+- 可访问的 MySQL 5.7+ / 8.x 实例
+
+## 生产构建
+
+```bash
+npm run build
+npm start
+```
+
+## 安全提示
+
+本工具面向可信网络下的管理与排障场景。自定义 `SELECT` 与连接账号权限请自行约束；勿将高权限账号暴露在公网。