快速开始

系统简介

沐霖工时管理系统是一个功能完善的工时管理系统，专注于项目工时记录、审核和统计分析。

核心功能

• 工时填报: 支持任务工时和普通工时两种类型，日历视图和列表视图双模式
• 工时审核: 完善的审核流程，支持单个审核和批量审核
• 任务管理: 项目任务创建、状态跟踪和任务日记
• 项目管理: 项目信息维护、成员管理和项目统计
• 数据统计: 多维度数据分析，支持图表展示和报表导出

技术特点

• 前后端分离: Go 后端 + Vue 3 前端
• 双工时类型: 任务工时（关联具体任务）和普通工时（日常事务）
• 工作类型分类: 开发、测试、设计、需求、部署、会议、其他
• 审核机制: 待审核 → 已通过/已驳回，完整审核记录
• 统计分析: 个人、项目、团队多维度统计

快速开始（推荐）

二进制包启动（最简单）

1. 下载最新版本的二进制包
2. 解压到指定目录
3. 配置数据库信息（修改 application.yaml）
4. 直接运行程序

Windows

# 解压后进入目录
cd mulin-go

# 修改配置文件
# 编辑 application.yaml，配置数据库连接

# 直接运行
mulin.exe

Linux/Mac

# 解压后进入目录
cd mulin-go

# 添加执行权限
chmod +x mulin

# 修改配置文件
# 编辑 application.yaml，配置数据库连接

# 直接运行
./mulin

程序默认运行在 http://localhost:8080

前置要求

• MySQL: 8.0+
• Redis: 6.0+

数据库准备

CREATE DATABASE mulin_cost DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

配置文件说明

修改 application.yaml 中的数据库配置：

db:
  host: localhost
  port: 3306
  user: root
  password: your_password
  name: mulin_cost

Redis 配置：

redis:
  host: localhost
  port: 6379
  password: ""

快速使用

第一步：创建项目

1. 登录系统
2. 进入"项目管理"页面
3. 点击"新增项目"
4. 填写项目信息并保存

第二步：创建任务

1. 进入项目详情页
2. 点击"新增任务"
3. 填写任务信息：
   • 任务名称
   • 负责人
   • 优先级
   • 计划时间

第三步：填报工时

1. 进入"工时管理"页面
2. 选择日期（日历视图）或点击"新增"（列表视图）
3. 选择项目和任务
4. 选择工作类型（开发/测试/设计等）
5. 填写工时数和工作记录
6. 保存提交

第四步：审核工时

1. 进入"工时审核"页面
2. 查看待审核的工时记录
3. 点击"审核"查看详情
4. 选择"通过"或"驳回"
5. 填写审核意见（可选）
6. 提交审核结果

第五步：查看统计

1. 进入"数据统计"页面
2. 选择统计维度：
   • 工时统计
   • 项目统计
   • 人员统计
3. 设置筛选条件
4. 查看图表和报表

一键构建

项目提供了一键构建脚本，支持 Windows 和 Linux 平台：

Windows

build-release.bat

Linux/Mac

chmod +x build-release.sh
./build-release.sh

构建产物在 release 目录

核心概念

工时类型

任务工时

• 关联到具体项目的具体任务
• 需要选择工作类型
• 适用于项目任务

普通工时

• 不关联具体任务
• 只需填写项目和工时记录
• 适用于日常事务、会议等

工作类型

• 开发: 编码、开发相关工作
• 测试: 测试、QA 相关工作
• 设计: UI/UX 设计工作
• 需求: 需求分析、文档编写
• 部署: 部署、运维工作
• 会议: 各类会议
• 其他: 其他类型工作

审核状态

• 待审核 (0): 工时已提交，等待审核
• 已通过 (1): 审核通过，工时已确认
• 已驳回 (2): 审核不通过，需要修改

下一步

• 查看 产品介绍 了解系统详情
• 查看 最佳实践 了解使用技巧
• 查看 部署指南 了解如何部署到生产环境
• 查看 核心功能 了解详细功能说明