无鱼软件文档中心

Appearance

FAQ 概览 ​

沐霖工时管理系统常见问题解答，帮助您快速解决使用中遇到的问题。

📋 问题分类 ​

产品问题 ​

Q1: 沐霖工时系统有哪些核心功能？ ​

A: 系统提供以下核心功能：

  1. 工时填报

    • 普通工时：不关联具体任务的工时记录
    • 任务工时：关联项目和具体任务的工时记录
    • 支持按周/月批量填报

  2. 工时审核

    • 项目经理审核团队成员工时
    • 支持通过/驳回操作
    • 可按项目筛选审核

  3. 项目管理

    • 项目创建与配置
    • 项目成员管理
    • 项目状态跟踪

  4. 任务管理

    • 任务创建与分配
    • 任务状态管理
    • 任务工时统计

  5. 数据统计

    • 个人工时统计
    • 项目工时统计
    • 团队工时统计
    • 可视化图表展示

Q2: 系统支持哪些部署方式？ ​

A: 系统支持三种部署方式：

部署方式适用场景特点
独立部署开发测试前端 Nginx + 后端服务 + 数据库
Docker 部署生产环境容器化，一键启动
单程序部署快速体验Go 二进制 + 嵌入式前端

详细说明请查看 部署指南

Q3: 社区版、专业版和企业版有什么区别？ ​

A:

功能社区版 (CE)专业版 (Pro)企业版 (Ent)
用户数上限≤ 49 人≤ 100 人无限制
项目数上限≤ 49 个无限制无限制
工时填报✅✅✅
工时审核✅✅✅
任务/项目管理✅✅✅
数据概览 + 人员统计✅✅✅
项目统计 + 填报记录查询—✅✅
数据分析模块—✅✅
站内通知✅✅✅
邮件通知—✅✅
钉钉/企微/飞书通知——✅
风险洞察与风险类型配置——✅
专属技术支持——✅

详细功能对比请查看 版本与功能

Q4: 系统的前后端技术栈是什么？ ​

A:

前端:

  • Vue 3.5 + Vite 6.3
  • Element Plus 2.9
  • ECharts 5.6
  • Pinia 状态管理

后端:

  • Go 版本：Gin 1.10 + GORM 1.25
  • Java 版本：Spring Boot + MyBatis

数据库:

  • MySQL（主数据库）
  • Redis（缓存/会话）

详细技术架构请查看 技术架构文档

使用问题 ​

Q1: 如何填报工时？ ​

A: 工时填报分为两种类型：

普通工时填报 ​

  1. 进入"工时填报"页面
  2. 选择日期
  3. 选择项目
  4. 填写工时数和备注
  5. 点击提交

任务工时填报 ​

  1. 进入"工时填报"页面
  2. 选择日期
  3. 选择项目和任务
  4. 选择工作类型（开发/测试/设计等）
  5. 填写工时数
  6. 点击提交

详细说明请查看 工时填报指南

Q2: 如何查看我的周报/月报？ ​

A:

  1. 进入"我的周报/月报"页面
  2. 选择时间范围（本周/上周/本月/上月或自定义）
  3. 选择工时类型（全部/普通工时/任务工时）
  4. 查看统计卡片和工时明细

详细说明请查看 周报/月报指南

Q3: 工时填报后为什么看不到数据？ ​

A: 请按以下步骤排查：

  1. ✅ 确认填报日期范围正确
  2. ✅ 确认选择了正确的项目
  3. ✅ 检查是否有权限查看该项目
  4. ✅ 刷新页面或重新登录
  5. ✅ 检查工时是否已审核（未审核的工时可能不显示在统计中）

Q4: 如何导出工时数据？ ​

A:

  1. 进入"数据统计"页面
  2. 设置查询条件（时间范围、项目等）
  3. 点击"导出"按钮
  4. 选择导出格式（Excel）
  5. 下载导出文件

Q5: 工作类型有哪些？如何选择？ ​

A: 系统提供 7 种工作类型：

类型说明适用场景
开发编码、调试功能开发、Bug修复
测试功能测试、回归测试测试用例执行
设计UI/UX 设计、架构设计界面设计、技术方案
需求需求分析、评审需求讨论、文档编写
部署环境部署、发布上线发布、配置
会议项目会议、评审会议会议参与
其他其他工作不属于以上类型的工作

Q6: 如何修改已填报的工时？ ​

A:

  1. 进入"我的周报/月报"页面
  2. 找到需要修改的工时记录
  3. 点击"编辑"按钮
  4. 修改工时信息
  5. 点击保存

注意: 已审核的工时可能无法修改，需要联系项目经理。

部署问题 ​

Q1: 系统运行需要哪些环境依赖？ ​

A:

单程序部署（推荐） ​

  • MySQL 5.7+ 或 8.0+
  • Redis 6.0+

Docker 部署 ​

  • Docker 20.10+
  • Docker Compose 2.0+

独立部署 ​

  • 前端: Node.js 18+, npm 9+
  • 后端: Go 1.21+ 或 JDK 17+
  • 数据库: MySQL 5.7+
  • 缓存: Redis 6.0+
  • Web服务器: Nginx 1.20+（前端部署）

Q2: 如何快速启动系统？ ​

A: 最简单的方式是使用单程序部署：

bash
# 1. 下载程序
# 从公众号"沐霖工时系统"获取下载链接

# 2. 初始化数据库
mysql -u root -p mulin_cost < sql/init.sql

# 3. 启动 Redis
redis-server

# 4. 启动程序
./mulin-cost

# 5. 访问系统
# http://localhost:8080

详细步骤请查看 单程序部署指南

Q3: 启动时提示数据库连接失败怎么办？ ​

A: 按以下步骤排查：

bash
# 1. 检查 MySQL 服务是否运行
# Windows
services.msc | findstr MySQL

# Linux
systemctl status mysql

# 2. 测试数据库连接
mysql -u root -p -h 127.0.0.1 -P 3306

# 3. 检查配置文件
cat application.yaml | grep -A 5 "mysql:"

# 4. 确认数据库已创建
mysql -u root -p -e "SHOW DATABASES;" | grep mulin_cost

Q4: Redis 连接超时怎么办？ ​

A:

bash
# 1. 检查 Redis 服务
redis-cli ping
# 应返回 PONG

# 2. 检查 Redis 配置
redis-cli CONFIG GET bind
redis-cli CONFIG GET port

# 3. 测试连接
redis-cli -h 127.0.0.1 -p 6379

# 4. 检查防火墙
# Windows: 检查入站规则
# Linux: sudo ufw status

Q5: 端口被占用如何修改？ ​

A:

修改后端端口 ​

编辑 application.yaml:

yaml
server:
  port: 8081  # 修改为你想要的端口

修改前端端口（独立部署） ​

编辑 vite.config.js:

javascript
export default defineConfig({
  server: {
    port: 3000  // 修改为你想要的端口
  }
})

Docker Compose 端口映射 ​

编辑 docker-compose.yml:

yaml
services:
  app:
    ports:
      - "8081:8080"  # 宿主机端口:容器端口

Q6: 如何备份和恢复数据？ ​

A:

数据库备份 ​

bash
# 备份
mysqldump -u root -p mulin_cost > backup_$(date +%Y%m%d_%H%M%S).sql

# 恢复
mysql -u root -p mulin_cost < backup_20260530_120000.sql

Redis 备份 ​

bash
# 手动保存
redis-cli BGSAVE

# 备份文件位置（默认）
/var/lib/redis/dump.rdb

Q7: 如何升级系统版本？ ​

A:

bash
# 1. 备份数据
mysqldump -u root -p mulin_cost > backup_before_upgrade.sql

# 2. 停止服务
# Docker 方式
docker-compose down

# 单程序方式
# Ctrl+C 或 kill 进程

# 3. 下载新版本
# 从公众号获取下载链接

# 4. 替换程序文件

# 5. 启动新版本
# Docker 方式
docker-compose up -d

# 单程序方式
./mulin-cost

# 6. 检查数据是否正常

详细升级指南请查看 发布记录 中的升级指南部分

Q8: 日志在哪里查看？ ​

A:

后端日志 ​

bash
# 单程序部署
tail -f logs/app.log

# Docker 部署
docker logs -f mulin-go
docker logs -f mulin-server

# 查看最近 100 行
tail -n 100 logs/app.log

前端日志 ​

  • 浏览器开发者工具 → Console 面板
  • 或使用 F12 打开开发者工具

Q9: Docker 部署时容器启动失败怎么办？ ​

A:

bash
# 1. 查看容器状态
docker-compose ps

# 2. 查看容器日志
docker-compose logs mysql
docker-compose logs redis
docker-compose logs app

# 3. 检查端口占用
netstat -tuln | grep 8080
netstat -tuln | grep 3306
netstat -tuln | grep 6379

# 4. 清理并重新启动
docker-compose down
docker-compose up -d

# 5. 查看资源使用
docker stats

技术支持 ​

获取帮助的途径 ​

1. 文档资源 ​

2. 社区支持 ​

  • 💬 Gitee Issues: 提交问题反馈

3. 商业支持 ​

  • 📱 微信公众号: wuyusoft
    • 获取最新版本下载链接
    • 获取部署包和资源文件
    • 获取技术支持
    • 菜单栏选择「沐霖工时系统下载」
  • 🤝 定制开发服务
  • 📚 技术培训服务

4. 紧急问题 ​

对于生产环境的紧急问题：

  1. 先查看日志定位问题
  2. 查看 FAQ 是否已有解决方案
  3. 提交 Gitee Issue（附详细错误信息）
  4. 联系技术支持团队

提交问题时请提供 ​

为了更快解决问题，请提供以下信息：

markdown
## 问题描述
简要描述遇到的问题

## 环境信息
- 系统版本: v4.0.0
- 部署方式: 单程序/Docker/独立部署
- 操作系统: Windows 11 / Ubuntu 22.04 / macOS
- 数据库版本: MySQL 8.0
- Redis 版本: Redis 7.0

## 复现步骤
1. ...
2. ...
3. ...

## 预期行为
应该发生什么

## 实际行为
实际发生了什么

## 错误日志

粘贴相关错误日志


## 截图
如有必要，提供截图

最后更新: 2026-05-30

Released under the MIT License.

Copyright © 2026 无鱼软件