# Phase 5:后端功能模块 ↔ 前端模块数据同源 ## 1. 数据同源(前端不再写死) | 前端位置 | 数据来源 | 后台维护入口 | |---|---|---| | 首页大促 Banner(角标/标题/副标题/时间) | `fa_banner` 表(`status=normal`,按 weigh 倒序,取第 1 条) | 后台 → 首页运营位 | | 首页服务保障条(4 项) | `fa_config` 键 `home_assure`,英文逗号分隔 | 后台 → 常规管理 → 系统配置 | | 首页教程卡(标题/副标题) | `fa_config` 键 `home_tutorial`,格式 `标题|副标题` | 同上 | | 订单状态提示文案 | `common/library/OrderStatus::tip()` 随接口下发 `status_tip` | 代码内统一维护 | 接口约定(`/api/home/index`): ```json { "banners": [{"id":1,"badge":"家装季","title":"双11 狂欢大促","subtitle":"下单立减 · 满额再返券","date_text":"10.23 - 11.15","image":"","link":""}], "assures": ["平台认证","先行赔付","极速上门","售后无忧"], "tutorial": {"title":"下单找师傅教程","sub":"3 分钟看懂,下单不踩坑"} } ``` 任一数据缺失/停用都会回落到代码内置兜底文案,前端不会白屏。 ## 2. 后台管理模块(13 个) 由 FastAdmin 官方生成器产出(controller + model + view + 菜单): ```bash cd /www/wwwroot/yjyf.gzyakj.com.cn PHP=/www/server/php/74/bin/php for t in fa_banner fa_order fa_master fa_merchant fa_coupon fa_review fa_message \ fa_service fa_service_cat fa_appeal fa_invoice fa_withdraw fa_settle; do $PHP think crud -t $t done for c in banner order master merchant coupon review message service appeal \ invoice withdraw settle; do $PHP think menu -c $c done $PHP think menu -c service/cat ``` > `crud` 只生成文件,**不会**写菜单;必须再执行 `menu` 才会出现在后台左侧导航。 ## 3. nginx 后台短地址 `/admin/*` 必须外部 301 到 `/admin.php/*`(内部 rewrite 会让 FastAdmin 依据 REQUEST_URI 生成的 相对 URL 丢失 `admin.php` 前缀,导致菜单点开 404): ```nginx location ~ ^/admin(/.*)?$ { return 301 /admin.php$1$is_args$args; } ``` 配置位于 `/www/server/panel/vhost/rewrite/yjyf.gzyakj.com.cn.conf`,改动前已备份为 `.bak.<时间戳>`。 ## 4. 写库字符集(重要) 服务器 mysql 客户端默认字符集非 utf8mb4,直接用 `mysql -e "UPDATE ... SET value='中文'"` 会把中文**二次编码**成乱码。务必加: ```bash mysql --default-character-set=utf8mb4 -uyjyf -pyjyf yjyf -e "..." # 或:mysql --default-character-set=utf8mb4 ... < file.sql ``` ## 5. 验证 ```bash node tests/phase5_data_sync.js # 16 项:后台改数据 → 前端接口即时反映 ``` 覆盖:服务上下架、Banner 增改与停用兜底、保障条、教程卡、发券/下架券、订单状态提示、后台模块完整性。