Skip to content

P
performance-score
Commit 417891d8 by luoqi
Options

feat:项目精简

parent 8472f7f4
Pipeline #3219 failed with stage
in 5 seconds
Showing with 599 additions and 3161 deletions
.circleci/config.yml deleted 100644 → 0
# 使用 CircleCI 2.1 版本的配置语法
version: 2.1
# "Jobs" 定义了要执行的具体任务
jobs:
# 将这个任务命名为 "deploy"
deploy:
# 指定运行此任务的环境。我们选择一个预装了常用工具（如 git, ssh）的基础 Docker 镜像
docker:
- image: cimg/base:stable
# "steps" 定义了任务中要按顺序执行的具体步骤
steps:
# 第一步：添加 SSH 密钥，用于连接你的部署服务器
# CircleCI 会从你的项目设置中，加载你预先存好的那个 SSH 私钥
- add_ssh_keys:
fingerprints:
- "SHA256:xnKKtj4THMHlhsQ/KW+cWuRaMl1nU/jFz6BWdya/Zmk"
# 第二步：执行连接服务器并部署的命令
- run:
name: Connect and Deploy to Server
# 这里的 command 就是您提供的部署脚本
command: |
echo "准备连接到部署服务器..."
# 使用 ssh 命令连接你的服务器
# -p $SSH_PORT 指定了你修改后的端口
# -o StrictHostKeyChecking=no 避免了首次连接时需要手动确认主机的提示，这在自动化脚本中是必需的
# $SSH_USER 和 $SSH_HOST 是你需要在 CircleCI 网站上设置的环境变量
ssh -p 19822 -o StrictHostKeyChecking=no root@47.251.104.47 << 'EOF'
# --- 以下是在你的部署服务器上执行的命令 ---
echo "✅ 连接服务器成功，开始执行部署脚本..."
# 1. 进入你的项目工作目录
# 请确保这个目录在服务器上已经存在，并且已经从 GitLab 克隆过一次
echo "进入项目目录: performance-score"
cd performance-score
# 2. 从 master 分支拉取最新的代码
echo "正在从 GitLab (origin) 拉取最新代码..."
git pull origin master
# 3. 使用 Docker Compose 重新构建并启动服务
echo "正在使用 Docker Compose 部署..."
docker compose up -d --build
echo "🚀 部署流程执行完毕！"
# --- 远程服务器上的命令结束 ---
EOF
# "Workflows" 用来编排和组织 Jobs 的执行流程和触发条件
workflows:
# 将这个工作流命名为 "build-and-deploy"
build-and-deploy:
jobs:
- deploy:
# "filters" 是过滤器，用来定义触发此 Job 的条件
filters:
branches:
# "only" 表示只有当代码被推送到指定分支时，才执行这个 Job
only:
- master
.env
# 前端环境变量配置
# ========================================
# 绩效计分系统 - 环境变量配置
# ========================================
# API 服务地址 - 指向外部API服务
# ==================== 前端配置 ====================
# API 服务地址 - 前端访问后端API的地址
VITE_API_BASE_URL=http://localhost:8000
# 应用配置
VITE_APP_TITLE=绩效计分系统
VITE_APP_VERSION=8.8.0
# ==================== 后端配置 ====================
# 数据库配置
DATABASE_URL=postgresql://performance_user:performance_pass@localhost:5431/performance_db
# 开发模式配置
VITE_DEV_MODE=true
# API 服务配置
API_HOST=0.0.0.0
API_PORT=8000
# CORS 配置（允许的前端域名）
CORS_ORIGINS=http://localhost:5173,http://localhost:8080,http://localhost:4001
# 安全配置
SECRET_KEY=your-secret-key-here-change-in-production
# 日志配置
LOG_LEVEL=INFO
LOG_FILE=logs/api.log
# 数据迁移配置
MIGRATION_BATCH_SIZE=100
.env.example
# 前端环境变量配置
# ========================================
# 绩效计分系统 - 环境变量配置示例
# ========================================
# 复制此文件为 .env 并根据实际情况修改配置
# API 服务地址
# ==================== 前端配置 ====================
# API 服务地址 - 前端访问后端API的地址
VITE_API_BASE_URL=http://localhost:8000
# 应用配置
VITE_APP_TITLE=绩效计分系统
VITE_APP_VERSION=8.8.0
# ==================== 后端配置 ====================
# 数据库配置
# 格式: postgresql://用户名:密码@主机:端口/数据库名
DATABASE_URL=postgresql://performance_user:performance_pass@localhost:5431/performance_db
# 开发模式配置
VITE_DEV_MODE=true
# API 服务配置
API_HOST=0.0.0.0
API_PORT=8000
# CORS 配置（允许的前端域名，JSON数组格式）
CORS_ORIGINS=["http://localhost:5173","http://localhost:8080","http://localhost:4001"]
# 安全配置
# 生产环境请务必更改为强密码
SECRET_KEY=your-secret-key-here-change-in-production
# 日志配置
LOG_LEVEL=INFO
LOG_FILE=logs/api.log
# 数据迁移配置
MIGRATION_BATCH_SIZE=100
# ==================== 开发环境说明 ====================
# 开发环境默认配置：
# - 前端开发服务器: http://localhost:5173 (vite dev)
# - 前端预览服务器: http://localhost:4001 (vite preview)
# - 后端API服务器: http://localhost:8000 (FastAPI)
# - 数据库: PostgreSQL localhost:5431
# ==================== 生产环境说明 ====================
# 生产环境需要修改的配置：
# 1. SECRET_KEY - 使用强随机密钥
# 2. DATABASE_URL - 使用生产数据库地址
# 3. CORS_ORIGINS - 只允许生产域名
# 4. LOG_LEVEL - 可设置为 WARNING 或 ERROR
.gitignore
......@@ -14,6 +14,11 @@ build/
.env.development.local
.env.test.local
.env.production.local
backend/.env
backend/.env.local
backend/.env.development.local
backend/.env.test.local
backend/.env.production.local
# IDE files
.vscode/
......
Docker部署指南.md deleted 100644 → 0
# 绩效计分系统 Docker 部署指南
++ /dev/null
# 绩效计分系统 Docker 部署指南
## 概述
本指南介绍如何使用Docker容器化部署绩效计分系统到生产环境。
## 系统架构
```
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Nginx Proxy │ │ Application │ │ PostgreSQL │
│ (Port 80/443) │────│ (Port 4001) │────│ (Port 5432) │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│
┌─────────────────┐
│ Redis │
│ (Port 6379) │
└─────────────────┘
```
## 前置要求
### 系统要求
- Windows 10/11 或 Windows Server 2019+
- 至少 4GB RAM
- 至少 10GB 可用磁盘空间
- 稳定的网络连接
### 软件要求
- Docker Desktop for Windows
- Docker Compose (通常包含在Docker Desktop中)
## 快速部署
### 1. 安装Docker Desktop
1. 下载Docker Desktop: https://www.docker.com/products/docker-desktop
2. 运行安装程序并重启计算机
3. 启动Docker Desktop并等待完全启动
### 2. 验证安装
```bash
docker --version
docker-compose --version
```
### 3. 一键部署
运行部署脚本：
```bash
deploy.bat
```
或手动执行：
```bash
# 构建并启动所有服务
docker-compose up -d --build
# 查看服务状态
docker-compose ps
# 查看日志
docker-compose logs -f
```
## 服务配置
### 端口映射
- **80**: Nginx反向代理 (HTTP)
- **443**: Nginx反向代理 (HTTPS)
- **8080**: 应用主入口
- **4001**: 后端API服务
- **5432**: PostgreSQL数据库
- **6379**: Redis缓存
### 环境变量
在 `docker-compose.yml` 中配置：
```yaml
environment:
- NODE_ENV=production
- PORT=4001
- REDIS_URL=redis://redis:6379
- DB_HOST=postgres
- DB_PORT=5432
- DB_NAME=performance_db
- DB_USER=performance_user
- DB_PASSWORD=performance_pass
```
### 数据持久化
系统使用Docker卷来持久化数据：
- `postgres_data`: 数据库数据
- `redis_data`: Redis数据
- `app_data`: 应用数据
- `app_logs`: 应用日志
- `nginx_logs`: Nginx日志
## 生产环境配置
### SSL证书配置
1. 将SSL证书文件放置在 `ssl/` 目录：
```
ssl/
├── cert.pem
└── key.pem
```
2. 更新 `nginx.prod.conf` 中的证书路径
### 安全配置
1. **修改默认密码**：
```bash
# 进入数据库容器
docker-compose exec postgres psql -U performance_user -d performance_db
# 更新管理员密码
UPDATE users SET password_hash = '$2b$10$新的哈希密码' WHERE username = 'admin';
```
2. **配置防火墙**：
- 只开放必要端口 (80, 443)
- 限制数据库端口访问
3. **定期备份**：
```bash
# 数据库备份
docker-compose exec postgres pg_dump -U performance_user performance_db > backup.sql
# 恢复数据库
docker-compose exec -T postgres psql -U performance_user performance_db < backup.sql
```
## 监控和维护
### 健康检查
系统内置健康检查端点：
- 应用健康: `http://localhost:8080/health`
- 数据库健康: 自动检查
- Redis健康: 自动检查
### 日志管理
```bash
# 查看所有服务日志
docker-compose logs
# 查看特定服务日志
docker-compose logs app
docker-compose logs postgres
docker-compose logs redis
# 实时跟踪日志
docker-compose logs -f app
```
### 性能监控
```bash
# 查看容器资源使用
docker stats
# 查看服务状态
docker-compose ps
# 重启服务
docker-compose restart app
```
## 故障排除
### 常见问题
1. **端口冲突**：
```bash
# 检查端口占用
netstat -ano | findstr :8080
# 修改docker-compose.yml中的端口映射
```
2. **内存不足**：
```bash
# 增加Docker Desktop内存限制
# 设置 -> Resources -> Advanced -> Memory
```
3. **数据库连接失败**：
```bash
# 检查数据库容器状态
docker-compose logs postgres
# 重启数据库服务
docker-compose restart postgres
```
### 完全重置
```bash
# 停止所有服务
docker-compose down
# 删除所有数据卷（注意：会丢失所有数据）
docker-compose down -v
# 清理所有镜像
docker system prune -a
# 重新部署
docker-compose up -d --build
```
## 更新部署
```bash
# 拉取最新代码
git pull
# 重新构建并部署
docker-compose up -d --build
# 或使用部署脚本
deploy.bat
```
## 备份策略
### 自动备份脚本
创建 `backup.bat`：
```batch
@echo off
set BACKUP_DIR=backups\%date:~0,4%-%date:~5,2%-%date:~8,2%
mkdir %BACKUP_DIR%
docker-compose exec postgres pg_dump -U performance_user performance_db > %BACKUP_DIR%\database.sql
docker-compose exec redis redis-cli --rdb %BACKUP_DIR%\redis.rdb
echo 备份完成: %BACKUP_DIR%
```
### 定期备份
使用Windows任务计划程序设置定期备份：
1. 打开任务计划程序
2. 创建基本任务
3. 设置触发器（每日/每周）
4. 设置操作为运行 `backup.bat`
## 支持
如有问题，请检查：
1. Docker Desktop是否正常运行
2. 端口是否被占用
3. 系统资源是否充足
4. 网络连接是否正常
更多技术支持，请查看项目文档或联系系统管理员。
Docker部署说明.md deleted 100644 → 0
# 绩效计分系统 8.8 版本 - Docker 部署说明
++ /dev/null
# 绩效计分系统 8.8 版本 - Docker 部署说明
## 🎉 部署成功！
绩效计分系统 8.8 版本已成功部署到 Docker 容器中，现在可以通过以下方式访问：
### 🌐 访问地址
- **主要访问地址**: http://localhost:4001/
- **管理员面板**: http://localhost:4001/admin
- **用户面板**: http://localhost:4001/user
### 👥 默认登录账号
- **管理员**: admin / admin123
- **张田田**: 13800138002 / 123456
- **陈锐屏**: 13800138001 / 123456
- **余芳飞**: 13800138003 / 123456
### 🐳 容器信息
- **容器名称**: scoring-system-8.8
- **镜像版本**: scoring-system:8.8
- **端口映射**: 4001:80
- **状态**: 运行中 (健康检查启用)
### 🛠️ 管理命令
#### 快速管理
- **一键管理**: 双击 `docker-manage.bat`
- **重新部署**: 双击 `docker-deploy.bat`
#### 手动命令
```bash
# 查看容器状态
docker ps
# 查看日志
docker logs scoring-system-8.8
# 重启容器
docker restart scoring-system-8.8
# 停止容器
docker stop scoring-system-8.8
# 启动容器
docker start scoring-system-8.8
# 删除容器
docker rm -f scoring-system-8.8
```
### 🔧 技术特性
- ✅ 前端路由支持 (刷新 /admin 不会 404)
- ✅ 图片上传权限修复
- ✅ 数据自动修复机制
- ✅ 响应式设计
- ✅ 健康检查
- ✅ 静态资源缓存优化
### 📁 项目结构
```
绩效计分系统7.24/
├── Dockerfile # Docker 构建文件
├── nginx.conf # Nginx 配置 (SPA 回退)
├── docker-compose.yml # Docker Compose 配置
├── docker-deploy.bat # 一键部署脚本
├── docker-manage.bat # 容器管理脚本
├── dist/ # 构建产物
└── src/ # 源代码
```
### 🚀 生产环境部署建议
#### 1. 使用 Docker Compose
```bash
docker-compose up -d
```
#### 2. 自定义端口
修改 docker-compose.yml 中的端口映射：
```yaml
ports:
- "8080:80" # 改为 8080 端口
```
#### 3. 数据持久化
如需数据持久化，可挂载数据目录：
```yaml
volumes:
- ./data:/app/data
```
### 🔍 故障排除
#### 端口被占用
```bash
# 查看端口占用
netstat -ano | findstr :4001
# 使用其他端口
docker run -d -p 8080:80 --name scoring-system-8.8 scoring-system:8.8
```
#### 容器无法启动
```bash
# 查看详细日志
docker logs scoring-system-8.8
# 重新构建镜像
docker build -t scoring-system:8.8 .
```
### 📞 支持信息
- **版本**: 8.8.0
- **构建时间**: 2025-08-08
- **技术栈**: Vue 3 + Element Plus + Nginx
- **容器化**: Docker + Alpine Linux
---
## 🎯 下一步
系统已成功部署并运行，你可以：
1. 访问 http://localhost:4001/ 开始使用
2. 使用管理员账号登录查看所有功能
3. 测试图片上传和删除功能
4. 根据需要调整端口或配置
Node.js安装指南.md deleted 100644 → 0
# Node.js 安装指南
++ /dev/null
# Node.js 安装指南
## 🚀 快速安装Node.js
### 步骤1：下载Node.js
1. 访问Node.js官方网站：[https://nodejs.org/](https://nodejs.org/)
2. 下载LTS（长期支持）版本（推荐）
3. 选择对应您操作系统的版本：
- Windows: `.msi` 文件
- macOS: `.pkg` 文件
- Linux: 二进制包或通过包管理器
### 步骤2：安装Node.js（Windows）
#### 使用安装包（推荐）
1. 双击下载的 `.msi` 文件
2. 按照安装向导进行安装：
- 点击"Next"继续
- 接受许可协议
- 选择安装路径（建议使用默认路径）
- **重要**：确保勾选"Add to PATH"选项
- 点击"Install"开始安装
3. 安装完成后点击"Finish"
### 步骤3：验证安装
安装完成后，**重新打开**命令提示符或PowerShell，然后运行以下命令：
```bash
# 检查Node.js版本
node --version
# 检查npm版本
npm --version
```
如果显示版本号，说明安装成功！
### 步骤4：启动项目
现在您可以运行项目了：
```bash
# 1. 进入项目目录
cd "D:\绩效计分系统7.24"
# 2. 安装依赖
npm install
# 3. 启动开发服务器
npm run dev
```
## 🔧 常见问题解决
### 问题1：安装后仍然提示npm命令不存在
**解决方案：**
1. **重启命令行工具**：关闭所有PowerShell/命令提示符窗口，重新打开
2. **检查环境变量**：
- 按`Win + R`，输入`sysdm.cpl`
- 点击"高级"选项卡 → "环境变量"
- 在"系统变量"中找到"Path"
- 确保包含类似路径：`C:\Program Files\nodejs\`
3. **重启计算机**：某些情况下需要重启系统
### 问题2：下载速度慢
**解决方案：**
可以使用国内镜像下载：
- 淘宝镜像：[https://npm.taobao.org/mirrors/node/](https://npm.taobao.org/mirrors/node/)
- 中科大镜像：[https://mirrors.ustc.edu.cn/node/](https://mirrors.ustc.edu.cn/node/)
### 问题3：权限问题
**解决方案：**
- 以管理员身份运行安装程序
- 安装到用户目录而不是系统目录
## 📋 安装检查清单
安装完成后，请确认以下项目：
- [ ] Node.js版本显示正常（推荐16.x或更高）
- [ ] npm版本显示正常（通常随Node.js一起安装）
- [ ] 重新打开了命令行工具
- [ ] 在项目目录下可以运行npm命令
## 🎯 推荐版本
- **Node.js**: 18.x LTS 或 20.x LTS
- **npm**: 8.x 或更高版本（随Node.js自动安装）
## 🆘 如果仍有问题
1. **检查杀毒软件**：某些杀毒软件可能阻止Node.js的安装
2. **尝试不同的安装方式**：
- 使用Chocolatey：`choco install nodejs`
- 使用Scoop：`scoop install nodejs`
3. **联系技术支持**：提供错误截图和系统信息
---
**安装完成后，请返回项目目录重新尝试启动命令！** 🚀
\ No newline at end of file
README.md
# 绩效计分系统
一个基于Vue 3的现代化绩效管理系统，用于管理用户、机构和图片上传的绩效评分。
一个基于 Vue 3 + FastAPI 的现代化全栈绩效管理系统，支持用户管理、机构管理、图片上传统计和绩效评分。
## 🚀 项目概述
绩效计分系统是一个全功能的Web应用程序，旨在帮助组织管理用户绩效、机构数据和图片上传统计。系统提供了直观的管理界面和用户界面，支持数据导出、历史统计和月度重置等功能。
绩效计分系统是一个企业级全栈Web应用程序，采用前后端分离架构，提供完整的用户绩效管理、机构数据管理和图片上传统计功能。系统支持多种部署方式，具备完善的数据迁移机制和实时数据同步能力。
### ✨ 核心特性
- 🔐 **JWT认证系统** - 基于JWT的安全认证，支持token刷新
- 👥 **用户权限管理** - 管理员和普通用户角色，细粒度权限控制
- 🏢 **机构管理** - 完整的机构CRUD操作，支持批量导入和权限分配
- 📊 **实时数据统计** - 动态统计和历史数据分析，支持数据可视化
- 📈 **智能绩效评分** - 自动计算互动分数和绩效分数
- 📁 **多格式数据导出** - 支持CSV、Excel、ZIP等格式导出
- 🔄 **自动化月度重置** - 定时任务支持，数据备份和清理
- 📱 **响应式设计** - 适配桌面端和移动端
- 🐳 **容器化部署** - 支持Docker一键部署
- 🔧 **数据库迁移** - 完善的数据库版本管理和迁移机制
## 🛠️ 技术架构
### 前端技术栈
- **Vue 3** - 组合式API，响应式框架
- **Element Plus** - 企业级UI组件库
- **Pinia** - 轻量级状态管理
- **Vue Router** - 单页面路由管理
- **Vite** - 快速构建工具
- **Axios** - HTTP客户端
### 后端技术栈
- **FastAPI** - 现代Python Web框架
- **SQLAlchemy** - ORM数据库操作
- **PostgreSQL** - 关系型数据库
- **Pydantic** - 数据验证和序列化
- **JWT** - 安全认证机制
- **APScheduler** - 定时任务调度
- **Loguru** - 结构化日志
### 基础设施
- **Docker** - 容器化部署
- **Nginx** - 反向代理和静态文件服务
- **PostgreSQL** - 数据持久化
- **数据库迁移系统** - 自动化schema管理
## � 快速开始
### 主要特性
### 环境要求
- 🔐 **用户认证系统** - 支持管理员和普通用户角色
- 👥 **用户管理** - 完整的用户CRUD操作
- 🏢 **机构管理** - 机构信息管理和权限控制
- 📊 **数据统计** - 实时统计和历史数据分析
- 📈 **绩效评分** - 自动计算互动分数和绩效分数
- 📁 **数据导出** - 支持CSV和ZIP格式导出
- 🔄 **月度重置** - 自动化的月度数据管理
- 📱 **响应式设计** - 适配各种设备屏幕
- **Node.js** 18+
- **Python** 3.11+
- **PostgreSQL** 15+
- **Docker** (可选，用于容器化部署)
## 🛠️ 技术栈
### 🎯 启动方式
### 前端
- **Vue 3** - 渐进式JavaScript框架
- **Element Plus** - Vue 3组件库
- **Pinia** - Vue状态管理
- **Vue Router** - 路由管理
- **Vite** - 构建工具
项目支持两种启动方式：**分步启动**和**Docker一键启动**
### 后端
- **Express.js** - Node.js Web框架
- **CORS** - 跨域资源共享
#### 方式一：分步启动（开发推荐）
### 数据存储
- **LocalStorage** - 客户端数据存储
- **JSON** - 数据格式
**1. 启动数据库**
```bash
# 使用Docker启动PostgreSQL
docker run -d \
--name performance_postgres \
-e POSTGRES_DB=performance_db \
-e POSTGRES_USER=performance_user \
-e POSTGRES_PASSWORD=performance_pass \
-p 5431:5432 \
postgres:15-alpine
```
### 工具库
- **XLSX** - Excel文件处理
- **jsPDF** - PDF生成
- **JSZip** - ZIP文件处理
- **html2canvas** - 截图功能
- **File-saver** - 文件下载
**2. 启动后端服务**
```bash
cd backend
pip install -r requirements.txt
# 或使用uv（推荐）
uv pip install -r requirements.txt
## 📦 安装指南
# 运行数据库迁移
python migrate.py
### 环境要求
# 启动API服务
uvicorn main:app --host 0.0.0.0 --port 8000 --reload
```
- Node.js >= 16.0.0
- npm >= 8.0.0
**3. 启动前端服务**
```bash
npm install
npm run dev
```
### 安装步骤
#### 方式二：Docker一键启动（生产推荐）
1. **克隆项目**
```bash
# 克隆项目
git clone <repository-url>
cd score-management-system
cd performance-score
# 配置环境变量
cp .env.example .env
# 编辑 .env 文件，配置数据库等信息
# 一键启动所有服务
docker compose up -d
# 查看服务状态
docker compose ps
```
2. **安装依赖**
```bash
npm install
### 🔗 访问地址
- **前端应用**：http://localhost:4001
- **后端API**：http://localhost:8000
- **API文档**：http://localhost:8000/docs
- **数据库**：localhost:5431
### 👤 默认账号
- **管理员**：admin / admin123
- **普通用户**：user1 / user123
## 📁 项目结构
```
performance-score/
├── frontend/ # 前端应用
│ ├── src/ # 源代码目录
│ │ ├── components/ # Vue组件
│ │ ├── views/ # 页面组件
│ │ │ ├── admin/ # 管理员页面
│ │ │ ├── auth/ # 认证页面
│ │ │ └── user/ # 用户页面
│ │ ├── store/ # Pinia状态管理
│ │ │ ├── auth.js # 认证状态
│ │ │ └── data.js # 数据状态
│ │ ├── router/ # 路由配置
│ │ ├── services/ # API服务
│ │ │ └── api.js # API接口封装
│ │ ├── utils/ # 工具函数
│ │ └── styles/ # 样式文件
│ ├── package.json # 前端依赖配置
│ └── vite.config.js # Vite构建配置
├── backend/ # 后端API服务
│ ├── routers/ # API路由
│ │ ├── auth.py # 认证路由
│ │ ├── users.py # 用户管理
│ │ ├── institutions.py # 机构管理
│ │ ├── history.py # 历史数据
│ │ └── system_config.py # 系统配置
│ ├── models/ # 数据模型
│ ├── migrations/ # 数据库迁移
│ │ ├── migrate.py # 迁移脚本
│ │ └── versions/ # 迁移版本
│ ├── database.py # 数据库配置
│ ├── main.py # FastAPI应用入口
│ └── requirements.txt # Python依赖
├── docker compose.yml # Docker编排配置
├── Dockerfile # 容器构建文件
├── .env.example # 环境变量模板
└── README.md # 项目说明
```
3. **启动开发服务器**
```bash
npm run dev
## 🔧 数据库迁移策略
项目采用完善的数据库版本管理和迁移机制，确保数据库结构变更的安全性和一致性。
### 迁移系统特点
- **🔄 自动迁移检测** - 启动时自动检测并执行待迁移的版本
- **📝 版本化管理** - 每个数据库变更都有对应的迁移文件
- **🛡️ 安全回滚** - 支持迁移失败时的安全回滚机制
- **📊 迁移日志** - 详细记录每次迁移的执行状态和时间
### 迁移文件结构
```
backend/migrations/
├── migrate.py # 迁移执行器
├── versions/ # 迁移版本目录
│ ├── 001_initial.py # 初始化数据库结构
│ ├── 002_add_institutions_data.py # 添加机构数据字段
│ └── 003_add_indexes.py # 添加数据库索引
└── migration_log.txt # 迁移执行日志
```
4. **构建生产版本**
### 使用方法
```bash
npm run build
# 手动执行迁移
cd backend
python migrate.py
# 查看迁移状态
python migrate.py --status
# 回滚到指定版本
python migrate.py --rollback 001
```
5. **预览生产版本**
### 新增迁移
当需要修改数据库结构时：
1. 在 `backend/migrations/versions/` 目录下创建新的迁移文件
2. 按照版本号命名：`00X_description.py`
3. 实现 `upgrade()` 和 `downgrade()` 函数
4. 重启应用，迁移将自动执行
## 🎯 核心功能模块
### 🔐 认证与权限系统
- **JWT安全认证** - 基于Token的无状态认证
- **角色权限控制** - 管理员/普通用户权限分离
- **Token自动刷新** - 无感知的登录状态保持
- **安全登出** - 服务端Token失效机制
### 👥 用户管理系统
- **用户CRUD操作** - 完整的用户生命周期管理
- **批量用户导入** - 支持Excel/CSV批量导入
- **用户状态管理** - 启用/禁用用户账号
- **密码安全策略** - 密码加密存储和重置
### 🏢 机构管理系统
- **机构层级管理** - 支持多级机构结构
- **权限精细控制** - 机构级别的数据访问控制
- **批量机构操作** - 导入、导出、转移等批量操作
- **机构数据统计** - 实时统计机构相关数据
### 📊 数据统计分析
- **实时数据监控** - 用户活跃度、上传量等实时统计
- **历史数据分析** - 月度、季度、年度数据趋势
- **绩效评分算法** - 智能计算用户绩效分数
- **数据可视化** - 图表展示统计结果
### 📁 数据导出系统
- **多格式导出** - CSV、Excel、ZIP等格式支持
- **自定义导出** - 可选择导出字段和时间范围
- **批量文件打包** - 图片和数据文件批量下载
- **导出任务管理** - 大数据量异步导出
### 🔄 自动化任务系统
- **月度数据重置** - 定时清理和备份月度数据
- **数据备份策略** - 自动备份重要数据
- **系统维护任务** - 日志清理、缓存更新等
- **任务调度管理** - 灵活的定时任务配置
## 📚 API文档
### 接口概览
系统提供完整的RESTful API，支持前后端分离架构。
**基础信息**
- **API Base URL**: `http://localhost:8000/api`
- **认证方式**: Bearer Token (JWT)
- **数据格式**: JSON
- **API文档**: http://localhost:8000/docs (Swagger UI)
### 主要接口
| 模块 | 方法 | 路径 | 描述 |
|------|------|------|------|
| 认证 | POST | `/users/login` | 用户登录 |
| 认证 | POST | `/users/refresh` | 刷新Token |
| 用户 | GET | `/users` | 获取用户列表 |
| 用户 | POST | `/users` | 创建用户 |
| 用户 | PUT | `/users/{id}` | 更新用户 |
| 用户 | DELETE | `/users/{id}` | 删除用户 |
| 机构 | GET | `/institutions` | 获取机构列表 |
| 机构 | POST | `/institutions` | 创建机构 |
| 历史 | GET | `/history` | 获取历史数据 |
| 配置 | GET | `/config` | 获取系统配置 |
### 认证示例
```bash
npm run preview
# 登录获取Token
curl -X POST "http://localhost:8000/api/users/login" \
-H "Content-Type: application/json" \
-d '{"phone":"admin","password":"admin123"}'
# 使用Token访问API
curl -X GET "http://localhost:8000/api/users" \
-H "Authorization: Bearer YOUR_TOKEN_HERE"
```
### 快速启动
## 🔧 环境配置
使用提供的批处理文件（Windows）：
- `启动开发服务器.bat` - 启动开发环境
- `启动生产环境.bat` - 构建并启动生产环境
- `启动.bat` - 一键启动
### 环境变量
## 📁 项目结构
创建 `.env` 文件配置环境变量：
```bash
# 数据库配置
DATABASE_URL=postgresql://performance_user:performance_pass@localhost:5431/performance_db
# JWT配置
SECRET_KEY=your-secret-key-here
ACCESS_TOKEN_EXPIRE_MINUTES=30
REFRESH_TOKEN_EXPIRE_DAYS=7
# 应用配置
DEBUG=true
CORS_ORIGINS=["http://localhost:4001"]
```
绩效计分系统/
├── src/ # 源代码目录
│ ├── components/ # Vue组件
│ ├── views/ # 页面组件
│ │ ├── admin/ # 管理员页面
│ │ │ └── AdminPanel.vue
│ │ ├── auth/ # 认证页面
│ │ │ └── Login.vue
│ │ └── user/ # 用户页面
│ │ └── UserPanel.vue
│ ├── store/ # Pinia状态管理
│ │ ├── auth.js # 认证状态
│ │ └── data.js # 数据状态
│ ├── router/ # 路由配置
│ │ └── index.js
│ ├── styles/ # 样式文件
│ │ ├── global.css
│ │ └── theme.css
│ ├── utils/ # 工具函数
│ │ ├── dataCleanup.js
│ │ └── index.js
│ ├── App.vue # 根组件
│ └── main.js # 入口文件
├── docs/ # 项目文档
│ ├── 使用指南.md # 详细使用说明
│ └── 部署指南.md # 部署说明
├── scripts/ # 启动脚本
│ ├── start-dev.bat # 开发环境启动
│ └── start-prod.bat # 生产环境启动
├── public/ # 静态资源
├── dist/ # 构建输出
├── server/ # 服务器文件
├── production-deploy/ # 生产部署文件
├── package.json # 项目配置
├── vite.config.js # Vite配置
├── VERSION.md # 版本信息
├── 启动.bat # 一键启动脚本
└── README.md # 项目文档
```
## 🎯 主要功能模块
### 1. 用户管理
- 用户注册和登录
- 用户信息编辑
- 密码重置
- 用户权限管理
### 2. 机构管理
- 机构创建和编辑
- 机构权限分配
- 批量导入机构
- 机构转移功能
### 3. 数据统计
- 实时数据统计
- 用户绩效排名
- 图片上传统计
- 历史数据查看
### 4. 数据导出
- CSV格式导出
- ZIP图片包导出
- 用户数据导出
- 历史数据导出
### 5. 月度重置
- 手动月度重置
- 数据备份到历史记录
- 图片数据清理
- 重置时间记录
## 🔧 配置说明
### 开发环境配置
系统默认运行在端口4001，可在`vite.config.js`中修改：
前端开发服务器配置（`vite.config.js`）：
```javascript
export default defineConfig({
server: {
port: 4001,
host: '0.0.0.0'
host: '0.0.0.0',
proxy: {
'/api': {
target: 'http://localhost:8000',
changeOrigin: true
}
}
}
})
```
### 生产环境配置
## 🚀 生产部署
### Docker Compose 部署（推荐）
```bash
# 生产环境一键部署
docker compose -f docker compose.prod.yml up -d
# 查看服务状态
docker compose ps
# 查看日志
docker compose logs -f
```
生产环境使用Express服务器，配置文件在`server.js`中。
### 手动部署
## 🚀 部署指南
**后端部署**
```bash
cd backend
pip install -r requirements.txt
python migrate.py
gunicorn main:app -w 4 -k uvicorn.workers.UvicornWorker --bind 0.0.0.0:8000
```
### 本地部署
**前端部署**
```bash
npm run build
# 将 dist/ 目录部署到 Nginx 或其他静态文件服务器
```
### Nginx 配置示例
```nginx
server {
listen 80;
server_name your-domain.com;
# 前端静态文件
location / {
root /path/to/dist;
try_files $uri $uri/ /index.html;
}
# 后端API代理
location /api/ {
proxy_pass http://localhost:8000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
1. 构建项目：`npm run build`
2. 启动服务器：`npm run preview`
## 📝 使用指南
### Docker部署
### 🔑 首次使用
1. 构建镜像：`docker build -t score-system .`
2. 运行容器：`docker run -p 4001:4001 score-system`
1. **启动系统** - 选择合适的启动方式（分步启动或Docker）
2. **访问应用** - 打开浏览器访问 http://localhost:4001
3. **管理员登录** - 使用默认管理员账号：admin / admin123
4. **初始化数据** - 创建用户和机构，配置系统参数
### 生产环境部署
### 👨‍💼 管理员操作流程
参考`Docker部署指南.md`和`部署说明.md`文件。
**用户管理**
- 创建用户账号，分配角色权限
- 批量导入用户数据（支持Excel/CSV）
- 管理用户状态（启用/禁用）
- 重置用户密码
## 📝 使用说明
**机构管理**
- 创建机构层级结构
- 分配机构给用户
- 批量导入机构数据
- 设置机构权限
### 管理员功能
**数据管理**
- 查看实时统计数据
- 导出各类报表
- 执行月度数据重置
- 管理历史数据
1. **登录系统** - 使用管理员账号登录
2. **用户管理** - 添加、编辑、删除用户
3. **机构管理** - 管理机构信息和权限
4. **数据统计** - 查看系统统计数据
5. **数据导出** - 导出各种格式的数据
6. **月度重置** - 执行月度数据重置
### 👤 普通用户操作流程
### 用户功能
**日常操作**
- 登录个人账号
- 查看分配的机构
- 上传机构相关图片
- 查看个人绩效统计
1. **登录系统** - 使用个人账号登录
2. **查看机构** - 查看分配的机构信息
3. **上传图片** - 上传机构相关图片
4. **查看统计** - 查看个人绩效数据
**数据查看**
- 个人上传统计
- 绩效分数排名
- 历史数据查询
## ⚠️ 注意事项
1. **数据备份** - 定期备份重要数据
2. **浏览器兼容** - 推荐使用Chrome、Firefox等现代浏览器
3. **存储限制** - LocalStorage有容量限制，注意数据大小
4. **月度重置** - 月度重置操作不可逆，请谨慎操作
5. **权限管理** - 确保用户权限设置正确
### 🔒 安全相关
- **生产环境密钥** - 务必修改默认的JWT密钥和数据库密码
- **HTTPS部署** - 生产环境建议使用HTTPS协议
- **权限控制** - 严格控制管理员权限的分配
- **定期备份** - 建立完善的数据备份策略
### 🛠️ 技术要求
- **浏览器兼容** - 推荐使用Chrome 90+、Firefox 88+、Safari 14+
- **数据库维护** - 定期清理日志和优化数据库性能
- **资源监控** - 监控服务器资源使用情况
- **版本管理** - 使用数据库迁移系统管理结构变更
### 📊 运维建议
- **监控告警** - 设置系统监控和告警机制
- **日志管理** - 定期清理和归档系统日志
- **性能优化** - 根据使用情况调整数据库和应用配置
- **容灾备份** - 建立异地备份和容灾恢复方案
## 🔄 版本更新
### v2.0.0 (2025-08-30) - 架构重构版本
#### 🎯 重大变更
- **全栈重构** - 从单体前端应用重构为前后端分离架构
- **数据库升级** - 从LocalStorage迁移到PostgreSQL数据库
- **认证系统** - 实现基于JWT的安全认证机制
- **API设计** - 设计完整的RESTful API接口
#### ✨ 新增功能
- **Docker支持** - 支持容器化部署和一键启动
- **数据库迁移** - 完善的数据库版本管理和迁移机制
- **API文档** - 自动生成的Swagger API文档
- **日志系统** - 结构化日志记录和错误追踪
- **定时任务** - 支持自动化的后台任务调度
#### 🔧 技术升级
- **后端框架** - 采用FastAPI构建高性能API服务
- **数据库ORM** - 使用SQLAlchemy进行数据库操作
- **状态管理** - 前端使用Pinia替代Vuex
- **构建工具** - 使用Vite提升开发和构建效率
#### 🚀 部署优化
- **多种部署方式** - 支持分步启动和Docker一键部署
- **环境配置** - 完善的环境变量配置管理
- **生产优化** - 针对生产环境的性能和安全优化
## �️ 故障排除
### 常见问题
**启动问题**
```bash
# 检查端口占用
lsof -i :8000 # 后端端口
lsof -i :4001 # 前端端口
lsof -i :5431 # 数据库端口
# 清理Docker容器
docker compose down
docker system prune -f
```
**数据库连接问题**
```bash
# 检查数据库状态
docker ps | grep postgres
# 查看数据库日志
docker logs performance_postgres
## 🔄 最近更新
# 重新创建数据库
docker compose down
docker compose up -d postgres
```
### v1.0.0 (2025-01-11)
**API请求失败**
- 检查后端服务是否正常启动
- 确认API地址和端口配置正确
- 查看浏览器网络面板的错误信息
- 检查JWT Token是否有效
#### 重要修复
- **月度重置功能修复** - 修复了月度重置显示错误的问题
- **错误处理优化** - 改进了错误处理和用户反馈
- **代码清理** - 移除了不必要的调试代码和临时文件
### 日志查看
#### 功能优化
- **导出功能精简** - 保留CSV和ZIP格式，移除JSON和Excel格式
- **数据管理简化** - 移除了复杂的数据修复功能
- **界面优化** - 改进了用户界面的响应性和易用性
```bash
# 查看后端日志
docker compose logs -f backend
#### 技术改进
- **存储错误处理** - 增强了LocalStorage操作的错误处理
- **方法调用修复** - 修复了未定义方法调用的问题
- **调试信息优化** - 添加了更好的调试和错误信息
# 查看前端构建日志
npm run dev
# 查看数据库日志
docker compose logs postgres
```
## 📞 技术支持
## �📞 技术支持
如遇到问题，请查看：
1. 项目文档和使用指南
2. 浏览器控制台错误信息
3. 系统日志输出
### 🔍 问题诊断步骤
1. **查看系统状态** - 确认所有服务正常运行
2. **检查日志输出** - 查看详细的错误信息
3. **验证配置** - 确认环境变量和配置文件正确
4. **测试API** - 使用Swagger文档测试API接口
5. **浏览器调试** - 检查浏览器控制台和网络面板
### 📚 参考资源
- **API文档**: http://localhost:8000/docs
- **FastAPI官方文档**: https://fastapi.tiangolo.com/
- **Vue 3官方文档**: https://vuejs.org/
- **Element Plus文档**: https://element-plus.org/
## 🤝 贡献指南
### 开发流程
1. **Fork项目** - 创建项目分支
2. **本地开发** - 在本地环境进行开发和测试
3. **代码规范** - 遵循项目的代码规范和最佳实践
4. **测试验证** - 确保新功能正常工作且不影响现有功能
5. **提交PR** - 提交Pull Request并描述变更内容
### 代码规范
- **Python**: 遵循PEP 8规范
- **JavaScript**: 使用ESLint和Prettier
- **Vue**: 遵循Vue官方风格指南
- **Git**: 使用语义化的提交信息
## 📄 许可证
本项目仅供内部使用。
本项目采用 MIT 许可证。详见 [LICENSE](LICENSE) 文件。
---
**绩效计分系统** - 让绩效管理更简单、更高效！
**绩效计分系统** - 现代化的企业级绩效管理解决方案
🌟 如果这个项目对您有帮助，请给我们一个Star！
VERSION.md deleted 100644 → 0
# 绩效计分系统 - 版本信息
## 当前版本：v1.0.0
### 发布日期：2025-01-11
## 📋 版本特性
### 核心功能
- ✅ **用户管理系统** - 完整的用户CRUD操作
- ✅ **机构管理功能** - 机构信息管理和权限控制
- ✅ **图片上传统计** - 实时图片上传统计和管理
- ✅ **绩效评分计算** - 自动计算互动分数和绩效分数
- ✅ **数据导出功能** - 支持CSV和ZIP格式导出
- ✅ **月度重置机制** - 手动月度数据重置和历史备份
- ✅ **历史数据管理** - 月度统计数据查看和管理
- ✅ **响应式设计** - 适配各种设备屏幕
### 技术栈
- **前端框架**：Vue 3.3.8
- **UI组件库**：Element Plus 2.4.4
- **状态管理**：Pinia 2.1.7
- **路由管理**：Vue Router 4.2.5
- **构建工具**：Vite 5.0.0
- **后端框架**：Express.js 5.1.0
- **数据存储**：LocalStorage + JSON
### 工具库
- **文件处理**：XLSX 0.18.5, jsPDF 3.0.1, JSZip 3.10.1
- **图片处理**：html2canvas 1.4.1
- **文件下载**：file-saver 2.0.5
- **工具函数**：lodash-es 4.17.21, uuid 11.1.0
## 🔄 更新日志
### v1.0.0 (2025-01-11) - 正式版本
#### 🔧 重要修复
- **月度重置功能修复** - 修复了月度重置显示错误的问题
- **错误处理优化** - 改进了错误处理和用户反馈机制
- **存储操作增强** - 增强了LocalStorage操作的错误处理
#### ⚡ 功能优化
- **导出功能精简** - 保留CSV和ZIP格式，移除JSON和Excel格式
- **数据管理简化** - 移除了复杂的数据修复功能，保留核心功能
- **界面优化** - 改进了用户界面的响应性和易用性
- **月度重置改进** - 改为仅手动重置，移除自动重置机制
#### 🧹 代码清理
- **文件整理** - 删除了临时文件、测试文件和重复文档
- **项目结构优化** - 重新组织了项目目录结构
- **文档完善** - 创建了完整的README和使用指南
#### 🛠️ 技术改进
- **方法调用修复** - 修复了未定义方法调用的问题
- **调试信息优化** - 添加了更好的调试和错误信息
- **启动脚本优化** - 简化了启动流程和脚本
### 修复问题
- 🐛 修复了数据加载异常的问题
- 🐛 修复了界面显示不一致的问题
- 🐛 修复了用户权限验证的问题
### 技术栈
- Vue 3.4.29
- Element Plus 2.7.6
- Vite 5.4.19
- Node.js 环境
### 部署说明
- 支持开发环境快速启动
- 准备Docker容器化部署
- 计划支持多用户实时数据同步
---
## 下一版本计划 (8.9)
- 🔄 多用户多浏览器数据同步
- 📡 WebSocket实时通信
- 🔐 增强安全性和权限管理
backend/.env deleted 100644 → 0
# 数据库配置
DATABASE_URL=postgresql://performance_user:performance_pass@localhost:5431/performance_db
# API 服务配置
API_HOST=0.0.0.0
API_PORT=8000
# CORS 配置（JSON 数组格式）
CORS_ORIGINS=["http://localhost:5173","http://localhost:8080","http://localhost:4001"]
# 安全配置
SECRET_KEY=your-secret-key-here-change-in-production
# 日志配置
LOG_LEVEL=INFO
LOG_FILE=logs/api.log
# 数据迁移配置
MIGRATION_BATCH_SIZE=100
backend/.env.example deleted 100644 → 0
# 数据库配置
DATABASE_URL=postgresql://performance_user:performance_pass@localhost:5431/performance_db
# API 服务配置
API_HOST=0.0.0.0
API_PORT=8000
# CORS 配置（JSON 数组格式）
CORS_ORIGINS=["http://localhost:5173","http://localhost:8080","http://localhost:4001"]
# 安全配置
SECRET_KEY=your-secret-key-here-change-in-production
# 日志配置
LOG_LEVEL=INFO
LOG_FILE=logs/api.log
# 数据迁移配置
MIGRATION_BATCH_SIZE=100
backend/check_table_structure.py deleted 100644 → 0
#!/usr/bin/env python3
"""
检查数据库表结构脚本
"""
import asyncio
from sqlalchemy import text
from database import database
import logging
# 配置日志
logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)
async def check_table_structure():
"""检查 monthly_history 表结构"""
try:
# 连接数据库
await database.connect()
logger.info("已连接到数据库")
# 查询表结构
query = text("""
SELECT column_name, data_type, is_nullable
FROM information_schema.columns
WHERE table_name = 'monthly_history'
ORDER BY ordinal_position;
""")
result = await database.fetch_all(query)
logger.info("monthly_history 表结构:")
logger.info("-" * 50)
for row in result:
logger.info(f"列名: {row['column_name']}, 类型: {row['data_type']}, 可空: {row['is_nullable']}")
# 检查是否存在 institutions_data 列
institutions_data_exists = any(row['column_name'] == 'institutions_data' for row in result)
if institutions_data_exists:
logger.info("✅ institutions_data 列存在")
else:
logger.error("❌ institutions_data 列不存在")
# 尝试添加列
logger.info("正在尝试添加 institutions_data 列...")
alter_query = text("""
ALTER TABLE monthly_history
ADD COLUMN institutions_data JSONB;
""")
await database.execute(alter_query)
logger.info("✅ 成功添加 institutions_data 列")
await database.disconnect()
logger.info("数据库连接已关闭")
except Exception as e:
logger.error(f"❌ 检查表结构失败: {e}")
raise
if __name__ == "__main__":
asyncio.run(check_table_structure())
backend/config.py
......@@ -37,7 +37,7 @@ class Settings(BaseSettings):
MAX_IMAGES_PER_INSTITUTION: int = 10
# CORS 配置
CORS_ORIGINS: str = "*" # 简化为字符串格式，避免 JSON 解析问题
CORS_ORIGINS: str = "http://localhost:5173,http://localhost:4001,http://localhost:8080" # 允许的前端域名
# WebSocket 配置
WEBSOCKET_HEARTBEAT_INTERVAL: int = 30
......@@ -56,7 +56,8 @@ class Settings(BaseSettings):
MIGRATION_BATCH_SIZE: int = 100
class Config:
env_file = ".env"
# 从项目根目录读取 .env 文件
env_file = os.path.join(os.path.dirname(os.path.dirname(__file__)), ".env")
case_sensitive = True
extra = "ignore" # 忽略额外的环境变量
......
backend/main.py
......@@ -96,14 +96,22 @@ app = FastAPI(
cors_origins = settings.CORS_ORIGINS
if isinstance(cors_origins, str):
if cors_origins == "*":
# 当允许所有来源时，不能同时设置 allow_credentials=True
cors_origins = ["*"]
allow_credentials = False
else:
cors_origins = [cors_origins]
# 支持逗号分隔的多个域名
cors_origins = [origin.strip() for origin in cors_origins.split(",")]
allow_credentials = True
else:
allow_credentials = True
logger.info(f"🌐 CORS配置: origins={cors_origins}, credentials={allow_credentials}")
app.add_middleware(
CORSMiddleware,
allow_origins=cors_origins,
allow_credentials=True,
allow_credentials=allow_credentials,
allow_methods=["GET", "POST", "PUT", "DELETE", "OPTIONS"],
allow_headers=["*"],
)
......
backend/migrate_add_institutions_data.py deleted 100644 → 0
#!/usr/bin/env python3
"""
数据库迁移脚本：为 monthly_history 表添加 institutions_data 列
"""
import asyncio
from sqlalchemy import text
from database import database, engine
import logging
# 配置日志
logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)
async def migrate_database():
"""执行数据库迁移"""
try:
# 连接数据库
await database.connect()
logger.info("已连接到数据库")
# 检查列是否已存在
check_column_query = text("""
SELECT column_name
FROM information_schema.columns
WHERE table_name = 'monthly_history'
AND column_name = 'institutions_data';
""")
result = await database.fetch_all(check_column_query)
if result:
logger.info("institutions_data 列已存在，无需迁移")
else:
# 添加 institutions_data 列
alter_query = text("""
ALTER TABLE monthly_history
ADD COLUMN institutions_data JSONB;
""")
await database.execute(alter_query)
logger.info("✅ 成功添加 institutions_data 列")
# 验证列是否添加成功
verify_result = await database.fetch_all(check_column_query)
if verify_result:
logger.info("✅ 验证成功：institutions_data 列已添加")
else:
logger.error("❌ 验证失败：institutions_data 列未添加")
await database.disconnect()
logger.info("数据库连接已关闭")
except Exception as e:
logger.error(f"❌ 数据库迁移失败: {e}")
raise
if __name__ == "__main__":
asyncio.run(migrate_database())
backend/routers/history.py
......@@ -7,6 +7,7 @@ from fastapi import APIRouter, HTTPException, Depends
from typing import List, Dict, Any
from loguru import logger
from datetime import datetime
from sqlalchemy import func
from database import monthly_history_table, get_database, DatabaseManager
from models import MonthlyHistoryCreate, MonthlyHistoryResponse, BaseResponse, UserResponse
......@@ -15,13 +16,14 @@ from dependencies import get_current_active_user, require_admin
router = APIRouter()
@router.get("/", response_model=List[MonthlyHistoryResponse], summary="获取所有历史记录")
@router.get("", response_model=List[MonthlyHistoryResponse], summary="获取所有历史记录")
async def get_all_history(
db: DatabaseManager = Depends(get_database),
current_user: UserResponse = Depends(get_current_active_user)
):
"""获取所有月度历史统计记录"""
try:
# 简单查询，让数据库处理字段选择
query = monthly_history_table.select().order_by(monthly_history_table.c.month.desc())
histories = await db.fetch_all(query)
......@@ -29,9 +31,11 @@ async def get_all_history(
for history in histories:
try:
# 安全地获取 institutions_data，确保兼容性
institutions_data = history["institutions_data"] if "institutions_data" in history._mapping else []
if institutions_data is None:
institutions_data = []
if hasattr(history, '_mapping') and "institutions_data" in history._mapping:
institutions_data = history["institutions_data"] or []
elif hasattr(history, 'institutions_data'):
institutions_data = history.institutions_data or []
result.append(MonthlyHistoryResponse(
id=history["id"],
......@@ -45,7 +49,7 @@ async def get_all_history(
created_at=history["created_at"]
))
except Exception as e:
history_id = history["id"] if "id" in history._mapping else "unknown"
history_id = history.get("id", "unknown")
logger.error(f"处理历史记录失败: {history_id}, 错误: {e}")
# 跳过有问题的记录，继续处理其他记录
continue
......@@ -54,6 +58,10 @@ async def get_all_history(
except Exception as e:
logger.error(f"获取历史记录失败: {e}")
# 如果是表不存在或字段不存在的错误，返回空列表而不是抛出异常
if "does not exist" in str(e).lower():
logger.info("历史记录表或字段不存在，返回空列表")
return []
raise HTTPException(status_code=500, detail="获取历史记录失败")
......@@ -99,7 +107,7 @@ async def get_history_by_month(
raise HTTPException(status_code=500, detail="获取历史记录失败")
@router.post("/", response_model=BaseResponse, summary="保存月度历史记录")
@router.post("", response_model=BaseResponse, summary="保存月度历史记录")
async def save_monthly_history(
history_data: Dict[str, Any], # 改为更灵活的字典类型
db: DatabaseManager = Depends(get_database),
......@@ -195,7 +203,7 @@ async def save_monthly_history(
raise HTTPException(status_code=500, detail=f"保存历史记录失败: {str(e)}")
@router.delete("/", response_model=BaseResponse, summary="清空所有历史记录")
@router.delete("", response_model=BaseResponse, summary="清空所有历史记录")
async def clear_all_history(
db: DatabaseManager = Depends(get_database),
current_user: UserResponse = Depends(require_admin)
......
backend/routers/institutions.py
......@@ -59,7 +59,7 @@ async def get_institution_with_images(institution_id: str, db: DatabaseManager):
)
@router.get("/", response_model=List[InstitutionResponse], summary="获取机构列表")
@router.get("", response_model=List[InstitutionResponse], summary="获取机构列表")
async def get_all_institutions(
db: DatabaseManager = Depends(get_database),
current_user: UserResponse = Depends(get_current_active_user)
......@@ -141,7 +141,7 @@ async def get_institutions_by_owner(
raise HTTPException(status_code=500, detail="获取机构失败")
@router.post("/", response_model=InstitutionResponse, summary="创建机构")
@router.post("", response_model=InstitutionResponse, summary="创建机构")
async def create_institution(
institution_data: InstitutionCreate,
db: DatabaseManager = Depends(get_database),
......
backend/routers/system_config.py
......@@ -14,7 +14,7 @@ from dependencies import get_current_active_user, require_admin
router = APIRouter()
@router.get("/", response_model=Dict[str, Any], summary="获取所有系统配置")
@router.get("", response_model=Dict[str, Any], summary="获取所有系统配置")
async def get_all_config(
db: DatabaseManager = Depends(get_database),
current_user: UserResponse = Depends(get_current_active_user)
......@@ -79,7 +79,7 @@ async def get_config_by_key(config_key: str, db: DatabaseManager = Depends(get_d
raise HTTPException(status_code=500, detail="获取配置项失败")
@router.post("/", response_model=BaseResponse, summary="创建或更新配置项")
@router.post("", response_model=BaseResponse, summary="创建或更新配置项")
async def set_config(
config_item: SystemConfigItem,
db: DatabaseManager = Depends(get_database),
......
backend/routers/users.py
......@@ -22,7 +22,7 @@ from config import settings
router = APIRouter()
@router.get("/", response_model=List[UserResponse], summary="获取所有用户")
@router.get("", response_model=List[UserResponse], summary="获取所有用户")
async def get_all_users(
db: DatabaseManager = Depends(get_database),
current_user: UserResponse = Depends(require_admin)
......@@ -85,7 +85,7 @@ async def get_user_by_id(
raise HTTPException(status_code=500, detail="获取用户失败")
@router.post("/", response_model=UserResponse, summary="创建用户")
@router.post("", response_model=UserResponse, summary="创建用户")
async def create_user(
user_data: UserCreate,
db: DatabaseManager = Depends(get_database),
......
backend/update_db.py deleted 100644 → 0
#!/usr/bin/env python3
"""
数据库表结构更新脚本
为 monthly_history 表添加 institutions_data 字段
"""
import asyncio
import asyncpg
from loguru import logger
async def update_database():
"""更新数据库表结构"""
try:
# 连接数据库
conn = await asyncpg.connect(
host="localhost",
port=5432,
user="performance_user",
password="performance_pass",
database="performance_db"
)
logger.info("✅ 数据库连接成功")
# 检查字段是否已存在
check_query = """
SELECT column_name
FROM information_schema.columns
WHERE table_name = 'monthly_history'
AND column_name = 'institutions_data'
"""
result = await conn.fetch(check_query)
if result:
logger.info("✅ institutions_data 字段已存在，无需更新")
else:
# 添加字段
alter_query = """
ALTER TABLE monthly_history
ADD COLUMN institutions_data JSONB
"""
await conn.execute(alter_query)
logger.info("✅ 成功添加 institutions_data 字段")
# 添加注释
comment_query = """
COMMENT ON COLUMN monthly_history.institutions_data
IS '机构图片数据，包含完整的机构和图片信息'
"""
await conn.execute(comment_query)
logger.info("✅ 成功添加字段注释")
# 验证更新结果
verify_query = """
SELECT column_name, data_type, is_nullable
FROM information_schema.columns
WHERE table_name = 'monthly_history'
AND column_name = 'institutions_data'
"""
result = await conn.fetch(verify_query)
if result:
row = result[0]
logger.info(f"✅ 字段验证成功: {row['column_name']} ({row['data_type']}, nullable: {row['is_nullable']})")
else:
logger.error("❌ 字段验证失败")
await conn.close()
logger.info("✅ 数据库连接已关闭")
except Exception as e:
logger.error(f"❌ 数据库更新失败: {e}")
raise
if __name__ == "__main__":
asyncio.run(update_database())
cursorrules deleted 100644 → 0
# 系统开发规则文档 (Cursor Rules)
## 项目概述
开发一个基于Web的记分管理系统，支持多用户登录、机构管理、图片上传、得分计算等功能。
## 技术栈要求
- 前端框架：Vue.js 3 + Composition API
- 状态管理：Pinia
- 路由管理：Vue Router
- UI框架：Element Plus
- 数据持久化：localStorage
- 构建工具：Vite
## 代码结构规范
```
src/
├── assets/ # 静态资源
├── components/ # 公共组件
├── views/ # 页面组件
│ ├── auth/ # 认证相关页面
│ ├── user/ # 用户操作页面
│ └── admin/ # 管理员页面
├── store/ # 状态管理
├── router/ # 路由配置
├── utils/ # 工具函数
└── styles/ # 样式文件
```
## 功能模块实现规则
### 1. 用户认证模块
#### 登录功能
```javascript
// 实现规则
1. 手机号作为用户名登录
2. 管理员可重置用户密码
3. 密码存储需加密处理
4. 登录状态持久化保存
```
#### 用户权限控制
```javascript
// 权限级别
- 管理员：拥有所有权限
- 普通用户：仅能操作自己负责的机构
```
### 2. 用户操作界面
#### 机构搜索筛选
```javascript
// 实现规则
1. 支持按机构名称模糊搜索
2. 支持按上传状态筛选
3. 无匹配机构时显示提示信息
4. 搜索结果实时更新
```
#### 图片上传功能
```javascript
// 实现规则
1. 每个机构最多上传10张图片
2. 支持图片预览功能
3. 上传记录按时间倒序排列
4. 点击图片可查看大图
5. 支持图片删除操作
```
### 3. 管理员功能模块
#### 用户管理
```javascript
// 实现规则
1. 添加用户时需设置初始密码
2. 删除用户前必须转移其负责机构
3. 用户列表显示负责机构数量
4. 支持批量操作
```
#### 机构管理
```javascript
// 实现规则
1. 单个/批量添加机构
2. 批量删除机构功能
3. 机构调配需选择源用户和目标用户
4. 公池机构可分配给任意用户
```
### 4. 得分计算系统
#### 互动得分计算
```javascript
// 计算逻辑
1. 每个机构：
- 0张图片 = 0分
- 1张图片 = 0.5分
- 2张及以上图片 = 1分
2. 用户总互动得分 = 所有负责机构得分之和
```
#### 绩效得分计算
```javascript
// 计算公式
绩效得分 = (互动得分 ÷ 负责机构数) × 10
注意：负责机构数为0时，绩效得分为0
```
## 数据结构规范
### 用户数据结构
```javascript
{
id: 'unique_id',
phone: '手机号',
password: '加密密码',
name: '用户姓名',
role: 'admin/user',
institutions: ['机构ID数组']
}
```
### 机构数据结构
```javascript
{
id: 'unique_id',
name: '机构名称',
ownerId: '负责人ID',
images: [
{
id: '图片ID',
url: '图片URL',
uploadTime: '上传时间'
}
]
}
```
### 系统配置数据
```javascript
{
defaultUsers: [
{ name: '陈锐屏', institutions: ['A', 'B', 'C', 'D', 'E'] },
{ name: '张田田', institutions: ['a', 'b', 'c', 'd', 'e'] },
{ name: '余芳飞', institutions: ['①', '②', '③', '④', '⑤'] }
]
}
```
## localStorage存储规范
### 存储键名定义
```javascript
const STORAGE_KEYS = {
USERS: 'score_system_users',
INSTITUTIONS: 'score_system_institutions',
CURRENT_USER: 'score_system_current_user',
SYSTEM_CONFIG: 'score_system_config'
}
```
### 数据持久化规则
```javascript
1. 所有数据变更实时同步到localStorage
2. 页面加载时从localStorage恢复数据
3. 提供数据初始化功能
4. 支持数据导出/导入功能
```
## 界面设计规范
### 页面布局要求
```css
/* 响应式设计 */
1. 支持移动端访问
2. 主要操作区域清晰可见
3. 得分统计区域固定显示
4. 操作按钮醒目易用
```
### UI组件规范
```javascript
// 使用Element Plus组件
1. 表格：展示机构列表和用户列表
2. 表单：用户登录和数据录入
3. 对话框：确认操作和信息提示
4. 图片预览：图片查看功能
5. 进度条：得分可视化展示
```
## 错误处理规范
### 异常情况处理
```javascript
1. 网络异常：显示友好提示
2. 数据异常：提供恢复机制
3. 权限异常：跳转到登录页面
4. 操作异常：显示错误原因
```
## 性能优化规则
### 前端性能优化
```javascript
1. 图片懒加载
2. 数据分页加载
3. 组件按需加载
4. 防抖节流处理
```
## 安全规范
### 数据安全
```javascript
1. 密码加密存储
2. 敏感操作二次确认
3. 用户权限验证
4. 输入数据校验
```
## 测试要求
### 功能测试覆盖
```javascript
1. 用户登录流程
2. 图片上传下载
3. 得分计算准确性
4. 数据持久化验证
5. 权限控制验证
```
### 兼容性测试
```javascript
1. 主流浏览器支持
2. 移动端适配测试
3. 不同分辨率适配
```
## 开发约定
### 代码风格
```javascript
1. 使用ESLint代码检查
2. 遵循Vue.js风格指南
3. 函数命名语义化
4. 注释完整清晰
```
### 版本管理
```bash
# Git提交规范
feat: 新功能开发
fix: bug修复
style: 代码样式调整
refactor: 代码重构
test: 测试相关
docs: 文档更新
```
deploy.bat deleted 100644 → 0
@echo off
chcp 65001 >nul
echo ================================
echo 绩效计分系统 Docker 部署脚本
echo ================================
echo.
echo [1/6] 检查Docker环境...
docker --version >nul 2>&1
if %errorlevel% neq 0 (
echo ❌ Docker未安装或未启动，请先安装Docker Desktop
pause
exit /b 1
)
docker-compose --version >nul 2>&1
if %errorlevel% neq 0 (
echo ❌ Docker Compose未安装
pause
exit /b 1
)
echo ✅ Docker环境检查通过
echo.
echo [2/6] 停止现有容器...
docker-compose down
echo.
echo [3/6] 清理旧镜像（可选）...
set /p cleanup="是否清理旧镜像？(y/N): "
if /i "%cleanup%"=="y" (
docker system prune -f
echo ✅ 清理完成
)
echo.
echo [4/6] 构建应用镜像...
docker-compose build --no-cache
if %errorlevel% neq 0 (
echo ❌ 镜像构建失败
pause
exit /b 1
)
echo ✅ 镜像构建完成
echo.
echo [5/6] 启动服务...
docker-compose up -d
if %errorlevel% neq 0 (
echo ❌ 服务启动失败
pause
exit /b 1
)
echo ✅ 服务启动完成
echo.
echo [6/6] 检查服务状态...
timeout /t 10 /nobreak >nul
docker-compose ps
echo.
echo ================================
echo 🎉 部署完成！
echo ================================
echo.
echo 📋 服务信息：
echo - 主应用: http://localhost:8080
echo - API接口: http://localhost:4001
echo - 数据库: localhost:5432
echo - Redis: localhost:6379
echo.
echo 📊 监控命令：
echo - 查看日志: docker-compose logs -f
echo - 查看状态: docker-compose ps
echo - 停止服务: docker-compose down
echo.
echo 🔧 管理命令：
echo - 重启服务: docker-compose restart
echo - 更新服务: docker-compose pull && docker-compose up -d
echo.
echo 正在检查服务健康状态...
timeout /t 5 /nobreak >nul
curl -s http://localhost:8080/health >nul 2>&1
if %errorlevel% equ 0 (
echo ✅ 应用服务正常
) else (
echo ⚠️ 应用服务可能还在启动中，请稍后检查
)
echo.
echo 按任意键打开应用...
pause >nul
start http://localhost:8080
docker-deploy.bat deleted 100644 → 0
@echo off
setlocal ENABLEDELAYEDEXPANSION
cd /d "%~dp0"
echo ========================================
echo 绩效计分系统 8.8 版本 - Docker 部署
echo ========================================
set CONTAINER_NAME=scoring-system-8.8
set IMAGE_NAME=scoring-system:8.8
set PORT=4001
echo [1/4] 检查 Docker 环境...
docker --version >nul 2>&1
if errorlevel 1 (
echo ❌ Docker 未安装或未启动
pause
exit /b 1
)
echo [2/4] 停止并移除旧容器（如果存在）...
docker stop %CONTAINER_NAME% >nul 2>&1
docker rm %CONTAINER_NAME% >nul 2>&1
echo [3/4] 构建最新镜像...
docker build -t %IMAGE_NAME% .
if errorlevel 1 (
echo ❌ 镜像构建失败
pause
exit /b 1
)
echo [4/4] 启动容器...
docker run -d -p %PORT%:80 --name %CONTAINER_NAME% %IMAGE_NAME%
if errorlevel 1 (
echo ❌ 容器启动失败
pause
exit /b 1
)
echo.
echo ✅ 部署成功！
echo.
echo 🌐 访问地址: http://localhost:%PORT%/
echo 📊 容器状态: docker ps
echo 📋 查看日志: docker logs %CONTAINER_NAME%
echo 🛑 停止服务: docker stop %CONTAINER_NAME%
echo.
echo 默认登录账号:
echo - 管理员: admin / admin123
echo - 张田田: 13800138002 / 123456
echo - 陈锐屏: 13800138001 / 123456
echo - 余芳飞: 13800138003 / 123456
echo.
pause
docker-manage.bat deleted 100644 → 0
@echo off
setlocal ENABLEDELAYEDEXPANSION
cd /d "%~dp0"
set CONTAINER_NAME=scoring-system-8.8
set IMAGE_NAME=scoring-system:8.8
:menu
echo.
echo ========================================
echo 绩效计分系统 8.8 版本 - Docker 管理
echo ========================================
echo.
echo 1. 查看容器状态
echo 2. 查看容器日志
echo 3. 重启容器
echo 4. 停止容器
echo 5. 启动容器
echo 6. 删除容器
echo 7. 重新构建并部署
echo 8. 打开浏览器访问
echo 0. 退出
echo.
set /p choice=请选择操作 (0-8):
if "%choice%"=="1" goto status
if "%choice%"=="2" goto logs
if "%choice%"=="3" goto restart
if "%choice%"=="4" goto stop
if "%choice%"=="5" goto start
if "%choice%"=="6" goto remove
if "%choice%"=="7" goto rebuild
if "%choice%"=="8" goto open
if "%choice%"=="0" goto exit
echo 无效选择，请重试
goto menu
:status
echo.
echo 容器状态:
docker ps -a --filter name=%CONTAINER_NAME%
goto menu
:logs
echo.
echo 容器日志 (最近50行):
docker logs --tail 50 %CONTAINER_NAME%
goto menu
:restart
echo.
echo 重启容器...
docker restart %CONTAINER_NAME%
echo 重启完成
goto menu
:stop
echo.
echo 停止容器...
docker stop %CONTAINER_NAME%
echo 停止完成
goto menu
:start
echo.
echo 启动容器...
docker start %CONTAINER_NAME%
echo 启动完成
goto menu
:remove
echo.
echo 删除容器...
docker stop %CONTAINER_NAME% >nul 2>&1
docker rm %CONTAINER_NAME%
echo 删除完成
goto menu
:rebuild
echo.
echo 重新构建并部署...
docker stop %CONTAINER_NAME% >nul 2>&1
docker rm %CONTAINER_NAME% >nul 2>&1
docker build -t %IMAGE_NAME% .
docker run -d -p 4001:80 --name %CONTAINER_NAME% %IMAGE_NAME%
echo 重新部署完成
goto menu
:open
echo.
echo 打开浏览器...
start http://localhost:4001/
goto menu
:exit
echo 退出管理工具
exit /b 0
docs/.gitkeep deleted 100644 → 0
# 文档目录
此目录包含项目相关的文档文件。
docs/使用指南.md deleted 100644 → 0
# 绩效计分系统 - 完整使用指南
++ /dev/null
# 绩效计分系统 - 完整使用指南
## 🎯 系统概述
绩效计分系统是一个基于Web的现代化应用，专为机构图片上传和绩效评分管理而设计。系统支持多用户角色、实时得分计算、数据统计分析等功能。
## 🚀 快速开始
### 环境要求
- Node.js >= 16.0.0
- 现代浏览器（Chrome、Firefox、Edge等）
### 启动系统
1. **开发环境启动**
```bash
npm run dev
```
或双击 `启动开发服务器.bat`
2. **生产环境启动**
```bash
npm run build
npm run preview
```
或双击 `启动生产环境.bat`
3. **访问系统**
- 开发环境：http://localhost:4001
- 生产环境：http://localhost:4001
## 👤 用户角色
### 管理员 (admin)
- **默认账号**：admin / admin123
- **权限**：系统完全控制权限
- **功能**：用户管理、机构管理、数据统计、系统配置
### 普通用户 (user)
- **账号**：由管理员创建
- **权限**：仅能访问分配的机构
- **功能**：图片上传、查看个人统计
## 🔐 登录系统
1. 打开浏览器访问系统地址
2. 在登录页面输入用户名和密码
3. 点击"登录"按钮
4. 系统会根据用户角色跳转到相应界面
## 👨‍💼 管理员功能详解
### 1. 数据统计
- **总体统计**：用户数、机构数、图片数
- **用户排名**：按绩效分数排序
- **上传统计**：图片上传情况分析
- **实时更新**：数据自动刷新
### 2. 用户管理
- **添加用户**：创建新用户账号
- **编辑用户**：修改用户信息
- **重置密码**：重置用户密码为123456
- **删除用户**：删除用户及相关数据
### 3. 机构管理
- **添加机构**：创建新机构
- **批量导入**：Excel批量导入机构
- **机构转移**：转移机构所有权
- **删除机构**：删除机构及图片数据
### 4. 数据管理
- **数据备份**：导出系统数据
- **数据恢复**：导入备份数据
- **月度重置**：清空图片数据，保存历史统计
### 5. 历史统计
- **月度数据**：查看历史月份统计
- **数据导出**：导出历史数据
- **数据删除**：删除指定月份数据
## 👤 用户功能详解
### 1. 机构查看
- **机构列表**：查看分配的机构
- **机构详情**：查看机构基本信息
- **图片统计**：查看已上传图片数量
### 2. 图片上传
- **选择机构**：选择要上传图片的机构
- **上传图片**：支持多种图片格式
- **查看图片**：查看已上传的图片
- **删除图片**：删除不需要的图片
### 3. 个人统计
- **绩效分数**：查看个人绩效评分
- **互动分数**：查看互动活跃度
- **上传统计**：查看上传图片统计
## 📊 评分规则
### 互动分数计算
- **基础分**：每个机构10分
- **上传奖励**：每上传1张图片+2分
- **完成奖励**：机构图片数≥5张时+10分
### 绩效分数计算
- **上传率权重**：40%
- **平均图片数权重**：35%
- **互动分数权重**：25%
## 📁 数据导出功能
### 支持格式
- **CSV格式**：表格数据导出
- **ZIP格式**：图片打包下载
### 导出内容
- **用户数据**：用户信息和统计数据
- **历史数据**：月度统计数据
- **图片数据**：机构图片文件
## 🔄 月度重置功能
### 重置内容
1. **保存统计**：当前月份数据保存到历史记录
2. **清空图片**：删除所有机构的图片数据
3. **重置分数**：用户分数重新计算
4. **更新时间**：记录重置时间
### 注意事项
- ⚠️ **不可逆操作**：重置后无法恢复
- 📅 **建议时机**：每月初执行
- 💾 **数据备份**：重置前建议备份数据
## 🛠️ 常见问题
### Q1: 忘记密码怎么办？
**A**: 联系管理员重置密码，重置后密码为123456
### Q2: 图片上传失败？
**A**: 检查图片格式和大小，确保网络连接正常
### Q3: 数据丢失怎么办？
**A**: 使用数据备份功能恢复，建议定期备份
### Q4: 系统运行缓慢？
**A**: 清理浏览器缓存，检查网络连接
### Q5: 无法访问某些功能？
**A**: 检查用户权限，确认是否有相应操作权限
## 📞 技术支持
### 故障排查
1. **检查浏览器控制台**：查看错误信息
2. **清理浏览器缓存**：解决显示问题
3. **重启系统**：解决临时故障
4. **检查网络连接**：确保网络正常
### 联系方式
- 查看系统日志获取详细错误信息
- 参考项目文档和README文件
## 📋 最佳实践
### 管理员建议
1. **定期备份**：每周备份系统数据
2. **用户培训**：为新用户提供使用培训
3. **权限管理**：合理分配用户权限
4. **数据监控**：定期检查数据完整性
### 用户建议
1. **及时上传**：按时上传机构图片
2. **图片质量**：确保图片清晰可用
3. **定期查看**：关注个人绩效数据
4. **问题反馈**：及时反馈使用问题
---
**绩效计分系统** - 让绩效管理更简单、更高效！
docs/部署指南.md deleted 100644 → 0
# 绩效计分系统 - 部署指南
++ /dev/null
# 绩效计分系统 - 部署指南
## 📋 系统要求
### 最低要求
- **操作系统**: Windows 7/8/10/11, macOS 10.14+, Ubuntu 18.04+
- **Node.js**: 16.0 或更高版本
- **内存**: 至少 2GB RAM
- **硬盘**: 至少 500MB 可用空间
- **浏览器**: Chrome、Firefox、Edge（推荐Chrome）
### 推荐配置
- **操作系统**: Windows 10/11, macOS 12+, Ubuntu 20.04+
- **Node.js**: 18.0 或更高版本
- **内存**: 4GB RAM 或更多
- **硬盘**: 1GB 可用空间
- **网络**: 稳定的网络连接
## 🚀 快速部署
### 方案一：开发环境部署
适用于：开发、测试、演示
```bash
# 1. 安装依赖
npm install
# 2. 启动开发服务器
npm run dev
# 3. 访问系统
# 浏览器打开 http://localhost:4001
```
**Windows用户可直接双击**：`启动开发服务器.bat`
### 方案二：生产环境部署
适用于：正式使用、生产环境
```bash
# 1. 安装依赖
npm install
# 2. 构建项目
npm run build
# 3. 启动生产服务器
npm run preview
```
**Windows用户可直接双击**：`启动生产环境.bat`
## 🐳 Docker部署
### 使用Docker Compose（推荐）
```bash
# 1. 构建并启动
docker-compose up -d
# 2. 查看状态
docker-compose ps
# 3. 停止服务
docker-compose down
```
### 手动Docker部署
```bash
# 1. 构建镜像
docker build -t score-system .
# 2. 运行容器
docker run -d -p 4001:4001 --name score-system score-system
# 3. 查看日志
docker logs score-system
```
## ⚙️ 配置说明
### 端口配置
默认端口：4001
修改端口：编辑 `vite.config.js`
```javascript
export default defineConfig({
server: {
port: 4001, // 修改为其他端口
host: '0.0.0.0'
}
})
```
### 环境变量
创建 `.env` 文件：
```env
# 端口配置
VITE_PORT=4001
# API地址（如果有后端API）
VITE_API_URL=http://localhost:3000
# 应用标题
VITE_APP_TITLE=绩效计分系统
```
## 🔧 高级配置
### Nginx反向代理
创建 `/etc/nginx/sites-available/score-system`：
```nginx
server {
listen 80;
server_name your-domain.com;
location / {
proxy_pass http://localhost:4001;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_cache_bypass $http_upgrade;
}
}
```
### SSL配置
使用Let's Encrypt：
```bash
# 安装certbot
sudo apt install certbot python3-certbot-nginx
# 获取SSL证书
sudo certbot --nginx -d your-domain.com
# 自动续期
sudo crontab -e
# 添加：0 12 * * * /usr/bin/certbot renew --quiet
```
## 🛠️ 故障排查
### 常见问题
1. **端口被占用**
```bash
# 查看端口占用
netstat -ano | findstr :4001
# 杀死进程
taskkill /PID <PID> /F
```
2. **Node.js版本过低**
```bash
# 检查版本
node --version
# 升级Node.js
# 访问 https://nodejs.org 下载最新版本
```
3. **依赖安装失败**
```bash
# 清理缓存
npm cache clean --force
# 删除node_modules重新安装
rm -rf node_modules package-lock.json
npm install
```
4. **内存不足**
```bash
# 增加Node.js内存限制
export NODE_OPTIONS="--max-old-space-size=4096"
npm run build
```
### 日志查看
- **开发环境**：控制台直接显示
- **生产环境**：检查 `logs/` 目录
- **Docker**：`docker logs <container-name>`
## 📊 性能优化
### 构建优化
```javascript
// vite.config.js
export default defineConfig({
build: {
rollupOptions: {
output: {
manualChunks: {
vendor: ['vue', 'vue-router', 'pinia'],
ui: ['element-plus']
}
}
},
chunkSizeWarningLimit: 1000
}
})
```
### 缓存配置
```nginx
# Nginx缓存配置
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ {
expires 1y;
add_header Cache-Control "public, immutable";
}
```
## 🔒 安全配置
### 基本安全措施
1. **更改默认密码**
- 首次登录后立即更改admin密码
2. **HTTPS配置**
- 生产环境必须使用HTTPS
3. **防火墙设置**
```bash
# Ubuntu防火墙
sudo ufw allow 4001
sudo ufw enable
```
4. **定期备份**
- 设置自动备份计划
- 备份数据到安全位置
## 📋 部署检查清单
### 部署前检查
- [ ] Node.js版本 >= 16.0
- [ ] 端口4001可用
- [ ] 网络连接正常
- [ ] 磁盘空间充足
### 部署后验证
- [ ] 系统可正常访问
- [ ] 登录功能正常
- [ ] 数据上传功能正常
- [ ] 导出功能正常
- [ ] 响应速度正常
### 生产环境检查
- [ ] HTTPS配置完成
- [ ] 防火墙配置正确
- [ ] 备份策略已设置
- [ ] 监控系统已配置
- [ ] 日志轮转已配置
## 📞 技术支持
### 获取帮助
1. 查看项目README.md
2. 检查docs目录下的文档
3. 查看系统日志文件
4. 检查浏览器控制台错误
### 报告问题
请提供以下信息：
- 操作系统和版本
- Node.js版本
- 浏览器类型和版本
- 错误信息截图
- 操作步骤描述
---
**绩效计分系统** - 专业的部署解决方案！
nginx.conf
......@@ -7,9 +7,9 @@ server {
root /usr/share/nginx/html;
index index.html;
# API 代理到后端服务（仅当使用相对路径 /api 时）
# API 代理到后端服务
location /api/ {
proxy_pass http://api:8000/;
proxy_pass http://api:8000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
......
nginx.prod.conf deleted 100644 → 0
events {
worker_connections 1024;
use epoll;
multi_accept on;
}
http {
include /etc/nginx/mime.types;
default_type application/octet-stream;
# 日志格式
log_format main '$remote_addr - $remote_user [$time_local] "$request" '
'$status $body_bytes_sent "$http_referer" '
'"$http_user_agent" "$http_x_forwarded_for"';
access_log /var/log/nginx/access.log main;
error_log /var/log/nginx/error.log warn;
# 性能优化
sendfile on;
tcp_nopush on;
tcp_nodelay on;
keepalive_timeout 65;
keepalive_requests 100;
types_hash_max_size 2048;
server_tokens off;
# 缓冲区设置
client_body_buffer_size 128k;
client_max_body_size 10m;
client_header_buffer_size 1k;
large_client_header_buffers 4 4k;
output_buffers 1 32k;
postpone_output 1460;
# Gzip压缩
gzip on;
gzip_vary on;
gzip_min_length 1024;
gzip_proxied any;
gzip_comp_level 6;
gzip_types
text/plain
text/css
text/xml
text/javascript
application/json
application/javascript
application/xml+rss
application/atom+xml
image/svg+xml;
# 限流配置
limit_req_zone $binary_remote_addr zone=api:10m rate=10r/s;
limit_req_zone $binary_remote_addr zone=login:10m rate=1r/s;
# 上游服务器配置
upstream backend {
least_conn;
server performance-system:80 max_fails=3 fail_timeout=30s;
keepalive 32;
}
# HTTP重定向到HTTPS
server {
listen 80;
server_name _;
return 301 https://$host$request_uri;
}
# HTTPS服务器
server {
listen 443 ssl http2;
server_name localhost;
# SSL配置
ssl_certificate /etc/nginx/ssl/cert.pem;
ssl_certificate_key /etc/nginx/ssl/key.pem;
ssl_session_timeout 1d;
ssl_session_cache shared:SSL:50m;
ssl_session_tickets off;
# 现代SSL配置
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384;
ssl_prefer_server_ciphers off;
# HSTS
add_header Strict-Transport-Security "max-age=63072000" always;
# 安全头
add_header X-Frame-Options "SAMEORIGIN" always;
add_header X-XSS-Protection "1; mode=block" always;
add_header X-Content-Type-Options "nosniff" always;
add_header Referrer-Policy "no-referrer-when-downgrade" always;
add_header Content-Security-Policy "default-src 'self' http: https: data: blob: 'unsafe-inline'" always;
# 静态文件缓存
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
expires 1y;
add_header Cache-Control "public, immutable";
add_header Vary "Accept-Encoding";
}
# API限流
location /api/ {
limit_req zone=api burst=20 nodelay;
proxy_pass http://backend;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_cache_bypass $http_upgrade;
proxy_connect_timeout 5s;
proxy_send_timeout 60s;
proxy_read_timeout 60s;
}
# 登录限流
location /api/login {
limit_req zone=login burst=5 nodelay;
proxy_pass http://backend;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
# WebSocket代理
location /socket.io/ {
proxy_pass http://backend;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_connect_timeout 7d;
proxy_send_timeout 7d;
proxy_read_timeout 7d;
}
# 主应用
location / {
proxy_pass http://backend;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_connect_timeout 5s;
proxy_send_timeout 60s;
proxy_read_timeout 60s;
}
# 健康检查
location /health {
access_log off;
proxy_pass http://backend/health;
}
}
}
scripts/.gitkeep deleted 100644 → 0
# 脚本目录
此目录包含项目的启动和部署脚本。
scripts/clear-cache.bat deleted 100644 → 0
@echo off
chcp 65001 >nul
echo.
echo ==========================================
echo 绩效计分系统 - 清理缓存
echo ==========================================
echo.
echo [1/4] 清理浏览器缓存提示...
echo 请手动清理浏览器缓存：
echo - Chrome: Ctrl+Shift+Delete
echo - Firefox: Ctrl+Shift+Delete
echo - Edge: Ctrl+Shift+Delete
echo.
echo [2/4] 清理Vite缓存...
if exist "node_modules\.vite" (
rmdir /s /q "node_modules\.vite"
echo ✅ Vite缓存已清理
) else (
echo ℹ️ Vite缓存目录不存在
)
echo.
echo [3/4] 清理dist目录...
if exist "dist" (
rmdir /s /q "dist"
echo ✅ dist目录已清理
) else (
echo ℹ️ dist目录不存在
)
echo.
echo [4/4] 重新构建项目...
echo 正在重新安装依赖并构建...
call npm install
call npm run build
echo.
echo ✅ 缓存清理完成！
echo 💡 建议：
echo 1. 重启开发服务器
echo 2. 强制刷新浏览器 (Ctrl+F5)
echo 3. 检查浏览器开发者工具中的网络选项卡，确保禁用缓存
echo.
pause
scripts/clear-cache.ps1 deleted 100644 → 0
# 绩效计分系统 - PowerShell缓存清理脚本
Write-Host ""
Write-Host "==========================================" -ForegroundColor Cyan
Write-Host " 绩效计分系统 - 清理缓存" -ForegroundColor Cyan
Write-Host "==========================================" -ForegroundColor Cyan
Write-Host ""
# 1. 清理Vite缓存
Write-Host "[1/4] 清理Vite缓存..." -ForegroundColor Yellow
if (Test-Path "node_modules\.vite") {
Remove-Item -Recurse -Force "node_modules\.vite"
Write-Host "✅ Vite缓存已清理" -ForegroundColor Green
} else {
Write-Host "ℹ️ Vite缓存目录不存在" -ForegroundColor Yellow
}
Write-Host ""
# 2. 清理dist目录
Write-Host "[2/4] 清理dist目录..." -ForegroundColor Yellow
if (Test-Path "dist") {
Remove-Item -Recurse -Force "dist"
Write-Host "✅ dist目录已清理" -ForegroundColor Green
} else {
Write-Host "ℹ️ dist目录不存在" -ForegroundColor Yellow
}
Write-Host ""
# 3. 清理npm缓存
Write-Host "[3/4] 清理npm缓存..." -ForegroundColor Yellow
try {
npm cache clean --force
Write-Host "✅ npm缓存已清理" -ForegroundColor Green
} catch {
Write-Host "⚠️ npm缓存清理失败" -ForegroundColor Red
}
Write-Host ""
# 4. 重新安装依赖
Write-Host "[4/4] 重新安装依赖..." -ForegroundColor Yellow
try {
npm install
Write-Host "✅ 依赖安装完成" -ForegroundColor Green
} catch {
Write-Host "❌ 依赖安装失败" -ForegroundColor Red
}
Write-Host ""
Write-Host "✅ 缓存清理完成！" -ForegroundColor Green
Write-Host ""
Write-Host "💡 接下来请：" -ForegroundColor Cyan
Write-Host "1. 启动开发服务器: npm run dev" -ForegroundColor White
Write-Host "2. 强制刷新浏览器: Ctrl+F5" -ForegroundColor White
Write-Host "3. 检查浏览器开发者工具，确保禁用缓存" -ForegroundColor White
Write-Host ""
# 询问是否立即启动开发服务器
$response = Read-Host "是否立即启动开发服务器？(y/n)"
if ($response -eq "y" -or $response -eq "Y" -or $response -eq "yes") {
Write-Host ""
Write-Host "🚀 正在启动开发服务器..." -ForegroundColor Green
npm run dev
}
Write-Host ""
Write-Host "按任意键退出..." -ForegroundColor Gray
$null = $Host.UI.RawUI.ReadKey("NoEcho,IncludeKeyDown")
scripts/fix-localhost.ps1 deleted 100644 → 0
# 修复localhost访问问题的脚本
Write-Host ""
Write-Host "==========================================" -ForegroundColor Cyan
Write-Host " 修复localhost访问问题" -ForegroundColor Cyan
Write-Host "==========================================" -ForegroundColor Cyan
Write-Host ""
Write-Host "[1/4] 清理DNS缓存..." -ForegroundColor Yellow
try {
ipconfig /flushdns
Write-Host "✅ DNS缓存已清理" -ForegroundColor Green
} catch {
Write-Host "⚠️ DNS缓存清理失败" -ForegroundColor Yellow
}
Write-Host ""
Write-Host "[2/4] 检查hosts文件..." -ForegroundColor Yellow
$hostsPath = "$env:SystemRoot\System32\drivers\etc\hosts"
$hostsContent = Get-Content $hostsPath -ErrorAction SilentlyContinue
$localhostEntry = $hostsContent | Where-Object { $_ -match "127\.0\.0\.1\s+localhost" }
if ($localhostEntry) {
Write-Host "✅ localhost映射正常" -ForegroundColor Green
} else {
Write-Host "⚠️ localhost映射可能有问题" -ForegroundColor Yellow
Write-Host "建议检查hosts文件: $hostsPath" -ForegroundColor White
}
Write-Host ""
Write-Host "[3/4] 清理浏览器缓存..." -ForegroundColor Yellow
Write-Host "请手动执行以下操作：" -ForegroundColor White
Write-Host "1. 完全关闭浏览器" -ForegroundColor White
Write-Host "2. 重新打开浏览器" -ForegroundColor White
Write-Host "3. 按 Ctrl+Shift+Delete 清理缓存" -ForegroundColor White
Write-Host "4. 或使用无痕模式访问" -ForegroundColor White
Write-Host ""
Write-Host "[4/4] 测试连接..." -ForegroundColor Yellow
$urls = @(
"http://localhost:4001/",
"http://127.0.0.1:4001/",
"http://192.168.100.70:4001/"
)
foreach ($url in $urls) {
try {
$response = Invoke-WebRequest -Uri $url -Method Head -TimeoutSec 5 -ErrorAction Stop
Write-Host "✅ $url - 连接正常 (状态码: $($response.StatusCode))" -ForegroundColor Green
} catch {
Write-Host "❌ $url - 连接失败" -ForegroundColor Red
}
}
Write-Host ""
Write-Host "✅ 修复完成！" -ForegroundColor Green
Write-Host ""
Write-Host "💡 如果localhost仍有问题，请尝试：" -ForegroundColor Cyan
Write-Host "1. 使用 http://127.0.0.1:4001/ 代替" -ForegroundColor White
Write-Host "2. 使用 http://192.168.100.70:4001/ (已确认工作)" -ForegroundColor White
Write-Host "3. 重启计算机以清理所有缓存" -ForegroundColor White
Write-Host ""
Write-Host "按任意键退出..." -ForegroundColor Gray
$null = $Host.UI.RawUI.ReadKey("NoEcho,IncludeKeyDown")
scripts/force-refresh.ps1 deleted 100644 → 0
# 绩效计分系统 - 强制刷新脚本
Write-Host ""
Write-Host "==========================================" -ForegroundColor Cyan
Write-Host " 绩效计分系统 - 强制刷新" -ForegroundColor Cyan
Write-Host "==========================================" -ForegroundColor Cyan
Write-Host ""
Write-Host "🔍 检测到localhost缓存问题！" -ForegroundColor Yellow
Write-Host ""
# 1. 停止开发服务器
Write-Host "[1/6] 停止开发服务器..." -ForegroundColor Yellow
try {
# 查找并终止占用4001端口的进程
$processes = Get-NetTCPConnection -LocalPort 4001 -ErrorAction SilentlyContinue | Select-Object -ExpandProperty OwningProcess
if ($processes) {
foreach ($pid in $processes) {
Stop-Process -Id $pid -Force -ErrorAction SilentlyContinue
Write-Host "✅ 已停止进程 PID: $pid" -ForegroundColor Green
}
} else {
Write-Host "ℹ️ 没有发现占用4001端口的进程" -ForegroundColor Yellow
}
} catch {
Write-Host "⚠️ 停止进程时出现错误，继续执行..." -ForegroundColor Yellow
}
Start-Sleep -Seconds 2
# 2. 清理所有缓存
Write-Host ""
Write-Host "[2/6] 清理项目缓存..." -ForegroundColor Yellow
# 清理Vite缓存
if (Test-Path "node_modules\.vite") {
Remove-Item -Recurse -Force "node_modules\.vite"
Write-Host "✅ Vite缓存已清理" -ForegroundColor Green
}
# 清理dist目录
if (Test-Path "dist") {
Remove-Item -Recurse -Force "dist"
Write-Host "✅ dist目录已清理" -ForegroundColor Green
}
# 清理npm缓存
npm cache clean --force 2>$null
Write-Host "✅ npm缓存已清理" -ForegroundColor Green
# 3. 修改Vite配置以禁用缓存
Write-Host ""
Write-Host "[3/6] 临时禁用Vite缓存..." -ForegroundColor Yellow
$viteConfig = @"
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'
export default defineConfig({
plugins: [vue()],
resolve: {
alias: {
'@': '/src'
}
},
server: {
port: 4001,
host: '0.0.0.0',
hmr: true,
force: true
},
build: {
rollupOptions: {
output: {
manualChunks: undefined
}
}
},
// 强制禁用缓存
optimizeDeps: {
force: true
},
// 添加时间戳避免缓存
define: {
__BUILD_TIME__: JSON.stringify(new Date().getTime())
}
})
"@
$viteConfig | Out-File -FilePath "vite.config.js" -Encoding UTF8
Write-Host "✅ Vite配置已更新" -ForegroundColor Green
# 4. 重新安装依赖
Write-Host ""
Write-Host "[4/6] 重新安装依赖..." -ForegroundColor Yellow
npm install --force
Write-Host "✅ 依赖重新安装完成" -ForegroundColor Green
# 5. 启动开发服务器
Write-Host ""
Write-Host "[5/6] 启动开发服务器..." -ForegroundColor Yellow
Write-Host "🚀 正在启动，请稍候..." -ForegroundColor Green
# 在后台启动开发服务器
Start-Process -FilePath "npm" -ArgumentList "run", "dev" -WindowStyle Hidden
# 等待服务器启动
Write-Host "⏳ 等待服务器启动..." -ForegroundColor Yellow
Start-Sleep -Seconds 8
# 6. 打开浏览器并清理缓存
Write-Host ""
Write-Host "[6/6] 打开浏览器..." -ForegroundColor Yellow
Write-Host ""
Write-Host "🌐 正在打开浏览器..." -ForegroundColor Green
Write-Host "📍 地址: http://localhost:4001/" -ForegroundColor Cyan
Write-Host ""
# 打开浏览器
Start-Process "http://localhost:4001/"
Write-Host "⚠️ 重要提醒：" -ForegroundColor Red
Write-Host ""
Write-Host "在浏览器中请立即执行以下操作：" -ForegroundColor Yellow
Write-Host "1. 按 F12 打开开发者工具" -ForegroundColor White
Write-Host "2. 右键点击刷新按钮" -ForegroundColor White
Write-Host "3. 选择 '清空缓存并硬性重新加载'" -ForegroundColor White
Write-Host "4. 或者按 Ctrl+Shift+R 强制刷新" -ForegroundColor White
Write-Host ""
Write-Host "如果仍有问题，请：" -ForegroundColor Yellow
Write-Host "- 按 Ctrl+Shift+Delete 清理浏览器缓存" -ForegroundColor White
Write-Host "- 在开发者工具 Network 标签页勾选 'Disable cache'" -ForegroundColor White
Write-Host "- 尝试无痕模式访问" -ForegroundColor White
Write-Host ""
Write-Host "✅ 强制刷新完成！" -ForegroundColor Green
Write-Host ""
Write-Host "按任意键退出..." -ForegroundColor Gray
$null = $Host.UI.RawUI.ReadKey("NoEcho,IncludeKeyDown")
scripts/start-dev.bat deleted 100644 → 0
@echo off
chcp 65001 >nul
echo.
echo ==========================================
echo 绩效计分系统 - 开发环境启动
echo ==========================================
echo.
echo [1/3] 检查Node.js环境...
node --version >nul 2>&1
if errorlevel 1 (
echo ❌ 未检测到Node.js，请先安装Node.js
echo 📥 下载地址：https://nodejs.org
pause
exit /b 1
)
echo ✅ Node.js环境检查通过
echo.
echo [2/3] 安装依赖包...
call npm install
if errorlevel 1 (
echo ❌ 依赖安装失败
pause
exit /b 1
)
echo ✅ 依赖安装完成
echo.
echo [3/3] 启动开发服务器...
echo 🚀 正在启动开发服务器...
echo 📱 启动完成后将自动打开浏览器
echo 🌐 访问地址：http://localhost:4001
echo.
echo ⚠️ 按 Ctrl+C 可停止服务器
echo.
call npm run dev
pause
scripts/start-prod.bat deleted 100644 → 0
@echo off
chcp 65001 >nul
echo.
echo ==========================================
echo 绩效计分系统 - 生产环境启动
echo ==========================================
echo.
echo [1/4] 检查Node.js环境...
node --version >nul 2>&1
if errorlevel 1 (
echo ❌ 未检测到Node.js，请先安装Node.js
echo 📥 下载地址：https://nodejs.org
pause
exit /b 1
)
echo ✅ Node.js环境检查通过
echo.
echo [2/4] 安装依赖包...
call npm install
if errorlevel 1 (
echo ❌ 依赖安装失败
pause
exit /b 1
)
echo ✅ 依赖安装完成
echo.
echo [3/4] 构建生产版本...
call npm run build
if errorlevel 1 (
echo ❌ 构建失败
pause
exit /b 1
)
echo ✅ 构建完成
echo.
echo [4/4] 启动生产服务器...
echo 🚀 正在启动生产服务器...
echo 🌐 访问地址：http://localhost:4001
echo.
echo ⚠️ 按 Ctrl+C 可停止服务器
echo.
call npm run preview
pause
src/services/api.js
......@@ -4,8 +4,8 @@
* 替换原有的 localStorage 存储机制
*/
// API 基础配置 - 使用相对路径，通过Vite代理访问后端
const API_BASE_URL = import.meta.env.VITE_API_BASE_URL || ''
// API 基础配置 - 直接使用后端API地址
const API_BASE_URL = import.meta.env.VITE_API_BASE_URL || 'http://localhost:8000'
/**
* HTTP 请求封装类
......@@ -402,7 +402,7 @@ export const configApi = {
// 设置配置项
async set(configKey, configValue, description = '') {
return apiClient.post('/api/config', {
return apiClient.post('/api/config/', {
config_key: configKey,
config_value: configValue,
description
......
start-database.bat deleted 100644 → 0
@echo off
chcp 65001 >nul
echo ========================================
echo 绩效计分系统 - 数据库启动脚本
echo ========================================
echo.
REM 检查 Docker 是否安装
where docker >nul 2>&1
if errorlevel 1 (
echo ❌ 未检测到 Docker，请先安装 Docker Desktop
pause
exit /b 1
)
REM 检查 Docker 是否运行
docker info >nul 2>&1
if errorlevel 1 (
echo ❌ Docker 未运行，请启动 Docker Desktop
pause
exit /b 1
)
echo ✅ Docker 环境检查通过
echo.
echo 🚀 启动 PostgreSQL 数据库...
docker compose up -d postgres
if errorlevel 1 (
echo ❌ 数据库启动失败
pause
exit /b 1
)
echo.
echo ⏳ 等待数据库初始化完成...
timeout /t 10 /nobreak >nul
REM 检查数据库健康状态
echo 🔍 检查数据库连接状态...
docker compose exec postgres pg_isready -U performance_user -d performance_db >nul 2>&1
if errorlevel 1 (
echo ⚠️ 数据库可能还在初始化中，请稍后检查
) else (
echo ✅ 数据库连接正常
)
echo.
echo ========================================
echo 🎉 数据库启动完成！
echo ========================================
echo.
echo 📋 数据库信息：
echo - 主机: localhost
echo - 端口: 5432
echo - 数据库: performance_db
echo - 用户: performance_user
echo - 密码: performance_pass
echo.
echo 🔧 管理命令：
echo - 查看日志: docker compose logs postgres
echo - 停止数据库: docker compose stop postgres
echo - 连接数据库: docker compose exec postgres psql -U performance_user -d performance_db
echo.
pause
start-dev-server.bat deleted 100644 → 0
@echo off
chcp 65001 >nul
echo ========================================
echo 绩效计分系统 v8.6 - 开发服务器
echo ========================================
echo.
REM 检查Node.js是否安装
node --version >nul 2>&1
if errorlevel 1 (
echo ❌ 错误: 未找到Node.js，请先安装Node.js
echo 请访问 https://nodejs.org/ 下载安装
pause
exit /b 1
)
echo ✅ Node.js 环境检查通过
node --version
REM 检查npm是否可用
npm --version >nul 2>&1
if errorlevel 1 (
echo ❌ 错误: 未找到npm，请检查Node.js安装
pause
exit /b 1
)
echo ✅ npm 环境检查通过
npm --version
echo.
REM 检查node_modules是否存在
if not exist "node_modules" (
echo 📦 正在安装项目依赖...
echo 这可能需要几分钟时间，请耐心等待...
npm install
if errorlevel 1 (
echo ❌ 依赖安装失败，请检查网络连接
pause
exit /b 1
)
echo ✅ 依赖安装完成
)
echo.
echo 🚀 启动绩效计分系统 v8.6 开发服务器...
echo.
echo 📍 服务器地址: http://localhost:8080
echo 🏠 主系统: http://localhost:8080
echo 🔍 诊断页面: http://localhost:8080/public/diagnose.html
echo.
echo 默认登录账号:
echo - 管理员: admin / admin123
echo - 陈锐屏: 13800138001 / 123456
echo - 张田田: 13800138002 / 123456
echo - 余芳飞: 13800138003 / 123456
echo.
echo 按 Ctrl+C 停止服务器
echo ========================================
echo.
REM 尝试启动vite开发服务器，使用不同端口避免权限问题
echo 正在启动vite开发服务器...
npx vite --port 8080 --host 127.0.0.1
REM 如果vite失败，使用简单HTTP服务器
if errorlevel 1 (
echo.
echo ⚠️ vite启动失败，使用备用HTTP服务器...
node basic-server.js
)
pause
start-docker.bat deleted 100644 → 0
@echo off
setlocal ENABLEDELAYEDEXPANSION
chcp 65001 >nul
cd /d "%~dp0"
echo ========================================
echo 绩效计分系统 8.8 - Docker 启动
echo ========================================
REM 1) 检查 Docker 可用
where docker >nul 2>&1
if errorlevel 1 (
echo ❌ 未检测到 Docker，请先安装 Docker Desktop 并启动后重试
pause
exit /b 1
)
REM 2) 检查 Docker Engine 是否运行
for /f "tokens=2 delims=:" %%a in ('docker info 2^>^&1 ^| findstr /C:"Server Version"') do set DOCKER_RUNNING=1
if not defined DOCKER_RUNNING (
echo ❌ 检测到 Docker Engine 未运行，请先启动 Docker Desktop
pause
exit /b 1
)
REM 3) 构建镜像并启动容器（使用 compose）
echo 🏗️ 正在构建镜像...
docker compose build
if errorlevel 1 (
echo ❌ 构建失败
pause
exit /b 1
)
echo 🚀 正在启动容器...
docker compose up -d
if errorlevel 1 (
echo ❌ 启动失败
pause
exit /b 1
)
echo ✅ 启动完成，请访问: http://localhost:8080/
echo 如需停止： docker compose down
pause
start-server.bat deleted 100644 → 0
@echo off
setlocal ENABLEDELAYEDEXPANSION
set PORT=8080
cd /d "%~dp0"
echo ========================================
echo Start static server (port %PORT%)
echo ========================================
REM [1/3] Free port using PowerShell only
powershell -NoProfile -ExecutionPolicy Bypass -Command "$port=%PORT%; try { $cons=Get-NetTCPConnection -LocalPort $port -ErrorAction SilentlyContinue; if ($cons) { ($cons | Select-Object -ExpandProperty OwningProcess -Unique) | ForEach-Object { try { Stop-Process -Id $_ -Force -ErrorAction SilentlyContinue } catch {} } } } catch {}"
REM Small wait
powershell -NoProfile -ExecutionPolicy Bypass -Command "Start-Sleep -Seconds 1"
REM [2/3] Check Node.js using PowerShell
powershell -NoProfile -ExecutionPolicy Bypass -Command "if (-not (Get-Command node -ErrorAction SilentlyContinue)) { Write-Host 'Node.js not found. Please install from https://nodejs.org/'; exit 1 }"
if errorlevel 1 (
pause
exit /b 1
)
REM [3/3] Start server (with SPA fallback)
echo Starting server: http://localhost:%PORT%/
powershell -NoProfile -ExecutionPolicy Bypass -Command "node serve-dist.js"
echo Server stopped.
pause
start-system.bat deleted 100644 → 0
@echo off
chcp 65001 >nul
echo ========================================
echo 绩效计分系统 - 完整启动脚本
echo ========================================
echo.
REM 检查 Docker 是否安装
where docker >nul 2>&1
if errorlevel 1 (
echo ❌ 未检测到 Docker，请先安装 Docker Desktop
pause
exit /b 1
)
REM 检查 Docker 是否运行
docker info >nul 2>&1
if errorlevel 1 (
echo ❌ Docker 未运行，请启动 Docker Desktop
pause
exit /b 1
)
echo ✅ Docker 环境检查通过
echo.
echo 🚀 启动完整系统...
echo.
echo 📊 1. 启动 PostgreSQL 数据库...
docker compose up -d postgres
if errorlevel 1 (
echo ❌ 数据库启动失败
pause
exit /b 1
)
echo ⏳ 等待数据库初始化完成...
timeout /t 15 /nobreak >nul
echo 🔍 检查数据库连接状态...
docker compose exec postgres pg_isready -U performance_user -d performance_db >nul 2>&1
if errorlevel 1 (
echo ⚠️ 数据库可能还在初始化中，继续启动其他服务...
) else (
echo ✅ 数据库连接正常
)
echo.
echo 🔧 2. 启动 FastAPI 后端服务...
docker compose up -d api
if errorlevel 1 (
echo ❌ 后端服务启动失败
pause
exit /b 1
)
echo ⏳ 等待后端服务启动...
timeout /t 10 /nobreak >nul
echo.
echo 🌐 3. 启动前端应用...
docker compose up -d frontend
if errorlevel 1 (
echo ❌ 前端应用启动失败
pause
exit /b 1
)
echo.
echo ========================================
echo 🎉 系统启动完成！
echo ========================================
echo.
echo 📋 服务信息：
echo - 前端应用: http://localhost:4001
echo - 后端API: http://localhost:8000
echo - API文档: http://localhost:8000/docs
echo - 数据库: localhost:5432
echo.
echo 🔧 管理命令：
echo - 查看日志: docker compose logs -f
echo - 停止系统: docker compose down
echo - 重启系统: docker compose restart
echo.
echo 📖 默认登录信息：
echo - 用户名: admin
echo - 密码: admin123
echo.
REM 等待5秒后自动打开浏览器
echo 🌐 5秒后自动打开浏览器...
timeout /t 5 /nobreak >nul
start http://localhost:4001
pause
start-system.ps1 deleted 100644 → 0
# 绩效计分系统启动脚本
# 用于启动前端开发服务器
Write-Host "=== 绩效计分系统启动脚本 ===" -ForegroundColor Green
# 检查Node.js是否安装
try {
$nodeVersion = node --version
Write-Host "Node.js版本: $nodeVersion" -ForegroundColor Green
} catch {
Write-Host "错误: 未找到Node.js，请先安装Node.js" -ForegroundColor Red
exit 1
}
# 检查npm是否安装
try {
$npmVersion = npm --version
Write-Host "npm版本: $npmVersion" -ForegroundColor Green
} catch {
Write-Host "错误: 未找到npm" -ForegroundColor Red
exit 1
}
# 停止可能正在运行的进程
Write-Host "停止现有进程..." -ForegroundColor Yellow
Get-Process -Name "node" -ErrorAction SilentlyContinue | Stop-Process -Force -ErrorAction SilentlyContinue
# 等待进程完全停止
Start-Sleep -Seconds 2
# 检查端口是否被占用
$port5173 = Get-NetTCPConnection -LocalPort 5173 -ErrorAction SilentlyContinue
$port4001 = Get-NetTCPConnection -LocalPort 4001 -ErrorAction SilentlyContinue
if ($port5173) {
Write-Host "警告: 端口5173仍被占用" -ForegroundColor Yellow
}
if ($port4001) {
Write-Host "警告: 端口4001仍被占用" -ForegroundColor Yellow
}
# 安装依赖（如果需要）
if (-not (Test-Path "node_modules")) {
Write-Host "安装依赖..." -ForegroundColor Yellow
npm install
if ($LASTEXITCODE -ne 0) {
Write-Host "错误: 依赖安装失败" -ForegroundColor Red
exit 1
}
}
Write-Host "启动前端服务器..." -ForegroundColor Yellow
$frontendJob = Start-Job -ScriptBlock {
Set-Location $using:PWD
npx vite --host 0.0.0.0 --port 5173
}
# 等待前端服务器启动
Start-Sleep -Seconds 5
# 检查服务状态
Write-Host "检查服务状态..." -ForegroundColor Yellow
try {
$frontendResponse = Invoke-WebRequest -Uri "http://localhost:5173" -Method HEAD -TimeoutSec 5 -ErrorAction Stop
Write-Host "✓ 前端服务器运行正常 (http://localhost:5173)" -ForegroundColor Green
} catch {
Write-Host "✗ 前端服务器启动失败" -ForegroundColor Red
}
Write-Host ""
Write-Host "=== 系统启动完成 ===" -ForegroundColor Green
Write-Host "前端应用: http://localhost:5173" -ForegroundColor Cyan
Write-Host "状态检查: http://localhost:5173/status.html" -ForegroundColor Cyan
Write-Host "同步测试: http://localhost:5173/sync-test.html" -ForegroundColor Cyan
Write-Host ""
Write-Host "按 Ctrl+C 停止所有服务" -ForegroundColor Yellow
# 监控服务状态
try {
while ($true) {
Start-Sleep -Seconds 30
# 检查作业状态
if ($frontendJob.State -eq "Failed" -or $frontendJob.State -eq "Stopped") {
Write-Host "前端服务器已停止，重新启动..." -ForegroundColor Yellow
$frontendJob = Start-Job -ScriptBlock {
Set-Location $using:PWD
npx vite --host 0.0.0.0 --port 5173
}
}
}
} finally {
Write-Host "停止所有服务..." -ForegroundColor Yellow
Stop-Job $frontendJob -ErrorAction SilentlyContinue
Remove-Job $frontendJob -ErrorAction SilentlyContinue
Get-Process -Name "node" -ErrorAction SilentlyContinue | Stop-Process -Force -ErrorAction SilentlyContinue
Write-Host "所有服务已停止" -ForegroundColor Green
}
vite.config.js
......@@ -12,20 +12,7 @@ export default defineConfig({
server: {
port: 5173,
host: '0.0.0.0',
hmr: true,
proxy: {
// 代理 API 请求到后端服务
'/api': {
target: 'http://localhost:8000',
changeOrigin: true,
secure: false
},
'/health': {
target: 'http://localhost:8000',
changeOrigin: true,
secure: false
}
}
hmr: true
},
build: {
rollupOptions: {
......
启动.bat deleted 100644 → 0
@echo off
++ /dev/null
@echo off
chcp 65001 >nul
:start
cls
echo ==========================================
echo 绩效计分系统 - 一键启动
echo ==========================================
echo.
echo 请选择启动模式：
echo.
echo [1] 开发环境 (推荐用于开发和测试)
echo - 启动快速，支持热重载
echo - 便于调试和开发
echo.
echo [2] 生产环境 (推荐用于正式使用)
echo - 性能优化，适合生产使用
echo - 需要构建时间较长
echo.
echo [3] 清理缓存并重启 (解决显示问题)
echo - 清理所有缓存文件
echo - 重新构建项目
echo.
echo [4] 查看使用说明
echo.
echo [5] 退出
echo.
set /p choice=请输入选择 (1-5):
if "%choice%"=="1" (
echo.
echo 🚀 启动开发环境...
call scripts\start-dev.bat
goto :start
) else if "%choice%"=="2" (
echo.
echo 🚀 启动生产环境...
call scripts\start-prod.bat
goto :start
) else if "%choice%"=="3" (
echo.
echo 🧹 清理缓存并重启...
call scripts\clear-cache.bat
goto :start
) else if "%choice%"=="4" (
echo.
echo 📖 打开使用说明...
if exist "docs\使用指南.md" (
start docs\使用指南.md
) else if exist "Node.js安装指南.md" (
start "Node.js安装指南.md"
) else (
echo ❌ 使用指南文件不存在
)
pause
goto :start
) else if "%choice%"=="5" (
echo.
echo 👋 再见！
exit /b 0
) else (
echo.
echo ❌ 无效选择，请重新输入
pause
goto :start
)
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment