docs: 更新 README 以反映项目结构调整和新增功能

- 添加管理员后台和开发者后台目录结构说明
- 更新环境要求和安装步骤,包含 Composer 依赖安装
- 补充功能说明,新增开发者后台功能介绍
- 完善注意事项,添加邮件服务配置说明
This commit is contained in:
2025-07-08 15:42:07 +08:00
parent dfd1d066ba
commit 858edb887d

View File

@@ -9,7 +9,25 @@ app2/
├── app_store.sql # 数据库初始化 SQL 文件
├── index.php # 首页
├── app.php # App 信息页
├── admin.php # App 管理页
├── admin/ # 管理员后台目录
│ ├── addapp.php
│ ├── deleteapp.php
│ ├── editapp.php
│ ├── index.php
│ ├── login.php
│ ├── manage_tags.php
│ ├── review_apps.php
│ └── system_info.php
├── developer/ # 开发者后台目录
│ ├── dashboard.php
│ ├── edit_app.php
│ ├── login.php
│ ├── logout.php
│ ├── profile.php
│ ├── register.php
│ └── upload_app.php
├── vendor/ # Composer 依赖
├── includes/ # 通用包含文件
├── api.php # API 接口文件
├── styles.css # 自定义 CSS 文件
├── images/ # 存储 App 预览图片和年龄分级 SVG
@@ -21,28 +39,36 @@ app2/
```
## 环境要求
- PHP 7.4
- MySQL
- PHP 7.4+
- MySQL 5.7+
- Composer
- Node.js (可选,用于前端资源构建)
- Web 服务器(如 Apache 或 Nginx
## 安装步骤
1. 创建项目目录并将代码复制到该目录下。
2. 修改 `config.php` 文件,配置 MySQL 数据库信息管理员账号。
3. 执行 `app_store.sql` 文件,创建数据库和表结构。可以使用以下命令
2. 修改 `config.php` 文件,配置 MySQL 数据库信息管理员账号和邮件服务设置
3. 安装依赖包(将自动创建 `vendor` 目录并安装 PHPMailer 等必要依赖)
```bash
composer install
```
4. 执行 `app_store.sql` 文件,创建数据库和表结构(确保数据库名为'awa'
```sql
mysql -u your_username -p your_database < app_store.sql
mysql -u your_username -p awa < app_store.sql
```
4. 创建 `files` 和 `images` 目录,并确保 Web 服务器对这些目录有写入权限。
## 功能说明
- **首页**:展示最新 App 列表,包含基本信息和评分。
- **App 信息页**:显示 App 详细信息、版本历史、预览图片和用户评价,支持用户评分。
- **管理页**:管理员可以添加、删除 App上传 App 文件和预览图片
- **管理页**:管理员可以添加、删除 App审核应用,管理标签和查看系统信息
- **开发者后台**:开发者可以注册账号、管理应用、上传新版本和查看应用统计。
- **API 接口**:提供 `/api` 获取 App 列表,`/api/app/<编号>` 获取单个 App 详细信息。
## 管理员登录
默认管理员账号信息在 `config.php` 中配置,登录后可访问管理页面。
## 注意事项
- 请确保 `files``images` 目录有足够的写入权限。
- 生产环境中建议修改管理员密码和数据库信息,保系统安全。
- 请确保 `files``images` 目录以及其子目录有足够的写入权限推荐设置权限为755
- 生产环境中必须修改默认管理员密码和数据库连接信息,保系统安全。
- 邮件服务配置:请在 `config.php` 中正确设置 SMTP 服务器地址、端口、用户名和密码,以确保开发者邮箱验证功能正常工作。