feat: 重构后台管理界面样式并新增商户/帖子审核功能
- 重构后台所有管理页面工具栏,移除图标改用纯文字按钮 - 新增商户管理的批量审核功能与商家详情/审核页面 - 新增帖子管理的批量审核/上下架功能与帖子详情/审核页面 - 新增多媒体相册字段的前后台处理逻辑 - 新增微信订阅消息兼容导出层 - 更新站点版本号并优化品牌色变量 - 新增商户/帖子控制器的详情与审核方法 - 新增 .sql 文件忽略规则
这个提交包含在:
147
docs/07-线上服务器部署与同步清单.md
普通文件
147
docs/07-线上服务器部署与同步清单.md
普通文件
@@ -0,0 +1,147 @@
|
||||
# 线上服务器部署与同步清单规范
|
||||
|
||||
> 文档编号:DOC-DEPLOY-07
|
||||
> 适用平台:同城分类信息与本地生活便民服务平台 (FastAdmin + UniApp)
|
||||
> 目标服务器:`fenleixinxi.gzyakj.com.cn`(远程路径:`/www/wwwroot/fenleixinxi.gzyakj.com.cn`)
|
||||
|
||||
---
|
||||
|
||||
## 一、 项目完整结构图解与职责分析
|
||||
|
||||
```text
|
||||
fenleixinxi/
|
||||
├── addons/ # [必选同步] FastAdmin 插件目录
|
||||
├── application/ # [必选同步] ThinkPHP 5 业务应用主目录
|
||||
│ ├── admin/ # 后台控制器、模型、视图(含已重构的商户/帖子/分销/审核页面)
|
||||
│ ├── api/ # 小程序端 RESTful API 接口层
|
||||
│ ├── common/ # 公共模型、服务层与支付/分销/佣金核心逻辑
|
||||
│ └── extra/ # 站点配置、上传配置等
|
||||
├── extend/ # [必选同步] 自定义扩展类库
|
||||
├── public/ # [必选同步] Web 根目录(Nginx DocumentRoot 指向此处)
|
||||
│ ├── assets/ # 后台 CSS/JS/微质感图标(含 backend-theme.css 绿白设计)
|
||||
│ │ └── libs/ # ★第三方前端组件库(Git 默认忽略,但部署必须存在)
|
||||
│ ├── static/ # 品牌分类图标、微质感插画
|
||||
│ ├── uploads/ # ★媒体与附件目录(必须保留且带读写权限)
|
||||
│ ├── index.php # 前台入口
|
||||
│ ├── s.php # 后台管理入口(地址:/s.php)
|
||||
│ └── nginx.htaccess # Nginx 伪静态配置
|
||||
├── thinkphp/ # [必选同步] ThinkPHP 5 核心框架底层(Git 默认忽略)
|
||||
├── vendor/ # [必选同步] Composer 依赖包(Git 默认忽略)
|
||||
├── 支付/ # [私密存放] 微信支付商户私有证书,建议放置在非公开根目录下
|
||||
├── uniapp/ # [小程序端] 前端源码,生产打包自动连接生产域名
|
||||
├── runtime/ # [服务器自动生成] 运行时缓存与日志(赋权限 www:www 777)
|
||||
├── .env # [线上独立配置] 线上数据库与环境配置文件(不可直接拿本地覆盖)
|
||||
└── database_backup.sql # [数据库同步] 本地导出的 47 张表完整结构与业务初始数据
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 二、 部署与同步分类清单
|
||||
|
||||
### 1. 必须上传/同步到服务器的目录与文件 (Sync Checklist)
|
||||
|
||||
| 目录/文件 | 说明 | 部署方式 / 注意事项 |
|
||||
| :--- | :--- | :--- |
|
||||
| **`application/`** | 业务核心代码(Admin/API/Common/Extra) | 覆盖更新,包含所有新增的审核、详情、主题视图 |
|
||||
| **`addons/`** | FastAdmin 插件 | 完整同步 |
|
||||
| **`extend/`** | 第三方扩展类库 | 完整同步 |
|
||||
| **`public/assets/`** | 后台样式、脚本、组件 | 包含重构的 `backend-theme.css` 及业务 JS |
|
||||
| **`public/assets/libs/`** | Git 默认忽略的第三方前端库 | **极关键**:若线上缺少会导致后台界面混乱、报 404 |
|
||||
| **`public/static/`** | 春绿主题内置图标与插画 | 完整同步 |
|
||||
| **`public/uploads/`** | 本地已初始化的测试与分类图 | 增量同步,线上需赋予 `755/777` 写入权限 |
|
||||
| **`public/index.php`** | 前端统一入口文件 | 覆盖 |
|
||||
| **`public/s.php`** | 后台管理唯一入口(保护管理后台) | 访问地址:`https://域名/s.php` |
|
||||
| **`thinkphp/`** | 框架核心 | 若线上已有基础安装则核对版本,全新部署必须同步 |
|
||||
| **`vendor/`** | Composer 扩展依赖 | 包含微信支付/二维码等扩展,需完整同步 |
|
||||
| **`支付/`** | 微信支付商户证书 (`.pem` / `.zip`) | 建议部署至项目根目录同级或非 Web 可访问的安全目录 |
|
||||
|
||||
### 2. 严禁同步或必须线上独立配置的文件 (Exclude / Independent)
|
||||
|
||||
| 目录/文件 | 规则 | 原因说明 |
|
||||
| :--- | :--- | :--- |
|
||||
| **`.env`** | **线上单独配置** | 线上数据库账号、密码、端口与本地完全不同,直接覆盖会导致数据库连接中断 |
|
||||
| **`AGENTS.md`** | **严禁上传** | 包含服务器 SSH、数据库口令等高敏感绝密凭证,严禁暴露 |
|
||||
| **`runtime/*`** | **严禁同步日志** | 本地缓存与日志无需同步,线上仅需空目录并配置写入权限 |
|
||||
| **`node_modules/`** | **无需上传** | 本地构建依赖包,线上 PHP 环境不执行 node 构建 |
|
||||
| **`tools/`** | **无需上传** | 本地 API 联调与测试脚本,纯开发辅助工具 |
|
||||
| **`.git/`** | **无需全量拷入** | 若采用 Git 部署拉取即可,若通过打包上传请排除 `.git` 目录 |
|
||||
|
||||
---
|
||||
|
||||
## 三、 数据库同步指南 (Database Sync)
|
||||
|
||||
### 1. 本地已生成备份文件
|
||||
- **导出文件名**:`database_backup.sql`(已在根目录下生成,UTF8MB4 编码,共 47 张表)。
|
||||
- **核心数据表涵盖**:
|
||||
- **基础系统**:`fa_admin`, `fa_auth_*`, `fa_config`, `fa_attachment` 等。
|
||||
- **分类与信息**:`fa_fc_category`, `fa_fc_post`, `fa_fc_draft`, `fa_fc_area`。
|
||||
- **商户与入驻**:`fa_fc_merchant`, `fa_fc_user_ext`。
|
||||
- **交易与佣金**:`fa_fc_order`, `fa_fc_plan`, `fa_fc_commission`, `fa_fc_dist_relation`, `fa_fc_finance_flow`, `fa_fc_withdraw`。
|
||||
- **营销与互动**:`fa_fc_banner`, `fa_fc_coupon`, `fa_fc_comment`, `fa_fc_favorite`, `fa_fc_follow`, `fa_fc_message`, `fa_fc_report`。
|
||||
|
||||
### 2. 线上数据库导入步骤
|
||||
1. **宝塔面板 / 终端导入**:
|
||||
```bash
|
||||
# 在服务器终端导入
|
||||
mysql -u [线上用户名] -p[线上密码] [线上数据库名] < database_backup.sql
|
||||
```
|
||||
2. **配置线上 `.env`**:
|
||||
在服务器项目根目录创建或修改 `.env`:
|
||||
```ini
|
||||
[app]
|
||||
debug = false
|
||||
trace = false
|
||||
|
||||
[database]
|
||||
hostname = 127.0.0.1
|
||||
database = [线上数据库名]
|
||||
username = [线上用户名]
|
||||
password = [线上密码]
|
||||
hostport = 3306
|
||||
prefix = fa_
|
||||
```
|
||||
|
||||
3. **同步后数据核验**:
|
||||
- 检查 `fa_config` 表中后台站点基础信息。
|
||||
- 确认后台管理员账号可正常登录:
|
||||
- 后台地址:`https://fenleixinxi.gzyakj.com.cn/s.php`
|
||||
- 管理员账号:`admin`
|
||||
|
||||
---
|
||||
|
||||
## 四、 Nginx 站点配置要点
|
||||
|
||||
1. **运行目录 (DocumentRoot)**:必须指向 `/www/wwwroot/fenleixinxi.gzyakj.com.cn/public`。
|
||||
2. **伪静态 (Rewrite Rule)**:
|
||||
```nginx
|
||||
location / {
|
||||
if (!-e $request_filename) {
|
||||
rewrite ^(.*)$ /index.php?s=/$1 last;
|
||||
break;
|
||||
}
|
||||
}
|
||||
```
|
||||
3. **安全防护**:
|
||||
- 禁止访问私密证书与隐藏文件:
|
||||
```nginx
|
||||
location ~ ^/(\.user.ini|\.htaccess|\.git|\.env|支付) {
|
||||
return 404;
|
||||
}
|
||||
```
|
||||
4. **目录权限**:
|
||||
```bash
|
||||
chown -R www:www /www/wwwroot/fenleixinxi.gzyakj.com.cn
|
||||
chmod -R 755 /www/wwwroot/fenleixinxi.gzyakj.com.cn
|
||||
chmod -R 777 /www/wwwroot/fenleixinxi.gzyakj.com.cn/runtime
|
||||
chmod -R 777 /www/wwwroot/fenleixinxi.gzyakj.com.cn/public/uploads
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 五、 小程序端发布对接说明
|
||||
|
||||
- 小程序端源码位于 `uniapp/` 目录。
|
||||
- 请求基地址已在 `uniapp/common/config/index.js` 内实现智能化分支:
|
||||
- HBuilderX 运行(本地开发)自动连接本地环境;
|
||||
- HBuilderX 发行(打包上传微信)自动锁定线上生产环境:`https://fenleixinxi.gzyakj.com.cn/api`。
|
||||
- 上线发布只需在本地运行发行到微信小程序,使用微信开发者工具上传并提交微信审核即可。
|
||||
在新工单中引用
屏蔽一个用户