cattleTransportation/tradeCattle/DATABASE_MIGRATION_README.md

数据库迁移：添加身份证字段

概述

为 member_driver 表添加 id_card 字段，用于存储司机身份证前后面照片的URL地址。

字段信息

• 字段名: id_card
• 数据类型: TEXT
• 允许空值: YES
• 默认值: NULL
• 注释: 身份证前后面照片地址（多个URL用逗号分隔）
• 位置: 在 car_img 字段之后

执行步骤

方法1：使用 MySQL 命令行

# 连接到数据库
mysql -h 129.211.213.226 -P 3306 -u root -p cattletrade

# 执行 SQL 脚本
source /path/to/add_id_card_field.sql

方法2：使用 MySQL Workbench 或其他数据库管理工具

1. 连接到数据库服务器：129.211.213.226:3306
2. 选择数据库：cattletrade
3. 执行 add_id_card_field.sql 文件中的 SQL 语句

方法3：直接在应用服务器上执行

# 在服务器上执行
mysql -h 129.211.213.226 -P 3306 -u root -p cattletrade < add_id_card_field.sql

验证

执行完成后，可以通过以下 SQL 验证字段是否添加成功：

-- 查看字段信息
SELECT COLUMN_NAME, DATA_TYPE, IS_NULLABLE, COLUMN_DEFAULT, COLUMN_COMMENT 
FROM INFORMATION_SCHEMA.COLUMNS 
WHERE TABLE_SCHEMA = 'cattletrade' 
  AND TABLE_NAME = 'member_driver' 
  AND COLUMN_NAME = 'id_card';

-- 查看完整表结构
DESCRIBE member_driver;

注意事项

1. 执行前请备份数据库
2. 确保有足够的数据库权限
3. 建议在维护时间窗口执行
4. 执行后重启应用服务以确保更改生效

相关代码更改

此数据库更改配合以下代码更改：

• ✅ 后端 Mapper 层已更新，支持 id_card 字段的增删改查
• ✅ 后端 Controller 层已更新，处理 idCard 参数
• ✅ 前端表单已添加身份证图片上传组件
• ✅ 前端详情页面已添加身份证图片显示组件

回滚方案

如果需要回滚，可以执行：

ALTER TABLE member_driver DROP COLUMN id_card;