feat: 娣诲姞澶氫釜鏂板姛鑳藉拰淇 - 鍖呮嫭鐢ㄦ埛绠＄悊銆佹暟鎹簱杩佺Щ銆丟it鎺ㄩ€佸伐鍏风瓑

database_migration_notes.md

@@ -0,0 +1,119 @@
+# 数据库迁移说明
+
+## 工单处理过程记录系统迁移
+
+### 新增表：`work_order_process_history`
+
+```sql
+CREATE TABLE IF NOT EXISTS work_order_process_history (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    work_order_id INTEGER NOT NULL,
+    processor_name VARCHAR(100) NOT NULL,
+    processor_role VARCHAR(50),
+    processor_region VARCHAR(50),
+    process_content TEXT NOT NULL,
+    action_type VARCHAR(50) NOT NULL,
+    previous_status VARCHAR(50),
+    new_status VARCHAR(50),
+    assigned_module VARCHAR(50),
+    process_time DATETIME NOT NULL,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    FOREIGN KEY (work_order_id) REFERENCES work_orders(id)
+);
+
+CREATE INDEX idx_process_history_workorder ON work_order_process_history(work_order_id);
+CREATE INDEX idx_process_history_time ON work_order_process_history(process_time);
+```
+
+### WorkOrder表新增字段
+
+如果使用SQLite，可以使用以下SQL添加字段：
+
+```sql
+-- 注意：SQLite不支持直接ALTER TABLE添加多个列，需要逐个添加
+
+ALTER TABLE work_orders ADD COLUMN assigned_module VARCHAR(50);
+ALTER TABLE work_orders ADD COLUMN module_owner VARCHAR(100);
+ALTER TABLE work_orders ADD COLUMN dispatcher VARCHAR(100);
+ALTER TABLE work_orders ADD COLUMN dispatch_time DATETIME;
+ALTER TABLE work_orders ADD COLUMN region VARCHAR(50);
+```
+
+### 使用Python脚本迁移（推荐）
+
+创建迁移脚本 `migrate_process_history.py`：
+
+```python
+# -*- coding: utf-8 -*-
+"""
+数据库迁移脚本：添加工单处理过程记录表和相关字段
+"""
+from src.core.database import db_manager
+from src.core.models import Base, WorkOrderProcessHistory
+from sqlalchemy import text
+
+def migrate_database():
+    """执行数据库迁移"""
+    try:
+        with db_manager.get_session() as session:
+            # 创建新表
+            WorkOrderProcessHistory.__table__.create(db_manager.engine, checkfirst=True)
+
+            # 检查并添加新字段（SQLite需要特殊处理）
+            try:
+                # 尝试添加字段（如果已存在会报错，可以忽略）
+                session.execute(text("ALTER TABLE work_orders ADD COLUMN assigned_module VARCHAR(50)"))
+            except Exception as e:
+                print(f"字段 assigned_module 可能已存在: {e}")
+
+            try:
+                session.execute(text("ALTER TABLE work_orders ADD COLUMN module_owner VARCHAR(100)"))
+            except Exception as e:
+                print(f"字段 module_owner 可能已存在: {e}")
+
+            try:
+                session.execute(text("ALTER TABLE work_orders ADD COLUMN dispatcher VARCHAR(100)"))
+            except Exception as e:
+                print(f"字段 dispatcher 可能已存在: {e}")
+
+            try:
+                session.execute(text("ALTER TABLE work_orders ADD COLUMN dispatch_time DATETIME"))
+            except Exception as e:
+                print(f"字段 dispatch_time 可能已存在: {e}")
+
+            try:
+                session.execute(text("ALTER TABLE work_orders ADD COLUMN region VARCHAR(50)"))
+            except Exception as e:
+                print(f"字段 region 可能已存在: {e}")
+
+            session.commit()
+            print("数据库迁移完成！")
+
+    except Exception as e:
+        print(f"数据库迁移失败: {e}")
+        raise
+
+if __name__ == "__main__":
+    migrate_database()
+```
+
+### 执行迁移
+
+运行迁移脚本：
+```bash
+python migrate_process_history.py
+```
+
+或者直接在Python交互式环境中执行：
+```python
+from migrate_process_history import migrate_database
+migrate_database()
+```
+
+## 注意事项
+
+1. **备份数据库**：在执行迁移前，请务必备份现有数据库
+2. **SQLite限制**：如果使用SQLite，ALTER TABLE添加列的操作在某些情况下可能失败，如果字段已存在会报错
+3. **数据迁移**：现有工单的处理过程历史记录（存储在`resolution`字段中的）不会自动迁移到新表，需要手动处理
+4. **索引优化**：新表已包含必要的索引，如果数据量大可以考虑添加更多索引
+