# task-track

**Repository Path**: Rovinty/task-track

## Basic Information

- **Project Name**: task-track
- **Description**: TaskTrack 是一个专为电商公司设计的运营需求管理系统，基于浏览器插件的局域网部署方案。系统核心特色是**需求类型预设流程**，通过配置不同需求类型的审批节点和负责人，实现自动化流程分配，同时支持手动加签和灵活的完成标记机制。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-12
- **Last Updated**: 2025-09-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TaskTrack - 需求管理系统

基于Gitee的纯前端需求管理系统，支持流程配置、多用户协作和实时数据同步。

## 🚀 功能特性

### 核心功能
- **需求看板**: 按紧急程度分组显示需求
- **流程管理**: 预设流程模板，自动匹配需求类型
- **手动加签**: 灵活添加审批节点
- **完成控制**: 手动标记任务完成
- **实时同步**: 基于Gitee API的云端数据同步

### 技术特点
- **纯前端**: 无需服务器，可部署到任何静态托管
- **云端存储**: 数据存储在Gitee仓库，支持版本控制
- **离线可用**: 本地缓存，离线也能正常使用
- **响应式**: 支持桌面和移动设备

## 📁 项目结构

```
task-track/
├── index.html              # 主页面
├── css/                    # 样式文件
│   ├── main.css           # 主样式
│   └── components.css     # 组件样式
├── js/                     # JavaScript文件
│   ├── app.js             # 主应用程序
│   ├── gitee-api.js       # Gitee API封装
│   ├── data-manager.js    # 数据管理
│   ├── workflow-engine.js # 流程引擎
│   └── components/        # UI组件
│       ├── demand-card.js # 需求卡片
│       └── workflow-preview.js # 流程预览
├── data/                   # 数据文件模板
│   ├── demands.json       # 需求数据
│   ├── workflows.json     # 流程配置
│   ├── users.json         # 用户数据
│   ├── demand-types.json  # 需求类型
│   ├── urgency-levels.json # 紧急度配置
│   └── config.json        # 系统配置
└── README.md              # 项目说明
```

## 🔧 部署指南

### 1. 准备Gitee仓库

1. 在Gitee创建新仓库 `task-track`
2. 将项目文件上传到仓库
3. 在Gitee设置中生成Access Token

### 2. 配置系统

1. 打开 `index.html`
2. 进入"系统设置"页面
3. 填写Gitee配置：
   - Access Token: 你的Gitee访问令牌
   - 用户名/组织: 你的Gitee用户名
   - 仓库名: task-track
4. 点击"测试连接"验证配置

### 3. 初始化数据

系统会自动创建以下数据文件：
- `data/demands.json` - 需求数据
- `data/workflows.json` - 流程配置
- `data/users.json` - 用户数据
- `data/demand-types.json` - 需求类型
- `data/urgency-levels.json` - 紧急度配置
- `data/config.json` - 系统配置

### 4. 部署到静态托管

#### Gitee Pages
1. 在仓库设置中启用Gitee Pages
2. 选择部署分支
3. 访问生成的网址

#### Vercel
1. 连接Gitee仓库到Vercel
2. 自动部署
3. 获得访问域名

#### 腾讯云静态网站托管
1. 上传文件到COS
2. 配置静态网站
3. 绑定自定义域名

## 📋 使用说明

### 创建需求
1. 点击"创建需求"标签
2. 填写需求信息
3. 选择需求类型（自动匹配流程）
4. 预览流程节点
5. 提交创建

### 流程管理
1. 系统根据需求类型自动创建流程
2. 每个节点有指定的负责人
3. 支持手动加签添加额外审批
4. 所有节点完成后需手动标记完成

### 数据同步
- 自动同步到Gitee仓库
- 支持多用户协作
- 本地缓存提高性能
- 支持数据导入导出

## 🔒 权限管理

### 用户角色
- **管理员**: 完整权限
- **产品经理**: 产品评估节点负责人
- **计划专员**: 计划制定节点负责人
- **执行经理**: 执行跟进节点负责人

### 操作权限
- 创建需求
- 编辑需求
- 删除需求
- 查看所有需求
- 配置流程
- 标记完成
- 手动加签

## 🎨 自定义配置

### 需求类型
在`data/demand-types.json`中配置：
```json
{
  "new_product": {
    "name": "新品上架",
    "color": "#007bff",
    "icon": "🛍️",
    "enabled": true,
    "workflowTemplate": "new_product"
  }
}
```

### 流程模板
在`data/workflows.json`中配置：
```json
{
  "new_product": {
    "id": "new_product",
    "name": "新品上架",
    "nodes": [
      {
        "id": "submit",
        "name": "需求提出",
        "defaultAssignee": null,
        "order": 1
      }
    ]
  }
}
```

### 紧急度配置
在`data/urgency-levels.json`中配置：
```json
[
  {
    "id": 4,
    "name": "紧急",
    "color": "#dc3545",
    "priority": 4,
    "days": 3
  }
]
```

## 🔧 开发指南

### 本地开发
1. 克隆仓库
2. 使用本地服务器打开（如Live Server）
3. 配置Gitee连接
4. 开始开发

### 添加新功能
1. 在对应的JS文件中添加功能
2. 更新HTML和CSS
3. 测试功能
4. 提交到Gitee

### 数据结构
- 所有数据以JSON格式存储
- 支持版本控制和备份
- 遵循RESTful API设计原则

## 📞 技术支持

### 常见问题
1. **连接失败**: 检查Access Token和仓库权限
2. **数据丢失**: 从Gitee仓库恢复数据
3. **同步失败**: 检查网络连接和API限制

### 联系方式
- 项目地址: https://gitee.com/Rovinty/task-track
- 问题反馈: 提交Issue
- 技术交流: 欢迎Star和Fork

## 📄 许可证

MIT License - 详见LICENSE文件

---

*TaskTrack v2.0.0 - 基于Gitee的纯前端需求管理系统*