小程序首页配置

2026-08-14 12:41:18 +08:00
parent 889f987f17
commit 8b3cef5af0
21 changed files with 1350 additions and 3 deletions
@@ -0,0 +1,90 @@
+<?php
+
+namespace App\Http\Controllers\Client;
+
+use App\Exceptions\RepositoryException;
+use App\Http\Requests\Client\BannerFormRequest;
+use App\Models\HomeBannerModel;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Auth;
+use Modules\AnnoRoute\Attribute\DeleteRoute;
+use Modules\AnnoRoute\Attribute\GetRoute;
+use Modules\AnnoRoute\Attribute\PostRoute;
+use Modules\AnnoRoute\Attribute\PutRoute;
+use Modules\AnnoRoute\Attribute\RequestAttribute;
+use Modules\Common\Http\Controllers\BaseController;
+use Modules\SystemTool\Services\SysFileService;
+
+/**
+ * 首页轮播图配置（小程序首页）
+ */
+#[RequestAttribute('/client/banner', 'client.banner')]
+class BannerController extends BaseController
+{
+    protected array $searchField = [
+        'status' => '=',
+    ];
+
+    protected array $quickSearchField = ['title'];
+
+    /** 轮播图列表（默认按排序升序） */
+    #[GetRoute(authorize: 'query')]
+    public function query(Request $request): JsonResponse
+    {
+        $params = $request->all();
+        $pageSize = $params['pageSize'] ?? 10;
+        $data = $this->buildSearch($params, HomeBannerModel::query())
+            ->orderBy('sort')
+            ->orderBy('id')
+            ->paginate($pageSize)
+            ->toArray();
+        return $this->success($data);
+    }
+
+    /** 上传轮播图片（文件分组：客户端配置） */
+    #[PostRoute('/upload', 'create')]
+    public function uploadImage(Request $request, SysFileService $service): JsonResponse
+    {
+        $data = $request->validate(['file' => 'required|file']);
+        $result = $service->upload(
+            $data['file'],
+            12,
+            20,
+            Auth::id()
+        );
+        return $this->success($result);
+    }
+
+    /** 新增轮播图 */
+    #[PostRoute(authorize: 'create')]
+    public function create(BannerFormRequest $request): JsonResponse
+    {
+        HomeBannerModel::create($request->validated());
+        return $this->success();
+    }
+
+    /** 编辑轮播图 */
+    #[PutRoute(route: '/{id}', authorize: 'update', where: ['id' => '[0-9]+'])]
+    public function update(int $id, BannerFormRequest $request): JsonResponse
+    {
+        $model = HomeBannerModel::find($id);
+        if (empty($model)) {
+            throw new RepositoryException('轮播图不存在');
+        }
+        $model->update($request->validated());
+        return $this->success();
+    }
+
+    /** 删除轮播图 */
+    #[DeleteRoute(route: '/{id}', authorize: 'delete', where: ['id' => '[0-9]+'])]
+    public function delete(int $id): JsonResponse
+    {
+        $model = HomeBannerModel::find($id);
+        if (empty($model)) {
+            throw new RepositoryException('轮播图不存在');
+        }
+        $model->delete();
+        return $this->success();
+    }
+}
@@ -0,0 +1,90 @@
+<?php
+
+namespace App\Http\Controllers\Client;
+
+use App\Exceptions\RepositoryException;
+use App\Http\Requests\Client\NavFormRequest;
+use App\Models\HomeNavModel;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Auth;
+use Modules\AnnoRoute\Attribute\DeleteRoute;
+use Modules\AnnoRoute\Attribute\GetRoute;
+use Modules\AnnoRoute\Attribute\PostRoute;
+use Modules\AnnoRoute\Attribute\PutRoute;
+use Modules\AnnoRoute\Attribute\RequestAttribute;
+use Modules\Common\Http\Controllers\BaseController;
+use Modules\SystemTool\Services\SysFileService;
+
+/**
+ * 宫格导航配置（小程序首页）
+ */
+#[RequestAttribute('/client/nav', 'client.nav')]
+class NavController extends BaseController
+{
+    protected array $searchField = [
+        'status' => '=',
+    ];
+
+    protected array $quickSearchField = ['name'];
+
+    /** 导航列表（默认按排序升序） */
+    #[GetRoute(authorize: 'query')]
+    public function query(Request $request): JsonResponse
+    {
+        $params = $request->all();
+        $pageSize = $params['pageSize'] ?? 10;
+        $data = $this->buildSearch($params, HomeNavModel::query())
+            ->orderBy('sort')
+            ->orderBy('id')
+            ->paginate($pageSize)
+            ->toArray();
+        return $this->success($data);
+    }
+
+    /** 上传导航图标（文件分组：客户端配置） */
+    #[PostRoute('/upload', 'create')]
+    public function uploadImage(Request $request, SysFileService $service): JsonResponse
+    {
+        $data = $request->validate(['file' => 'required|file']);
+        $result = $service->upload(
+            $data['file'],
+            12,
+            20,
+            Auth::id()
+        );
+        return $this->success($result);
+    }
+
+    /** 新增导航 */
+    #[PostRoute(authorize: 'create')]
+    public function create(NavFormRequest $request): JsonResponse
+    {
+        HomeNavModel::create($request->validated());
+        return $this->success();
+    }
+
+    /** 编辑导航 */
+    #[PutRoute(route: '/{id}', authorize: 'update', where: ['id' => '[0-9]+'])]
+    public function update(int $id, NavFormRequest $request): JsonResponse
+    {
+        $model = HomeNavModel::find($id);
+        if (empty($model)) {
+            throw new RepositoryException('导航不存在');
+        }
+        $model->update($request->validated());
+        return $this->success();
+    }
+
+    /** 删除导航 */
+    #[DeleteRoute(route: '/{id}', authorize: 'delete', where: ['id' => '[0-9]+'])]
+    public function delete(int $id): JsonResponse
+    {
+        $model = HomeNavModel::find($id);
+        if (empty($model)) {
+            throw new RepositoryException('导航不存在');
+        }
+        $model->delete();
+        return $this->success();
+    }
+}
@@ -0,0 +1,90 @@
+<?php
+
+namespace App\Http\Controllers\Client;
+
+use App\Exceptions\RepositoryException;
+use App\Http\Requests\Client\PromoFormRequest;
+use App\Models\HomePromoModel;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Auth;
+use Modules\AnnoRoute\Attribute\DeleteRoute;
+use Modules\AnnoRoute\Attribute\GetRoute;
+use Modules\AnnoRoute\Attribute\PostRoute;
+use Modules\AnnoRoute\Attribute\PutRoute;
+use Modules\AnnoRoute\Attribute\RequestAttribute;
+use Modules\Common\Http\Controllers\BaseController;
+use Modules\SystemTool\Services\SysFileService;
+
+/**
+ * 促销推荐卡片配置（小程序首页）
+ */
+#[RequestAttribute('/client/promo', 'client.promo')]
+class PromoController extends BaseController
+{
+    protected array $searchField = [
+        'status' => '=',
+    ];
+
+    protected array $quickSearchField = ['title', 'sub_title'];
+
+    /** 促销卡片列表（默认按排序升序） */
+    #[GetRoute(authorize: 'query')]
+    public function query(Request $request): JsonResponse
+    {
+        $params = $request->all();
+        $pageSize = $params['pageSize'] ?? 10;
+        $data = $this->buildSearch($params, HomePromoModel::query())
+            ->orderBy('sort')
+            ->orderBy('id')
+            ->paginate($pageSize)
+            ->toArray();
+        return $this->success($data);
+    }
+
+    /** 上传卡片图片（文件分组：客户端配置） */
+    #[PostRoute('/upload', 'create')]
+    public function uploadImage(Request $request, SysFileService $service): JsonResponse
+    {
+        $data = $request->validate(['file' => 'required|file']);
+        $result = $service->upload(
+            $data['file'],
+            12,
+            20,
+            Auth::id()
+        );
+        return $this->success($result);
+    }
+
+    /** 新增促销卡片 */
+    #[PostRoute(authorize: 'create')]
+    public function create(PromoFormRequest $request): JsonResponse
+    {
+        HomePromoModel::create($request->validated());
+        return $this->success();
+    }
+
+    /** 编辑促销卡片 */
+    #[PutRoute(route: '/{id}', authorize: 'update', where: ['id' => '[0-9]+'])]
+    public function update(int $id, PromoFormRequest $request): JsonResponse
+    {
+        $model = HomePromoModel::find($id);
+        if (empty($model)) {
+            throw new RepositoryException('促销卡片不存在');
+        }
+        $model->update($request->validated());
+        return $this->success();
+    }
+
+    /** 删除促销卡片 */
+    #[DeleteRoute(route: '/{id}', authorize: 'delete', where: ['id' => '[0-9]+'])]
+    public function delete(int $id): JsonResponse
+    {
+        $model = HomePromoModel::find($id);
+        if (empty($model)) {
+            throw new RepositoryException('促销卡片不存在');
+        }
+        $model->delete();
+        return $this->success();
+    }
+}
@@ -0,0 +1,46 @@
+<?php
+
+namespace App\Http\Controllers\Mini;
+
+use App\Models\HomeBannerModel;
+use App\Models\HomeNavModel;
+use App\Models\HomePromoModel;
+use Illuminate\Http\JsonResponse;
+use Modules\AnnoRoute\Attribute\GetRoute;
+use Modules\AnnoRoute\Attribute\RequestAttribute;
+
+/**
+ * 小程序首页配置（轮播图 + 宫格导航 + 促销推荐卡片，仅返回启用项）
+ */
+#[RequestAttribute('/mini', 'mini', authGuard: 'users')]
+class HomeController extends BaseMiniController
+{
+    /** 首页配置聚合：banners / navs / promos，按 sort 升序 */
+    #[GetRoute('/home', authorize: false)]
+    public function index(): JsonResponse
+    {
+        $banners = HomeBannerModel::query()
+            ->where('status', HomeBannerModel::STATUS_NORMAL)
+            ->orderBy('sort')
+            ->orderBy('id')
+            ->get(['id', 'title', 'image_id', 'link', 'sort']);
+
+        $navs = HomeNavModel::query()
+            ->where('status', HomeNavModel::STATUS_NORMAL)
+            ->orderBy('sort')
+            ->orderBy('id')
+            ->get(['id', 'name', 'image_id', 'link', 'sort']);
+
+        $promos = HomePromoModel::query()
+            ->where('status', HomePromoModel::STATUS_NORMAL)
+            ->orderBy('sort')
+            ->orderBy('id')
+            ->get(['id', 'title', 'sub_title', 'image_id', 'link', 'sort']);
+
+        return $this->success([
+            'banners' => $banners,
+            'navs' => $navs,
+            'promos' => $promos,
+        ]);
+    }
+}
@@ -57,10 +57,8 @@ class ProductController extends BaseMiniController

    /**
     * 商品列表：价格取当前门店客户等级价；
-     * 未绑定门店/门店未设客户等级 → 仍可浏览，price 为 null（不可见价格，加购/下单另由前置校验拦截）；
-     * ?category_id=&keyword=&page=&pageSize=
     */
-    #[GetRoute('/product/list', authorize: true)]
+    #[GetRoute('/product/list', authorize: false)]
    public function products(Request $request): JsonResponse
    {
        $user = $this->currentUser($request);