Skip to content

Latest commit

 

History

History
281 lines (248 loc) · 8.9 KB

database.md

File metadata and controls

281 lines (248 loc) · 8.9 KB

OpenCourse 数据库表设计文档

本文档为 OpenCourse 团队数据库表设计文档，主要记录数据库表的定义和说明信息，用于开发时参考使用

Department

院系信息表，存储院系相关信息

create table `Department` if not exists (
    `id` tinyint auto_increment primary key,
    `name` varchar(31) not null unique
) engine=InnoDB default charset=utf8mb4 collate=utf8mb4_unicode_ci;
字段 含义
id 院系 ID
name 院系名称

Course

课程信息表，存储课程相关信息

create table `Course` if not exists (
    `id` smallint primary key auto_increment,
    `name` varchar(31) not null,
    `code` varchar(31) unique not null,
    `department_id` tinyint not null,
    `course_type` enum(
        'GENERAL_REQUIRED',
        'GENERAL_OPTIONAL',
        'MAJOR_REQUIRED',
        'MAJOR_OPTIONAL'
    ) not null,
    `credits` decimal(3, 1) not null,
    foreign key (`department_id`) references `Department`(`id`)
) engine=InnoDB default charset=utf8mb4 collate=utf8mb4_unicode_ci;
字段 含义
id 课程 ID
name 课程名称
code 课程代码
department_id 所属院系 ID
course_type 课程类型
credits 学分

User

用户信息表，存储用户相关信息

create table `User` if not exists (
    `id` int auto_increment primary key,
    `name` varchar(31) not null unique,
    `email` varchar(63) not null unique,
    `password` varchar(255) not null,
    `role` enum('user', 'visitor', 'admin') not null,
    `activity` int default 1,
    `created_at` timestamp default current_timestamp,
    `updated_at` timestamp default null on update current_timestamp
) engine=InnoDB default charset=utf8mb4 collate=utf8mb4_unicode_ci;
字段 含义
id 用户 ID
name 用户名称
email 用户邮箱
password 用户密码
role 用户权限
activity 用户活跃度
created_at 创建时间
updated_at 更新时间

Resource

资源信息表，存储资源相关信息

create table `Resource` if not exists (
    /* Basic Information */
    `id` int auto_increment primary key,
    `name` varchar(63) not null,
    `description` varchar(255) default null,
    `resourse_type` enum(
        'EXAM',
        'ASSIGNMENT',
        'NOTE',
        'TEXTBOOK',
        'SLIDES',
        'OTHER'
    ) not null,
    /* File Metadata */
    `file_type` enum('pdf', 'text', 'other') not null,
    `file_size` decimal(3, 2) not null,
    `file_path` varchar(255) not null,
    /* Time Metadata */
    `created_at` timestamp default current_timestamp,
    /* Relevant Information */
    `course_id` smallint not null,
    `user_id` int not null,
    /* Statistics */
    `views` int default 0,
    `likes` int default 0,
    `dislikes` int default 0,
    /* Foreign Keys */
    foreign key (`course_id`) references `Course`(`id`),
    foreign key (`user_id`) references `User`(`id`)
) engine=InnoDB default charset=utf8mb4 collate=utf8mb4_unicode_ci;
字段 含义
id 资源 ID
name 资源名称
description 资源描述
resourse_type 资源类型
file_type 文件类型
file_size 文件大小
file_path 文件路径
created_at 创建时间
course_id 所属课程 ID
user_id 上传用户 ID
views 浏览次数
likes 点赞数
dislikes 点踩数

Interaction

互动系统表，存储互动评论区信息

create table `Interaction` if not exists (
    /* Basic Information */
    `id` int primary key auto_increment,
    `course_id` smallint not null,
    `user_id` int not null,
    `content` text default null,
    `rating` tinyint default null,
    /* Statistics */
    `likes` int default 0,
    `dislikes` int default 0,
    /* Time Metadata */
    `created_at` datetime default current_timestamp,
    foreign key (`course_id`) references `Course`(`id`),
    foreign key (`user_id`) references `User`(`id`)
) engine=InnoDB default charset=utf8mb4 collate=utf8mb4_unicode_ci;
字段 含义
id 评论 ID
course_id 所属课程 ID
user_id 评论者用户 ID
content 评论内容
rating 对课程评分
likes 被点赞数
dislikes 被点踩数
created_at 发表时间

History

历史记录表，存储用户视角下的重要操作记录

create table `History` if not exists (
    `id` bigint auto_increment primary key,
    `user_id` int not null,
    `action_type` enum(
        'CREATE_COURSE',      -- 21
        'UPDATE_COURSE',      -- 22
        'DELETE_COURSE',      -- 23
        'CREATE_DEPARTMENT',  -- 24
        'UPDATE_DEPARTMENT',  -- 25
        'DELETE_DEPARTMENT',  -- 26
        'CREATE_RESOURCE',    -- 27
        'UPDATE_RESOURCE',    -- 28
        'DELETE_RESOURCE',    -- 29
        'LIKE_RESOURCE',      -- 30
        'UNLIKE_RESOURCE',    -- 31
        'VIEW_RESOURCE',      -- 32
        'CREATE_INTERACTION', -- 33
        'UPDATE_INTERACTION', -- 34
        'DELETE_INTERACTION', -- 35
        'LIKE_INTERACTION',   -- 36
        'UNLIKE_INTERACTION', -- 37
        'RATE_COURSE',        -- 38
        'CREATE_USER',        -- 39
        'UPDATE_USER',        -- 40
        'DELETE_USER'         -- 41
    ) not null,
    `object_id` int default null,
    `timestamp` timestamp default current_timestamp,
    foreign key (`user_id`) references `User`(`id`)
) engine=InnoDB default charset=utf8mb4 collate=utf8mb4_unicode_ci;
字段 含义
id 历史记录 ID
user_id 用户 ID
action_type 操作类型
object_id 操作对象 ID
timestamp 操作时间戳

E-R Graph

erDiagram
    Department {
        tinyint id PK "院系ID"
        varchar name UK "院系名称"
    }
    
    Course {
        smallint id PK "课程ID"
        varchar name "课程名称"
        varchar code UK "课程代码"
        tinyint department_id FK "所属院系ID"
        enum course_type "课程类型"
        decimal credits "学分"
    }
    
    User {
        int id PK "用户ID"
        varchar name UK "用户名"
        varchar email UK "用户邮箱"
        varchar password "用户密码"
        enum role "用户角色"
        int activity "用户活跃度"
        timestamp created_at "创建时间"
        timestamp updated_at "更新时间"
    }
    
    Resource {
        int id PK "资源ID"
        varchar name "资源名称"
        varchar description "资源描述"
        enum resourse_type "资源类型"
        enum file_type "文件类型"
        decimal file_size "文件大小"
        varchar file_path "文件路径"
        timestamp created_at "创建时间"
        smallint course_id FK "所属课程ID"
        int user_id FK "上传用户ID"
        int views "浏览次数"
        int likes "点赞数"
        int dislikes "点踩数"
    }
    
    Interaction {
        int id PK "评论ID"
        smallint course_id FK "所属课程ID"
        int user_id FK "评论者用户ID"
        text content "评论内容"
        tinyint rating "课程评分"
        int likes "被点赞数"
        int dislikes "被点踩数"
        datetime created_at "发表时间"
    }
    
    History {
        bigint id PK "历史记录ID"
        int user_id FK "用户ID"
        enum action_type "操作类型"
        int object_id "操作对象ID"
        timestamp timestamp "操作时间戳"
    }

    %% 关系定义
    Department ||--o{ Course : "一个院系有多个课程"
    Course ||--o{ Resource : "一个课程有多个资源"
    Course ||--o{ Interaction : "一个课程有多个评论"
    User ||--o{ Resource : "一个用户可以上传多个资源"
    User ||--o{ Interaction : "一个用户可以发表多个评论"
    User ||--o{ History : "一个用户有多个操作历史"
Loading