项目文档 一、 项目概述 本项目是一个赛事管理系统，提供了赛事的创建、管理、报名、证书上传等功能。系统包括前端页面、后台管理和API接口。 二、 项目结构 project-root/ │ ├── admin/ # 后台管理系统 │ ├── api/ # API接口 │ ├── assets/ # 静态资源 │ ├── includes/ # 公共函数和认证 │ ├── layout/ # 页面布局 │ ├── pages/ # 后台页面 │ ├── init.php # 初始化文件 │ ├── login.php # 登录页面 │ └── logout.php # 注销页面 │ ├── api/ # 前端API接口 │ ├── config/ # 配置文件 │ └── db_connect.php # 数据库连接配置 │ ├── assets/ # 前端静态资源 │ ├── src/ # 前端源代码 │ └── components/ # React组件 │ ├── index.html # 前端首页 ├── form.html # 报名表单页面 ├── success.html # 支付成功页面 ├── competition_list.html # 赛事列表页面 ├── certificate_query.html # 证书查询页面 └── test_db.php # 数据库测试文件 三、 API 介绍 1. 获取赛事列表 • URL: /api/competition_list.php • 方法: GET • 描述: 获取所有未结束的赛事列表。 • 响应: { "success": true, "data": [ { "id": 1, "name": "2024青少年编程大赛", "start_date": "2024-03-01", "end_date": "2024-04-30", "price": 299.00, "status": "进行中", "thumbnail": "assets/images/competitions/thumb1.jpg", "banner": "assets/images/tp/image1.jpg", "pdf_file": "assets/docs/competition1.pdf" } ] } 2. 注册赛事 • URL: /api/register.php • 方法: POST • 参数: competition_id, name, school, student_id, phone • 描述: 注册参加指定的赛事。 • 响应: { "success": true, "message": "报名成功", "data": { "registration_id": 123, "out_trade_no": "2024030112345678", "payment_amount": 299.00 } } 3. 上传证书 • URL: /api/upload_certificate.php • 方法: POST • 参数: registration_id, certificate (文件) • 描述: 上传参赛者的证书。 • 响应: { "success": true, "message": "证书上传成功", "path": "assets/images/zs/certificate_123.jpg" } 4. 查询订单 • URL: /api/order_query.php • 方法: GET • 参数: phone • 描述: 根据*号查询订单信息。 • 响应: { "success": true, "data": [ { "id": 1, "competition_name": "2024青少年编程大赛", "name": "张三", "school": "北京大学", "phone": "13800138001", "payment_amount": "299.00", "status": "已支付", "certificate_path": "assets/images/zs/certificate_123.jpg" } ] } 数据库配置 数据库配置文件 在 config/db_connect.php 中配置数据库连接： 四、 // 数据库配置 五、 $host = 'localhost'; // 数据库主机 六、 $dbname = 'competition_system'; // 数据库名 七、 $username = 'root'; // 数据库用户名 八、 $password = 'root'; // 数据库密码 九、 $charset = 'utf8mb4'; // 字符集 十、 十一、 部署指南 环境要求 • 操作系统: Linux/Unix 或 Windows • Web 服务器: Apache 或 Nginx • PHP: 7.4 或更高版本 • 数据库: MySQL 5.7 或更高版本 部署步骤 1. 克隆代码库 git clone https://github.com/your-repo/competition-system.git cd competition-system 2. 配置Web服务器 • Apache: 确保启用了mod_rewrite模块，并在虚拟主机配置中设置DocumentRoot指向项目的public目录。 • Nginx: 配置server块，设置root指向项目的public目录，并配置PHP处理。 • 配置数据库 • 创建数据库并导入database.sql文件： CREATE DATABASE competition_system; USE competition_system; SOURCE /path/to/database.sql; • 在config/db_connect.php中配置数据库连接信息。 • 设置文件权限确保assets/images和assets/docs目录可写，以便上传文件。 chmod -R 775 assets/images chmod -R 775 assets/docs • 安装依赖如果项目使用了Composer或NPM，请安装依赖： composer install npm install • 启动服务确保Web服务器和数据库服务已启动，并访问项目的URL以确认部署成功。7. 配置域名和SSL • 配置域名解析到服务器IP。 • 使用Let's Encrypt或其他证书颁发机构配置SSL证书。 • 测试通过访问API和前端页面，确保所有功能正常工作。---这套文档涵盖了项目的主要功能和部署步骤，确保您能够顺利地进行开发和部署。如果有任何问题或需要进一步的帮助，请随时联系技术支持团队。