本仓库包含:
- 后端:Flask + SQLAlchemy(除迁移/DDL 外,业务读写均使用原始 SQL)
- 前端:Vue 3 + Vite + TS + Vue Router + Pinia + Axios + Element Plus
- 设计/验收文档与脚本:位于
design/
目录:
code/backend:后端源码(Flask 蓝图、迁移、模型定义)code/frontend:前端源码code/run.py:后端启动入口
- 启动一个 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 版本是否设置正确- 在启动的终端中输入以下指令配置镜像源(建议不使用)
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 yesPip(清华镜像):
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- 在启动的终端中继续输入以下指令,安装运行依赖
后端 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 # 安装成功会显示版本信息在 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 等环境变量应该被手动设置。
- 在启动的终端中继续输入以下指令
cd code/backend
$env:FLASK_APP = "manage.py"
# 若首次没有 migrations 目录才需要 init
# flask db init
flask db upgrade- 在启动的终端中继续输入以下指令
flask create-user --username admin --password xxx --role ADMIN # username 建议为 admin,password 可以自己简单设置- 在启动的终端中继续输入以下指令,输入完该终端置于后台
项目根目录:
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 # 换成你的项目根目录路径- 在新开的终端中继续输入以下指令
cd code/frontend
npm install- 在新开的终端中继续输入以下指令,之后该终端也置于后台运行
npm run dev浏览器打开:Vite 输出的地址(通常是 http://127.0.0.1:5173)。
- 再新开一个步骤
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 的会话。
-
如果想要停止运行服务器,将全部打开的终端直接关掉即可。
- 启动一个 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