# KisTask

**Repository Path**: moxiaoyuapp/kis-task

## Basic Information

- **Project Name**: KisTask
- **Description**: KisTask一个开源的项目管理软件，支持多项目管理，应用于BUG跟踪、需求管理等多种形式的任务管理。
- **Primary Language**: PHP
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://kis.hicenxin.com
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 0
- **Created**: 2025-12-18
- **Last Updated**: 2026-06-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# KisTask

KisTask 是一款开源的项目管理软件，支持多项目管理，可应用于 BUG 跟踪、需求管理等多种形式的任务管理场景。系统采用前后端分离设计，提供完善的任务管理功能。

## 功能特性

- **多项目管理**：支持创建和管理多个项目，实现项目资源的隔离与共享
- **任务管理**：支持 BUG 跟踪、需求管理、任务分配等多种任务类型
- **工作流配置**：可自定义项目流程，灵活配置状态流转
- **权限管理**：基于角色的权限控制，支持部门、员工、角色的管理
- **文件管理**：支持图片、音频、视频、文档等多种资源的上传和管理
- **移动端支持**：提供 H5 移动端界面，方便移动办公
- **第三方登录**：支持微信登录，提供二维码扫描登录功能
- **实时通信**：集成 WebSocket 支持实时消息推送

## 技术栈

- **后端**：PHP 7.0+ / MySQL / Redis
- **前端**：Vue.js 2.x / Element UI
- **Web 服务器**：Apache / Nginx
- **依赖管理**：Composer（PHP）

## 目录结构

```
kis-task/
├── config/                 # 配置文件目录
│   ├── config.php          # 主配置文件
│   ├── config_db.php       # 数据库配置
│   ├── config_biz.php      # 业务配置
│   └── config_menu.php     # 菜单配置
├── controller/             # 控制器目录
│   ├── api/                # API 接口控制器
│   │   ├── account/        # 账户相关接口
│   │   ├── issue/          # 任务相关接口
│   │   ├── project/        # 项目相关接口
│   │   ├── group/          # 分组相关接口
│   │   ├── res/            # 资源相关接口
│   │   └── oauth/          # 认证授权接口
│   ├── app.class.php       # 主应用控制器
│   └── h5.class.php        # H5 移动端控制器
├── model/                  # 数据模型目录
│   ├── account/            # 账户模型
│   ├── issue/              # 任务模型
│   ├── project/            # 项目模型
│   └── group/              # 分组模型
├── lib/                    # 核心库目录
│   ├── class/              # 核心类
│   │   ├── Application.class.php
│   │   ├── Controller.class.php
│   │   └── Model.class.php
│   ├── core/               # 核心框架
│   └── function/           # 公共函数
├── static/                 # 前端静态资源
├── h5/                     # H5 移动端页面
├── projectTest/            # 测试项目
├── composer.json           # Composer 依赖配置
└── kis.sql                 # 数据库脚本
```

## 快速开始

### 环境要求

- PHP >= 7.0
- MySQL >= 5.7
- Redis >= 3.0
- Composer
- Web 服务器（Apache/Nginx）

### 安装步骤

1. **准备运行环境**
   
   确保服务器已安装 PHP、MySQL 和 Redis，并正确配置环境变量。

2. **上传代码**
   
   将 KisTask 代码上传到 Web 服务器的目录中。

3. **导入数据库**
   
   创建数据库并导入 `kis.sql` 文件：
   ```bash
   mysql -u username -p database_name < kis.sql
   ```

4. **配置数据库连接**
   
   编辑 `config/config_db.php` 文件，配置 MySQL 和 Redis 连接信息：
   ```php
   //数据库设置
		define('DB_HOST',     'localhost');
		define('DB_NAME',     'your_database');
		define('DB_USER',     'your_username');
		define('DB_PASS',     'your_password'); 

		//redis设置
		define('REDIS_HOST','localhost');
		define('REDIS_PORT',6379);
		define('REDIS_PASS','your_password');
   ```

5. **安装依赖**
   
   使用 Composer 安装 PHP 依赖：
   ```bash
   composer install
   ```

6. **配置 Web 服务器**
   
   配置 Web 服务器指向项目根目录，设置 URL 重写规则支持路由。

### 访问系统

完成安装后，通过浏览器访问系统。使用初始账号登录体验：
- **体验地址**：https://kis.hicenxin.com
- **账号**：13800138000
- **密码**：123456

## 主要功能模块

### 系统管理
- **角色权限**：配置用户角色和访问权限
- **部门管理**：组织架构管理
- **员工管理**：用户账号管理
- **项目管理**：项目的创建、配置和归档

### 任务管理
- **我的待办**：查看分配给自己的任务
- **已完成**：查看已完成的任务列表
- **我创建的**：查看自己创建的任务
- **任务创建**：创建新的任务，支持多种任务类型

### 资源管理
- **图片管理**：图片上传、预览、裁剪
- **文档管理**：文档上传和在线预览
- **音视频管理**：音视频资源的上传和管理
- **分组管理**：资源分组和分类

### 移动端功能
- **H5 页面**：适配移动端的任务管理界面
- **扫码登录**：通过扫码方式完成登录验证
- **消息推送**：实时接收任务更新通知

## API 接口

系统提供 RESTful API 接口，主要接口模块包括：

| 模块 | 说明 |
|------|------|
| `/api/account` | 用户账户管理接口 |
| `/api/issue` | 任务管理接口 |
| `/api/project` | 项目管理接口 |
| `/api/group` | 分组管理接口 |
| `/api/res` | 资源管理接口 |
| `/api/oauth` | 认证授权接口 |

## 开发指南

### 添加新功能

1. 在 `model/` 目录创建对应的数据模型
2. 在 `controller/api/` 目录创建控制器文件
3. 在 `config/config_menu.php` 中注册菜单
4. 编写前端页面组件

### 代码规范

- PHP 代码遵循 PSR 标准
- 使用 PDO 操作数据库
- 控制器方法返回统一格式
- 模型方法使用表模型封装

## 参与贡献

欢迎贡献代码！请遵循以下步骤：

1. Fork 本仓库
2. 创建功能分支：`git checkout -b feature/xxx`
3. 提交更改：`git commit -m 'Add xxx'`
4. 推送分支：`git push origin feature/xxx`
5. 提交 Pull Request

## 许可证

本项目采用 MIT 许可证开源。

## 相关链接

- **在线体验**：https://kis.hicenxin.com
- **Gitee 项目**：https://gitee.com/moxiaoyuapp/kis-task
- **开源中国**：https://www.oschina.net/p/kis-task