# 数据库初始化脚本说明

## 📋 概述

本目录包含数据库初始化脚本，用于Docker容器首次启动时自动初始化数据库。

**基于**: `schoolNewsServ/.bin/mysql/sql/reInit.sh` 的实现逻辑

## 📂 脚本文件

| 文件 | 说明 | 状态 |
|------|------|------|
| `01-init-database.sql` | 创建数据库和初始化标记表 | ✅ 已就绪 |
| `02-create-tables.sql` | 创建所有业务表（50+张） | ⚠️ 需准备 |
| `03-init-data.sql` | 导入初始数据（用户、菜单等） | ⚠️ 需准备 |
| `prepare-sql.sh` | 自动准备脚本 | ✅ 已就绪 |
| `数据库初始化指南.md` | 详细说明文档 | ✅ 已就绪 |

## 🚀 快速开始

### 方式1: 使用自动脚本（推荐）

```bash
cd docker/init-db
chmod +x prepare-sql.sh
./prepare-sql.sh
```

脚本会自动：
1. ✅ 从 `schoolNewsServ/.bin/mysql/sql/` 读取所有SQL文件
2. ✅ 合并所有 `createTable*.sql` 到 `02-create-tables.sql`
3. ✅ 合并所有 `init*.sql` 到 `03-init-data.sql`
4. ✅ 添加Docker环境特定配置（爬虫路径等）
5. ✅ 生成统计信息

### 方式2: 手动准备

参见 [数据库初始化指南.md](数据库初始化指南.md)

## 📊 脚本执行顺序

MySQL容器会按照文件名的字母顺序自动执行此目录下的`.sql`文件：

```
容器启动
   ↓
01-init-database.sql
   ├─ 创建数据库 school_news
   └─ 创建初始化标记表 _db_init_status
   ↓
02-create-tables.sql
   ├─ 创建用户模块表（3+张）
   ├─ 创建权限模块表（10+张）
   ├─ 创建资源模块表（5+张）
   ├─ 创建学习模块表（8+张）
   ├─ 创建AI模块表（5+张）
   ├─ 创建系统模块表（5+张）
   ├─ 创建成就模块表（5+张）
   ├─ 创建定时任务模块表（3+张）
   ├─ 创建消息模块表（3+张）
   └─ 创建敏感词模块表（1+张）
   ↓
03-init-data.sql
   ├─ 导入菜单和权限数据
   ├─ 导入默认用户和角色
   ├─ 导入系统配置
   └─ 导入Docker环境配置（爬虫路径）
   ↓
数据库就绪 ✓
```

## 🎯 初始化特性

### 幂等性设计

所有脚本支持重复执行，不会导致错误：

```sql
-- 表创建使用IF NOT EXISTS
CREATE TABLE IF NOT EXISTS tb_user (...);

-- 数据插入使用INSERT IGNORE
INSERT IGNORE INTO tb_sys_config VALUES (...);

-- 使用_db_init_status表跟踪执行状态
INSERT IGNORE INTO _db_init_status (script_name) VALUES ('02-create-tables.sql');
```

### 避免重复初始化

系统使用 `_db_init_status` 表来跟踪已执行的脚本：

```bash
# 查看已执行的脚本
docker exec school-news-mysql mysql -uroot -p123456 school_news -e \
"SELECT * FROM _db_init_status ORDER BY executed_at;"
```

## 🗄️ 数据库结构

### 模块组成

| 模块 | 表数量 | 说明 |
|------|--------|------|
| 用户管理 | 3+ | 用户、部门、角色 |
| 权限管理 | 10+ | 菜单、权限、角色权限映射 |
| 资源管理 | 5+ | 资源、标签、分类、评论 |
| 课程管理 | 3+ | 课程、章节、课件 |
| 学习管理 | 5+ | 学习记录、笔记、错题 |
| 个人中心 | 3+ | 收藏、历史、个人信息 |
| AI智能体 | 5+ | AI对话、知识库 |
| 系统配置 | 5+ | 配置、日志、文件管理 |
| 成就系统 | 5+ | 成就、徽章、等级 |
| 定时任务 | 3+ | 任务、执行记录、元数据 |
| 消息通知 | 3+ | 消息、通知、模板 |
| 敏感词 | 1+ | 敏感词过滤 |

**总计**: 50+ 张表

### 默认数据

#### 默认用户
- **用户名**: admin
- **密码**: admin123
- **角色**: 管理员（拥有所有权限）

#### 系统配置
- `crawler.pythonPath`: /usr/bin/python3
- `crawler.basePath`: /app/crawler

## 🔄 重新初始化

### 完全重新初始化（会删除所有数据）

```bash
# 停止并删除容器和数据卷
cd docker
docker-compose down -v

# 重新启动
docker-compose up -d
```

### 只重置初始化标记

```bash
# 清空标记表，下次重启时重新执行脚本
docker exec school-news-mysql mysql -uroot -p123456 -e \
"TRUNCATE TABLE school_news._db_init_status;"

# 重启MySQL容器
docker-compose restart mysql
```

## 🧪 验证初始化

### 1. 查看初始化日志

```bash
docker logs school-news-mysql 2>&1 | grep -i "init\|sql"
```

### 2. 检查数据库和表

```bash
# 检查数据库
docker exec school-news-mysql mysql -uroot -p123456 -e "SHOW DATABASES;"

# 检查表数量
docker exec school-news-mysql mysql -uroot -p123456 school_news -e \
"SELECT COUNT(*) AS table_count FROM information_schema.tables WHERE table_schema='school_news';"

# 查看所有表
docker exec school-news-mysql mysql -uroot -p123456 school_news -e "SHOW TABLES;"
```

### 3. 验证默认数据

```bash
# 检查默认用户
docker exec school-news-mysql mysql -uroot -p123456 school_news -e \
"SELECT username, nickname, status FROM tb_sys_user WHERE username='admin';"

# 检查系统配置
docker exec school-news-mysql mysql -uroot -p123456 school_news -e \
"SELECT config_key, config_value FROM tb_sys_config WHERE config_key LIKE 'crawler.%';"

# 检查菜单数量
docker exec school-news-mysql mysql -uroot -p123456 school_news -e \
"SELECT COUNT(*) AS menu_count FROM tb_sys_menu;"
```

### 4. 检查初始化状态

```bash
docker exec school-news-mysql mysql -uroot -p123456 school_news -e \
"SELECT script_name, executed_at, status FROM _db_init_status ORDER BY executed_at;"
```

## ⚠️ 注意事项

### 1. SOURCE语句不支持

Docker的mysql镜像**不支持** `SOURCE` 语句，需要将所有SQL合并到一个文件：

```sql
-- ❌ 不支持
SOURCE createTableUser.sql;

-- ✅ 需要合并
-- 将createTableUser.sql的内容直接复制过来
CREATE TABLE tb_user (...);
```

### 2. 文件执行顺序

文件按字母顺序执行，命名规范：

```
01-xxx.sql  (最先执行)
02-xxx.sql  (其次执行)
03-xxx.sql  (最后执行)
04-xxx.sql  (可选：迁移脚本)
```

### 3. 字符集配置

确保使用UTF8MB4字符集：

```sql
CREATE TABLE tb_xxx (
    ...
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
```

### 4. 安全性

生产环境必须：
- ✅ 修改默认密码
- ✅ 使用强密码策略
- ✅ 限制数据库访问权限
- ✅ 定期备份数据

## 🗂️ 数据持久化

数据库数据持久化在Docker数据卷中：

```yaml
volumes:
  mysql-data:
    driver: local
```

### 查看和管理数据卷

```bash
# 查看所有数据卷
docker volume ls

# 查看数据卷详情
docker volume inspect docker_mysql-data

# 备份数据卷
docker run --rm -v docker_mysql-data:/data -v $(pwd):/backup \
  alpine tar czf /backup/mysql-backup.tar.gz /data

# 恢复数据卷
docker run --rm -v docker_mysql-data:/data -v $(pwd):/backup \
  alpine tar xzf /backup/mysql-backup.tar.gz -C /
```

## 🐛 故障排查

### 问题1: 脚本未执行

**症状**: 数据库创建了但没有表

**排查**:
```bash
# 查看MySQL日志
docker logs school-news-mysql

# 检查SQL文件
ls -l docker/init-db/*.sql
```

**解决**: 
- 确保SQL文件有读权限
- 检查SQL语法是否正确

### 问题2: 初始化失败

**症状**: 容器启动失败或反复重启

**排查**:
```bash
# 查看错误日志
docker logs school-news-mysql 2>&1 | grep -i error

# 进入容器检查
docker exec -it school-news-mysql bash
```

**解决**:
- 检查SQL语法错误
- 确保表之间的依赖关系正确
- 验证数据格式是否正确

### 问题3: 重复执行导致错误

**解决**: 使用幂等性设计
- 使用 `CREATE TABLE IF NOT EXISTS`
- 使用 `INSERT IGNORE`
- 使用 `_db_init_status` 表跟踪

## 📚 相关文档

- [数据库初始化指南](数据库初始化指南.md) - 详细的准备和使用说明
- [reInit.sh](../../schoolNewsServ/.bin/mysql/sql/reInit.sh) - 原始初始化脚本
- [Docker README](../README.md) - Docker部署文档

## 💡 最佳实践

1. ✅ **自动化** - 使用 `prepare-sql.sh` 自动准备SQL文件
2. ✅ **幂等性** - 确保脚本可以重复执行
3. ✅ **版本控制** - SQL文件纳入Git管理（注意敏感信息）
4. ✅ **文档同步** - 表结构变更同步更新SQL文件
5. ✅ **定期备份** - 重要数据定期备份
6. ✅ **测试验证** - 在测试环境充分验证后再部署生产

---

**更新时间**: 2025-11-24  
**基于**: schoolNewsServ/.bin/mysql/sql/reInit.sh v1.1.0