众筹团购独立应用

众筹团购插件（crowd）说明

版本 1.1.0 · 标识 crowd · 标签 运营 · 路径 plugins/crowd

一、插件介绍

独立众筹/团购模块，不挂社区主题。用户可自行发起项目，多人用积分或金币分摊费用；人数凑齐后由发起者上传资源，仅参与者可见。

适用场景：软件、课程、影音、会员等「多人拼单买资源」。

依赖：社区插件（会员/积分金币）、可选消息插件（站内通知）。

二、作用与价值

三、核心流程

发起 → 参与扣款 → 人数达标「已达成」

↓

发起者上传交付内容 →「已交付」（仅参与者可见）

未达标且到期 →「已过期」→ 可自动退款

达成后逾期未交 → 可自动退款取消（可配置）

发起者取消（无人他人参与）→ 退款

状态：0 进行中 → 1 已达成 → 2 已交付；或 3 已过期 / 4 已取消

四、功能清单

前台

• 广场列表：关键词 / 分类 / 货币 / Tab（全部·进行中·热门·已达成·已交付）
• 侧栏：热门推荐、即将截止、参与须知
• 发起/编辑：分类、封面上传、金额人数、有效期、自动退款
• 详情：进度、参与、复制分享链接、浏览量
• 达成后：发起者交付；参与者催交付（冷却可配）
• 我的：我发起的 / 我参与的
• 取消：仅进行中且无他人参与时可取消并退款

后台

• 配置：货币、金额/人数/天数范围、发起权限、交付时限、催交付、规则文案
• 项目管理：搜索、推荐/置顶、强制过期/退款/取消/删除、操作日志
• 分类管理：增删改、排序、启停

资金与通知

• 积分 / 金币（Coin 流水：crowd_join / crowd_refund）
• 可选站内通知（message 插件）

五、目录结构

plugins/crowd/

├── CrowdPlugin.php # 入口：配置、安装卸载、菜单、Schema 热升级

├── plugin.json

├── helpers.php # crowd_url()

├── routes.php

├── install.sql

├── icon.svg

├── controller/

│ ├── Index.php # 前台

│ └── admin/

│ ├── Base.php / Setting.php / Campaign.php / Category.php

├── service/

│ ├── CrowdService.php # 核心业务

│ ├── CategoryService.php

│ ├── NotifyService.php

│ └── LogService.php

├── view/

│ ├── front/ # index/detail/form/mine/deliver/_nav/_aside

│ └── admin/ # setting/campaign_*/category_index/_nav

└── static/

├── crowd.css

└── crowd.js

六、数据表

七、主要路由

前台：/crowd · /crowd/create · /crowd/mine · /crowd/{id} · /crowd/{id}/edit · /crowd/{id}/deliver
接口：save / join / deliver / cancel / urge / upload

后台：/admin/crowd（配置）· /admin/crowd/campaign（项目）· /admin/crowd/category（分类）

八、关键配置项（摘要）

应用中心弹窗另有：enabled、page_title、page_intro。

九、安装与入口

1. 应用中心安装并启用 crowd
2. 前台：/crowd（安装时尽量写入社区顶栏「众筹」）
3. 后台菜单：众筹团购 → 配置 / 项目管理 / 分类
4. 已装旧版：访问前台或后台会自动补表字段