first version

2026-07-23 20:41:25 +08:00
parent 00a0938a1b
commit 10cff754a4
211 changed files with 11577 additions and 842 deletions
@@ -0,0 +1,91 @@
+<?php
+
+namespace App\Http\Controllers\Customer;
+
+use App\Exceptions\RepositoryException;
+use App\Http\Requests\Customer\CustomerLevelFormRequest;
+use App\Models\CustomerLevelModel;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+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;
+
+/**
+ * 客户等级管理（同一商品按客户等级定价）
+ */
+#[RequestAttribute('/customer/level', 'customer.level')]
+class CustomerLevelController extends BaseController
+{
+    protected array $searchField = [
+        'name' => 'like',
+        'status' => '=',
+    ];
+
+    /** 等级列表 */
+    #[GetRoute(authorize: 'query')]
+    public function query(Request $request): JsonResponse
+    {
+        $params = $request->all();
+        $pageSize = $params['pageSize'] ?? 10;
+        $data = $this->buildSearch($params, CustomerLevelModel::query())
+            ->orderBy('sort')
+            ->orderBy('id', 'desc')
+            ->paginate($pageSize)
+            ->toArray();
+        return $this->success($data);
+    }
+
+    /** 创建等级 */
+    #[PostRoute(authorize: 'create')]
+    public function create(CustomerLevelFormRequest $request): JsonResponse
+    {
+        CustomerLevelModel::create($request->validated());
+        return $this->success();
+    }
+
+    /** 编辑等级 */
+    #[PutRoute(route: '/{id}', authorize: 'update', where: ['id' => '[0-9]+'])]
+    public function update(int $id, CustomerLevelFormRequest $request): JsonResponse
+    {
+        $model = CustomerLevelModel::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 = CustomerLevelModel::find($id);
+        if (empty($model)) {
+            throw new RepositoryException('客户等级不存在');
+        }
+        if ($model->stores()->exists()) {
+            throw new RepositoryException('该等级下存在门店，无法删除');
+        }
+        if ($model->prices()->exists()) {
+            throw new RepositoryException('该等级下存在商品价格，无法删除');
+        }
+        $model->delete();
+        return $this->success();
+    }
+
+    /** 等级下拉选项（门店表单 / 价格矩阵用） */
+    #[GetRoute('/options', 'query')]
+    public function options(): JsonResponse
+    {
+        $data = CustomerLevelModel::query()
+            ->where('status', CustomerLevelModel::STATUS_NORMAL)
+            ->orderBy('sort')
+            ->get(['id', 'name'])
+            ->toArray();
+        return $this->success($data);
+    }
+}
@@ -0,0 +1,96 @@
+<?php
+
+namespace App\Http\Controllers\Customer;
+
+use App\Exceptions\RepositoryException;
+use App\Http\Requests\Customer\MiniUserBindRequest;
+use App\Models\StoreModel;
+use App\Models\SupplierModel;
+use App\Models\UserModel;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Modules\AnnoRoute\Attribute\GetRoute;
+use Modules\AnnoRoute\Attribute\PutRoute;
+use Modules\AnnoRoute\Attribute\RequestAttribute;
+use Modules\Common\Http\Controllers\BaseController;
+
+/**
+ * 小程序用户管理（用户由小程序登录自动生成，后台只做绑定与状态管理，无增删）
+ */
+#[RequestAttribute('/customer/miniUser', 'customer.miniUser')]
+class MiniUserController extends BaseController
+{
+    protected array $searchField = [
+        'type' => '=',
+        'store_id' => '=',
+        'supplier_id' => '=',
+        'status' => '=',
+    ];
+
+    protected array $quickSearchField = ['nickname', 'phone'];
+
+    /** 小程序用户列表 */
+    #[GetRoute(authorize: 'query')]
+    public function query(Request $request): JsonResponse
+    {
+        $params = $request->all();
+        $pageSize = $params['pageSize'] ?? 10;
+        $data = $this->buildSearch($params, UserModel::query()->with('store:id,name', 'supplier:id,name'))
+            ->orderBy('id', 'desc')
+            ->paginate($pageSize)
+            ->toArray();
+        return $this->success($data);
+    }
+
+    /**
+     * 绑定门店/供应商（一个门店可绑多个账号，一个账号只绑一个主体）
+     */
+    #[PutRoute(route: '/{id}/bind', authorize: 'bind', where: ['id' => '[0-9]+'])]
+    public function bind(int $id, MiniUserBindRequest $request): JsonResponse
+    {
+        $validated = $request->validated();
+        $user = UserModel::find($id);
+        if (empty($user)) {
+            throw new RepositoryException('用户不存在');
+        }
+
+        if ((int) $validated['type'] === UserModel::TYPE_STORE) {
+            $store = StoreModel::find((int) $validated['store_id']);
+            if (empty($store)) {
+                throw new RepositoryException('门店不存在');
+            }
+            $user->type = UserModel::TYPE_STORE;
+            $user->store_id = $store->id;
+            $user->supplier_id = 0;
+        } else {
+            $supplier = SupplierModel::find((int) $validated['supplier_id']);
+            if (empty($supplier)) {
+                throw new RepositoryException('供应商不存在');
+            }
+            $user->type = UserModel::TYPE_SUPPLIER;
+            $user->supplier_id = $supplier->id;
+            $user->store_id = 0;
+        }
+        $user->save();
+        return $this->success();
+    }
+
+    /** 启用/停用（停用后登录时检查 status 拒绝，token 鉴权拦截） */
+    #[PutRoute(route: '/{id}/status', authorize: 'update', where: ['id' => '[0-9]+'])]
+    public function status(int $id, Request $request): JsonResponse
+    {
+        $data = $request->validate([
+            'status' => 'required|integer|in:0,1',
+        ], [
+            'status.required' => '状态不能为空',
+            'status.in' => '状态值不正确',
+        ]);
+        $user = UserModel::find($id);
+        if (empty($user)) {
+            throw new RepositoryException('用户不存在');
+        }
+        $user->status = (int) $data['status'];
+        $user->save();
+        return $this->success();
+    }
+}
@@ -0,0 +1,62 @@
+<?php
+
+namespace App\Http\Controllers\Customer;
+
+use App\Exceptions\RepositoryException;
+use App\Http\Requests\Customer\NoticeFormRequest;
+use App\Models\NoticeModel;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Modules\AnnoRoute\Attribute\DeleteRoute;
+use Modules\AnnoRoute\Attribute\GetRoute;
+use Modules\AnnoRoute\Attribute\PostRoute;
+use Modules\AnnoRoute\Attribute\RequestAttribute;
+use Modules\Common\Http\Controllers\BaseController;
+
+/**
+ * 通知管理（小程序端消息；user_id=0 为全员广播）
+ */
+#[RequestAttribute('/customer/notice', 'customer.notice')]
+class NoticeController extends BaseController
+{
+    protected array $searchField = [
+        'type' => '=',
+        'is_read' => '=',
+        'user_id' => '=',
+    ];
+
+    protected array $quickSearchField = ['title', 'content'];
+
+    /** 通知列表 */
+    #[GetRoute(authorize: 'query')]
+    public function query(Request $request): JsonResponse
+    {
+        $params = $request->all();
+        $pageSize = $params['pageSize'] ?? 10;
+        $data = $this->buildSearch($params, NoticeModel::query())
+            ->orderBy('id', 'desc')
+            ->paginate($pageSize)
+            ->toArray();
+        return $this->success($data);
+    }
+
+    /** 发布通知（user_id=0 全员广播） */
+    #[PostRoute(authorize: 'create')]
+    public function create(NoticeFormRequest $request): JsonResponse
+    {
+        NoticeModel::create($request->validated() + ['is_read' => NoticeModel::UNREAD]);
+        return $this->success();
+    }
+
+    /** 删除通知 */
+    #[DeleteRoute(route: '/{id}', authorize: 'delete', where: ['id' => '[0-9]+'])]
+    public function delete(int $id): JsonResponse
+    {
+        $model = NoticeModel::find($id);
+        if (empty($model)) {
+            throw new RepositoryException('通知不存在');
+        }
+        $model->delete();
+        return $this->success();
+    }
+}
@@ -0,0 +1,88 @@
+<?php
+
+namespace App\Http\Controllers\Customer;
+
+use App\Exceptions\RepositoryException;
+use App\Http\Requests\Customer\StoreFormRequest;
+use App\Models\StoreModel;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+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;
+
+/**
+ * 门店管理（小程序下单主体，即客户）
+ */
+#[RequestAttribute('/customer/store', 'customer.store')]
+class StoreController extends BaseController
+{
+    protected array $searchField = [
+        'name' => 'like',
+        'code' => 'like',
+        'level_id' => '=',
+        'status' => '=',
+    ];
+
+    protected array $quickSearchField = ['name', 'code', 'contact', 'phone'];
+
+    /** 门店列表（含等级名回显） */
+    #[GetRoute(authorize: 'query')]
+    public function query(Request $request): JsonResponse
+    {
+        $params = $request->all();
+        $pageSize = $params['pageSize'] ?? 10;
+        $data = $this->buildSearch($params, StoreModel::query()->with('level:id,name'))
+            ->orderBy('id', 'desc')
+            ->paginate($pageSize)
+            ->toArray();
+        return $this->success($data);
+    }
+
+    /** 创建门店 */
+    #[PostRoute(authorize: 'create')]
+    public function create(StoreFormRequest $request): JsonResponse
+    {
+        StoreModel::create($request->validated());
+        return $this->success();
+    }
+
+    /** 编辑门店 */
+    #[PutRoute(route: '/{id}', authorize: 'update', where: ['id' => '[0-9]+'])]
+    public function update(int $id, StoreFormRequest $request): JsonResponse
+    {
+        $model = StoreModel::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 = StoreModel::find($id);
+        if (empty($model)) {
+            throw new RepositoryException('门店不存在');
+        }
+        $model->delete();
+        return $this->success();
+    }
+
+    /** 门店下拉选项（小程序用户绑定、订单筛选用） */
+    #[GetRoute('/options', 'query')]
+    public function options(): JsonResponse
+    {
+        $data = StoreModel::query()
+            ->where('status', StoreModel::STATUS_NORMAL)
+            ->orderBy('id')
+            ->get(['id', 'name', 'code'])
+            ->toArray();
+        return $this->success($data);
+    }
+}
@@ -0,0 +1,86 @@
+<?php
+
+namespace App\Http\Controllers\Customer;
+
+use App\Exceptions\RepositoryException;
+use App\Http\Requests\Customer\SupplierFormRequest;
+use App\Models\SupplierModel;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+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;
+
+/**
+ * 供应商管理（采购单接收方）
+ */
+#[RequestAttribute('/customer/supplier', 'customer.supplier')]
+class SupplierController extends BaseController
+{
+    protected array $searchField = [
+        'name' => 'like',
+        'status' => '=',
+    ];
+
+    protected array $quickSearchField = ['name', 'contact', 'phone'];
+
+    /** 供应商列表 */
+    #[GetRoute(authorize: 'query')]
+    public function query(Request $request): JsonResponse
+    {
+        $params = $request->all();
+        $pageSize = $params['pageSize'] ?? 10;
+        $data = $this->buildSearch($params, SupplierModel::query())
+            ->orderBy('id', 'desc')
+            ->paginate($pageSize)
+            ->toArray();
+        return $this->success($data);
+    }
+
+    /** 创建供应商 */
+    #[PostRoute(authorize: 'create')]
+    public function create(SupplierFormRequest $request): JsonResponse
+    {
+        SupplierModel::create($request->validated());
+        return $this->success();
+    }
+
+    /** 编辑供应商 */
+    #[PutRoute(route: '/{id}', authorize: 'update', where: ['id' => '[0-9]+'])]
+    public function update(int $id, SupplierFormRequest $request): JsonResponse
+    {
+        $model = SupplierModel::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 = SupplierModel::find($id);
+        if (empty($model)) {
+            throw new RepositoryException('供应商不存在');
+        }
+        $model->delete();
+        return $this->success();
+    }
+
+    /** 供应商下拉选项 */
+    #[GetRoute('/options', 'query')]
+    public function options(): JsonResponse
+    {
+        $data = SupplierModel::query()
+            ->where('status', SupplierModel::STATUS_NORMAL)
+            ->orderBy('id')
+            ->get(['id', 'name'])
+            ->toArray();
+        return $this->success($data);
+    }
+}