|
> 模块类 型：盲盒纸条交友 / 恋爱广场 + 代理分销
---
## 一、移动端核心功能（H5 页面）
- **首页 / 纸条广场（`inc/mobile/index.inc.php` + `template/mobile/index*.html`）** - **首页展示**：根据模块配置展示轮播、公告、活动入口、充值入口等。 - **纸条广场**：拉取已审核的纸条列表（性别、城市、省份、属性等多条件筛选），展示图片、文字内容。 - **弹幕/跑马灯**： - `cmd=dm`：随机取用户头像与文案，组合“用户XXX抽到了一个男/女纸条”弹幕。 - `cmd=dm1`：随机取代理用户，展示“用户****累计赚取X元”的收益弹幕。 - **首页动态信息流**（`cmd=getfeeds`）：随机统计放入纸条、抽取纸条的用户信息，生成“用户***放入/抽取一个纸条”的列表，用于前端动态提示。 - **投诉入口**（`cmd=tousu`）： - 用户可对纸条/用户进行投诉，提交类型、内容、联系方式（微信号/手机）、可选截图。 - 数据落表 `huaidan_mhjy_tousu`，用于后台或审核端处理。
- **纸条匹配广场（`inc/mobile/match.inc.php` + `template/mobile/match.html`）** - **广场列表**（默认或 `submit=list`）： - 条件：`status=1`、`verify_status=20`、`is_square=1`、`is_des=0`、未删除。 - 支持按性别、城市、省份（`prop1`）、自定义属性（`prop2`）筛选。 - 可开启“资料不完整屏蔽”（昵称、头像为空将不展示）。 - 图片字段反序列化，并转换为完整媒体 URL。 - **抽取纸条（`cmd=feedget`）** - 可配置“必须先投放纸条才能抽取”（`feedin_must`）。 - 校验纸条是否存在、是否已销毁（`is_des`）、是否重复抽取。 - 按配置扣减积分/金币（`coin_top_qu` / `coin_top_qu2`、是否同城 `is_tc`），不足时返回 `nocoin`。 - 写入 `huaidan_mhjy_user_feed` 用户纸条记录，更新用户投/取统计与纸条浏览计数，达到设定浏览数后自动销毁纸条。 - 成功后返回跳转链接到“我的纸条详情”（`cmd=ufeed`）。
- **用户中心 & 资料相关（主要在 `inc/mobile/index.inc.php` 中的 `cmd=mine` 分支）** - **手机号绑定与短信验证码**： - 生成短信验证码，限制同用户 60 秒内重复发送、每天发送次数上限。 - 校验手机号是否已被其他账号绑定。 - **位置信息更新**（`submit=location`）： - 通过腾讯地图 API（`qmap_key`）将经纬度解析为省、市、区、街道，写入用户位置。 - **个人资料编辑**： - 昵称、头像、性别、自定义属性（`prop1/prop2`）、签名、图片等。 - 可配置是否允许修改特殊字段（如学校等长文本，有“解决编辑框不能超过1000字符”的兼容）。 - **充值积分（金币）**： - 按配置的多档充值套餐（`inmoney_coin1-6`/`inmoney_fee1-6`）校验金额。 - 限制用户日/月累计充值上限（可选关闭）。 - 创建 `huaidan_mhjy_order` 记录，返回发起微信支付需要的参数（与 `site.php` 中 `doMobilePay` 配合）。 - **其他个人相关**：如签到送积分、回复扣积分、投放纸条次数/金额加价（通过 `getjia_price` 获取）、任务等（在 `index.inc.php` 后续逻辑中实现）。
- **代理 / 店主端（`inc/mobile/agent.inc.php` + 模板 `agent_*.html`）** - **代理开通与购买**： - 配置代理费（`agent_fee`）与多级佣金比例（`agent_rate/agent_rate1/agent_rate2`）。 - 若代理费为 0，直接开通；否则生成 `AGENT_xxx` 订单走微信支付。 - **佣金提现（`cmd=outcash`）**： - 支持多种提现渠道（微信收款码、企业付款到零钱等，受 `outcash_way` 控制）。 - 校验单笔最小/最大额度，提现间隔天数（`outcash_sp`）、账户余额。 - 记录提现申请 `huaidan_mhjy_outcash`，同步变更 `agent_money` 与 `huaidan_mhjy_money` 流水。 - **账号同步 / 代理合并功能**（`cmd=tongbu`、`cmd=passwordadd`）： - 通过自定义同步密码，将历史账号数据（openid / uid）跟当前用户合并。 - **提现赠送活动**： - 配置满多少提现赠送额外金额（`ti_zeng`），自动计算赠送金额并计入到账金额。
- **活动中心（拉新活动，`inc/mobile/activity.inc.php`）** - **活动首页（`op=display `）**： - 展示活动海报、进度、奖励档位等（配置自 `module.php` settings）。 - **活动邀请列表（`op=invit`）**： - 统计在活动时间范围内（`activity_start~activity_end`）通过 `acuid` 邀请注册的用户。 - **活动奖励领取（`op=gift` / `op=ling`）**： - 按多个“角色档位”（`activity_role1-8`）判断是否满足邀请人数，是否已在奖励有效期内领取。 - 领取成功后增加 `act_credit` 或其它配置的奖励，并写入 `huaidan_mhjy_activity_gift_log`。 - **活动积分兑换（`op=dui`）**： - 将活动积分兑换为金币或其它奖励，支持兑换审核、记录日志。 - **活动专属推广二维码（`op=qr`）**： - 生成带背景图的推广二维码（可选择纯二维码或叠加到活动海报底图中）。
- **扩展推广中心（`inc/mobile/extension.inc.php`）** - **扩展活动首页（`op=display`）**： - 根据 `extension_*` 系列配置，生成用户专属推广链接、推广海报（调用 `createPoster` 合成带二维码海报）。 - 展示推广人数、奖励档位状态（未达标/可领取/已领取/过期）。 - **推广邀请列表（`op=invit`）**： - 查询在 `extension_start~extension_end` 内，`extension_uid` 为当前用户的下级列表。 - **推广奖励领取（`op=ling`）**： - 满足每个档位人数后，可领取对应金币奖励（`extension_role*_gift`），写入 `huaidan_mhjy_extension_gift_log`。
- **公共页面 / 工具（`inc/mobile/public.inc.php`）** - **图文富文本展示**： - `cmd=html`：展示帮助中心（Q&A）、用户协议、轮播图/导航详情等（来源于配置或其它模块表）。 - `cmd=page`：展示后台自定义单页 `huaidan_mhjy_page` 内容（与 web 端 `page.inc.php` 对应）。 - **城市选择界面（`cmd=citys`）**：城市/省份选择弹窗模板。 - **邀请码 / 授权码工具**： - `cmd=door`：输入邀请码，绑定到第三方表 `vp_sphz_user` 的 `fuid` 字段。 - `cmd=auth`：批量输入邀请码列表，进行编码后返回（前后台共用的授权码工具）。 - **公共用户信息展示（`cmd=user`）**：渲染公共用户信息页模板。
- **管理员移动端（`inc/mobile/admin.inc.php`）** - **仅管理员可访问（`mine.admin=1`）**，功能包括： - 用户手动充值积分（手充）、生成对应订单及佣金、写入金币流水。 - 设置/取消用户代理身份。 - 纸条审核列表：审核用户提交的纸条（通过/拒绝，拒绝时发送模板消息）。 - 举报 & 投诉管理（`huaidan_mhjy_alarm` 和 `huaidan_mhjy_tousu`）： - 查看举报记录，删除违规回复、拉黑用户、标记举报处理完成或忽略。
- **审核员移动端（`inc/mobile/admin2.inc.php`）** - **仅审核员可访问（`mine.admin1=1`）**，功能包括： - 独立的纸条审核列表（批量通过/拒绝）。 - 投诉列表查看与处理（标记投诉已处理）。 - 与管理员类似的“为用户手充积分”“设为/取消代理”等简化管理操作。
- **地图页（`doMobileMaps` + `template/mobile/maps.html`）** - 简单地图页，用于展示定位或帮助用户授权地理位置。
- **登录与授权（`doMobileLogin` / `_doMobileAuth` / `__doMobileAuth` / `doMobileGetuinfousecode`）** - **公众号 OAuth 授权**： - 通过微信网页授权（或第三方聚合登录 `log.o9p.cn`）获取用户昵称、头像、openid。 - 处理粉丝表 `mc_mapping_fans`、`mc_members` 的注册与更新。 - **应用容器校验**： - 限制仅微信内访问（已在你的需求中做了 UA 放宽判断）。 - **登录跳转**： - 自动获取用户信息失败时给出错误提示并引导重试。
- **辅助接口** - **图片上传（`doMobileupimg`）**：上传用户图片到系统附件，并返回路径 + 媒体 URL。 - **二维码输出（`doMobileQr`）**：接收 `raw` 文本，生成二维码图片返回。 - **清理会话（`doMobileReset`）**：清空当前会话 `session_unset()`。 - **定时任务接口**： - `doMobileTaskTopExp`：定时取消过期加热纸条（置顶到期）。 - `doMobileTaskWork`：任务系统的超时处理（任务状态流转、返库存、模板消息通知）。
---
## 二、PC 后台（模块管理端功能）
- **纸条管理（`inc/web/feed.inc.php` + 模板 `web/feed_list.html`）** - 列表查看所有纸条，按用户 UID、性别、关键词搜索。 - 支持逻辑删除、物理清理（清空被删除的纸条与回复）、批量清理 60 天前数据。 - 一键清理地理位置信息（重置 `lng/lat/address` 等字段）。 - 单条封禁/解封纸条（`op` 字段：封禁原因、封禁时间等）。
- **用户管理（`inc/web/user.inc.php` + 模板 `web/user_list.html`）** - 用户列表：按 ID 搜索、分页展示、过滤昵称。 - 操作： - 设置/取消代理（店主）、设置/取消管理员（`admin`）、设置/取消审核员（`admin1`）。 - 加入/移出黑名单（`is_black`）。 - 删除用户（危险操作）。
- **订单管理（充值订单，`inc/web/order.inc.php` + `web/order_list.html`）** - 列表展示所有已支付订单（`status=20`），可按 UID 搜索。 - 支持“管理员手动退款”： - 创建微信退款订单，调用 `refund()` 执行。 - 回滚用户金币、代理佣金，记录负向流水（`huaidan_mhjy_coin`、`huaidan_mhjy_money`）。
- **提现管理（代理提现，`inc/web/outcash.inc.php` + `web/outcash_list.html`）** - 提现记录列表，按用户、状态筛选。 - 批量发放提现： - 手动标记已打款，或调用微信企业付款接口自动打款（需正确配置微信支付证书）。 - 拒绝提现：填写拒绝原因，状态标记为拒绝。 - 提供历史“手充佣金错误恢复”辅助工具（`cmd=bugback`）。
- **代理清算与配置（`inc/web/agent.inc.php` + `web/agent_list.html`）** - **调整单个代理的佣金余额**（`cmd=agent_money`）。 - **代理实名认证审核**（`cmd=verify`）：通过/拒绝并填写备注。 - **设置代理个人佣金比例**（`cmd=agent_rate`）。 - **代理清算（`cmd=over`）**： - 将代理账户剩余佣金全部提现（手动打款或企业付款），并将其 `agent` 状态置为 0。 - **代理列表**： - 分“已清算 / 未清算”两类，展示每个代理的首次/最后提现记录情况。
- **自定义单页管理（`inc/web/page.inc.php` + 模板 `web/page_*`）** - 新增/编辑/删除自定义 H5 页面（如活动规则、帮助说明等）。 - 为每个单页自动生成前端访问链接（通过 `public.cmd=page` 解码 `id`）。
- **客服投诉 & 举报管理（配合移动端 admin/admin2）** - 通过 `huaidan_mhjy_tousu` 与 `huaidan_mhjy_alarm` 数据，后台可查看投诉详情、相关纸条及图片。 - 对严重违规内容可在管理员端直接销毁纸条、拉黑用户。
---
## 三、模块设置（`module.php` 中的配置项大类）
- **基础配置** - 应用名称、Logo、背景图、简介、暂停访问 / 仅邀请用户开放等开关。 - 公众号信息、公众号二维码、第三方聚合登录（`set_acc_*`）、是否强制微信环境访问。 - 是否必须绑定手机、是否屏蔽未完善资料用户、内容图片审核开关。
- **积分 / 金币体系** - 金币名称、图标、自定义别名。 - 多档充值套餐（金额 + 赠送）、充值渠道（微信、iOS 内购屏蔽等）。 - 抽纸条消耗、回复消耗、获取规则（投放纸条奖励、签到奖励等）。
- **纸条配置** - 纸条有效浏览数上限、自动销毁规则。 - 纸条属性（省份/城市/自定义属性）的启用与选项。 - 纸条中允许上传的图片数量、联系方式字段显示与否、文案占位提示。
- **活动与推广配置** - 拉新活动（`activity_*`）：时间范围、奖励档位、赠送物品（积分/金币）、兑换比例等。 - 扩展推广活动（`extension_*`）：时间、奖励档位、奖励金币数、海报底图等。 - 日常邀请奖励（`invite_*`）：每邀 1 人赠送金额/积分、总上限、专属分享图文与海报。
- **代理/分销配置** - 代理开通价格、代理名称、代理页面文案（介绍/分享话术）。 - 一级/二级/三级佣金比例，任务奖励分配方式。 - 提现方式、单笔最小最大额度、提现间隔天数、提现赠送规则等。
- **广告与合规信息** - 顶部、底部广告位图片 + 链接、悬浮广告、弹窗广告等位置开关与素材。 - 备案号、网安备案号等展示配置。
| 
发表于 
