# medu_db

**Repository Path**: beijing_jane_harvest_javaandroidc/medu_db

## Basic Information

- **Project Name**: medu_db
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-10
- **Last Updated**: 2026-08-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 中医药智慧教育传承平台 - 数据库脚本

## 项目简介

本仓库为中医药智慧教育传承平台的数据库脚本中心，统一维护全平台的数据库建表脚本（DDL）、初始化数据脚本（DML）、版本迁移脚本以及 DBA 运维脚本，供后端服务、BI 数据看板、测试环境与生产环境统一引用，确保多环境数据库结构的一致性与可追溯性。

## 数据库信息

| 项目 | 说明 |
|------|------|
| 数据库 | MySQL 8.0+ |
| 字符集 | utf8mb4 |
| 排序规则 | utf8mb4_unicode_ci |
| 主键策略 | BIGINT UNSIGNED（雪花算法） |
| 软删除 | deleted_at 字段标记 |
| 扩展字段 | ext（JSON）预留业务扩展 |

## 业务模块概览

数据库按六大业务模块拆分数据表，合计 35 张核心业务表：

| 模块 | 说明 | 核心表数量 |
|------|------|-----------|
| M1 用户权限 | 用户、角色、权限、组织架构 | 6 |
| M2 课程资源 | 课程、章节、主题专区、讲师、传承资料、学术传承 | 10 |
| M3 直播业务 | 直播间、直播记录、直播聊天 | 3 |
| M4 工作室管理 | 工作室、成员、学员名额、传承资料归属 | 5 |
| M5 学习记录 | 学习进度、考核、积分、证书、调查问卷 | 7 |
| M6 消息通知 | 系统公告、消息中心、通知模板 | 4 |

## 目录结构

```
medu_db/
├── README.md                  # 本文件
├── .gitignore
├── .cursorrules              # AI 编码规范
├── ddl/                       # 建表脚本（按模块拆分）
│   ├── m1_user_permission.sql # 用户权限模块（6张表）
│   ├── m2_course.sql          # 课程资源模块（10张表）
│   ├── m3_live.sql            # 直播业务模块（3张表）
│   ├── m4_studio.sql          # 工作室管理模块（5张表）
│   ├── m5_study.sql           # 学习记录模块（7张表）
│   └── m6_message.sql         # 消息通知模块（4张表）
├── dml/                       # 初始化数据脚本
│   ├── init_roles.sql         # 预置角色（5个）
│   ├── init_admin.sql         # 超级管理员账号
│   ├── init_permissions.sql   # 权限项与菜单（80+权限点）
│   └── init_dict.sql          # 字典与配置数据
├── migrations/                # 版本迁移脚本
│   └── V20260812__init_schema.sql
└── ops/                       # DBA 运维脚本
    ├── backup.sh              # 数据库备份脚本
    ├── health_check.sh        # 健康检查脚本
    └── monitor.sql            # 监控查询（慢SQL/连接数）
```

## 快速开始

### 1. 创建数据库

```bash
mysql -uroot -p -e "CREATE DATABASE tcm_education DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_unicode_ci;"
```

### 2. 导入表结构（按模块顺序执行）

```bash
# M1 用户权限模块（6张表）
mysql -uroot -p tcm_education < ddl/m1_user_permission.sql

# M2 课程资源模块（10张表）
mysql -uroot -p tcm_education < ddl/m2_course.sql

# M3 直播业务模块（3张表）
mysql -uroot -p tcm_education < ddl/m3_live.sql

# M4 工作室管理模块（5张表）
mysql -uroot -p tcm_education < ddl/m4_studio.sql

# M5 学习记录模块（7张表）
mysql -uroot -p tcm_education < ddl/m5_study.sql

# M6 消息通知模块（4张表）
mysql -uroot -p tcm_education < ddl/m6_message.sql
```

### 3. 导入初始化数据

```bash
mysql -uroot -p tcm_education < dml/init_roles.sql
mysql -uroot -p tcm_education < dml/init_admin.sql
mysql -uroot -p tcm_education < dml/init_permissions.sql
mysql -uroot -p tcm_education < dml/init_dict.sql
```

### 4. 默认管理员账号

| 用户名 | 密码 | 角色 |
|--------|------|------|
| admin | admin123 | 超级管理员 |

> 首次登录后请强制修改密码！

## 设计规范

- **通用字段**：所有业务表统一包含 `id`、`created_at`、`updated_at`、`deleted_at`、`ext` 字段
- **命名规范**：表名小写蛇形（snake_case），模块前缀（如 `sys_`、`course_`、`live_`）
- **主键策略**：BIGINT UNSIGNED，雪花算法生成，避免自增 ID 暴露业务量
- **软删除**：使用 `deleted_at` 字段标记，NULL 表示未删除
- **索引规范**：唯一索引 `uk_`、普通索引 `idx_`、联合索引按区分度排序
- **预留扩展**：`ext` 字段使用 JSON 类型，支持业务扩展无需变更表结构

详细设计参见 [medu_prompt/database-design.md](https://gitee.com/beijing_jane_harvest_javaandroidc/medu_prompt)。

## DBA 运维

### 数据库备份

```bash
# 设置环境变量
export DB_HOST=localhost
export DB_PORT=3306
export DB_USER=root
export DB_PASS=your_password
export DB_NAME=tcm_education
export BACKUP_DIR=./backup

# 执行备份
./ops/backup.sh
```

### 健康检查

```bash
DB_PASS=your_password ./ops/health_check.sh
```

## 相关仓库

| 仓库 | 说明 | Gitee 地址 |
|------|------|-----------|
| medu_backend | 后端服务（Spring Boot 3） | https://gitee.com/beijing_jane_harvest_javaandroidc/medu_backend |
| medu_frontend_website | 学员端前端 | https://gitee.com/beijing_jane_harvest_javaandroidc/medu_frontend_website |
| medu_admin_frontend | 管理后台前端 | https://gitee.com/beijing_jane_harvest_javaandroidc/medu_admin_frontend |
| medu_studio_frontend | 工作室端前端 | https://gitee.com/beijing_jane_harvest_javaandroidc/medu_studio_frontend |
| medu_bi | 数据看板前端 | https://gitee.com/beijing_jane_harvest_javaandroidc/medu_bi |
| medu_AI | AI 智能问答服务（Python + LangChain + Milvus） | https://gitee.com/beijing_jane_harvest_javaandroidc/medu_AI |
| medu_prompt | 项目文档（接口规范、数据库设计、开发规范、部署文档） | https://gitee.com/beijing_jane_harvest_javaandroidc/medu_prompt |
| medu_db | 数据库脚本 | https://gitee.com/beijing_jane_harvest_javaandroidc/medu_db |