feat: 完善应用启动、停止和状态检查脚本

重构启动、停止和状态检查脚本，增加错误处理、日志记录和配置管理
添加Makefile支持常用命令
更新.env.example文件包含更详细的配置说明

Author: Wpc-121

.env.example

@@ -1,17 +1,77 @@
 # EveryDocs Environment Variables
 # Copy this file to .env and fill in the actual values
+# Note: .env is already listed in .gitignore, so your secrets will never be committed.
 
-# Rails secret key base - use `openssl rand -hex 64` to generate
-SECRET_KEY_BASE=your_secret_key_base_here
+# ==============================================================================
+# Database Configuration (for Docker Compose and Manual Installation)
+# ==============================================================================
 
-# MySQL root password - use a strong password
+# MySQL root password - use a strong password (Docker Compose only)
+# Generate: openssl rand -hex 32
 MYSQL_ROOT_PASSWORD=your_strong_mysql_root_password
 
-# MySQL user password for 'everydocs' user - use a strong password
+# MySQL password for the 'everydocs' user - use a strong password
+# Generate: openssl rand -hex 32
 MYSQL_PASSWORD=your_strong_mysql_password
 
-# Security Notes:
-# 1. NEVER use the default or weak passwords in production
+# Rails secret key base - required for all installations
+# Generate: openssl rand -hex 64
+SECRET_KEY_BASE=your_secret_key_base_here
+
+# ==============================================================================
+# Database Connection (for Manual Installation only)
+# ==============================================================================
+
+# Database adapter (default: mysql2)
+EVERYDOCS_DB_ADAPTER=mysql2
+
+# Database name (default: everydocs)
+EVERYDOCS_DB_NAME=everydocs
+
+# Database user (default: everydocs)
+EVERYDOCS_DB_USER=everydocs
+
+# Database host (default: localhost)
+EVERYDOCS_DB_HOST=localhost
+
+# Database port (default: 3306)
+EVERYDOCS_DB_PORT=3306
+
+# ==============================================================================
+# Application Configuration (for Manual Installation only)
+# ==============================================================================
+
+# Rails environment (development, test, production)
+# Default: production
+RAILS_ENV=production
+
+# Application port
+# Default: 5678
+PORT=5678
+
+# Log directory (relative to project root or absolute path)
+# Default: log
+LOG_DIR=log
+
+# PID file directory (relative to project root or absolute path)
+# Default: tmp/pids
+PID_DIR=tmp/pids
+
+# ==============================================================================
+# Docker Compose Configuration
+# ==============================================================================
+
+# Docker Compose ports (these are the ports exposed on the host)
+# API Port (EveryDocs Core) - Default: 5678
+# Web UI HTTP Port - Default: 8080
+# Web UI HTTPS Port - Default: 8443
+
+# ==============================================================================
+# Security Notes
+# ==============================================================================
+# 1. NEVER use weak passwords or the example values in production
 # 2. Use `openssl rand -hex 32` or similar to generate strong passwords
-# 3. Keep this file (and your .env) out of version control
-# 4. .env is already listed in .gitignore
+# 3. Use `openssl rand -hex 64` to generate SECRET_KEY_BASE
+# 4. Keep this file (and your .env) out of version control
+# 5. For Docker Compose, only MYSQL_ROOT_PASSWORD, MYSQL_PASSWORD, and SECRET_KEY_BASE are required
+# 6. For Manual Installation, all database and application variables are required

Makefile

@@ -0,0 +1,122 @@
+.PHONY: start stop restart status smoke clean help
+
+.DEFAULT_GOAL := help
+
+PROJECT_DIR := $(shell dirname $(realpath $(firstword $(MAKEFILE_LIST))))
+PID_DIR := tmp/pids
+PID_FILE := $(PID_DIR)/everydocs.pid
+LOG_DIR := log
+
+help:
+	@echo "EveryDocs Core - Make Commands"
+	@echo "=============================================="
+	@echo ""
+	@echo "Commands:"
+	@echo "  start       - Start the EveryDocs server"
+	@echo "  stop        - Stop the EveryDocs server"
+	@echo "  restart     - Restart the EveryDocs server"
+	@echo "  status      - Check server status"
+	@echo "  smoke       - Run non-interactive smoke test (for CI)"
+	@echo "  test        - Run Rails tests"
+	@echo "  logs        - Tail the server logs"
+	@echo "  clean-logs  - Clean log files"
+	@echo "  help        - Show this help message"
+	@echo ""
+	@echo "Environment Variables (can be set in .env file):"
+	@echo "  RAILS_ENV       - Rails environment (default: production)"
+	@echo "  PORT            - Server port (default: 5678)"
+	@echo "  SECRET_KEY_BASE - Rails secret key (required)"
+	@echo "  MYSQL_PASSWORD  - Database password (required)"
+	@echo ""
+	@echo "Examples:"
+	@echo "  make start"
+	@echo "  make stop"
+	@echo "  make restart"
+	@echo "  make smoke"
+	@echo ""
+
+start:
+	@echo "Starting EveryDocs Core..."
+	@cd $(PROJECT_DIR) && ./start-app.sh
+
+stop:
+	@echo "Stopping EveryDocs Core..."
+	@cd $(PROJECT_DIR) && ./stop-app.sh
+
+restart: stop start
+
+status:
+	@cd $(PROJECT_DIR) && ./status.sh
+
+logs:
+	@echo "Tailing logs (Ctrl+C to exit)..."
+	@tail -f $(LOG_DIR)/everydocs.log $(LOG_DIR)/everydocs.error.log 2>/dev/null || echo "Log files not found yet"
+
+logs-error:
+	@echo "Tailing error logs (Ctrl+C to exit)..."
+	@tail -f $(LOG_DIR)/everydocs.error.log 2>/dev/null || echo "Error log file not found yet"
+
+clean-logs:
+	@echo "Cleaning log files..."
+	@rm -f $(LOG_DIR)/everydocs.log $(LOG_DIR)/everydocs.error.log
+	@echo "Log files cleaned"
+
+test:
+	@echo "Running Rails tests..."
+	@cd $(PROJECT_DIR) && rails test RAILS_ENV=test
+
+test-controllers:
+	@echo "Running controller tests..."
+	@cd $(PROJECT_DIR) && rails test test/controllers/ RAILS_ENV=test
+
+db-migrate:
+	@echo "Running database migrations..."
+	@cd $(PROJECT_DIR) && rails db:migrate
+
+db-migrate-test:
+	@echo "Running database migrations (test env)..."
+	@cd $(PROJECT_DIR) && rails db:migrate RAILS_ENV=test
+
+smoke:
+	@echo "=============================================="
+	@echo "EveryDocs Core - Non-Interactive Smoke Test"
+	@echo "=============================================="
+	@echo ""
+	@echo "Phase 1: Checking prerequisites..."
+	@cd $(PROJECT_DIR) && if [ ! -f .env ]; then \
+		echo "  ERROR: .env file not found"; \
+		echo "  Create one from .env.example: cp .env.example .env"; \
+		exit 1; \
+	else \
+		echo "  ✓ .env file exists"; \
+	fi
+	@cd $(PROJECT_DIR) && if grep -q "your_secret_key_base_here" .env 2>/dev/null; then \
+		echo "  ERROR: SECRET_KEY_BASE not set in .env"; \
+		echo "  Generate one with: openssl rand -hex 64"; \
+		exit 1; \
+	else \
+		echo "  ✓ SECRET_KEY_BASE appears to be set"; \
+	fi
+	@echo ""
+	
+	@echo "Phase 2: Checking required commands..."
+	@which ruby >/dev/null 2>&1 && echo "  ✓ ruby" || (echo "  ✗ ruby (required)" && exit 1)
+	@which bundle >/dev/null 2>&1 && echo "  ✓ bundle" || (echo "  ✗ bundle (required)" && exit 1)
+	@which rails >/dev/null 2>&1 && echo "  ✓ rails" || (echo "  ✗ rails (required)" && exit 1)
+	@echo ""
+	
+	@echo "Phase 3: Checking bundle dependencies..."
+	@cd $(PROJECT_DIR) && bundle check 2>/dev/null && echo "  ✓ Dependencies satisfied" || (echo "  ✗ Dependencies missing. Run: bundle install" && exit 1)
+	@echo ""
+	
+	@echo "Phase 4: Checking test setup..."
+	@cd $(PROJECT_DIR) && rails db:migrate RAILS_ENV=test 2>&1 | tail -1
+	@echo ""
+	
+	@echo "Phase 5: Running basic tests..."
+	@cd $(PROJECT_DIR) && rails test RAILS_ENV=test 2>&1
+	@echo ""
+	
+	@echo "=============================================="
+	@echo "Smoke Test Completed"
+	@echo "=============================================="