🎉 Gitea Mirror: Added

scripts/README.md

@@ -0,0 +1,58 @@
+# Scripts Directory
+
+This folder contains utility scripts for database management.
+
+## Database Management Tool (manage-db.ts)
+
+This is a consolidated database management tool that handles all database-related operations. It combines the functionality of the previous separate scripts into a single, more intelligent script that can check, fix, and initialize the database as needed.
+
+### Features
+
+- **Check Mode**: Validates the existence and integrity of the database
+- **Init Mode**: Creates the database only if it doesn't already exist
+- **Fix Mode**: Corrects database file location issues
+- **Reset Users Mode**: Removes all users and their data
+- **Auto Mode**: Automatically checks, fixes, and initializes the database if needed
+
+## Running the Database Management Tool
+
+You can execute the database management tool using your package manager with various commands:
+
+```bash
+# Checks database status (default action if no command is specified, equivalent to 'pnpm check-db')
+pnpm manage-db
+
+# Check database status
+pnpm check-db
+
+# Initialize the database (only if it doesn't exist)
+pnpm init-db
+
+# Fix database location issues
+pnpm fix-db
+
+# Automatic check, fix, and initialize if needed
+pnpm db-auto
+
+# Reset all users (for testing signup flow)
+pnpm reset-users
+
+# Update the database schema to the latest version
+pnpm update-schema
+
+# Remove database files completely
+pnpm cleanup-db
+
+# Complete setup (install dependencies and initialize database)
+pnpm setup
+
+# Start development server with a fresh database
+pnpm dev:clean
+
+# Start production server with a fresh database
+pnpm start:fresh
+```
+
+## Database File Location
+
+The database file should be located in the `./data/gitea-mirror.db` directory. If the file is found in the root directory, the fix mode will move it to the correct location.