huahuibao/app-mall/controllers/HomePageConfigController.php

<?php

namespace mall\controllers;

use bizHd\homePageConfig\classes\HomePageConfigClass;
use bizHd\homePageConfig\classes\HomePageDisplayClass;
use bizHd\homePageConfig\classes\HomePageModuleClass;
use common\components\util;
use mall\models\homePageConfig\GetSectionGoodsForm;

/**
 * 商城端首页配置读取接口
 * mallApp 通过 account(shopId) 获取配置，与 hd 管理端共用 Redis。
 * 具体的格式化/真实商品解析逻辑统一收敛在 HomePageDisplayClass，
 * 保证与 app-hd 的预览接口返回结构完全一致。
 * 登录态会解析/创建顾客与门店的 hd 绑定，把 hdId 带回给 mallApp 缓存并拼到跳转链接。
 */
class HomePageConfigController extends BaseController
{
    public $guestAccess = [
        'get-banner',
        'get-nav-grid',
        'get-seckill',
        'get-group-buy',
        'get-hot',
        'get-new',
        'get-pull-goods',
        'get-home',
        'get-section-goods',
    ];

    /**
     * 一次拉取首页全部模块配置，便于 mallApp 首页组装。
     * 已登录情况下，会解析当前门店的 hd 绑定：已有则直接返回 hdId，没有则建客建 hd。
     */
    public function actionGetHome()
    {
        // 换店/分享直达时请求可能仍带旧 hdId，先按 account 恢复门店再解析当前店绑定
        $ctx = $this->recoverShopAndResolveHd();
        $re = HomePageDisplayClass::buildHome($ctx['mainId'], $ctx['shopId']);
        $re['hdId'] = $ctx['hdId'];
        $re['inviteBound'] = $ctx['inviteBound'];
        util::success($re);
    }

    public function actionGetBanner()
    {
        util::success(HomePageDisplayClass::formatBanner(HomePageConfigClass::getBanner($this->requireMainId(), $this->requireShopId())));
    }

    public function actionGetNavGrid()
    {
        util::success(HomePageDisplayClass::formatNavGrid(HomePageModuleClass::getNavGrid($this->requireMainId(), $this->requireShopId())));
    }

    public function actionGetSeckill()
    {
        util::success(HomePageDisplayClass::formatActivity(HomePageModuleClass::getSeckill($this->requireMainId(), $this->requireShopId(), true)));
    }

    public function actionGetGroupBuy()
    {
        util::success(HomePageDisplayClass::formatActivity(HomePageModuleClass::getGroupBuy($this->requireMainId(), $this->requireShopId(), true)));
    }

    public function actionGetHot()
    {
        util::success(HomePageDisplayClass::formatGoodsSection($this->requireMainId(), $this->requireShopId(), 'hot'));
    }

    public function actionGetNew()
    {
        util::success(HomePageDisplayClass::formatGoodsSection($this->requireMainId(), $this->requireShopId(), 'new'));
    }

    public function actionGetPullGoods()
    {
        util::success(HomePageDisplayClass::formatGoodsSection($this->requireMainId(), $this->requireShopId(), 'pullGoods'));
    }

    /**
     * 首页模块「更多」商品列表分页
     * moduleKey: seckill|groupBuy|hot|new|pullGoods
     */
    public function actionGetSectionGoods()
    {
        $form = new GetSectionGoodsForm();
        $form->loadAndValidate();
        util::success(HomePageDisplayClass::getSectionGoodsPage(
            $this->requireMainId(),
            $this->requireShopId(),
            $form->moduleKey,
            (int)$form->page,
            (int)$form->pageSize
        ));
    }

    private function requireMainId()
    {
        $mainId = intval($this->mainId);
        if ($mainId <= 0) {
            util::fail('无效mainId');
        }
        return $mainId;
    }

    private function requireShopId()
    {
        $shopId = intval($this->shopId);
        if ($shopId <= 0) {
            util::fail('无效门店');
        }
        return $shopId;
    }
}