fdb2 1.0.22 → 1.0.23

package/README.md

@@ -1,4 +1,10 @@
-# fdb2 - 数据库管理工具
+# fdb2 - 数据库管理工具 / Database Management Tool
+
+**[中文](#中文)** | **[English](#english)**
+
+---
+
+## 中文
 
 一款轻量级、跨平台的数据库管理工具,支持多种数据库类型,提供类似 Navicat Premium 的使用体验。
 
@@ -317,3 +323,343 @@ rm -rf ~/.db-tool
 ---
 
 **享受使用 fdb2 数据库管理工具！如有任何问题，欢迎反馈。**
+
+---
+
+## English
+
+A lightweight, cross-platform database management tool that supports multiple database types, providing a Navicat Premium-like experience.
+
+![fdb2 Preview](public/fdb2.png)
+
+### Quick Start
+
+This is an open-source database management tool. You can install it globally via npm as a command-line tool, or download our pre-built desktop client application.
+
+#### Desktop Client Download (Recommended)
+If you prefer not to use the command line, you can directly download our pre-built cross-platform desktop client:
+- **Windows / macOS / Linux**: [Go to Release page to download](https://github.com/fefeding/fdb2/releases/tag/client)
+- Unzip and double-click to run, no environment configuration required.
+
+#### Command Line Installation
+
+```bash
+# Global installation
+npm install -g fdb2
+
+# Or use yarn
+yarn global add fdb2
+
+# Or use pnpm
+pnpm add -g fdb2
+```
+
+#### Start Service
+
+```bash
+# Start the database management tool
+fdb2 start
+
+# Stop service
+fdb2 stop
+
+# Check service status
+fdb2 status
+
+# Restart service
+fdb2 restart
+```
+
+#### Access Application
+
+After starting the service, open in browser (check the output for the actual URL, the port may vary):
+```
+http://localhost:9800
+```
+
+**Homepage**: [https://surl.fit/tools/tools/fdb2](https://surl.fit/tools/tools/fdb2)
+
+### Features
+
+#### Connection Management
+- Supports 8 database types: MySQL, PostgreSQL, SQLite, SQL Server, Oracle, CockroachDB, MongoDB, SAP HANA
+- Visual connection configuration interface, simple and intuitive
+- One-click test connection for quick verification
+- Secure local storage of connection information
+
+#### Database Structure
+- Clear database information overview
+- Detailed table structure viewing
+- Complete column info, indexes, and foreign key relationships
+- Real-time database size and statistics
+
+#### Data Operations
+- Quick table data viewing and pagination
+- Flexible conditional queries and sorting
+- Convenient data insert, edit, and delete
+- Export data to JSON and CSV formats
+
+#### SQL Query
+- Code editor-style SQL input
+- SQL syntax formatting for better readability
+- Auto-save query history
+- Batch query result display
+
+#### Key Advantages
+- **Zero Configuration**: Ready to use after global installation
+- **Cross-Platform**: Full compatibility with Windows, macOS, and Linux
+- **Lightweight & Efficient**: Low resource usage
+- **Local Storage**: Data saved locally, safe and reliable
+- **Offline Use**: Manage local databases without internet
+
+### Usage Guide
+
+#### Add Database Connection
+
+1. Open browser and visit `http://localhost:9800`
+2. Click "Connection Management" in the left navigation
+3. Click "New Connection" button
+4. Fill in connection information:
+   - **Connection Name**: Custom name for easy identification (e.g., Production MySQL)
+   - **Database Type**: Select the corresponding database type
+   - **Host**: Database server address (use `localhost` or `127.0.0.1` for local databases)
+   - **Port**: Database service port (default port will be auto-filled)
+   - **Database Name**: The database name to connect to
+   - **Username/Password**: Database authentication credentials
+5. Click "Test Connection" to verify the configuration
+6. Save the connection configuration
+
+#### View Database Structure
+
+1. Select "Database Structure" in the left navigation
+2. Select a configured database connection
+3. Select the database to view
+4. Browse table list and details:
+   - **Table Info**: Row count, size, and other statistics
+   - **Column Definitions**: Data types, constraints, default values, etc.
+   - **Index Info**: Primary keys, unique indexes, regular indexes
+   - **Foreign Keys**: Relationships between tables
+
+#### View and Edit Table Data
+
+1. Click the "Data" button in the table list
+2. Set query conditions:
+   - **WHERE Condition**: Enter filter conditions (e.g., `id > 100`)
+   - **Order By**: Specify sorting (e.g., `create_time DESC`)
+   - **Page Size**: Adjust pagination (10/50/100/500)
+3. Click "Query" button to execute
+4. Supported operations:
+   - **View Details**: Click a row to view complete data
+   - **Edit Record**: Modify data and save
+   - **Delete Record**: Remove unwanted data
+   - **Insert Data**: Click "New" button to add data
+   - **Export Data**: Choose JSON or CSV format for export
+
+#### Execute SQL Queries
+
+1. Click "SQL Query" in the left navigation
+2. Select a database connection
+3. Enter SQL statements in the editor
+4. Quick actions:
+   - **Ctrl + Enter** (Windows) or **Cmd + Enter** (Mac): Quick execute
+   - Click "Format" button: Beautify SQL statements
+   - View history: Click history button to select previous queries
+5. View query results with export support
+
+#### Common SQL Examples
+
+```sql
+-- Query first 10 rows
+SELECT * FROM table_name LIMIT 10;
+
+-- Conditional query
+SELECT * FROM users WHERE status = 'active' ORDER BY created_at DESC;
+
+-- Aggregate data
+SELECT COUNT(*) as total, status FROM users GROUP BY status;
+
+-- Insert data
+INSERT INTO users (name, email, status) VALUES ('John', 'john@example.com', 'active');
+
+-- Update data
+UPDATE users SET status = 'inactive' WHERE last_login < '2024-01-01';
+
+-- Delete data
+DELETE FROM logs WHERE created_at < '2024-01-01';
+```
+
+### Supported Database Types
+
+| Database Type | Default Port | Features |
+|--------------|-------------|----------|
+| MySQL | 3306 | Stored procedures, triggers, views, full-text search |
+| PostgreSQL | 5432 | Stored procedures, triggers, views, JSON type |
+| SQLite | - | Lightweight, file-based, no server required |
+| SQL Server | 1433 | Microsoft database, stored procedures, triggers, views |
+| Oracle | 1521 | Enterprise-grade, feature-rich |
+| CockroachDB | 26257 | Distributed SQL, PostgreSQL compatible |
+| MongoDB | 27017 | NoSQL document database |
+| SAP HANA | 39013 | In-memory database, high-performance analytics |
+
+**Compatibility Notes**:
+- MariaDB, TiDB are compatible with MySQL — select MySQL type
+- Aurora MySQL is compatible with MySQL — select MySQL type
+- Aurora PostgreSQL is compatible with PostgreSQL — select PostgreSQL type
+- Better-SQLite3 is compatible with SQLite — select SQLite type
+
+### FAQ
+
+<details>
+<summary>Installation & Startup</summary>
+
+**Q: Service won't start after installation?**
+
+A: Please check the following:
+1. Confirm correct installation: `npm install -g fdb2`
+2. Check Node.js version (v14+ recommended): `node --version`
+3. View error details: `fdb2 start --verbose`
+4. Check if the port is already in use
+
+**Q: How to change the port?**
+
+A: Use the `-p` parameter:
+```bash
+fdb2 start -p 8080
+```
+
+Or set via environment variable:
+```bash
+# Windows
+set PORT=8080
+fdb2 start
+
+# Mac/Linux
+PORT=8080 fdb2 start
+```
+
+</details>
+
+<details>
+<summary>Connection Issues</summary>
+
+**Q: Failed to connect to database?**
+
+A: Follow these troubleshooting steps:
+1. Confirm the database service is running
+2. Check network connection and port settings
+3. Verify username and password
+4. Check if the database allows remote connections
+5. Review database firewall settings
+
+**Q: SQLite connection failed?**
+
+A: SQLite requires a database file path:
+- Absolute path: `D:\data\mydb.sqlite`
+- Relative path: `./data/mydb.sqlite` (relative to data directory)
+- Ensure the file exists and is readable
+
+</details>
+
+<details>
+<summary>Data Operations</summary>
+
+**Q: Empty query results?**
+
+A: Possible reasons:
+1. The table has no data
+2. WHERE condition is too strict
+3. Wrong database or table name
+4. Insufficient query permissions
+
+**Q: Cannot edit or delete data?**
+
+A: Please check:
+1. Sufficient database permissions
+2. Foreign key constraints on the table
+3. Data is locked
+4. Check database error logs
+
+</details>
+
+<details>
+<summary>Performance</summary>
+
+**Q: Slow query speed?**
+
+A: Optimization suggestions:
+1. Add appropriate indexes
+2. Limit query results (use LIMIT)
+3. Avoid `SELECT *`, only query needed fields
+4. Optimize WHERE conditions
+5. Consider batch processing for large datasets
+
+**Q: Slow database info loading?**
+
+A: Possible reasons:
+1. Too many tables in the database
+2. Large table data size
+3. Network latency
+4. Database performance issues
+
+</details>
+
+<details>
+<summary>Data Security</summary>
+
+**Q: Are connection passwords secure?**
+
+A: The current version stores passwords in plain text in local config files. Recommendations:
+1. Don't save sensitive database connections on public computers
+2. Change database passwords regularly
+3. Use read-only accounts for daily operations
+4. Use encrypted connections (SSL/TLS) in production
+
+**Q: How to backup connection config?**
+
+A: Simply copy the config file:
+```bash
+# Windows
+copy C:\Users\YourName\.db-tool\connections.json D:\backup\
+
+# Mac/Linux
+cp ~/.db-tool/connections.json ~/backup/
+```
+
+</details>
+
+<details>
+<summary>Update & Uninstall</summary>
+
+**Q: How to update to the latest version?**
+
+A: Simply reinstall:
+```bash
+npm update -g fdb2
+```
+
+**Q: How to completely uninstall?**
+
+A: Follow these steps:
+```bash
+# Uninstall
+npm uninstall -g fdb2
+
+# Delete data directory (optional, removes all connection configs)
+# Windows
+rmdir /s C:\Users\YourName\.db-tool
+
+# Mac/Linux
+rm -rf ~/.db-tool
+```
+
+</details>
+
+### Get Help
+
+- **GitHub Issues**: [Submit an issue](https://github.com/fefeding/fdb2/issues)
+- **Documentation**: View online docs
+- **Community**: Join user groups
+
+---
+
+**Enjoy using fdb2 Database Management Tool! Feel free to provide feedback.**

package/dist/public/.vite/manifest.json

@@ -84,8 +84,8 @@
     "isEntry": true,
     "imports": [
       "_rolldown-runtime.js",
-      "_bootstrap.js",
-      "_vue.js"
+      "_vue.js",
+      "_bootstrap.js"
     ],
     "dynamicImports": [
       "src/platform/database/layout.vue",

package/dist/public/bootstrap.js

@@ -1652,6 +1652,11 @@ var init_lib = __esmMin((() => {
 }));
 //#endregion
 //#region node_modules/.pnpm/bootstrap@5.3.8_@popperjs+core@2.11.8/node_modules/bootstrap/dist/js/bootstrap.esm.js
+/*!
+* Bootstrap v5.3.8 (https://getbootstrap.com/)
+* Copyright 2011-2025 The Bootstrap Authors (https://github.com/twbs/bootstrap/graphs/contributors)
+* Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)
+*/
 /**
 * Private methods
 */
@@ -2413,7 +2418,7 @@ var init_bootstrap_esm = __esmMin((() => {
 	CLASS_NAME_PREV = "carousel-item-prev";
 	SELECTOR_ACTIVE = ".active";
 	SELECTOR_ITEM = ".carousel-item";
-	SELECTOR_ACTIVE_ITEM = SELECTOR_ACTIVE + SELECTOR_ITEM;
+	SELECTOR_ACTIVE_ITEM = ".active.carousel-item";
 	SELECTOR_ITEM_IMG = ".carousel-item img";
 	SELECTOR_INDICATORS = ".carousel-indicators";
 	SELECTOR_DATA_SLIDE = "[data-bs-slide], [data-bs-slide-to]";