chore: 增加数据库说明文档
This commit is contained in:
108
docs/db/README_INTEGRATION.md
Normal file
108
docs/db/README_INTEGRATION.md
Normal file
@@ -0,0 +1,108 @@
|
||||
# 数据库初始化脚本整合说明
|
||||
|
||||
## 🎯 任务完成概述
|
||||
|
||||
已成功将 `init_v2.0_full.sql` 中的基础配置数据整合到完整的 `init_v2.0.sql` 脚本中,创建了包含294个表结构 + 基础数据的完整初始化脚本。
|
||||
|
||||
## 📁 生成的文件
|
||||
|
||||
### 1. `init_v2.0_with_data.sql` ⭐ **推荐使用**
|
||||
- **完整内容**: 294个表结构 + 基础配置数据
|
||||
- **文件大小**: 约 1.2MB
|
||||
- **特点**:
|
||||
- 包含所有表结构定义
|
||||
- 集成核心插件数据
|
||||
- 包含省市区基础数据
|
||||
- 包含初始化验证脚本
|
||||
|
||||
### 2. 其他参考文件
|
||||
- `init_v2.0.sql` - 原始294个表结构(无数据)
|
||||
- `init_v2.0_full.sql` - 部分表结构 + 基础数据
|
||||
- `init_v2.0_complete.sql` - 核心表演示版本
|
||||
|
||||
## 🎯 整合的基础数据
|
||||
|
||||
### ✅ 已包含的核心数据
|
||||
|
||||
#### 1. 插件系统数据 (6个核心插件)
|
||||
```sql
|
||||
INSERT INTO lucky_addon VALUES
|
||||
(1,'fenxiao','tool',...), -- 分销插件
|
||||
(2,'memberconsume','system',...), -- 消费返利
|
||||
(3,'merch','tool',...), -- 多商户
|
||||
(4,'membercancel','tool',...), -- 会员注销
|
||||
(5,'cases','tool',...), -- 案例展示
|
||||
(6,'personnel','tool',...); -- 电子名片
|
||||
```
|
||||
|
||||
#### 2. 省级行政区数据 (34个省市)
|
||||
```sql
|
||||
INSERT INTO lucky_area VALUES
|
||||
(110000,0,'北京市','北京','116.40529','39.904987',1,0,1),
|
||||
(120000,0,'天津市','天津','117.190182','39.125596',1,0,1),
|
||||
...
|
||||
(820000,0,'澳门特别行政区','澳门','113.54909','22.198951',1,0,1);
|
||||
```
|
||||
|
||||
### 🚫 排除的数据(为安全考虑)
|
||||
- 会员个人信息
|
||||
- 订单交易数据
|
||||
- 支付敏感信息
|
||||
- 商品业务数据
|
||||
- 具体业务记录
|
||||
|
||||
## 🚀 使用方法
|
||||
|
||||
### 1. 创建数据库
|
||||
```sql
|
||||
CREATE DATABASE shop_v2 CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
|
||||
```
|
||||
|
||||
### 2. 导入脚本
|
||||
```bash
|
||||
mysql -u root -p shop_v2 < init_v2.0_with_data.sql
|
||||
```
|
||||
|
||||
### 3. 验证初始化结果
|
||||
执行脚本后会自动运行验证查询,显示:
|
||||
- 基础初始化完成消息
|
||||
- 插件数据数量
|
||||
- 省份数量
|
||||
- 总表数量
|
||||
|
||||
## 📊 脚本特性
|
||||
|
||||
### ✅ 安全特性
|
||||
- 禁用外键检查避免导入错误
|
||||
- 使用事务确保数据一致性
|
||||
- 设置合适的自增值起始点
|
||||
- 包含完整的字符集设置
|
||||
|
||||
### ✅ 数据完整性
|
||||
- 保留所有294个表结构
|
||||
- 集成必要的系统配置数据
|
||||
- 排除敏感业务信息
|
||||
- 支持生产环境快速部署
|
||||
|
||||
### ✅ 验证机制
|
||||
- 自动验证表创建数量
|
||||
- 检查基础数据导入状态
|
||||
- 提供清晰的完成反馈
|
||||
|
||||
## 🎉 优势总结
|
||||
|
||||
1. **一键部署**: 单个脚本完成完整初始化
|
||||
2. **数据安全**: 只包含必要的系统配置数据
|
||||
3. **生产就绪**: 基于真实生产环境备份生成
|
||||
4. **易于维护**: 清晰的注释和模块化结构
|
||||
5. **完整验证**: 内置验证确保导入成功
|
||||
|
||||
## 📞 技术支持
|
||||
|
||||
此脚本已通过完整测试,可直接用于:
|
||||
- ✅ 开发环境初始化
|
||||
- ✅ 测试环境部署
|
||||
- ✅ 生产环境快速恢复
|
||||
- ✅ Docker容器初始化
|
||||
|
||||
**注意**: 如需添加更多基础配置数据,请参考 `v2.0_mysql_data.sql` 生产备份文件进行选择性提取。
|
||||
Reference in New Issue
Block a user