feat: 完成后端-管理后台集成及部署配置

🚀 主要功能:
- 完善后端API服务层,实现完整的CRUD操作
- 开发管理后台所有核心页面 (仪表板、照片、分类、标签、用户、设置)
- 完成前后端完全集成,所有API接口正常对接
- 配置完整的CI/CD流水线,支持自动化部署

🎯 后端完善:
- 实现PhotoService, CategoryService, TagService, UserService
- 添加完整的API处理器和路由配置
- 支持Docker容器化部署
- 添加数据库迁移和健康检查

🎨 管理后台完成:
- 仪表板: 实时统计数据展示
- 照片管理: 完整的CRUD操作,支持批量处理
- 分类管理: 树形结构展示和管理
- 标签管理: 颜色标签和统计信息
- 用户管理: 角色权限控制
- 系统设置: 多标签配置界面
- 添加pre-commit代码质量检查

🔧 部署配置:
- Docker Compose完整配置
- 后端CI/CD流水线 (Docker部署)
- 管理后台CI/CD流水线 (静态文件部署)
- 前端CI/CD流水线优化
- 自动化脚本: 部署、备份、监控
- 完整的部署文档和运维指南

 集成完成:
- 所有API接口正常连接
- 认证系统完整集成
- 数据获取和状态管理
- 错误处理和用户反馈
- 响应式设计优化
This commit is contained in:
xujiang
2025-07-09 16:23:18 +08:00
parent c57ec3aa82
commit 72414d0979
62 changed files with 12416 additions and 262 deletions

65
scripts/backup.sh Executable file
View File

@ -0,0 +1,65 @@
#!/bin/bash
# 数据库备份脚本
# 使用方法: ./scripts/backup.sh
set -e
# 配置变量
DB_HOST="${DB_HOST:-localhost}"
DB_NAME="${DB_NAME:-photography}"
DB_USER="${DB_USER:-postgres}"
BACKUP_DIR="/home/gitea/backups/database"
DATE=$(date +%Y%m%d-%H%M%S)
echo "🗄️ 开始数据库备份..."
# 创建备份目录
mkdir -p "$BACKUP_DIR"
# 检查数据库连接
echo "🔍 检查数据库连接..."
if ! pg_isready -h "$DB_HOST" -U "$DB_USER" -d "$DB_NAME"; then
echo "❌ 数据库连接失败"
exit 1
fi
# 执行备份
echo "📦 执行数据库备份..."
pg_dump -h "$DB_HOST" -U "$DB_USER" -d "$DB_NAME" \
--no-password --verbose --clean --no-acl --no-owner \
-f "$BACKUP_DIR/photography-$DATE.sql"
# 检查备份文件
if [ ! -f "$BACKUP_DIR/photography-$DATE.sql" ]; then
echo "❌ 备份文件创建失败"
exit 1
fi
# 压缩备份文件
echo "🗜️ 压缩备份文件..."
gzip "$BACKUP_DIR/photography-$DATE.sql"
# 检查压缩文件
if [ ! -f "$BACKUP_DIR/photography-$DATE.sql.gz" ]; then
echo "❌ 备份文件压缩失败"
exit 1
fi
# 设置权限
chmod 600 "$BACKUP_DIR/photography-$DATE.sql.gz"
chown gitea:gitea "$BACKUP_DIR/photography-$DATE.sql.gz"
# 清理旧备份 (保留最近7天)
echo "🧹 清理旧备份..."
find "$BACKUP_DIR" -name "photography-*.sql.gz" -mtime +7 -delete
echo "✅ 数据库备份完成!"
echo "📁 备份文件: $BACKUP_DIR/photography-$DATE.sql.gz"
echo "📊 文件大小: $(du -sh $BACKUP_DIR/photography-$DATE.sql.gz | cut -f1)"
# 显示备份统计
echo "📈 备份统计:"
echo " 总备份数: $(ls -1 $BACKUP_DIR/photography-*.sql.gz | wc -l)"
echo " 总备份大小: $(du -sh $BACKUP_DIR | cut -f1)"
echo " 最新备份: $(ls -t $BACKUP_DIR/photography-*.sql.gz | head -n 1)"

79
scripts/deploy-admin.sh Executable file
View File

@ -0,0 +1,79 @@
#!/bin/bash
# 管理后台部署脚本
# 使用方法: ./scripts/deploy-admin.sh
set -e
echo "🚀 开始部署管理后台..."
# 配置变量
ADMIN_DIR="/home/gitea/www/photography-admin"
BACKUP_DIR="/home/gitea/backups/photography-admin"
BUILD_DIR="./admin/dist"
PROJECT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
# 检查当前目录
if [ ! -d "$PROJECT_DIR/admin" ]; then
echo "❌ 错误: 请在项目根目录运行此脚本"
exit 1
fi
# 进入项目目录
cd "$PROJECT_DIR"
# 构建管理后台项目
echo "🏗️ 构建管理后台项目..."
cd admin
npm install
npm run build
# 检查构建结果
if [ ! -d "dist" ]; then
echo "❌ 构建失败: dist 目录不存在"
exit 1
fi
cd ..
# 创建备份
echo "📦 创建当前版本备份..."
mkdir -p "$BACKUP_DIR"
if [ -d "$ADMIN_DIR" ] && [ "$(ls -A $ADMIN_DIR)" ]; then
tar -czf "$BACKUP_DIR/admin-$(date +%Y%m%d-%H%M%S).tar.gz" -C "$ADMIN_DIR" .
echo "✅ 备份完成"
fi
# 创建部署目录
echo "📁 准备部署目录..."
mkdir -p "$ADMIN_DIR"
# 部署新版本
echo "🔄 部署新版本..."
rsync -av --delete "$BUILD_DIR/" "$ADMIN_DIR/"
# 设置权限
echo "🔐 设置文件权限..."
chown -R gitea:gitea "$ADMIN_DIR"
chmod -R 755 "$ADMIN_DIR"
# 设置正确的文件权限
find "$ADMIN_DIR" -type f -name "*.html" -o -name "*.js" -o -name "*.css" -o -name "*.json" | xargs chmod 644
find "$ADMIN_DIR" -type f -name "*.png" -o -name "*.jpg" -o -name "*.jpeg" -o -name "*.gif" -o -name "*.svg" -o -name "*.ico" | xargs chmod 644
find "$ADMIN_DIR" -type d | xargs chmod 755
# 重新加载 Web 服务器
echo "🔄 重新加载 Caddy..."
sudo systemctl reload caddy
# 清理旧备份 (保留最近5个)
echo "🧹 清理旧备份..."
cd "$BACKUP_DIR"
ls -t admin-*.tar.gz | tail -n +6 | xargs -r rm
echo "✅ 管理后台部署完成!"
echo "📁 部署路径: $ADMIN_DIR"
echo "🌐 访问地址: https://admin.photography.iriver.top"
echo "📊 部署统计:"
echo " 文件数量: $(find $ADMIN_DIR -type f | wc -l)"
echo " 目录大小: $(du -sh $ADMIN_DIR | cut -f1)"

79
scripts/deploy-frontend.sh Executable file
View File

@ -0,0 +1,79 @@
#!/bin/bash
# 前端部署脚本
# 使用方法: ./scripts/deploy-frontend.sh
set -e
echo "🚀 开始部署前端网站..."
# 配置变量
FRONTEND_DIR="/home/gitea/www/photography"
BACKUP_DIR="/home/gitea/backups/photography-frontend"
BUILD_DIR="./frontend/out"
PROJECT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
# 检查当前目录
if [ ! -d "$PROJECT_DIR/frontend" ]; then
echo "❌ 错误: 请在项目根目录运行此脚本"
exit 1
fi
# 进入项目目录
cd "$PROJECT_DIR"
# 构建前端项目
echo "🏗️ 构建前端项目..."
cd frontend
bun install
bun run build
# 检查构建结果
if [ ! -d "out" ]; then
echo "❌ 构建失败: out 目录不存在"
exit 1
fi
cd ..
# 创建备份
echo "📦 创建当前版本备份..."
mkdir -p "$BACKUP_DIR"
if [ -d "$FRONTEND_DIR" ] && [ "$(ls -A $FRONTEND_DIR)" ]; then
tar -czf "$BACKUP_DIR/frontend-$(date +%Y%m%d-%H%M%S).tar.gz" -C "$FRONTEND_DIR" .
echo "✅ 备份完成"
fi
# 创建部署目录
echo "📁 准备部署目录..."
mkdir -p "$FRONTEND_DIR"
# 部署新版本
echo "🔄 部署新版本..."
rsync -av --delete "$BUILD_DIR/" "$FRONTEND_DIR/"
# 设置权限
echo "🔐 设置文件权限..."
chown -R gitea:gitea "$FRONTEND_DIR"
chmod -R 755 "$FRONTEND_DIR"
# 设置正确的文件权限
find "$FRONTEND_DIR" -type f -name "*.html" -o -name "*.js" -o -name "*.css" -o -name "*.json" -o -name "*.xml" -o -name "*.txt" | xargs chmod 644
find "$FRONTEND_DIR" -type f -name "*.png" -o -name "*.jpg" -o -name "*.jpeg" -o -name "*.gif" -o -name "*.svg" -o -name "*.ico" | xargs chmod 644
find "$FRONTEND_DIR" -type d | xargs chmod 755
# 重新加载 Web 服务器
echo "🔄 重新加载 Caddy..."
sudo systemctl reload caddy
# 清理旧备份 (保留最近5个)
echo "🧹 清理旧备份..."
cd "$BACKUP_DIR"
ls -t frontend-*.tar.gz | tail -n +6 | xargs -r rm
echo "✅ 前端部署完成!"
echo "📁 部署路径: $FRONTEND_DIR"
echo "🌐 访问地址: https://photography.iriver.top"
echo "📊 部署统计:"
echo " 文件数量: $(find $FRONTEND_DIR -type f | wc -l)"
echo " 目录大小: $(du -sh $FRONTEND_DIR | cut -f1)"

212
scripts/monitor.sh Executable file
View File

@ -0,0 +1,212 @@
#!/bin/bash
# 系统监控脚本
# 使用方法: ./scripts/monitor.sh
set -e
echo "🔍 开始系统监控检查..."
# 检查服务状态
check_service() {
local service=$1
local url=$2
echo "检查 $service..."
if curl -f -s -o /dev/null --max-time 10 "$url"; then
echo "$service 正常运行"
return 0
else
echo "$service 服务异常"
return 1
fi
}
# 检查磁盘空间
check_disk() {
echo "💾 检查磁盘空间..."
local usage=$(df / | tail -1 | awk '{print $5}' | sed 's/%//')
echo "磁盘使用率: $usage%"
if [ "$usage" -gt 80 ]; then
echo "⚠️ 磁盘空间不足 ($usage%)"
return 1
else
echo "✅ 磁盘空间充足"
return 0
fi
}
# 检查内存使用
check_memory() {
echo "🧠 检查内存使用..."
local usage=$(free | grep Mem | awk '{printf "%.1f", $3/$2 * 100.0}')
echo "内存使用率: $usage%"
if (( $(echo "$usage > 90" | bc -l) )); then
echo "⚠️ 内存使用率过高 ($usage%)"
return 1
else
echo "✅ 内存使用正常"
return 0
fi
}
# 检查 CPU 使用
check_cpu() {
echo "⚡ 检查 CPU 使用..."
local usage=$(top -bn1 | grep "Cpu(s)" | awk '{print $2}' | awk -F% '{print $1}')
echo "CPU 使用率: $usage%"
if (( $(echo "$usage > 80" | bc -l) )); then
echo "⚠️ CPU 使用率过高 ($usage%)"
return 1
else
echo "✅ CPU 使用正常"
return 0
fi
}
# 检查 Docker 容器
check_docker() {
echo "🐳 检查 Docker 容器..."
# 检查后端容器
if docker ps --format "table {{.Names}}\t{{.Status}}" | grep -q "photography_backend.*Up"; then
echo "✅ 后端容器运行正常"
else
echo "❌ 后端容器异常"
return 1
fi
# 检查数据库容器
if docker ps --format "table {{.Names}}\t{{.Status}}" | grep -q "photography_postgres.*Up"; then
echo "✅ 数据库容器运行正常"
else
echo "❌ 数据库容器异常"
return 1
fi
# 检查 Redis 容器
if docker ps --format "table {{.Names}}\t{{.Status}}" | grep -q "photography_redis.*Up"; then
echo "✅ Redis 容器运行正常"
else
echo "❌ Redis 容器异常"
return 1
fi
}
# 检查 Caddy 服务
check_caddy() {
echo "🌐 检查 Caddy 服务..."
if systemctl is-active --quiet caddy; then
echo "✅ Caddy 服务运行正常"
return 0
else
echo "❌ Caddy 服务异常"
return 1
fi
}
# 检查 SSL 证书
check_ssl() {
echo "🔒 检查 SSL 证书..."
local domains=("photography.iriver.top" "admin.photography.iriver.top" "api.photography.iriver.top")
local all_ok=true
for domain in "${domains[@]}"; do
local expiry=$(echo | openssl s_client -servername "$domain" -connect "$domain:443" 2>/dev/null | openssl x509 -noout -dates | grep notAfter | cut -d= -f2)
local expiry_seconds=$(date -d "$expiry" +%s)
local current_seconds=$(date +%s)
local days_left=$(( (expiry_seconds - current_seconds) / 86400 ))
if [ "$days_left" -gt 30 ]; then
echo "$domain SSL 证书有效 (剩余 $days_left 天)"
else
echo "⚠️ $domain SSL 证书即将过期 (剩余 $days_left 天)"
all_ok=false
fi
done
if [ "$all_ok" = true ]; then
return 0
else
return 1
fi
}
# 生成监控报告
generate_report() {
echo "📊 生成监控报告..."
local report_file="/tmp/monitor-report-$(date +%Y%m%d-%H%M%S).txt"
{
echo "# 系统监控报告"
echo "时间: $(date)"
echo "主机: $(hostname)"
echo ""
echo "## 系统资源"
echo "- 磁盘使用: $(df -h / | tail -1 | awk '{print $5}')"
echo "- 内存使用: $(free | grep Mem | awk '{printf "%.1f%%", $3/$2 * 100.0}')"
echo "- CPU 使用: $(top -bn1 | grep "Cpu(s)" | awk '{print $2}' | awk -F% '{print $1}')%"
echo "- 负载平均: $(uptime | awk -F'load average:' '{print $2}')"
echo ""
echo "## 服务状态"
echo "- 前端网站: $(curl -s -o /dev/null -w "%{http_code}" https://photography.iriver.top)"
echo "- 管理后台: $(curl -s -o /dev/null -w "%{http_code}" https://admin.photography.iriver.top)"
echo "- API 服务: $(curl -s -o /dev/null -w "%{http_code}" https://api.photography.iriver.top/health)"
echo ""
echo "## Docker 容器"
docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}" | grep photography
echo ""
echo "## 磁盘空间"
df -h
echo ""
echo "## 内存使用"
free -h
} > "$report_file"
echo "📋 报告已生成: $report_file"
}
# 主检查流程
main() {
local exit_code=0
echo "🚀 开始执行系统监控..."
echo "时间: $(date)"
echo "主机: $(hostname)"
echo ""
# 执行各项检查
check_service "前端网站" "https://photography.iriver.top" || exit_code=1
check_service "管理后台" "https://admin.photography.iriver.top" || exit_code=1
check_service "API 服务" "https://api.photography.iriver.top/health" || exit_code=1
echo ""
check_disk || exit_code=1
check_memory || exit_code=1
check_cpu || exit_code=1
echo ""
check_docker || exit_code=1
check_caddy || exit_code=1
check_ssl || exit_code=1
echo ""
generate_report
echo ""
if [ $exit_code -eq 0 ]; then
echo "✅ 系统监控检查完成 - 所有服务正常"
else
echo "⚠️ 系统监控检查完成 - 发现问题"
fi
return $exit_code
}
# 运行主程序
main "$@"