# 国际交友平台
20260925更新说明：
1，新增机器人控制管理后台，一个客服即可通过一个管理后台同时管理多个账号跟用户聊天
​2，优化后台和前端bug，新增一套电脑和手机端模板
​3，新增视频打赏，付费视频，付费照片功能
​4，加入了百度翻译功能
​5，管理员手机端就可以审核，编辑用户信息
6，发消息可以设置免费几条后收费，可以按条收费，可以按会员收费
7，可以开启男女互看，男的看不到男的，只能在网站上看到女生
8，一共5套模板
9，新增了6种支付
10，优化系统修改太多就不一一列举了
支持定制，微信  huaidanwangluokeji
内置客服账号 huaidan520@qq.com
密码 123456

1.PHP8.2  需要安装扩展 fileinfo
2.数据库配置文件修改  /app/Config/database.php
3.管理员账号密码修改位置/app/Config/admin.php
一个功能完善的国际交友社交平台，支持多语言、VIP会员、支付、聊天、动态发布、短视频、礼物红包等丰富的社交与付费变现功能。

## ✨ 主要特性

- 🌍 **13 种语言** - 简体中文 / 繁体中文 / 英语 / 日语 / 韩语 / 越南语 / 泰语 / 印尼语 / 马来语 / 俄语 / 高棉语 / 老挝语 / 缅甸语
- 💬 **实时聊天** - 文字、图片、视频消息，支持付费消息与媒体解锁
- 📝 **动态广场** - 文字 / 图片 / 视频动态，评论点赞
- 🎬 **短视频** - 付费解锁、打赏、评论点赞
- 👥 **社交体系** - 好友、点赞、评论、礼物赠送、红包、拉黑
- 💰 **支付系统** - PayPal / Stripe 在线支付 + 余额消费 + 人工充值审核
- ⭐ **VIP会员** - VIP 特权管理，付费项可配置 VIP 豁免
- 🛠️ **完善后台** - 数据大屏、用户/内容/订单审核管理、机器人客服
- 📱 **响应式设计** - PC（huaidan_pc）与手机（huaidan_mobile）双端独立主题



                       
## 🚀 快速开始

### 系统要求

- PHP >= 8.0
- MySQL >= 5.6
- Web服务器（Apache/Nginx）

### 安装步骤

1. **下载程序**
   ```bash
   # 下载并解压到网站目录
   ```

2. **访问安装向导**
   ```
   http://yourdomain.com/install.php
   ```

3. **按照向导完成安装**
   - 环境检测
   - 数据库配置
   - 管理员账号设置

4. **完成安装**
   - 删除 `install.php` 文件（安全建议）
   - 访问前台和后台

详细安装说明请查看 [INSTALL.md](INSTALL.md)

## 📚 文档

- [功能清单](FEATURES.md) - 完整的功能列表
- [安装教程](INSTALL.md) - 详细的安装和使用指南

## 📁 目录结构

```
国际交友新增模板/
├── app/                    # 应用核心代码
│   ├── Admin/             # 后台管理（Controllers + Views）
│   ├── Config/            # 配置文件
│   ├── Core/              # 核心类库（Router/Lang/Auth/Model...）
│   ├── Front/             # 前台功能
│   │   ├── Controllers/   # 前台控制器
│   │   ├── Models/        # 数据模型
│   │   ├── Services/      # 服务类（红娘佣金等）
│   │   └── Views/         # 视图 + themes/ 主题目录
│   ├── Lang/              # 语言包（13 种语言）
│   └── Services/          # 公共服务类
├── public/                 # 公共目录（Web根目录）
│   ├── assets/           # 静态资源（CSS/JS/图片）
│   ├── uploads/          # 上传文件
│   ├── index.php         # 前台入口
│   └── admin.php         # 后台入口
├── routes/                # 路由文件（web.php / admin.php）
├── storage/               # 存储目录（日志/缓存）
├── install.php           # 安装向导
└── composer.json          # Composer配置
```

## 🔧 配置说明

### 数据库配置

编辑 `app/Config/database.php`：

```php
return [
    'host' => '127.0.0.1',
    'dbname' => 'intl_dating',
    'user' => 'root',
    'password' => 'password',
];
```

### 支付配置

编辑 `app/Config/payment.php` 配置PayPal和Stripe密钥。

## 🎯 主要功能

### 一、前台功能（用户端）

**1. 账号与认证**
- 邮箱注册（验证码校验）、登录、退出
- 忘记密码（邮箱找回）
- 男性头像上传需后台审核，前端显示「审核中」徽章

**2. 发现与匹配**
- 首页推荐列表
- 用户搜索（性别 / 国家 / 年龄条件）
- 发现页（`/discover`）异性推荐 feed
- 在线用户列表 + 30 分钟心跳在线统计
- 男女隔离模式下搜索自动按异性筛选

**3. 个人主页**
- 个人资料编辑、头像上传
- 他人主页（`/u`）查看
- 身份认证申请（后台审核）

**4. 社交关系**
- 好友系统：搜索 / 申请 / 接受 / 拒绝 / 备注 / 删除
- 拉黑管理（黑名单添加 / 移除）
- 点赞、评论互动

**5. 动态广场（`/posts`）**
- 发布文字 / 图片 / 视频动态
- 动态编辑、删除、管理
- 评论与点赞（PC 详情页支持评论输入框，未登录提示引导登录）
- 逐条 / 列表浏览

**6. 相册与照片（`/albums`、`/photos`）**
- 照片相册 / 视频相册创建（类型、名称、封面）
- 私密收费相册（按整册定价解锁，VIP 可配免费）
- 按张付费照片（设为私密、付费解锁）

**7. 短视频（`/shorts`，手机端）**
- 短视频 feed 流、详情页
- 付费视频解锁（扣余额）
- 视频打赏（tip）
- 短视频评论与点赞

**8. 聊天与消息（`/chat`、`/messages`）**
- 实时文字 / 图片 / 视频消息
- 消息撤回
- 付费聊天：付费消息 / 付费发图 / 付费发视频（单价后台可配，VIP 豁免可配，含免费额度）
- 付费查看对方发来的图片 / 视频（媒体解锁 `/chat/unlock-media`）
- 客服会话入口（`/chat/support`）
- 消息中心（`/messages`）会话列表

**9. 消费与支付体系**
- 余额充值：PayPal / Stripe 在线支付 + 人工充值（后台审核）
- VIP 开通 / 续费（`/vip`、`/upgrade`）
- 礼物赠送（礼物盒子 `/gifts-box`，赠送列表、发送）
- 红包收发（`/red-package/send|receive|detail`）
- 照片墙上墙（套餐购买、上墙管理）
- 文本翻译（`/translate`，百度翻译，按次扣余额）
- 红娘 / 月老服务开通
- 邀请好友（`/invite`）

**10. 订单与消费记录（`/orders`）**
- 订单列表：消费类型识别（充值 / VIP / 礼物 / 红包 / 翻译 / 视频解锁 / 视频打赏 / 照片解锁 / 相册解锁 / 聊天消息 / 聊天图片视频等）
- 消费详情展示（如礼物名称×数量、视频标题与作者、红包对象等）
- 余额变动与变动后余额回溯

**11. 其它**
- 多语言切换（`/lang`，13 种语言）
- 通知中心、条款与隐私页、帮助与关于
- 设置中心（密码 / 通知 / 隐私 / 黑名单 / 认证）
- 登录 / 注册页深色玻璃风格（PC 与手机端统一）

### 二、后台功能（管理端 `/admin`）

**1. 数据大屏（后台首页）**
- 今日核心指标：新增用户、活跃用户、付费订单、订单金额、在线人数、男女比例
- 累计与趋势：累计用户、累计收入、近 7 天新增与收入、礼物赠送笔数与金额、待处理事项
- 内容规模：动态 / 相册 / 照片 / 视频 / 礼物 / 订单总量
- 近 7 天新增用户与收入趋势柱状图（悬停查看当日明细）
- 聊天媒体统计（发送 / 查看图片视频的次数与收入）
- 最近订单 / 充值列表
- 待办提醒（待处理订单、待审核头像，可点击直达）
- 跑马灯滚动播报 + 全屏大屏模式 + 快速导航卡片

**2. 用户管理**
- 用户增删改查、启用 / 封禁
- 注册审核（单个 / 批量审批）
- 头像审核（独立审核页，当前头像 vs 待审头像对比，单个 / 批量通过）
- 身份认证审核（通过 / 拒绝）
- 修改用户密码
- 代登录（login-as 模拟用户登录）
- 用户聊天记录查看

**3. 媒体内容管理**
- 相册管理：上下架 / 删除
- 照片管理：上下架 / 删除 / 设为私密、批量生成缩略图
- 视频管理：上下架 / 删除 / 设为付费视频
- 动态管理：置顶 / 删除 / 批量操作、动态详情与评论删除

**4. 礼物与订单**
- 礼物管理：礼物商品增删改
- 礼物赠送记录：赠送明细与统计
- 订单管理：关键词 / 状态 / 支付渠道 / 日期筛选
  - 消费类型徽章（16 种类型分色：翻译 / 看视频 / 视频打赏 / 看照片 / 相册 / 礼物 / 红包 / VIP / 充值 / 聊天 / 媒体 / 红娘 / 照片墙等）
  - 消费详情（礼物名称×数量、视频标题·作者、红包对象、翻译说明等）
  - 订单状态流转（待支付 / 已支付 / 已发货 / 已完成 / 已取消）

**5. 照片墙管理**
- 上墙套餐管理
- 上墙用户管理

**6. 红娘管理**
- 红娘列表与资料管理
- 佣金结算（订单分销佣金计算）

**7. 客服体系**
- 人工客服：会话列表、消息发送、人工审核
- 机器人客服（bot-kefu）：机器人收件箱、消息翻译、会员群发、自动回复规则引擎

**8. 系统设置**
- 站点基础配置
- 支付设置（PayPal / Stripe）+ 充值套餐管理
- 存储配置（本地上传）
- 邮件配置（SMTP）
- 聊天设置（付费消息 / 图片 / 视频单价、免费额度、VIP 豁免开关）
- 条款与隐私政策内容管理
- 模板 / UI 管理（PC 与手机模板、资源缓存版本）
- 多语言管理
- 数据库一键升级（迁移）
- 后台管理员密码修改

**9. 审计日志**
- 后台敏感操作记录（订单状态变更等）

## 🔒 安全建议

1. 安装完成后删除 `install.php`
2. 修改默认管理员密码
3. 配置HTTPS
4. 定期备份数据
5. 设置合理的文件权限

## 📞 技术支持

如有问题，请查看文档或联系技术支持。

## 📋 更新日志

### 2026-09-23 界面优化与统计完善

#### ✨ 新增功能

**1. PC 端动态详情页评论功能**
- 修改 `app/Front/Views/themes/huaidan_pc/post/detail.php`
- 评论区新增输入框与提交逻辑（`POST /comments`），成功后免刷新插入列表顶部、评论数 +1
- 未登录显示「登录后参与评论」提示；新增语言键 `pd_comment_login_tip`（13 语言）

**2. 后台首页数据统计完善**
- 修改 `app/Admin/Controllers/DashboardController.php` + `app/Admin/Views/dashboard.php`
- 新增统计：累计收入 / 累计已支付订单 / 近 7 天新增与收入 / 礼物赠送笔数与金额 / 待处理订单 / 待审核头像
- 大屏重排为：今日指标 → 累计与趋势 → 内容规模 → 趋势图 + 聊天媒体统计 + 最近订单
- 新增待办提醒条（直达处理页）、跑马灯扩充、快速导航卡片化
- 修复原页面未闭合容器与全局 `a:hover` 样式泄漏问题

**3. 后台订单列表详细消费记录**
- 修改 `app/Front/Models/Order.php`：抽出 `resolveType()` 共用解析方法，新增 `enrichForAdmin()` 后台批量补充（跨用户、不含余额回溯，前台 `enrichOrders()` 行为不变）
- 修改 `app/Admin/Controllers/AdminOrdersController.php`：列表与详情页接入消费类型 / 详情补充
- 修改 `app/Admin/Views/orders/index.php`：类型列显示完整消费文案 + 详情小字，徽章扩展为 16 种分色
- 修改 `app/Admin/Views/orders/show.php`：详情页新增「消费类型」「消费详情」字段，礼物明细表补充空态

#### 🎨 样式优化

**4. 手机端登录 / 注册页透明玻璃背景**
- 修改 `public/assets/front/mobile-template-huaidan-mobile.css`
- `.m-auth-container` 由白色底改为与 PC 端 `.au-panel` 一致的深色玻璃（不再遮挡背景图），配套提亮输入图标、复选框、错误提示与分隔线

#### 🌍 语言包补全

**5. 相册页面多语言补全（54 个新键 × 13 语言）**
- 相册类型（照片相册 / 视频相册）、私密收费相册、定价、VIP 免费提示
- 照片页 / 视频页 / 解锁确认 / 删除确认等全部缺失键补齐（PC 与手机主题）
- 顺带修复相册视图中 10 处绕过语言包的 JS 硬编码中文（上传失败 / 网络错误 / 解锁失败 / 操作失败）

---

### 2026-07-06 功能修复与优化

#### 🐛 Bug 修复

**1. 女性账号支持发送空白警告消息**
- 修改 `app/Front/Controllers/ChatController.php`
- 消息类型为 `warning`（违规提醒）时，允许发送空白内容消息

**2. 后台审核"通过"按钮点击无反应**
- 修改 `app/Admin/Views/users/index.php`
- 修复 HTML 表单嵌套问题：批量审批 `<form>` 与单个用户审批表单不再嵌套
- 通过 HTML5 `form` 属性关联批量审批表单，解决浏览器忽略内层表单的兼容性问题

**3. 男女隔离时前端好友搜索男生禁止搜索男生**
- 修改 `app/Front/Controllers/FriendsController.php` — 搜索接口自动按异性筛选
- 修改 `app/Front/Views/friends/mobile.php` — 开启隔离时隐藏性别/国家/年龄条件筛选

#### ✨ 新增功能

**4. 男性账号头像上传需后台审核**
- 新增数据库迁移 `database/migrations/20260706_add_avatar_review.sql`（添加 `avatar_status`、`pending_avatar` 字段）
- 修改 `app/Front/Models/User.php` — 新增字段加入允许更新列表
- 修改 `app/Front/Controllers/SettingsController.php` — 男性上传进入待审核状态，女性直接生效
- 修改 `app/Admin/Controllers/AdminUsersController.php` — 新增 `approveAvatar()` / `rejectAvatar()` 审核方法
- 修改 `routes/admin.php` — 新增头像审核路由
- 修改 `app/Admin/Views/users/index.php` — 后台用户列表新增头像审核状态标记和通过/拒绝按钮
- 修改 `app/Lang/zh_CN/messages.php` / `app/Lang/en/messages.php` — 新增审核提示多语言翻译

#### ⚠️ 升级注意事项
- **必须执行数据库迁移**：在后台「一键升级」页面执行迁移，或手动运行 `database/migrations/20260706_add_avatar_review.sql`
- 确保 `public/uploads/` 目录有写入权限
- 女性头像无法上传可能因 `register_female_need_approval` 配置导致账号无法登录，请在后台检查配置

**5. 后台用户管理左侧新增「头像审核」菜单和独立审核页面**
- 新增 `app/Admin/Controllers/AdminAvatarReviewController.php` — 头像审核专用控制器（审核通过/拒绝/批量通过）
- 新增 `app/Admin/Views/avatar-review/index.php` — 头像审核页面（当前头像 vs 待审头像对比展示）
- 修改 `routes/admin.php` — 新增 `/admin/avatar-review` 相关路由
- 修改 `app/Admin/Views/layout.php` — 用户管理侧边栏新增「头像审核」菜单项

**6. 修复头像审核开关无效问题（开启后男生头像仍直接生效）**
- 修改 `app/Front/Controllers/SettingsController.php` — `uploadAvatar()` 改用数据库字段预检机制
  - 先执行 `SHOW COLUMNS FROM users LIKE 'avatar_status'` 检查字段是否存在
  - 只有开关开启 + 数据库字段就绪时才进入待审核流程
  - 字段缺失时记录 `error_log` 警告，提示管理员执行数据库迁移
- 修改 `app/Admin/Controllers/AdminAvatarReviewController.php` — 同样加入字段存在性预检
- 修改 `app/Admin/Views/avatar-review/index.php` — 数据库未迁移时显示引导前往一键升级的提示

**7. 前端「审核中」状态徽章 + 后台「已通过」内联反馈**
- 移动端设置页 (`mobile.php`) — 头像区域底部显示橙色「审核中」徽章（`avatar_status === 'pending'` 时），通过后不显示
- PC端设置页 (`index.php`) — 头像下方显示圆角「审核中」徽章，通过后不显示
- 上传头像 JS 新增 `data.pending` 标记响应，动态添加/移除审核徽章
- 后台头像审核页改为 AJAX 操作：点击「通过」→ 行变绿显示「✓ 已通过」；点击「拒绝」→ 行渐隐移除
- 审核控制器 `approve()`/`reject()` 支持 `X-Requested-With: XMLHttpRequest` 头返回 JSON
- 多语言新增 `avatar_review_pending` / `avatar_review_approved` / `avatar_review_rejected`

---

## 📄 许可证

版权所有 © 2024 坏蛋网络科技