优化验证报名信息对话框车牌号输入布局，使标签和输入框在同一行显示

2026-04-09 15:37:40 +08:00
parent 89960b1cb8
commit 4920620d2c
48 changed files with 4804 additions and 3916 deletions
@@ -0,0 +1,84 @@
+/**
+ * 迁移: 初始化数据库结构（确保所有表和字段存在）
+ * 版本: 0000
+ * 日期: 2025-01-09
+ */
+
+module.exports = {
+  async up(manager) {
+    console.log('  - 检查并创建所有必需的表和字段...');
+    
+    // Activities 表的额外字段
+    const activityFields = [
+      { name: 'registrationEnabled', sql: 'ALTER TABLE Activities ADD COLUMN registrationEnabled INTEGER DEFAULT 1;' },
+      { name: 'coverImage', sql: 'ALTER TABLE Activities ADD COLUMN coverImage TEXT;' },
+      { name: 'price', sql: 'ALTER TABLE Activities ADD COLUMN price DECIMAL(10, 2) DEFAULT 0;' },
+      { name: 'budget', sql: 'ALTER TABLE Activities ADD COLUMN budget DECIMAL(10, 2) DEFAULT 0;' },
+      { name: 'locationLat', sql: 'ALTER TABLE Activities ADD COLUMN locationLat DECIMAL(10, 7);' },
+      { name: 'locationLng', sql: 'ALTER TABLE Activities ADD COLUMN locationLng DECIMAL(10, 7);' }
+    ];
+    
+    for (const field of activityFields) {
+      await manager.executeSql(field.sql);
+    }
+    
+    // Registrations 表的额外字段
+    const registrationFields = [
+      { name: 'peopleCount', sql: 'ALTER TABLE Registrations ADD COLUMN peopleCount INTEGER DEFAULT 1;' },
+      { name: 'note', sql: 'ALTER TABLE Registrations ADD COLUMN note TEXT;' }
+    ];
+    
+    for (const field of registrationFields) {
+      await manager.executeSql(field.sql);
+    }
+    
+    // Expenses 表的额外字段
+    const expenseFields = [
+      { name: 'category', sql: 'ALTER TABLE Expenses ADD COLUMN category TEXT;' },
+      { name: 'receipt', sql: 'ALTER TABLE Expenses ADD COLUMN receipt TEXT;' },
+      { name: 'note', sql: 'ALTER TABLE Expenses ADD COLUMN note TEXT;' },
+      { name: 'media', sql: 'ALTER TABLE Expenses ADD COLUMN media TEXT;' }
+    ];
+    
+    for (const field of expenseFields) {
+      await manager.executeSql(field.sql);
+    }
+    
+    // Photos 表的额外字段
+    const photoFields = [
+      { name: 'description', sql: 'ALTER TABLE Photos ADD COLUMN description TEXT;' },
+      { name: 'uploadedBy', sql: 'ALTER TABLE Photos ADD COLUMN uploadedBy TEXT;' },
+      { name: 'status', sql: 'ALTER TABLE Photos ADD COLUMN status TEXT DEFAULT "approved";' }
+    ];
+    
+    for (const field of photoFields) {
+      await manager.executeSql(field.sql);
+    }
+    
+    // Sponsors 表的额外字段
+    const sponsorFields = [
+      { name: 'logo', sql: 'ALTER TABLE Sponsors ADD COLUMN logo TEXT;' },
+      { name: 'type', sql: 'ALTER TABLE Sponsors ADD COLUMN type TEXT DEFAULT "sponsor";' },
+      { name: 'link', sql: 'ALTER TABLE Sponsors ADD COLUMN link TEXT;' }
+    ];
+    
+    for (const field of sponsorFields) {
+      await manager.executeSql(field.sql);
+    }
+    
+    // Admins 表的额外字段
+    const adminFields = [
+      { name: 'name', sql: 'ALTER TABLE Admins ADD COLUMN name TEXT;' }
+    ];
+    
+    for (const field of adminFields) {
+      await manager.executeSql(field.sql);
+    }
+    
+    console.log('  - 初始化完成');
+  },
+
+  async down(manager) {
+    console.log('  - 回滚不支持');
+  }
+};
@@ -0,0 +1,24 @@
+/**
+ * 迁移: 添加弹幕功能字段
+ * 版本: 0001
+ * 日期: 2025-01-09
+ */
+
+module.exports = {
+  async up(manager) {
+    console.log('  - 添加 danmakuEnabled 字段...');
+    await manager.executeSql(`
+      ALTER TABLE Activities ADD COLUMN danmakuEnabled INTEGER DEFAULT 0;
+    `);
+    
+    console.log('  - 添加 danmakuContent 字段...');
+    await manager.executeSql(`
+      ALTER TABLE Activities ADD COLUMN danmakuContent TEXT;
+    `);
+  },
+
+  async down(manager) {
+    // SQLite 不支持 DROP COLUMN，需要重建表
+    console.log('  - 回滚不支持，请手动处理');
+  }
+};
@@ -0,0 +1,18 @@
+/**
+ * 迁移: 添加赞助商排序字段
+ * 版本: 0002
+ * 日期: 2025-01-09
+ */
+
+module.exports = {
+  async up(manager) {
+    console.log('  - 添加 Sponsors.sortOrder 字段...');
+    await manager.executeSql(`
+      ALTER TABLE Sponsors ADD COLUMN sortOrder INTEGER DEFAULT 0;
+    `);
+  },
+
+  async down(manager) {
+    console.log('  - 回滚不支持');
+  }
+};
@@ -0,0 +1,23 @@
+/**
+ * 迁移: 添加签到功能字段
+ * 版本: 0003
+ * 日期: 2025-01-09
+ */
+
+module.exports = {
+  async up(manager) {
+    console.log('  - 添加 Registrations.checkInStatus 字段...');
+    await manager.executeSql(`
+      ALTER TABLE Registrations ADD COLUMN checkInStatus INTEGER DEFAULT 0;
+    `);
+    
+    console.log('  - 添加 Registrations.checkInTime 字段...');
+    await manager.executeSql(`
+      ALTER TABLE Registrations ADD COLUMN checkInTime DATETIME;
+    `);
+  },
+
+  async down(manager) {
+    console.log('  - 回滚不支持');
+  }
+};
@@ -0,0 +1,31 @@
+/**
+ * 迁移: 添加奖品表
+ * 版本: 0004
+ * 日期: 2025-01-10
+ */
+
+module.exports = {
+  async up(manager) {
+    console.log('  - 创建 Prizes 表...');
+    
+    await manager.executeSql(`
+      CREATE TABLE IF NOT EXISTS Prizes (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        activityId INTEGER NOT NULL,
+        name TEXT NOT NULL,
+        level TEXT NOT NULL CHECK(level IN ('一等奖', '二等奖', '三等奖', '参与奖', '伴手礼')),
+        description TEXT,
+        image TEXT,
+        quantity INTEGER DEFAULT 1,
+        sortOrder INTEGER DEFAULT 0,
+        createdAt DATETIME DEFAULT CURRENT_TIMESTAMP,
+        updatedAt DATETIME DEFAULT CURRENT_TIMESTAMP
+      );
+    `);
+  },
+
+  async down(manager) {
+    console.log('  - 删除 Prizes 表...');
+    await manager.executeSql('DROP TABLE IF EXISTS Prizes;');
+  }
+};
@@ -0,0 +1,190 @@
+# 数据库迁移系统
+
+## 概述
+
+本项目使用版本化的数据库迁移系统，支持增量更新和自动同步。
+
+## 特性
+
+- ✅ 版本管理：每个迁移有唯一版本号
+- ✅ 增量执行：只执行未执行的迁移
+- ✅ 自动运行：服务器启动时自动执行迁移
+- ✅ 幂等性：重复执行不会出错
+- ✅ 迁移记录：记录所有已执行的迁移
+
+## 迁移文件命名规范
+
+```
+XXXX-description.js
+```
+
+- `XXXX`: 4位数字版本号（如 0001, 0002）
+- `description`: 迁移描述（使用短横线分隔）
+
+示例：
+- `0001-add-danmaku-fields.js`
+- `0002-add-user-avatar.js`
+
+## 创建新迁移
+
+### 1. 创建迁移文件
+
+在 `backend/migrations/` 目录下创建新文件：
+
+```javascript
+/**
+ * 迁移: 添加用户头像字段
+ * 版本: 0002
+ * 日期: 2025-01-09
+ */
+
+module.exports = {
+  async up(manager) {
+    console.log('  - 添加 avatar 字段...');
+    await manager.executeSql(`
+      ALTER TABLE Users ADD COLUMN avatar TEXT;
+    `);
+  },
+
+  async down(manager) {
+    // 回滚逻辑（可选）
+    console.log('  - 回滚不支持');
+  }
+};
+```
+
+### 2. 迁移方法
+
+#### `up(manager)` - 升级
+执行数据库变更的方法。
+
+可用的 manager 方法：
+- `executeSql(sql)`: 执行SQL语句
+- `db`: 直接访问数据库连接
+
+#### `down(manager)` - 回滚（可选）
+回滚数据库变更的方法。
+
+注意：SQLite 不支持 DROP COLUMN，回滚可能需要重建表。
+
+## 执行迁移
+
+### 自动执行（推荐）
+
+服务器启动时会自动执行所有未执行的迁移：
+
+```bash
+# 开发环境
+cd backend
+npm start
+
+# 生产环境（Docker）
+docker-compose up -d
+# 或
+docker-compose restart
+```
+
+### 手动执行
+
+#### 在容器内执行：
+
+```bash
+# Windows
+migrate.bat
+
+# Linux/Mac
+chmod +x migrate.sh
+./migrate.sh
+```
+
+#### 直接在容器中执行：
+
+```bash
+docker exec quanyoumi-app node /app/backend/migrations/index.js
+```
+
+## 迁移状态
+
+迁移执行记录保存在 `migrations` 表中：
+
+```sql
+SELECT * FROM migrations;
+```
+
+输出示例：
+```
+id | version | name                  | executed_at
+---+---------+-----------------------+---------------------
+1  | 1       | add-danmaku-fields    | 2025-01-09 10:30:00
+2  | 2       | add-user-avatar       | 2025-01-09 11:00:00
+```
+
+## 常见问题
+
+### Q: 迁移失败怎么办？
+
+A: 检查错误日志，修复问题后重新启动服务器。已执行的迁移不会重复执行。
+
+### Q: 如何回滚迁移？
+
+A: 目前不支持自动回滚。如需回滚，请手动修改数据库或创建新的迁移来撤销更改。
+
+### Q: 可以修改已执行的迁移吗？
+
+A: 不建议。已执行的迁移不应修改。如需更改，请创建新的迁移。
+
+### Q: 迁移在什么时候执行？
+
+A: 服务器启动时自动执行。也可以手动运行 `migrate.bat` 或 `migrate.sh`。
+
+## 最佳实践
+
+1. **版本号递增**：新迁移的版本号应大于所有现有迁移
+2. **描述清晰**：文件名和注释应清楚说明迁移目的
+3. **测试迁移**：在开发环境测试后再部署到生产环境
+4. **幂等性**：迁移应该可以安全地重复执行
+5. **小步迭代**：每个迁移只做一件事，便于追踪和回滚
+
+## 示例
+
+### 添加新字段
+
+```javascript
+module.exports = {
+  async up(manager) {
+    await manager.executeSql(`
+      ALTER TABLE Activities ADD COLUMN featured INTEGER DEFAULT 0;
+    `);
+  }
+};
+```
+
+### 创建新表
+
+```javascript
+module.exports = {
+  async up(manager) {
+    await manager.executeSql(`
+      CREATE TABLE IF NOT EXISTS Comments (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        activityId INTEGER NOT NULL,
+        userId INTEGER NOT NULL,
+        content TEXT NOT NULL,
+        createdAt DATETIME DEFAULT CURRENT_TIMESTAMP
+      );
+    `);
+  }
+};
+```
+
+### 修改数据
+
+```javascript
+module.exports = {
+  async up(manager) {
+    await manager.executeSql(`
+      UPDATE Activities SET status = 'completed' WHERE endTime < datetime('now');
+    `);
+  }
+};
+```
@@ -0,0 +1,141 @@
+const sqlite3 = require('sqlite3').verbose();
+const path = require('path');
+const fs = require('fs');
+
+const dbPath = path.join(__dirname, '..', 'data', 'database.sqlite');
+const migrationsDir = __dirname;
+
+class MigrationManager {
+  constructor() {
+    this.db = new sqlite3.Database(dbPath);
+  }
+
+  // 初始化迁移表
+  async initMigrationTable() {
+    return new Promise((resolve, reject) => {
+      this.db.run(`
+        CREATE TABLE IF NOT EXISTS migrations (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          version INTEGER NOT NULL UNIQUE,
+          name TEXT NOT NULL,
+          executed_at DATETIME DEFAULT CURRENT_TIMESTAMP
+        )
+      `, (err) => {
+        if (err) reject(err);
+        else resolve();
+      });
+    });
+  }
+
+  // 获取已执行的迁移版本
+  async getExecutedMigrations() {
+    return new Promise((resolve, reject) => {
+      this.db.all('SELECT version FROM migrations ORDER BY version', (err, rows) => {
+        if (err) reject(err);
+        else resolve(rows.map(r => r.version));
+      });
+    });
+  }
+
+  // 记录迁移执行
+  async recordMigration(version, name) {
+    return new Promise((resolve, reject) => {
+      this.db.run(
+        'INSERT INTO migrations (version, name) VALUES (?, ?)',
+        [version, name],
+        (err) => {
+          if (err) reject(err);
+          else resolve();
+        }
+      );
+    });
+  }
+
+  // 执行SQL语句
+  async executeSql(sql) {
+    return new Promise((resolve, reject) => {
+      this.db.run(sql, (err) => {
+        if (err) {
+          // 忽略字段已存在的错误
+          if (err.message.includes('duplicate column name')) {
+            resolve();
+          } else {
+            reject(err);
+          }
+        } else {
+          resolve();
+        }
+      });
+    });
+  }
+
+  // 加载所有迁移文件
+  loadMigrations() {
+    const files = fs.readdirSync(migrationsDir)
+      .filter(f => f.match(/^\d{4}-.*\.js$/) && f !== 'index.js')
+      .sort();
+
+    return files.map(file => {
+      const version = parseInt(file.split('-')[0]);
+      const name = file.replace(/^\d{4}-/, '').replace('.js', '');
+      const migration = require(path.join(migrationsDir, file));
+      return { version, name, file, migration };
+    });
+  }
+
+  // 执行迁移
+  async runMigrations() {
+    try {
+      console.log('🔄 开始数据库迁移...\n');
+      
+      // 初始化迁移表
+      await this.initMigrationTable();
+      
+      // 获取已执行的迁移
+      const executed = await this.getExecutedMigrations();
+      console.log(`📊 已执行迁移: ${executed.length} 个`);
+      
+      // 加载所有迁移文件
+      const migrations = this.loadMigrations();
+      console.log(`📁 发现迁移文件: ${migrations.length} 个\n`);
+      
+      // 执行未执行的迁移
+      let count = 0;
+      for (const { version, name, file, migration } of migrations) {
+        if (!executed.includes(version)) {
+          console.log(`⏳ 执行迁移 [${version}] ${name}...`);
+          
+          try {
+            await migration.up(this);
+            await this.recordMigration(version, name);
+            console.log(`✅ 迁移 [${version}] ${name} 完成\n`);
+            count++;
+          } catch (error) {
+            console.error(`❌ 迁移 [${version}] ${name} 失败:`, error.message);
+            throw error;
+          }
+        } else {
+          console.log(`⏭️  跳过已执行的迁移 [${version}] ${name}`);
+        }
+      }
+      
+      console.log(`\n✨ 迁移完成！共执行 ${count} 个新迁移`);
+      
+    } catch (error) {
+      console.error('\n❌ 迁移失败:', error);
+      throw error;
+    } finally {
+      this.db.close();
+    }
+  }
+}
+
+// 如果直接运行此文件
+if (require.main === module) {
+  const manager = new MigrationManager();
+  manager.runMigrations()
+    .then(() => process.exit(0))
+    .catch(() => process.exit(1));
+}
+
+module.exports = MigrationManager;