payroll/deploy/部署清单.txt

======================================================
工资发放管理系统 - 生产环境部署包
======================================================

打包日期: 2025-12-27
系统版本: v1.0.1
打包状态: ✅ 完成

======================================================
一、部署文件清单
======================================================

1. 后端服务 (约46.5MB)
   ✅ payroll-system-1.0.0.jar
   
2. 前端静态文件 (frontend目录,40个文件)
   ✅ index.html (入口文件)
   ✅ assets/ (CSS和JS文件)
   
3. 数据库脚本 (db目录)
   ✅ schema.sql (基础表结构)
   ✅ salary_schema.sql (薪资模块)
   ✅ attendance_schema.sql (考勤模块)
   ✅ payroll_schema.sql (工资单模块)
   ✅ insurance_schema.sql (社保公积金模块)
   
4. 配置文件
   ✅ application-prod.yml (生产环境配置)
   
5. 文档和脚本
   ✅ 打包说明.txt (详细部署文档)
   ✅ 一键打包.bat (打包脚本)
   ✅ 打包后端.bat (后端打包脚本)
   ✅ 打包前端.bat (前端打包脚本)

======================================================
二、部署前准备
======================================================

⚠️ 重要:部署前必须修改配置!

1. 修改 application-prod.yml
   需要根据生产环境修改以下配置:
   
   [数据库配置]
   - spring.datasource.druid.url
     默认: jdbc:mysql://localhost:3306/payroll_system
     改为: 生产环境MySQL地址
   
   - spring.datasource.druid.username
     默认: root
     改为: 生产环境数据库用户名
   
   - spring.datasource.druid.password
     默认: root
     改为: 生产环境数据库密码
   
   [Redis配置]
   - spring.redis.host
     默认: localhost
     改为: 生产环境Redis地址
   
   - spring.redis.password
     默认: (空)
     改为: 生产环境Redis密码(如有)

2. 准备服务器环境
   - JDK 1.8或更高版本
   - MySQL 8.0
   - Redis 6.0+
   - Nginx (用于前端部署)

======================================================
三、快速部署步骤
======================================================

步骤1: 创建数据库
-----------------------------------------------
mysql -u root -p
CREATE DATABASE payroll_system CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

步骤2: 导入数据库脚本
-----------------------------------------------
cd /path/to/deploy/db
mysql -u root -p payroll_system < schema.sql
mysql -u root -p payroll_system < salary_schema.sql
mysql -u root -p payroll_system < attendance_schema.sql
mysql -u root -p payroll_system < payroll_schema.sql
mysql -u root -p payroll_system < insurance_schema.sql

步骤3: 部署后端服务
-----------------------------------------------
# 创建部署目录
mkdir -p /opt/payroll-system

# 上传jar包和配置文件
scp payroll-system-1.0.0.jar user@server:/opt/payroll-system/
scp application-prod.yml user@server:/opt/payroll-system/

# 启动服务
cd /opt/payroll-system
nohup java -jar payroll-system-1.0.0.jar --spring.profiles.active=prod > app.log 2>&1 &

# 查看启动日志
tail -f app.log

步骤4: 部署前端
-----------------------------------------------
# Nginx配置示例
server {
    listen 80;
    server_name your-domain.com;
    
    root /var/www/payroll-web;
    index index.html;
    
    location / {
        try_files $uri $uri/ /index.html;
    }
    
    location /api/ {
        proxy_pass http://localhost:8080/api/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

# 上传前端文件
scp -r frontend/* user@server:/var/www/payroll-web/

# 重启Nginx
nginx -s reload

步骤5: 验证部署
-----------------------------------------------
# 检查后端服务
curl http://localhost:8080/api/auth/test-password

# 浏览器访问
http://your-domain.com

# 测试登录
用户名: admin
密码: 123456

======================================================
四、系统功能清单
======================================================

✅ 组织架构管理
   - 组织管理
   - 部门管理
   - 员工管理

✅ 薪资配置管理
   - 薪资项目
   - 薪资方案
   - 社保公积金

✅ 考勤管理
   - 考勤记录
   - 考勤统计

✅ 工资管理
   - 工资计算
   - 工资单查询

✅ 系统管理
   - 用户管理
   - 角色管理

✅ Dashboard首页
   - 数据统计
   - 快捷入口

======================================================
五、技术栈信息
======================================================

后端:
- Spring Boot 2.7.18
- MyBatis Plus 3.5.5
- MySQL Connector
- Druid连接池
- Redis
- JWT认证

前端:
- Vue 3
- Element Plus
- Pinia状态管理
- Vue Router
- Axios

======================================================
六、常见问题
======================================================

Q1: 后端启动失败怎么办?
A1: 
   1. 检查JDK版本是否为1.8+
   2. 检查数据库连接配置是否正确
   3. 查看app.log日志文件
   4. 确认8080端口未被占用

Q2: 前端访问404?
A2:
   1. 检查Nginx配置是否正确
   2. 检查文件权限
   3. 查看Nginx错误日志
   4. 确认root路径正确

Q3: 登录后接口调用失败?
A3:
   1. 检查Nginx代理配置
   2. 检查后端服务是否正常运行
   3. 查看浏览器控制台错误
   4. 检查防火墙规则

======================================================
七、停止和重启服务
======================================================

停止后端:
  ps aux | grep payroll-system
  kill -9 <进程ID>

重启后端:
  cd /opt/payroll-system
  nohup java -jar payroll-system-1.0.0.jar --spring.profiles.active=prod > app.log 2>&1 &

重启Nginx:
  nginx -s reload

======================================================
八、备份建议
======================================================

生产环境必须做好备份:

1. 数据库备份 (每天自动)
   mysqldump -u用户名 -p密码 payroll_system > backup_$(date +%Y%m%d).sql

2. 定期清理日志
   find /opt/payroll-system -name "*.log" -mtime +7 -delete

3. 保留备份
   建议保留最近30天的数据库备份

======================================================
部署支持:
联系人: 
电话: 
邮箱: 
部署日期: 2025-12-27
======================================================