ItemManagerWebsite

爱特工作室管理系统

爱特工作室管理系统是中国海洋大学爱特工作室开发的一个用于管理物品和财务的系统。该系统旨在帮助工作室更高效地管理物品库存和财务记录。遵循MIT协议开源，允许自由、合法地使用。

注：以下安装教程使用环境均为 Debian12 (应该也不会有人用 Windows 部署这个吧)

需要准备的软件包

使用系统的包管理器安装(如 apt, yum 等)

• git
• nodejs
• python3
• wget

前端

前端使用 Vue 框架开发，使用方法如下

安装

pnpm 包管理器安装：

wget -qO- https://get.pnpm.io/install.sh | sh -

pnpm install

启动服务

pnpm run serve

编译

pnpm run build

后端

后端使用 Django 框架开发，搭配 asgi + uvicorn + gunicorn 食用，运行src/backend/start.sh即可自动构建部署

若 venv 环境创建失败，请手动输入

apt install python3.x-venv # 其实就是安装 venv 包，x 是你的 python3 的小版本号

并且注意，在第一次启动前，需要在 src/backend/item_manager 中手动创建 secure.json 并将 SECRET_KEY 和 SMTP 填入，否则无法启动

注意

• 如果需要使用 MySQL/MariaDB 作为数据库，请在 src/backend/item_manager/settings.py 中修改数据库配置，并且填写 secure.json 中的数据库信息
• 如果需要自定义登录背景图，请修改源代码，src/frontend/src/views/Login.vue 中的 backgroundImage 字段，并将背景图放到 src/frontend/public/_images/ 目录下
• 如果出现 MYSQL 软件包安装问题，尝试输入以下指令 apt-get install python3-dev default-libmysqlclient-dev build-essential pkg-config
• 创建一些默认的部门和财务类别，可以输入 python manage.py init_finance_data
• 创建一些默认的物品类别，可以输入 python manage.py create_default_categories