固定资产管理系统

这是一个前后端分离的固定资产管理系统，覆盖资产台账、借用归还、扫码出入库、挂载关系、维修、报废、统计分析和系统设置等功能。

技术栈

• 前端：Vue 3、Vite、TypeScript、Pinia、Vue Router、Tailwind CSS
• 后端：Express、TypeScript、Prisma、MySQL
• 部署：Docker Compose

目录结构

• frontend/：前端页面、组件、状态管理、接口封装
• backend/：后端路由、控制器、中间件、工具函数
• backend/prisma/schema.prisma：数据库模型
• deploy.sh：固定资产系统安全部署脚本
• scripts/backup-equipment.sh：固定资产系统备份脚本
• AGENTS.md：仓库协作与多代理分工说明
• BACKUP.md：备份与回滚说明

本地开发

分别安装依赖：

cd frontend && npm install
cd backend && npm install

常用命令：

cd frontend && npm run dev
cd frontend && npm run build
cd backend && npm run dev
cd backend && npm run build
cd backend && npm run prisma:generate
cd backend && npm run prisma:migrate

服务器部署

生产服务器上同时运行两套同类系统：

• 固定资产系统：/opt/equipment-management
• 摄影设备借还系统：/opt/shebeiguanli

两套系统使用不同的容器、端口、网络和数据卷。部署本项目时，只能操作固定资产系统这一套资源，不能影响 shebeiguanli-* 容器。

执行部署：

cd /opt/equipment-management
./deploy.sh

部署脚本默认会先备份，再重建固定资产系统容器，最后检查健康状态和另一套系统状态。

标准发布命令

在当前这台 Windows 开发机上，推荐直接使用：

$env:DEPLOY_PASSWORD="jsjj8888"
.\scripts\publish-to-server.ps1

这个脚本会自动完成：

• 打包当前仓库源码
• 上传到 /opt/equipment-management
• 只覆盖固定资产系统源码
• 调用服务器上的安全部署脚本

常用参数：

.\scripts\publish-to-server.ps1 -SkipDeploy
.\scripts\publish-to-server.ps1 -SkipBackup

• -SkipDeploy：只同步代码，不执行服务器部署
• -SkipBackup：执行部署，但跳过备份，不建议常用

备份与回滚

执行备份：

cd /opt/equipment-management
./scripts/backup-equipment.sh

默认只保留最近 3 份备份，备份目录在 /opt/backups/equipment-management。详细说明见 BACKUP.md。

当前线上资源

• 前端：http://1.13.22.133
• 后端：http://1.13.22.133:3000/api
• 健康检查：http://1.13.22.133:3000/api/health

注意事项

• 不要把真实密码、数据库连接串或生产环境地址提交到仓库。
• 涉及 Prisma 模型调整时，先生成客户端，再验证相关接口。
• 发布前默认执行备份，不建议跳过。