门店评分详情 及 更新

Signed-off-by: houhezheng <houhezheng@romens.cn>

backend/config/urlmanager.php

@@ -34,6 +34,8 @@ return [
                         'POST,OPTIONS add' => 'add',
                         'DELETE,OPTIONS del' => 'del',
                         'GET,OPTIONS branch-score-list' => 'branch-score-list',
+                        'GET,OPTIONS score-info' => 'score-info',
+                        'PUT,OPTIONS score-info-update'=>'score-info-update',
                         'GET,OPTIONS branch-service-list' => 'branch-service-list',
                         'POST,OPTIONS add-branch-service' => 'add-branch-service',
                         'PUT,OPTIONS revise-branch-service' => 'revise-branch-service',
@@ -41,7 +43,7 @@ return [
                         'GET,OPTIONS user-list' => 'user-list',
                         'GET,OPTIONS user-detail'=>'user-detail',
                         'GET,OPTIONS user-update'=>'user-update',
-                        'GET,OPTIONS user-delete'=>'user-delete',
+                        'GET,OPTIONS user-delete'=>'user-delete', 
                     ],
                 ],
                 'GET swaggers/swagger/<id>'=>'swagger/swagger',

backend/controllers/v1/branch/BranchController.php

@@ -6,10 +6,11 @@ use app\models\v1\branch\ShopBranchScore;
 use Yii;
 use backend\controllers\v1\BaseController;
 use yii\web\BadRequestHttpException;
+use yii\web\ServerErrorHttpException;
 
 class BranchController extends BaseController
 {
-    public $modelClass='app\models\v1\branch\ShopBranch';
+    public $modelClass = 'app\models\v1\branch\ShopBranch';
 
     /**
      * @OA\GET(
@@ -44,19 +45,128 @@ class BranchController extends BaseController
         $params = Yii::$app->request->queryParams;
 
         $model->attributes = $params;
-        if(!$model->validate()){
-            throw new BadRequestHttpException('Your request probably have some mistake !');
+        if (!$model->validate()) {
+            throw new BadRequestHttpException('Data Validation Failed !');
         }
 
         $data = $model->branchScoreList($params);
-        if(!$list=$data->getModels()){
+        if (!$list = $data->getModels()) {
             throw new BadRequestHttpException('未找到符合条件的数据');
         }
         //门店评价最终值计算
-        foreach($list as $key=>$value){
+        foreach ($list as $key => $value) {
             $list[$key]['REAL_SCORE'] = $value['SCORE'] + $value['CUSTOMERE_VALUATION'];
         }
         $data->setModels($list);
         return $data;
     }
+
+    /**
+     * @OA\GET(
+     *   path="/backend/web/v1/branch/branches/score-info",
+     *   tags={"门店&DC"},
+     *   summary="门店评价详情(侯贺政)",
+     *   description="门店服务打分详情",
+     *   @OA\Parameter(name="id",in="query",required=true,description="评分GUID",@OA\Schema(type="string")),
+     *   @OA\Response(response="200",description="
+     *                GUID:评分GUID
+     *                BRANCH_NAME:门店名称,
+     *                BRANCH_CODE:门店编号,
+     *                BASIC_SERVICES:基础服务分数,
+     *                QUALITY_ASSURANCE:质量管理分数,
+     *                OPERATION_MANAGEMENT:运营管理分数,
+     *                STORE_IMAGE:门店形象分数,
+     *                ELECTRICITY_MANAGEMENT:店务管理分数,
+     *                CUSTOMERE_VALUATION:顾客评价分数（手动干预评价分数）,
+     *                STORE_CONFIGURATION:门店配置分数,
+     *                ARTIFICIAL_NUMBER:导入员工,
+     *                ARTIFICIAL_NAME:导入员工姓名"),
+     *   security={{"Authorization":{}}}
+     * )
+     */
+    public function actionScoreInfo($id)
+    {
+        $model = new ShopBranchScore();
+        $model->GUID = $id;
+
+        if (!$model->validate()) {
+            throw new BadRequestHttpException('Data Validation Failed !');
+        }
+
+        $info = $model->soreInfo($id);
+        if (!$info) {
+            throw new BadRequestHttpException('请求有误，不存在该评分！');
+        }
+        return $info;
+    }
+
+    /**
+     * @OA\Put(
+     *     path="/backend/web/v1/branch/branches/score-info-update",
+     *     tags={"门店&DC"},
+     *     summary="更新门店服务打分(侯贺政)",
+     *     description="更新门店服务打分",
+     *     @OA\RequestBody(
+     *         required=true,
+     *         description="填入需要更新的参数以及数据，GUID必填",
+     *         @OA\JsonContent(
+     *             type="object",
+     *             required={"GUID"},
+     *             @OA\Property(property="GUID", type="string",description="评分GUID"),
+     *             @OA\Property(property="BASIC_SERVICES" ,type="float(12,2)", description="基础服务分数"),
+     *             @OA\Property(property="QUALITY_ASSURANCE", type="float(12,2)",description="质量管理分数"),
+     *             @OA\Property(property="OPERATION_MANAGEMENT", type="float(12,2)",description="运营管理分数"),
+     *             @OA\Property(property="STORE_IMAGE", type="float(12,2)",description="门店形象分数"),
+     *             @OA\Property(property="ELECTRICITY_MANAGEMENT", type="float(12,2)",description="店务管理分数"),
+     *             @OA\Property(property="CUSTOMERE_VALUATION", type="float(12,2)",description="顾客评价分数（手动干预评价分数）"),
+     *             @OA\Property(property="STORE_CONFIGURATION", type="float(12,2)",description="门店配置分数"),
+     *             @OA\Property(property="ARTIFICIAL_NUMBER:", type="string",description="导入员工"),
+     *             @OA\Property(property="ARTIFICIAL_NAME", type="string",description="导入员工姓名"),
+     *             example={"GUID":"123","BASIC_SERVICES":"10"}
+     *          ),
+     *         @OA\MediaType(
+     *             mediaType="application/x-www-form-urlencoded",
+     *             @OA\Schema(
+     *                type="object",
+     *                required={"GUID"},
+     *                @OA\Property(property="GUID", type="string",description="评分GUID"),
+     *                @OA\Property(property="BASIC_SERVICES" ,type="float(12,2)", description="基础服务分数"),
+     *                @OA\Property(property="QUALITY_ASSURANCE", type="float(12,2)",description="质量管理分数"),
+     *                @OA\Property(property="OPERATION_MANAGEMENT", type="float(12,2)",description="运营管理分数"),
+     *                @OA\Property(property="STORE_IMAGE", type="float(12,2)",description="门店形象分数"),
+     *                @OA\Property(property="ELECTRICITY_MANAGEMENT", type="float(12,2)",description="店务管理分数"),
+     *                @OA\Property(property="CUSTOMERE_VALUATION", type="float(12,2)",description="顾客评价分数（手动干预评价分数）"),
+     *                @OA\Property(property="STORE_CONFIGURATION", type="float(12,2)",description="门店配置分数"),
+     *                @OA\Property(property="ARTIFICIAL_NUMBER:", type="string",description="导入员工"),
+     *                @OA\Property(property="ARTIFICIAL_NAME", type="string",description="导入员工姓名"),
+     *             )   
+     *         )
+     *     ),
+     *     @OA\Response(
+     *         response=200,
+     *         description="OK,succeed"
+     *     ),
+     *     security={{"Authorization":{}}},
+     * )
+     */
+    public function actionScoreInfoUpdate()
+    {
+        $params = Yii::$app->request->bodyParams;
+        $model = ShopBranchScore::findOne($params['GUID']);
+        if (!$model) {
+            throw new BadRequestHttpException('Please check if your request is correct !');
+        }
+
+        $model->attributes = $params;
+        if (!$model->validate()) {
+            throw new BadRequestHttpException('Your request probably have some mistake !');
+        }
+
+        $model->UPDATE_TIME = date('Y-m-d H:i:s',time());
+        if (!$model->save()) {
+            throw new ServerErrorHttpException('保存失败！');
+        }
+
+        return ['code'=>200,'message'=>'保存成功！'];
+    }
 }

backend/models/v1/branch/ShopBranchScore.php

@@ -45,7 +45,7 @@ class ShopBranchScore extends BaseModel
             [['GUID', 'BRANCH_CODE', 'BRANCH_NAME'], 'string', 'max' => 50],
             [['ARTIFICIAL_NUMBER'], 'string', 'max' => 12],
             [['ARTIFICIAL_NAME'], 'string', 'max' => 20],
-            [['GUID'], 'unique'],
+            [['GUID'], 'unique','on'=>['creation']],
         ];
     }
 
@@ -103,4 +103,20 @@ class ShopBranchScore extends BaseModel
             ]
         ]);
     }
+
+    /**
+     * 评分详情
+     * 
+     * @params string $id  评分GUID
+     * @return array|null 返回评分详情
+     */
+    public function soreInfo($id)
+    {
+        $info = static::find()
+            ->select('GUID,BRANCH_NAME,BRANCH_CODE,BASIC_SERVICES,QUALITY_ASSURANCE,OPERATION_MANAGEMENT,STORE_IMAGE,ELECTRICITY_MANAGEMENT,CUSTOMERE_VALUATION,STORE_CONFIGURATION,ARTIFICIAL_NUMBER,ARTIFICIAL_NAME')
+            ->where(['GUID'=>$id])
+            ->one();
+
+        return $info;
+    }
 }