Skip to content

About

No description, website, or topics provided.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

26 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

BUAA_2025_Database(高校教学管理系统)

本仓库包含:

  • 后端:Flask + SQLAlchemy(除迁移/DDL 外,业务读写均使用原始 SQL)
  • 前端:Vue 3 + Vite + TS + Vue Router + Pinia + Axios + Element Plus
  • 设计/验收文档与脚本:位于 design/

目录:

  • code/backend:后端源码(Flask 蓝图、迁移、模型定义)
  • code/frontend:前端源码
  • code/run.py:后端启动入口

1. 环境配置

1.1 创建并激活环境

  • 启动一个 Anaconda PowerShell Prompt 的终端,或者在全局有配置 conda 环境变量的情况下直接打开一个 PowerShell 终端,输入以下指令。如果遇到网络加载问题,可以先转到步骤 1.2,如果已经配置过镜像源,请直接转到步骤 1.3
conda create -n buaa_db_proj python=3.10 -y # 新建虚拟环境并指定对应 python 版本
conda activate buaa_db_proj  # 在该终端中激活虚拟环境 
python --version # 检查虚拟环境中的 python 版本是否设置正确

1.2(可选)临时配置镜像源(加速)

  • 在启动的终端中输入以下指令配置镜像源(建议不使用)

Conda(清华镜像):

conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
conda config --set show_channel_urls yes

Pip(清华镜像):

python -m pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
python -m pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn

1.3 安装依赖(Python + Node)

  • 在启动的终端中继续输入以下指令,安装运行依赖

后端 Python 依赖:

python -m pip install -U pip
python -m pip install Flask Flask-SQLAlchemy Flask-Migrate PyMySQL python-dotenv

前端 Node/npm:

conda install -c conda-forge nodejs=20 -y
node -v # 安装成功会显示版本信息
npm -v # 安装成功会显示版本信息
conda install -c conda-forge mysql -y
where mysql # 安装成功会显示路径
mysql --version # 安装成功会显示版本信息

2. 后端启动与迁移

2.1 配置后端 .env

在 code/backend/.env 创建并填写(示例):

DB_HOST=the_host
DB_PORT=the_port
DB_NAME=buaa_db
DB_USER=root 
DB_PASS=xxxx

SECRET_KEY=dev-secret-change-me
TOKEN_EXPIRES_SECONDS=86400

其中的 DB_PASS 等环境变量应该被手动设置。

2.2 迁移初始化与升级

  • 在启动的终端中继续输入以下指令
cd code/backend
$env:FLASK_APP = "manage.py"

# 若首次没有 migrations 目录才需要 init
# flask db init

flask db upgrade

2.3 创建教务账号(ADMIN)

  • 在启动的终端中继续输入以下指令
flask create-user --username admin --password xxx --role ADMIN # username 建议为 admin,password 可以自己简单设置

2.4 运行后端服务

  • 在启动的终端中继续输入以下指令,输入完该终端置于后台

项目根目录:

cd d:\Python_projects\BUAA_2025_Database # 换成你的项目根目录路径
python .\code\run.py

默认后端地址:http://127.0.0.1:5000

  • 新开一个步骤 1.1 中说明的终端,在该终端中输入以下指令,在该会话进入我们的虚拟环境,并来到项目的根目录下
conda activate buaa_db_proj
cd d:\Python_projects\BUAA_2025_Database # 换成你的项目根目录路径

3. 前端启动

3.1 安装依赖

  • 在新开的终端中继续输入以下指令
cd code/frontend
npm install

3.2 启动 dev

  • 在新开的终端中继续输入以下指令,之后该终端也置于后台运行
npm run dev

浏览器打开:Vite 输出的地址(通常是 http://127.0.0.1:5173)。


4. 测试数据库功能

  • 再新开一个步骤 1.1 中说明的终端,在该终端中输入以下指令,数据库会自动导入示例数据。接下来,你可以用教务账号在用户管理界面对用户信息进行编辑,赋予其账号密码,并在其他浏览器会话中使用设置的(账户/邮箱 + 密码)尝试登录。
cd d:\Python_projects\BUAA_2025_Database
conda activate buaa_db_proj

python .\design\seed_data.py --scale M --reset # 导入示例数据
  • 由于浏览器的Cookie共享机制,浏览器为每个网站(域名+端口)存储Cookie,且同一浏览器的所有标签页和窗口共享相同的Cookie。而当您登录一个账号时,服务器会设置一个会话Cookie,这导致在同一个浏览器中登录第二个账号时,会覆盖前一个账号的Cookie。

  • 所以,为了同时操作 4 种账号(教务、院系、老师、学生),我们这里需要用到两个浏览器,分别打开无痕与非无痕标签页,共 4 个不共享 Cookie 的会话。

  • 如果想要停止运行服务器,将全部打开的终端直接关掉即可。


5. 环境清理

  • 启动一个 Anaconda PowerShell Prompt 的终端,或者在全局有配置 conda 环境变量的情况下直接打开一个 PowerShell 终端,依次输入以下指令即可,如要保留镜像源设置则不需要执行。

删除环境:

conda env remove -n buaa_db_proj

恢复 conda 源(按你实际添加的 channels 逐条 remove):

conda config --remove channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/
conda config --remove channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/

恢复 pip 源:

python -m pip config unset global.index-url
python -m pip config unset global.trusted-host

About

No description, website, or topics provided.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages