diff --git a/README.md b/README.md index efc1ac95255a404005444c84e5a3fbd0264fe8f7..6a390ace7b424b7eeddfb386a7cc9a4f28d3ea23 100644 --- a/README.md +++ b/README.md @@ -1,431 +1,101 @@ -# 晴玖极简发卡系统 - -一个轻量级的自助发卡系统，包含管理后台和用户前台。基于PHP原生+MySQL开发，无需框架，部署简单。 - -## 系统特点 - -- **轻量级**：无需框架，基于PHP原生开发，性能卓越 -- **管理后台**：商品管理、卡密管理、订单管理、系统设置等一应俱全 -- **用户前台**：响应式设计，完美适配PC端和移动端 -- **多语言支持**：内置多种语言，支持快速切换 -- **多支付渠道**：支持平安夜支付、易支付(V1/V2)接口和PayPal国际支付 -- **自动发货**：订单支付完成后自动发送卡密到用户邮箱 -- **多发货方式**：支持卡密发货、固定信息发货(无限卡密)、API对接发货和人工核销发货 -- **多端模板**：支持PC端和移动端不同模板，并可一键切换 -- **邀请系统**：完整的邀请码生成和管理功能，解锁易支付V1和V2接口，无限分类和无限商品功能 -- **AI宣传文案**：内置AI助手，自动生成营销宣传内容 -- **滑动验证码**：更安全的验证码机制，防止机器人攻击 -- **维信聊天室**：集成私域聊天群和站长聊天室功能，提升用户粘性 -- **数据库同步**：系统更新后自动提示同步数据库结构 -- **邮件通知**：基于PHPMailer的可靠邮件发送系统 -- **微信推送**：支持WxPusher的消息推送，及时通知站长和用户 -- **自动识别站点URL**：无需手动配置，自动适应不同环境 -- **二维码支持**：内置二维码生成功能 -- **自动更新**：一键在线升级系统到最新版本 -- **访问统计**：详细记录网站流量和用户行为数据 -- **支付汇率配置**：支持自定义不同货币的汇率转换，适配国际支付 -- **发货日志模块**：详细记录每笔订单的发货情况，方便排查问题 - -## 前台演示 -[https://test3.79tian.com/](https://test3.79tian.com/) - -## 下载地址 - -官方发布地址：[https://gitee.com/QtCodeCreators/faka/releases](https://gitee.com/QtCodeCreators/faka/releases) - -> **注意**：本系统为免费商用软件，可在授权范围内使用，无需付费购买，但不允许进行二次开发，有需求可以去提issues - -## 安装说明 - -### 环境要求 - -- PHP 7.0+ -- MySQL 5.6+ -- PDO_MySQL扩展 -- OpenSSL扩展 -- GD库（用于验证码和二维码生成） -- cURL扩展（用于接口请求和更新检查） -- JSON扩展（用于数据处理） -- ZIP扩展（用于自动更新功能） -- 支持SMTP的邮箱（用于发送邮件） - -### 安装步骤 - -1. 将源码上传到网站根目录 -2. 访问网站，系统将自动进入安装向导 -3. 填写数据库信息和管理员账号 -4. 安装完成后，使用创建的管理员账号登录后台 -5. 登录后台配置网站基本信息和支付接口 - -> **全新安装模式**：系统采用数据库校准模式，无需手动导入数据库，安装向导会自动完成数据库初始化 - -> **升级说明**：系统支持一键在线升级，升级后会自动提示进行数据库同步，确保系统正常运行 - -## 目录结构 - -``` -├── admin/ # 管理后台目录 -│ ├── api/ # 管理后台API接口 -│ │ ├── ai_chat.php # AI聊天助手API -│ │ ├── data_analysis.php # 数据分析API -│ │ ├── invite/ # 邀请码API -│ │ │ └──generate_promo.php # 生成宣传文案API -│ │ ├── product/ # 商品管理API -│ │ └── settings/ # 系统设置API -│ ├── js/ # 后台JavaScript文件 -│ ├── index.php # 后台首页 -│ ├── login.php # 管理员登录页面 -│ ├── settings.php # 系统设置 -│ ├── products.php # 商品管理列表 -│ ├── product_edit.php # 商品编辑页面 -│ ├── categories.php # 分类管理列表 -│ ├── cards.php # 卡密管理页面 -│ ├── orders.php # 订单管理列表 -│ ├── order_detail.php # 订单详情页面 -│ ├── payment_settings.php # 支付设置页面 -│ ├── exchange_rate.php # 汇率配置页面 -│ ├── delivery_logs.php # 发货日志管理页面 -│ ├── admins.php # 管理员列表 -│ ├── invite.php # 邀请码管理页面 -│ ├── visits.php # 访问统计页面 -│ ├── templates.php # 模板切换管理页面 -│ ├── ai_chat.php # AI聊天助手 -│ ├── issues.php # 问题反馈管理 -│ ├── version.php # 版本管理与更新 -│ └── db_maintenance.php # 数据库维护 -├── api/ # 前台API接口目录 -│ ├── delivery/ # 发货API接口目录 -│ └── invite/ # 邀请相关API -├── backup/ # 数据库备份目录 -├── cache/ # 缓存目录 -│ └── ip/ # IP信息缓存 -├── data/ # 系统数据目录 -│ ├── invite/ # 邀请数据 -│ └── visits/ # 访问统计数据 -├── includes/ # 系统核心文件 -│ ├── gateways/ # 支付网关实现 -│ │ ├── QjpayGateway.php # 平安夜支付网关 -│ │ ├── EpayV1Gateway.php # 易支付V1网关 -│ │ ├── EpayV2Gateway.php # 易支付V2网关 -│ │ └── PaypalGateway.php # PayPal支付网关 -│ ├── delivery/ # 发货方式实现 -│ │ ├── CardDelivery.php # 卡密发货 -│ │ ├── FixedDelivery.php # 固定信息发货 -│ │ ├── ApiDelivery.php # API对接发货 -│ │ └── ManualDelivery.php # 人工核销发货 -│ ├── invite/ # 邀请系统 -│ │ ├── functions.php # 邀请功能函数 -│ ├── parsedown/ # Markdown解析库 -│ ├── PHPMailer/ # 邮件发送库 -│ ├── WxPusher/ # 微信推送库 -│ ├── config.php # 配置文件 -│ ├── db.php # 数据库操作类 -│ ├── functions.php # 公共函数 -│ ├── payment.php # 支付处理核心类 -│ ├── PaymentFactory.php # 支付网关工厂类 -│ ├── PaymentGatewayLoader.php # 支付网关加载器 -│ ├── PaymentConfig.php # 支付配置管理 -│ ├── payment_utils.php # 支付工具函数 -│ ├── exchange_rate.php # 汇率计算工具 -│ ├── EpayCore.class.php # 易支付核心类 -│ ├── captcha.php # 验证码生成器 -│ ├── sliding-captcha.php # 滑动验证码实现 -│ ├── language.php # 语言处理 -│ ├── phpqrcode.php # 二维码生成 -│ ├── version_info.php # 版本信息 -│ ├── db_schema.php # 数据库结构定义 -│ ├── db_synchronizer.php # 数据库同步工具 -│ ├── template_manager.php # 模板管理工具 -│ ├── backup_database.php # 数据库备份功能 -│ └── gitee_helper.php # Gitee API交互助手 -├── install/ # 安装程序目录 -│ ├── static/ # 安装界面静态资源 -│ ├── index.php # 安装引导页面 -│ ├── install.php # 安装处理脚本 -│ └── check_environment.php # 环境检查脚本 -├── languages/ # 多语言文件目录 -│ ├── zh-CN/ # 简体中文 -│ ├── en-US/ # 英语(美国) -│ ├── ja-JP/ # 日语 -│ ├── ru-RU/ # 俄语 -│ ├── de-DE/ # 德语 -│ ├── fr-FR/ # 法语 -│ ├── es-ES/ # 西班牙语 -│ └── ug-CN/ # 维吾尔语 -├── logs/ # 系统日志目录 -│ ├── ai/ # AI功能相关日志 -│ ├── delivery/ # 发货相关日志 -│ └── invite_test/ # 邀请功能测试日志 -├── static/ # 静态资源文件 -│ ├── css/ # CSS样式文件 -│ │ ├── cyberpunk/ # 赛博朋克主题样式 -│ │ └── sliding-captcha/ # 滑动验证码样式 -│ ├── js/ # JavaScript文件 -│ │ ├── sliding-captcha/ # 滑动验证码脚本 -│ │ ├── tinymce/ # TinyMCE富文本编辑器 -│ │ └── wangeditor/ # wangEditor富文本编辑器 -│ ├── img/ # 图片资源 -│ │ └── payment/ # 支付方式图标 -│ ├── fonts/ # 字体文件 -│ └── webfonts/ # Web字体文件 -├── templates/ # 前台模板目录 -│ ├── default/ # 默认PC端模板 -│ └── mobile/ # 移动端模板 -├── temp/ # 临时文件目录 -│ └── updates/ # 更新临时文件 -├── uploads/ # 上传文件目录 -│ ├── editor/ # 编辑器上传文件 -│ ├── qrcode/ # 二维码图片 -│ └── qrcodes/ # 用户上传的二维码 -├── index.php # 前台首页 -├── buy.php # 购买页面 -├── order.php # 订单查询 -├── check_order.php # 订单查询处理 -├── invite.php # 邀请注册页面 -├── captcha_image.php # 验证码生成 -├── process_email_queue.php # 邮件队列处理 -├── process_wxpusher_queue.php # 微信推送队列处理 -├── notify.php # 支付异步通知接口 -├── return.php # 支付同步跳转页面 -└── README.md # 项目说明文档 -``` - -## 数据库表结构 - -系统核心数据库表结构定义在`includes/db_schema.php`文件中，主要包括： - -- `products`: 商品表，存储商品信息 -- `categories`: 分类表，存储商品分类 -- `orders`: 订单表，记录用户订单信息 -- `cards`: 卡密表，存储待售和已售卡密 -- `admins`: 管理员表，存储管理员账号信息 -- `configs`: 系统配置表，存储系统设置 -- `payment_channels`: 支付通道表，配置支付方式 -- `exchange_rates`: 汇率配置表，存储不同货币汇率 -- `email_queue`: 邮件队列表，存储待发送邮件 -- `wxpusher_queue`: 微信推送队列表，存储待推送消息 -- `delivery_logs`: 发货日志表，记录订单发货详情 - -## 功能说明 - -### 多语言支持 - -系统内置多种语言支持，可以在前台轻松切换： - -- 支持简体中文 (zh-CN)、英文 (en-US)、德语 (de-DE)、西班牙语 (es-ES) -- 法语 (fr-FR)、日语 (ja-JP)、俄语 (ru-RU)、维吾尔语 (ug-CN)等 -- 管理后台可开启/关闭多语言功能 -- 用户可通过前台语言选择器切换语言 -- 开发者可通过添加语言文件扩展更多语言支持 - -### 多商品发货方式 - -系统支持多种发货方式，满足不同商品需求： - -- **卡密发货**：传统的一次性卡密自动发货模式 -- **固定信息发货**：适用于虚拟服务，无需消耗卡密库存 -- **API对接发货**：支持对接第三方API自动完成发货 -- **人工核销发货**：适用于需要人工审核或处理的订单 - -### 模板切换系统 - -支持多端多模板切换： - -- **PC端模板**：默认响应式模板，适合桌面浏览器访问 -- **移动端模板**：专为手机用户优化的轻量级模板 -- **一键切换**：管理后台可一键切换不同模板 -- **设备检测**：自动识别用户设备，应用最佳模板 - -### 邀请系统 - -系统提供完整的邀请码功能： - -- **邀请码生成**：后台可以获取邀请链接 -- **AI宣传文案**：自动生成邀请宣传内容，提高转化率 -- **邀请页面**：专门的邀请落地页，提供邀请码登记和下载 -- **邀请统计**：详细记录和统计邀请使用情况 -- **特权解锁**：通过邀请可以解锁以下功能： - - 易支付V1和V2接口完整使用权限 - - 无限商品数量（突破默认的20个限制） - - 无限分类创建权限 - -### 聊天室集成 - -系统集成了维信聊天功能： - -- **私域聊天群**：在前台为用户提供互动交流平台，提升用户粘性 -- **站长聊天室**：在后台为站长提供与其他管理员的实时沟通渠道 -- **地区分组**：支持根据用户IP地区自动分配到不同聊天群组 -- **免登录模式**：支持访客无需登录即可参与聊天 - -### 支付对接 - -系统支持以下支付方式： - -- **平安夜支付**：直接对接平安夜支付网关 -- **易支付V1接口**：支持易支付V1标准接口（需通过邀请或被邀请解锁） -- **易支付V2接口**：支持易支付V2标准接口（需通过邀请或被邀请解锁） -- **PayPal支付**：支持国际支付，接入PayPal标准支付网关 - -在管理后台可轻松配置各支付接口参数，系统会自动处理支付通知和订单状态更新。 - -### 汇率配置 - -系统支持灵活的汇率配置： - -- **多币种支持**：支持配置不同币种间的汇率 -- **实时更新**：支持手动更新或API自动更新汇率 -- **自动转换**：自动将外币转换为本地货币计价 - -### 卡密批量管理 - -增强的卡密管理功能： - -- **批量导入**：支持Excel/CSV/TXT格式批量导入卡密 -- **批量导出**：支持将卡密数据导出备份 -- **批量删除**：支持按条件批量删除卡密库存 -- **状态筛选**：支持按使用状态筛选卡密 - -### 发货日志 - -详细的发货日志系统： - -- **发货记录**：记录每笔订单的发货详情 -- **发货状态**：显示发货成功/失败状态 -- **错误追踪**：记录发货失败原因，便于排查 -- **重新发货**：支持失败订单手动重新发货 - -### 邮件通知系统 - -基于PHPMailer构建的可靠邮件发送系统： - -- 支持SMTP服务器配置 -- HTML邮件模板 -- 支持附件和图片嵌入 -- 邮件发送队列和失败重试机制 - -### 微信推送通知 - -基于WxPusher的推送功能： - -- 订单状态变更推送 -- 系统异常报警推送 -- 管理员登录通知 -- 支付成功通知 - -### 二维码生成 - -内置phpqrcode库，支持多种二维码生成场景： - -- 订单查询二维码 -- 支付二维码 -- 邀请码二维码 -- 自定义链接二维码 - -## 使用说明 - -### 管理员登录 - -- 访问`/admin/`目录进入管理后台 -- 使用安装时设置的管理员账号密码登录 -- 登录后请及时完善网站配置 - -### 商品管理 - -1. 添加商品：填写商品名称、价格、描述等信息 -2. 选择发货方式：卡密发货、固定信息发货、API对接发货或人工核销 -3. 上传/导入卡密：支持批量导入卡密 -4. 设置商品状态：上架/下架 - -### 配置支付接口 - -1. 进入系统设置 -2. 填写支付平台提供的商户ID和密钥 -3. 配置汇率（如使用国际支付） - -### 模板管理 - -1. 进入模板管理页面 -2. 选择PC端或移动端模板 -3. 设置是否自动识别设备类型 - -## 安全建议 - -1. 使用强密码保护管理员账号 -2. 设置合理的目录权限 -3. 定期备份数据库 -4. 启用HTTPS保护用户数据安全 -5. 定期更新系统到最新版本 - -## 常见问题 - -### Q: 支付成功但未发货？ - -A: 检查支付通道列表配置是否有误，确认通知URL是否正确，查看发货日志进行排查。 - -### Q: 如何添加新的语言支持？ - -A: 联系开发者，或在更新建议里面反馈。目前系统已支持8种语言。 - -### Q: 邮件发送失败怎么办？ - -A: 检查SMTP设置是否正确，查看系统日志了解具体错误信息。常见问题包括SMTP认证失败、端口被封等。 - -### Q: 如何修改邮件模板？ - -A: 在管理后台的系统设置中可以自定义邮件模板HTML内容。 - -### Q: 如何使用AI生成宣传文案？ - -A: 进入管理后台的邀请码管理页面，在宣传文案生成工具中选择相应的模板和风格即可生成。 - -### Q: 如何配置PayPal支付？ - -A: 在支付设置页面配置PayPal商户ID和密钥，并在汇率配置中设置正确的汇率。 - - -## 图片展示 -### 前台主页[部分] -![前台主页](https://gitee.com/QtCodeCreators/faka/raw/master/images/imagesimage.png) -![商品详情](https://gitee.com/QtCodeCreators/faka/raw/master/images/imagesimage2.png) -![订单查询](https://gitee.com/QtCodeCreators/faka/raw/master/images/imagesimage3.png) -### 管理后台[部分] -![仪表盘](https://gitee.com/QtCodeCreators/faka/raw/master/images/imagesimage18.png) -![访问统计](https://gitee.com/QtCodeCreators/faka/raw/master/images/imagesimage4.png) -![AI助手](https://gitee.com/QtCodeCreators/faka/raw/master/images/imagesimage5.png) -![管理列表](https://gitee.com/QtCodeCreators/faka/raw/master/images/imagesimage6.png) -![邀请统计](https://gitee.com/QtCodeCreators/faka/raw/master/images/imagesimage7.png) -![数据维护](https://gitee.com/QtCodeCreators/faka/raw/master/images/imagesimage8.png) -![支付网关](https://gitee.com/QtCodeCreators/faka/raw/master/images/imagesimage9.png) -![系统设置](https://gitee.com/QtCodeCreators/faka/raw/master/images/imagesimage10.png) -![版本维护](https://gitee.com/QtCodeCreators/faka/raw/master/images/imagesimage11.png) -![商品列表](https://gitee.com/QtCodeCreators/faka/raw/master/images/imagesimage12.png) -![编辑商品](https://gitee.com/QtCodeCreators/faka/raw/master/images/imagesimage13.png) -![卡密库存](https://gitee.com/QtCodeCreators/faka/raw/master/images/imagesimage14.png) -![批量导入卡密](https://gitee.com/QtCodeCreators/faka/raw/master/images/imagesimage15.png) -![批量导出卡密](https://gitee.com/QtCodeCreators/faka/raw/master/images/imagesimage16.png) -![分类管理](https://gitee.com/QtCodeCreators/faka/raw/master/images/imagesimage17.png) - -## 许可说明 - -本系统为**免费使用**软件，任何人都可以在授权范围内免费使用，无需付费购买。 - -**严格禁止**： -- 对程序进行二次开发并发布 -- 破解或修改程序版权信息 -- 将程序源码进行重新打包销售 -- 未经授权修改并发布程序代码 - -违反上述规定的行为将被视为侵权。 - -## 技术支持 - -如有使用问题，请通过以下方式获取支持： - -- 提交Issues：[https://gitee.com/QtCodeCreators/faka/issues](https://gitee.com/QtCodeCreators/faka/issues) -- 查看Wiki文档：[https://gitee.com/QtCodeCreators/faka/wikis](https://gitee.com/QtCodeCreators/faka/wikis) -- 邮件支持：[keh5@vip.qq.com](keh5@vip.qq.com) - ---- - -Copyright © 2025-2029 QtCodeCreators. All Rights Reserved. \ No newline at end of file + + +晴玖极简发卡系统 +==== +系统特点 +---- +晴玖极简发卡系统是一款轻量级的虚拟商品发卡平台，具备简洁直观的界面和高效的发货机制。主要特点包括： + +- **多语言支持**：系统支持多种语言切换，满足国际化需求。 +- **多商品发货方式**：支持多种虚拟商品的发货方式，便于管理。 +- **模板切换系统**：可灵活更换前端模板，个性化展示。 +- **邀请系统**：支持邀请机制，便于用户推广和增长。 +- **聊天室集成**：内置聊天室功能，方便用户沟通。 +- **支付对接**：支持多种支付方式，包括PayPal等主流支付平台。 +- **汇率配置**：支持多币种，汇率可灵活配置。 +- **卡密批量管理**：支持批量导入和管理卡密。 +- **发货日志**：记录所有发货信息，便于追溯。 +- **邮件通知系统**：支持邮件通知，及时告知用户发货状态。 +- **微信推送通知**：支持通过微信推送通知，提升用户体验。 +- **二维码生成**：支持生成商品二维码，便于分享。 + +安装说明 +---- +### 环境要求 +- PHP 7.4 或更高版本 +- MySQL 5.6 或更高版本 +- Composer +- Web服务器（如 Nginx 或 Apache） + +### 安装步骤 +1. 下载项目代码并解压到服务器目录。 +2. 通过 Composer 安装依赖： + ```bash + composer install + ``` +3. 配置数据库信息，导入数据库表结构（可在文档中找到详细说明）。 +4. 修改系统配置文件，配置支付接口、邮件服务器等信息。 +5. 设置 Web 服务器，确保访问路径正确指向项目入口文件。 +6. 访问前台或管理后台并完成初始化设置。 + +功能说明 +---- +- **商品管理**：支持添加、编辑、删除商品信息。 +- **支付接口配置**：可配置 PayPal 等多种支付接口。 +- **模板管理**：支持切换和自定义前端模板。 +- **发货日志**：实时查看所有发货记录。 +- **多语言支持**：轻松添加或切换语言包。 + +使用说明 +---- +### 管理员登录 +访问管理后台，输入管理员账号和密码登录，进行系统设置和商品管理。 + +### 商品管理 +在后台添加商品信息，包括名称、价格、发货方式等。支持批量导入商品和卡密。 + +### 支付接口配置 +在系统设置中配置 PayPal 或其他支付接口的 API 信息，确保支付流程畅通。 + +### 模板管理 +系统支持多模板切换，可在配置中启用新模板或自定义模板样式。 + +安全建议 +---- +1. 确保数据库和服务器权限配置安全。 +2. 定期更新系统依赖，防止潜在漏洞。 +3. 使用 HTTPS 加密传输数据，保障支付安全。 +4. 限制后台登录尝试次数，防止暴力破解。 + +常见问题 +---- +### Q: 支付成功但未发货？ +A: 检查支付回调接口是否配置正确，同时查看发货日志确认是否存在异常。 + +### Q: 如何添加新的语言支持？ +A: 在语言包目录中添加对应语言的翻译文件，并在配置文件中启用。 + +### Q: 邮件发送失败怎么办？ +A: 检查邮件服务器配置是否正确，确保邮件模板内容无误。 + +### Q: 如何修改邮件模板？ +A: 在邮件模板目录中找到对应模板文件，修改内容即可。 + +### Q: 如何使用AI生成宣传文案？ +A: 在系统后台的文案生成模块中，输入关键词和风格，即可生成宣传文案。 + +### Q: 如何配置 PayPal 支付？ +A: 在支付配置页面填写 PayPal 的 API Key 和 Secret，设置回调地址。 + +图片展示 +---- +- **前台主页**：展示商品列表和购买入口。 +- **管理后台**：提供商品管理、订单查看、支付配置等功能。 + +许可说明 +---- +本项目采用 MIT 许可证，详情请参考 LICENSE 文件。 + +技术支持 +---- +如需技术支持，请访问我们的官方论坛或联系客服邮箱。 \ No newline at end of file