添加角色信息编辑

lib/data/character/book_character_dao.dart

@@ -0,0 +1,85 @@
+import 'package:flutter/foundation.dart';
+import '../../models/data_models.dart';
+import '../database_helper.dart';
+
+/// 书籍角色数据访问对象
+class BookCharacterDao {
+  final DatabaseHelper _dbHelper = DatabaseHelper.instance;
+
+  Future<T> _wrap<T>(String op, Future<T> Function() fn) async {
+    try {
+      return await fn();
+    } catch (e) {
+      debugPrint('[BookCharacterDao] $op error: $e');
+      rethrow;
+    }
+  }
+
+  /// 获取书籍的所有角色
+  Future<List<BookCharacter>> getByBookId(String bookId) => _wrap('getByBookId', () async {
+    final db = await _dbHelper.database;
+    final maps = await db.query(
+      'book_characters',
+      where: 'book_id = ? AND is_deleted = 0',
+      whereArgs: [bookId],
+      orderBy: 'sort_order, created_at',
+    );
+    return maps.map((m) => BookCharacter.fromJson(m)).toList();
+  });
+
+  /// 根据ID获取角色
+  Future<BookCharacter?> getById(String id) => _wrap('getById', () async {
+    final db = await _dbHelper.database;
+    final maps = await db.query(
+      'book_characters',
+      where: 'id = ? AND is_deleted = 0',
+      whereArgs: [id],
+    );
+    if (maps.isEmpty) return null;
+    return BookCharacter.fromJson(maps.first);
+  });
+
+  /// 添加角色
+  Future<int> insert(BookCharacter character) => _wrap('insert', () async {
+    final db = await _dbHelper.database;
+    return await db.insert('book_characters', character.toJson());
+  });
+
+  /// 更新角色
+  Future<int> update(BookCharacter character) => _wrap('update', () async {
+    final db = await _dbHelper.database;
+    return await db.update(
+      'book_characters',
+      character.toJson(),
+      where: 'id = ?',
+      whereArgs: [character.id],
+    );
+  });
+
+  /// 软删除角色
+  Future<int> delete(String id) => _wrap('delete', () async {
+    final db = await _dbHelper.database;
+    return await db.update(
+      'book_characters',
+      {'is_deleted': 1, 'updated_at': DateTime.now().toUtc().toIso8601String()},
+      where: 'id = ?',
+      whereArgs: [id],
+    );
+  });
+
+  /// 获取书籍的角色数量
+  Future<int> getCount(String bookId) => _wrap('getCount', () async {
+    final db = await _dbHelper.database;
+    final result = await db.rawQuery(
+      'SELECT COUNT(*) as count FROM book_characters WHERE book_id = ? AND is_deleted = 0',
+      [bookId],
+    );
+    return result.first['count'] as int? ?? 0;
+  });
+
+  /// 彻底删除角色
+  Future<void> permanentDelete(String id) => _wrap('permanentDelete', () async {
+    final db = await _dbHelper.database;
+    await db.delete('book_characters', where: 'id = ?', whereArgs: [id]);
+  });
+}

lib/data/character/game_character_dao.dart

@@ -0,0 +1,85 @@
+import 'package:flutter/foundation.dart';
+import '../../models/data_models.dart';
+import '../database_helper.dart';
+
+/// 游戏角色数据访问对象
+class GameCharacterDao {
+  final DatabaseHelper _dbHelper = DatabaseHelper.instance;
+
+  Future<T> _wrap<T>(String op, Future<T> Function() fn) async {
+    try {
+      return await fn();
+    } catch (e) {
+      debugPrint('[GameCharacterDao] $op error: $e');
+      rethrow;
+    }
+  }
+
+  /// 获取游戏的所有角色
+  Future<List<GameCharacter>> getByGameId(String gameId) => _wrap('getByGameId', () async {
+    final db = await _dbHelper.database;
+    final maps = await db.query(
+      'game_characters',
+      where: 'game_id = ? AND is_deleted = 0',
+      whereArgs: [gameId],
+      orderBy: 'sort_order, created_at',
+    );
+    return maps.map((m) => GameCharacter.fromJson(m)).toList();
+  });
+
+  /// 根据ID获取角色
+  Future<GameCharacter?> getById(String id) => _wrap('getById', () async {
+    final db = await _dbHelper.database;
+    final maps = await db.query(
+      'game_characters',
+      where: 'id = ? AND is_deleted = 0',
+      whereArgs: [id],
+    );
+    if (maps.isEmpty) return null;
+    return GameCharacter.fromJson(maps.first);
+  });
+
+  /// 添加角色
+  Future<int> insert(GameCharacter character) => _wrap('insert', () async {
+    final db = await _dbHelper.database;
+    return await db.insert('game_characters', character.toJson());
+  });
+
+  /// 更新角色
+  Future<int> update(GameCharacter character) => _wrap('update', () async {
+    final db = await _dbHelper.database;
+    return await db.update(
+      'game_characters',
+      character.toJson(),
+      where: 'id = ?',
+      whereArgs: [character.id],
+    );
+  });
+
+  /// 软删除角色
+  Future<int> delete(String id) => _wrap('delete', () async {
+    final db = await _dbHelper.database;
+    return await db.update(
+      'game_characters',
+      {'is_deleted': 1, 'updated_at': DateTime.now().toUtc().toIso8601String()},
+      where: 'id = ?',
+      whereArgs: [id],
+    );
+  });
+
+  /// 获取游戏的角色数量
+  Future<int> getCount(String gameId) => _wrap('getCount', () async {
+    final db = await _dbHelper.database;
+    final result = await db.rawQuery(
+      'SELECT COUNT(*) as count FROM game_characters WHERE game_id = ? AND is_deleted = 0',
+      [gameId],
+    );
+    return result.first['count'] as int? ?? 0;
+  });
+
+  /// 彻底删除角色
+  Future<void> permanentDelete(String id) => _wrap('permanentDelete', () async {
+    final db = await _dbHelper.database;
+    await db.delete('game_characters', where: 'id = ?', whereArgs: [id]);
+  });
+}

lib/data/character/movie_character_dao.dart

@@ -0,0 +1,85 @@
+import 'package:flutter/foundation.dart';
+import '../../models/data_models.dart';
+import '../database_helper.dart';
+
+/// 影视角色数据访问对象
+class MovieCharacterDao {
+  final DatabaseHelper _dbHelper = DatabaseHelper.instance;
+
+  Future<T> _wrap<T>(String op, Future<T> Function() fn) async {
+    try {
+      return await fn();
+    } catch (e) {
+      debugPrint('[MovieCharacterDao] $op error: $e');
+      rethrow;
+    }
+  }
+
+  /// 获取影视的所有角色
+  Future<List<MovieCharacter>> getByMovieId(String movieId) => _wrap('getByMovieId', () async {
+    final db = await _dbHelper.database;
+    final maps = await db.query(
+      'movie_characters',
+      where: 'movie_id = ? AND is_deleted = 0',
+      whereArgs: [movieId],
+      orderBy: 'sort_order, created_at',
+    );
+    return maps.map((m) => MovieCharacter.fromJson(m)).toList();
+  });
+
+  /// 根据ID获取角色
+  Future<MovieCharacter?> getById(String id) => _wrap('getById', () async {
+    final db = await _dbHelper.database;
+    final maps = await db.query(
+      'movie_characters',
+      where: 'id = ? AND is_deleted = 0',
+      whereArgs: [id],
+    );
+    if (maps.isEmpty) return null;
+    return MovieCharacter.fromJson(maps.first);
+  });
+
+  /// 添加角色
+  Future<int> insert(MovieCharacter character) => _wrap('insert', () async {
+    final db = await _dbHelper.database;
+    return await db.insert('movie_characters', character.toJson());
+  });
+
+  /// 更新角色
+  Future<int> update(MovieCharacter character) => _wrap('update', () async {
+    final db = await _dbHelper.database;
+    return await db.update(
+      'movie_characters',
+      character.toJson(),
+      where: 'id = ?',
+      whereArgs: [character.id],
+    );
+  });
+
+  /// 软删除角色
+  Future<int> delete(String id) => _wrap('delete', () async {
+    final db = await _dbHelper.database;
+    return await db.update(
+      'movie_characters',
+      {'is_deleted': 1, 'updated_at': DateTime.now().toUtc().toIso8601String()},
+      where: 'id = ?',
+      whereArgs: [id],
+    );
+  });
+
+  /// 获取影视的角色数量
+  Future<int> getCount(String movieId) => _wrap('getCount', () async {
+    final db = await _dbHelper.database;
+    final result = await db.rawQuery(
+      'SELECT COUNT(*) as count FROM movie_characters WHERE movie_id = ? AND is_deleted = 0',
+      [movieId],
+    );
+    return result.first['count'] as int? ?? 0;
+  });
+
+  /// 彻底删除角色
+  Future<void> permanentDelete(String id) => _wrap('permanentDelete', () async {
+    final db = await _dbHelper.database;
+    await db.delete('movie_characters', where: 'id = ?', whereArgs: [id]);
+  });
+}

lib/data/database_helper.dart

@@ -81,7 +81,7 @@ class DatabaseHelper {
 
     return await openDatabase(
       path,
-      version: 39,
+      version: 40,
       onCreate: _createDB,
       onUpgrade: _onUpgrade,
     );
@@ -405,6 +405,14 @@ class DatabaseHelper {
       // 创建人物表和关联表
       await _createPeopleTables(db);
     }
+    if (oldVersion < 40) {
+      // 创建角色表
+      await _createCharacterTables(db);
+      // 早期 v40 迭代可能已建表但缺列，补齐缺失列
+      await _ensureCharacterColumns(db, 'movie_characters');
+      await _ensureCharacterColumns(db, 'book_characters');
+      await _ensureCharacterColumns(db, 'game_characters');
+    }
   }
   Future<void> _upgradeBooksTableV26(Database db) async {
     final columns = await db.rawQuery('PRAGMA table_info(books)');
@@ -1040,6 +1048,8 @@ class DatabaseHelper {
 
     // 人物表
     await _createPeopleTables(db);
+    // 角色表
+    await _createCharacterTables(db);
   }
 
   /// 创建人物表和关联表
@@ -1107,6 +1117,85 @@ class DatabaseHelper {
     await db.execute('CREATE INDEX IF NOT EXISTS idx_game_people_person ON game_people(person_id)');
   }
 
+  /// 创建角色表（影视/书籍/游戏）
+  Future<void> _createCharacterTables(Database db) async {
+    await db.execute('''
+      CREATE TABLE IF NOT EXISTS movie_characters (
+        id TEXT PRIMARY KEY,
+        movie_id TEXT NOT NULL,
+        name TEXT NOT NULL,
+        role TEXT,
+        aliases TEXT DEFAULT '[]',
+        tags TEXT DEFAULT '[]',
+        description TEXT,
+        image_path TEXT,
+        sort_order INTEGER DEFAULT 0,
+        is_deleted INTEGER DEFAULT 0,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      )
+    ''');
+    await db.execute('CREATE INDEX IF NOT EXISTS idx_movie_characters_movie ON movie_characters(movie_id)');
+
+    await db.execute('''
+      CREATE TABLE IF NOT EXISTS book_characters (
+        id TEXT PRIMARY KEY,
+        book_id TEXT NOT NULL,
+        name TEXT NOT NULL,
+        role TEXT,
+        aliases TEXT DEFAULT '[]',
+        tags TEXT DEFAULT '[]',
+        description TEXT,
+        image_path TEXT,
+        sort_order INTEGER DEFAULT 0,
+        is_deleted INTEGER DEFAULT 0,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      )
+    ''');
+    await db.execute('CREATE INDEX IF NOT EXISTS idx_book_characters_book ON book_characters(book_id)');
+
+    await db.execute('''
+      CREATE TABLE IF NOT EXISTS game_characters (
+        id TEXT PRIMARY KEY,
+        game_id TEXT NOT NULL,
+        name TEXT NOT NULL,
+        role TEXT,
+        aliases TEXT DEFAULT '[]',
+        tags TEXT DEFAULT '[]',
+        description TEXT,
+        image_path TEXT,
+        sort_order INTEGER DEFAULT 0,
+        is_deleted INTEGER DEFAULT 0,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      )
+    ''');
+    await db.execute('CREATE INDEX IF NOT EXISTS idx_game_characters_game ON game_characters(game_id)');
+  }
+
+  /// 补齐角色表缺失的列（早期 v40 迭代建表时可能未包含）
+  Future<void> _ensureCharacterColumns(Database db, String table) async {
+    final columns = await db.rawQuery('PRAGMA table_info($table)');
+    final names = columns.map((c) => c['name'] as String).toSet();
+    const additions = <String, String>{
+      'role': 'TEXT',
+      'aliases': "TEXT DEFAULT '[]'",
+      'tags': "TEXT DEFAULT '[]'",
+      'description': 'TEXT',
+      'image_path': 'TEXT',
+      'sort_order': 'INTEGER DEFAULT 0',
+      'is_deleted': 'INTEGER DEFAULT 0',
+      'created_at': "TEXT DEFAULT ''",
+      'updated_at': "TEXT DEFAULT ''",
+    };
+    for (final entry in additions.entries) {
+      if (!names.contains(entry.key)) {
+        await db.execute('ALTER TABLE $table ADD COLUMN ${entry.key} ${entry.value}');
+      }
+    }
+  }
+
   // 关闭数据库
   Future close() async {
     if (_database != null) {