威客任务（witkey）

基于「特殊主题 + 竞标」模式的威客任务中心插件：发布需求 → 服务方竞标报价 → 发布者选标中标，平台只负责撮合与流程管理，不介入中标后的交易与支付。

• 作者：kuakeba.cn
• 版本：1.0.0
• 适用：ThinkPHP 8 + PHP 8.1+ + MySQL 5.7 / 8.0

功能一览

• 三级项目分类：一级大类 → 二级细分 → 三级子项，后台可视化维护，支持图标、描述、排序、启停。
• 自定义项目字段：字段可绑定分类（或设为全局），支持文本 / 多行文本 / 数字 / 下拉 / 单选 / 日期 / 链接；可设置必填、可筛选、可修改、默认值与占位提示。
• 任务大厅：关键词、分类（含子分类）、状态、预算区间、排序、自定义字段组合筛选。
• 发布与竞标：发布者可设置预算、截止日期、联系方式与封面；服务方提交报价、工期与留言，可在截止前修改或撤回。
• 选标中标：发布者或后台可将某个竞标设为中标，任务转为「已选标」，其余竞标自动落选；任务可继续标记「已完成」或「关闭」。
• 我的任务 / 我的竞标：会员可集中查看自己发布的任务与参与过的竞标记录。
• 后台管理：任务列表（审核、置顶、改状态、删除）、任务分类、自定义字段、竞标记录（设为中标 / 删除）。
• 发布与竞标权限：按用户组限制可发布、可竞标人群；可限制每人同时进行的任务数、竞标需绑定联系方式。
• 移动端适配：前台页面与后台表格均自适应。

安装

1. 将 plugins/witkey 目录放入站点 plugins/ 目录。
2. 进入后台「应用中心 → 插件」，找到「威客任务」并点击安装。
3. 安装时会自动：

  - 执行 install.sql 建立 4 张数据表（自动替换表前缀）；

  - 注册后台菜单「威客任务」；

  - 初始化示例分类（设计创意 / 开发编程 / 文案营销，各含 3 个二级分类）；

  - 将 static/ 资源复制到 public/static/witkey/。

1. 安装完成后访问 /witkey 进入任务大厅；后台入口为 /admin/witkey。

若为本地开发、未走安装流程，请手动把 plugins/witkey/static/* 复制到 public/static/witkey/，否则前台样式与脚本不会加载。

目录结构

plugins/witkey/
├── plugin.json              插件元信息
├── icon.svg / icon.png      插件图标
├── install.sql              建表脚本
├── routes.php               前台 / 后台路由
├── WitkeyPlugin.php         插件入口（配置、菜单、安装、会员态）
├── service/WitkeyService.php 业务服务（分类、字段、任务、竞标、选标）
├── controller/
│   ├── FrontBase.php        前台基类
│   ├── Index.php            前台：大厅 / 详情 / 发布 / 竞标 / 我的
│   └── admin/               后台：任务 / 分类 / 字段 / 竞标
├── view/
│   ├── front/               前台模板（layout / index / detail / publish / my）
│   └── admin/               后台模板
└── static/                  witkey.css / witkey.js

数据表

任务状态：1 待审核 / 2 竞标中 / 3 已选标 / 4 已完成 / 5 已关闭 / 6 未通过 / 7 已取消。

竞标状态：1 竞标中 / 2 已中标 / 3 未中标 / 4 已撤回。

前台路由

后台功能

• 任务管理：按标题 / 分类 / 状态筛选；审核通过或驳回（附驳回原因）；置顶；编辑任务（含自定义字段）；批量删除。
• 任务分类：三级分类维护，删除前需先清空子分类与任务；删除分类会同步移除其自定义字段。
• 自定义字段：按分类新增字段，支持类型切换、选项维护、必填 / 可筛选 / 可修改设置。
• 竞标记录：按任务标题与竞标状态筛选，可将竞标设为中标，或删除单条记录。

配置项（应用中心 → 威客任务 → 设置）

使用流程

1. 后台「任务分类」维护项目分类；「自定义字段」按需增加字段（如预算范围、项目周期）。
2. 会员在前台「发布任务」填写需求，提交后按 发布需审核 配置进入待审核或直接竞标中。
3. 服务方进入任务详情提交竞标（报价 / 工期 / 留言）；截止前可修改或撤回。
4. 发布者在详情页或后台「竞标记录」选择中标者，任务转为「已选标」。
5. 线下完成交付后，发布者可将任务标记为「已完成」。

说明与注意事项

• 插件不包含支付、资金托管与评价体系，中标后的交易由双方自行确认。
• 会员登录态优先复用「社区」插件；未安装社区时读取站点会话中的会员 / 管理员身份。
• 后台管理员可代为发布任务；前台游客默认只读（取决于「游客可浏览」配置）。
• 自定义字段筛选依赖 MySQL JSON_EXTRACT，建议 MySQL 5.7 及以上。

版本记录

• 1.0.0：首个版本，包含三级分类、自定义字段、任务大厅、竞标与选标、我的任务、后台管理与权限配置。