driesp/timetracker

TimeTracker镜像说明

镜像概述

TimeTracker是一个自托管的时间跟踪、项目管理和 invoicing 平台，采用Docker优先架构设计，可实现快速本地开发、可预测部署及轻松自托管。该仓库包含平台完整源代码，支持跨环境一致运行。

核心功能

• 前端: Web单页应用（SPA），提供时间跟踪、项目管理、报表生成和 invoicing 操作界面。
• 后端: REST API，处理认证、时间条目管理、项目配置、发票生成、报表统计及数据持久化。
• 数据库: 关系型数据库，存储用户、项目、任务、时间条目、发票等核心实体数据。
• Docker层: 确保开发、测试、生产环境的一致性，简化部署流程。

使用场景

• 团队内部时间管理与工作时长统计
• 项目进度跟踪与任务分配
• 生成客户发票与财务报表
• 个人或小型团队的自托管办公工具

配置说明

前提条件

需安装以下工具：

• Docker
• Docker Compose
• Git

部署步骤

1. 克隆仓库

bash
git clone https://github.com/DRYTRIX/TimeTracker.git
cd TimeTracker

2. 配置环境变量
   创建或编辑.env文件：

env
APP_ENV=production
APP_PORT=3000
DB_HOST=db
DB_PORT=5432
DB_NAME=timetracker
DB_USER=timetracker
DB_PASSWORD=changeme

根据实际环境调整参数。

3. 启动应用

bash
docker compose up -d

该命令会构建镜像、启动API/前端/数据库服务，并自动应用数据库迁移。应用启动后可通过http://localhost:3000访问。

4. 首次设置

• 打开Web UI创建初始管理员账户
• 配置公司信息、发票模板、货币及税务设置

开发与维护

• 本地开发模式：

bash
docker compose up

支持热重载与代码实时更新。

• 数据库迁移：
  自动应用迁移，手动执行可使用：

bash
docker compose exec backend npm run migrate

• 日志查看：

bash
docker compose logs -f

• 应用更新：

bash
git pull
docker compose down
docker compose pull
docker compose up -d

最佳实践

• 升级前备份数据库卷
• 生产环境使用强密码
• 通过反向代理（Traefik/Nginx/Caddy）部署并启用HTTPS
• 监控容器健康状态与磁盘使用情况

文档与支持

• 演示与文档：[***]
• 问题反馈：GitHub Issues
• 贡献：欢迎提交Pull Request