项目源码说明 README.md
一、项目简介
本套源码是一套基于 PHP 开发的多端一体化业务管理系统，集成 PC 管理后台、H5 网页、微信小程序、API 接口服务，开箱即用，内置可视化安装程序，支持在线版本升级，适合家政服务、本地生活、上门维修、服务预约类商业项目快速落地与二次开发。
二、核心技术栈
- 后端语言：PHP 7.4 ~ PHP 8.1
- 数据库：MySQL 5.7 / 8.0
- Web 服务：Apache / Nginx（自带.htaccess 伪静态规则）
- 前端：原生 JS + CSS + HTML，小程序原生代码
- 架构模式：简易 MVC 分层，前后端分离接口设计
三、源码核心特点
1. 部署简单，零代码基础快速安装
- 内置完整
install可视化安装向导，上传源码至服务器，访问域名自动进入安装页 - 自动检测服务器环境、数据库权限、目录读写权限，异常项给出修复提示
- 一键导入数据库，自动创建管理员账号，3 分钟完成部署上线
- 自带在线更新脚本
update.php，支持后续版本补丁、数据库结构同步升级
2. 多端统一打通，一套后端支撑多终端
- Admin 后台管理端：完整运营后台，订单、用户、商品 / 服务、财务、权限、配置统一管理
- API 接口层：标准化 REST 接口，鉴权、分页、统一返回格式，支持第三方对接
- H5 前端页面：适配手机浏览器，可独立分发、分享
- miniapp 小程序端：完整微信小程序前端源码，无需重构后端接口直接使用
- 多端数据互通，用户、订单、资金数据实时同步，统一后台管控
3. 目录分层清晰，易维护、易二次开发
plaintext
├── admin # 管理后台业务代码
├── api # 通用接口服务
├── assets # 静态资源css/js/图片
├── config # 全局配置文件（数据库、密钥、支付、第三方配置）
├── includes # 公共工具类、函数库、数据库操作封装
├── install # 安装程序
├── miniapp # 小程序前端源码
├── pages # H5页面视图
├── runtime # 缓存、日志、临时文件（自动生成，需读写权限）
├── uploads # 用户上传图片、附件存储目录
├── views # 后台模板视图
├── update.php # 系统在线升级入口
├── index.php # 项目统一入口
- 业务代码与配置、静态资源完全分离
- 公共方法统一封装，减少重复代码，修改功能无需多处改动
- 注释规范，关键业务逻辑标注清晰，新手也能快速看懂
4. 完善通用业务能力，商用开箱即用
- 用户体系：会员注册登录、分销、余额、优惠券、会员等级
- 订单体系：下单、支付、退款、订单状态流转、工单管理
- 文件上传：统一上传组件，图片压缩、格式限制、路径隔离
- 权限管理：后台多角色分权限，管理员菜单、操作权限精细化控制
- 支付集成：预留微信支付、支付宝支付对接接口
- 系统配置：后台可视化修改站点名称、LOGO、联系方式、开关功能
- 日志记录：运行日志、操作日志、支付日志统一存入 runtime，方便排错
5. 安全防护机制
- 全局输入过滤，防 SQL 注入、XSS 跨站攻击
- 接口 Token 鉴权，非法请求拦截，防止越权访问
- 上传目录限制脚本执行，禁止恶意文件上传运行
- 数据库账号密码独立配置，不硬编码在业务代码中
- 后台登录验证码、登录异常记录，防止暴力破解
6. 轻量化高性能，服务器门槛低
- 无重型框架依赖，原生 PHP 开发，运行占用资源低
- 数据库查询缓存机制，减少重复 SQL 请求，访问速度快
- 静态资源可搭配 CDN 加速，支持图片压缩优化
- 兼容虚拟主机、轻量云服务器，低配服务器也可稳定运行
7. 高度可定制，二次开发友好
- 业务逻辑解耦，新增功能模块无需改动底层核心代码
- 视图与业务分离，修改页面样式仅调整 views/pages 目录文件
- 接口统一规范，可自由新增接口、对接 APP、其他第三方平台
- 关闭、隐藏功能仅需后台配置开关，无需修改源码
四、环境要求
- PHP ≥7.4，推荐 8.0/8.1
- MySQL ≥5.7
- 开启 PHP 扩展：mysqli、curl、gd、fileinfo
- 服务器：Apache / Nginx
- 目录权限：runtime、uploads、install 设置 755/777 读写权限
五、安装步骤
- 将全部源码上传至网站根目录
- 创建 MySQL 数据库，记录数据库名、账号、密码
- 浏览器访问域名，自动跳转
/install安装页面 - 按页面提示填写数据库信息、设置管理员账号密码
- 安装完成后删除 install 文件夹（安全建议）
- 后台地址：域名 /admin，小程序配置后端域名即可对接
六、升级说明
- 下载新版源码，覆盖除
config、uploads以外文件 - 访问域名 /update.php 执行数据库升级
- 升级完成后清理 runtime 缓存目录
七、使用须知
- 商用部署建议修改后台登录地址、数据库前缀提升安全性
- 生产环境请删除 install 安装目录，避免重复安装导致数据丢失
- 定期备份数据库与 uploads 上传文件目录
- 第三方密钥（支付、小程序 appid 等）请妥善保管，不要泄露