jncinet/qihucms-user-task

qihucms user task.

1.0.2 2020-12-29 06:03 UTC

MIT

• zhangye

• task
• laravel
• qihucms

README

说明

任务主发布任务，其它会员完成任务，并提交任务凭证，任务主审核通过后，会员获取任务奖励

安装

$ composer require jncinet/qihucms-user-task

开始

数据迁移

$ php artisan migrate

发布资源

$ php artisan vendor:publish --provider="Qihucms\UserTask\TaskServiceProvider"

路由

admin

在后台管理菜单中添加管理菜单

• 任务管理：task/tasks
• 完成记录：task/orders

api

【会员任务】

1. 简单任务列表分页
   • 请求方法：GET
   • 链接地址：task/select-tasks
   • 请求参数：
     • 关键词 | q
2. 任务分页列表
   • 请求方法：GET
   • 链接地址：task/tasks
   • 请求参数：
     • 分页显示条数 | limit | int | 可选
     • 会员ID | user_id | int | 可选
3. 我的任务分页列表
   • 请求方法：GET
   • 链接地址：task/tasks/user
   • 请求参数：
     • 分页显示条数 | limit | int | 可选
     • 任务状态 | status | int | 可选
     • 奖励托管状态 | pay_status | 可选
4. 任务详细
   • 请求方法：GET
   • 链接地址：task/tasks/{id}
5. 我的任务详细（返回任务说细及任务完成记录）
   • 请求方法：GET
   • 链接地址：task/tasks/user/{id}
6. 发布任务
   • 请求方法：POST
   • 链接地址：task/tasks
   • 请求参数：
     • 任务标题 | title | string
     • 缩略图 | thumbnail | string
     • 开始时间 | start_time | datetime | 默认为发布时间
     • 结束时间 | end_time | datetime | 默认发布时间后三天
     • 任务总数 | stock | int
     • 奖励类型 | currency_type_id | int
     • 奖励数额 | amount | decimal
     • 详细介绍 | content | longtext
     • 链接按钮文字 | btn_text | string|null
     • 任务链接 | link | string|null
7. 提前结束任务或延长时间
   • 请求方法：PUT | PATCH
   • 链接地址：task/tasks/{id}
   • 请求参数：
     • 结束时间 | end_time | datetime | 可选，当end_time存在则必须是一个大于当前时间的时间
     • 任务状态 | status=2 | 可选，当status参数存在时，即结束任务其它值无效
8. 删除任务（有完成记录的任务不可删除）
   • 请求方法：DELETE
   • 链接地址：task/tasks/{id}

【任务完成记录】

1. 任务订单记录（任务发布者可查看）
   • 请求方法：GET
   • 链接地址：task/orders
   • 请求参数：
     • 显示条数 | limit | 可选 | 默认每页15条
     • 任务状态 | status | 可选值[0=>'待审核', 1=>'已审核', 2=>'已完成'] | 可选
2. 任务订单详细
   • 请求方法：GET
   • 链接地址：task/orders/{id}
3. 领取任务
   • 请求方法：POST
   • 链接地址：task/orders
   • 请求参数：
     • 任务ID | user_task_id | 必须是有效的任务ID
4. 完成任务提交凭证
   • 请求方法：PUT|PATCH
   • 链接地址：task/orders/{id}
   • 请求参数：
     • 任务ID | user_task_id | int | 必填
     • 根据任务要求完的任务的图片记录 | files | array | 可选
     • 根据任务要求填写的说明 | remark | string ｜ 可选
5. 任务主审核完成记录
   • 请求方法：POST
   • 链接地址：task/orders/audit/{id=任务ID}
6. 会员删除任务记录（只能删除未完成的记录）
   • 请求方法：DELETE
   • 链接地址：task/orders/{id}

task前缀可通过在/config/qihu.php中添加或修改：
'user_task_prefix' => 'task'

事件

// 任务模型中
'saved' => TaskSaved::class
// 任务记录模型中
'saved' => TaskCompleted::class

数据库

任务表：user_tasks

Field	Type	Length	AllowNull	Default	Comment
id	bigint
user_id	bigint				发布会员ID
title	varchar	255			任务标题
thumbnail	varchar	255	Y	NULL	缩略图地址
start_time	timestamp		Y	NULL	开始时间
end_time	timestamp		Y	NULL	结束时间
stock	int			0	任务总数量
currency_type_id	bigint				奖励类型ID
amount	decimal	8,2		0.00	奖励金额
content	longtext		Y		任务介绍
btn_text	varchar	255	Y	NULL	链接文字
link	varchar	255	Y	NULL	链接地址
pay_status	tinyint			0	奖金托管状态
status	tinyint			0	任务状态
created_at	timestamp		Y	NULL	创建时间
updated_at	timestamp		Y	NULL	更新时间

任务表完成记录：user_task_orders

Field	Type	Length	AllowNull	Default	Comment
id	bigint
user_id	bigint				发布会员ID
user_task_id	bigint				完成任务ID
files	json		Y	NULL	任务图片凭证
content	text		Y		完成介绍
status	tinyint			0	完成状态
created_at	timestamp		Y	NULL	创建时间
updated_at	timestamp		Y	NULL	更新时间