fixed：技师端-优化基本信息提交

app/Http/Controllers/Coach/AccountController.php

@@ -35,12 +35,26 @@ class AccountController extends Controller
     /**
      * [账户]提交基本信息
      *
-     * @description 提交技师的基本个人信息
+     * @description 提交技师的基本个人信息，包括头像、生活照片、个人资料等
      *
-     * @authenticated
+     * 业务流程：
+     * 1. 验证提交的数据
+     * 2. 调用服务层处理业务逻辑
+     * 3. 返回处理结果
+     *
+     * 注意事项：
+     * - 同一时间只能有一条待审核记录
+     * - 审核不通过可以重新提交
+     * - 头像和生活照片支持任意格式的图片数据
+     * - 除性别和手机号外，其他字段均为可选
+     * - 生活照片为可选，支持多张
+     *
+     * @authenticated 需要技师身份认证
      *
      * @bodyParam nickname string nullable 昵称(2-20个字符) Example: 张三
      * @bodyParam avatar string nullable 头像图片 Example: base64或其他格式的图片数据
+     * @bodyParam life_photos array nullable 生活照片数组
+     * @bodyParam life_photos.* string required 生活照片 Example: base64或其他格式的图片数据
      * @bodyParam gender string required 性别(1:男 2:女) Example: 1
      * @bodyParam mobile string required 手机号 Example: 13800138000
      * @bodyParam birthday date nullable 出生日期(年龄需满18岁) Example: 1990-01-01
@@ -48,15 +62,36 @@ class AccountController extends Controller
      * @bodyParam intention_city string nullable 意向城市 Example: 北京
      * @bodyParam introduction string nullable 个人简介(10-255个字符) Example: 专业按摩师，从业5年
      *
-     * @response {
-     *  "message": "基本信息提交成功"
+     * @response 200 {
+     *   "status": true,
+     *   "message": "基本信息提交成功"
+     * }
+     * @response 404 {
+     *   "message": "技师信息不存在"
+     * }
+     * @response 422 {
+     *   "message": "已有待审核的基本信息记录"
+     * }
+     * @response 422 {
+     *   "message": "验证错误",
+     *   "errors": {
+     *     "nickname": ["昵称不能少于2个字符"],
+     *     "gender": ["性别不能为空"],
+     *     "mobile": ["手机号不能为空"],
+     *     "life_photos.*": ["生活照片格式不正确"]
+     *   }
      * }
      */
     public function submitBaseInfo(SubmitBaseInfoRequest $request)
     {
+        // 获取验证后的数据
         $data = $request->validated();
 
-        return $this->success($this->service->submitBaseInfo(Auth::user(), $data));
+        // 调用服务层处理业务逻辑
+        // 传入当前认证用户和验证后的数据
+        return $this->success(
+            $this->service->submitBaseInfo(Auth::user(), $data)
+        );
     }
 
     /**
@@ -118,6 +153,10 @@ class AccountController extends Controller
      *     "base_info": {
      *       "nickname": "张三",
      *       "avatar": "base64或其他格式的图片数据",
+     *       "life_photos": [
+     *         "base64或其他格式的图片数据1",
+     *         "base64或其他格式的图片数据2"
+     *       ],
      *       "gender": "1",
      *       "mobile": "138****8000",
      *       "birthday": "1990-01-01",

app/Http/Requests/Coach/SubmitBaseInfoRequest.php

@@ -16,6 +16,8 @@ class SubmitBaseInfoRequest extends FormRequest
         return [
             'nickname' => 'nullable|string|min:2|max:20',
             'avatar' => 'nullable|string|max:2048',
+            'life_photos' => 'nullable|array',
+            'life_photos.*' => 'required|string|max:2048',
             'gender' => 'required|string|in:1,2',
             'mobile' => 'required|string|size:11',
             'birthday' => 'nullable|date|before:' . now()->subYears(18)->format('Y-m-d'),
@@ -46,6 +48,10 @@ class SubmitBaseInfoRequest extends FormRequest
             'intention_city.max' => '意向城市不能超过50个字符',
             'introduction.min' => '个人简介不能少于10个字符',
             'introduction.max' => '个人简介不能超过255个字符',
+            'life_photos.array' => '生活照片必须是数组格式',
+            'life_photos.*.required' => '生活照片不能为空',
+            'life_photos.*.string' => '生活照片格式不正确',
+            'life_photos.*.max' => '生活照片数据过大',
         ];
     }
 }

app/Services/Coach/AccountService.php

@@ -31,13 +31,14 @@ class AccountService
      * 业务流程：
      * 1. 验证技师信息存在性
      * 2. 检查是否有待审核的记录
-     * 3. 创建新的基本信息记录
-     * 4. 清除相关缓存
+     * 3. 处理生活照片数据
+     * 4. 创建新的基本信息记录
+     * 5. 清除相关缓存
      *
      * 注意事项：
      * - 同一时间只能有一条待审核记录
      * - 审核不通过可以重新提交
-     * - 头像图片数据不限制格式
+     * - 头像和生活照片不限制格式
      * - 除性别和手机号外，其他字段均为可选
      * - 手机号会进行脱敏处理
      *
@@ -45,42 +46,57 @@ class AccountService
      * @param array $data 基本信息数据，包含：
      *        - nickname: string|null 昵称(可选)
      *        - avatar: string|null 头像图片(可选)
+     *        - life_photos: array|null 生活照片数组(可选)
      *        - gender: string 性别(1:男 2:女)
      *        - mobile: string 手机号
      *        - birthday: string|null 出生日期(可选)
      *        - work_years: int|null 工作年限(可选)
      *        - intention_city: string|null 意向城市(可选)
      *        - introduction: string|null 个人简介(可选)
-     * @return array 返回结果
+     * @return array 返回结果，包含：
+     *        - message: string 提示信息
      * @throws \Exception 当验证失败或保存失败时抛出异常
      */
     public function submitBaseInfo($user, array $data)
     {
+        // 开启数据库事务，确保数据一致性
         DB::beginTransaction();
         try {
-            // 验证技师信息是否存在
+            // 验证技师信息是否存在，不存在则抛出404异常
             abort_if(!$user->coach, 404, '技师信息不存在');
 
             // 检查是否有待审核的记录，避免重复提交
+            // 如果存在待审核记录，则抛出422异常
             $pendingRecord = $this->hasPendingRecord($user->coach, 'info');
             abort_if($pendingRecord, 422, '已有待审核的基本信息记录');
 
-            // 创建技师信息
+            // 处理生活照片数据：将数组转换为JSON格式存储
+            // 如果没有生活照片数据，则保持原样
+            if (isset($data['life_photos'])) {
+                // 使用array_values确保数组索引连续
+                $data['life_photos'] = json_encode(array_values($data['life_photos']));
+            }
+
+            // 创建新的基本信息记录，设置为待审核状态
+            // 合并用户提交的数据和审核状态
             $user->coach->infoRecords()->create(array_merge($data, [
-                'state' => TechnicianAuthStatus::AUDITING->value,
+                'state' => TechnicianAuthStatus::AUDITING->value,  // 设置为待审核状态
             ]));
 
             // 清除技师信息缓存，确保数据一致性
+            // 避免用户获取到旧的缓存数据
             $this->clearCoachCache($user->coach->id);
 
-            // 提交事务
+            // 提交事务，确保所有操作成功
             DB::commit();
 
             // 返回成功结果
             return ['message' => '基本信息提交成功'];
         } catch (\Exception $e) {
-            // 发生异常时回滚事务
+            // 发生异常时回滚事务，确保数据一致性
             DB::rollBack();
+
+            // 向上抛出异常，由调用方处理
             throw $e;
         }
     }
@@ -285,6 +301,7 @@ class AccountService
         return [
             'nickname' => $info->nickname,
             'avatar' => $info->avatar,  // 支持任意格式的图片数据
+            'life_photos' => json_decode($info->life_photos, true) ?? [],  // 生活照片数组
             'gender' => $info->gender,
             'mobile' => $this->maskMobile($info->mobile),  // 手机号脱敏处理
             'birthday' => $info->birthday,

database/migrations/2024_03_13_add_life_photos_to_coach_info_records_table.php

@@ -0,0 +1,28 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('coach_info_records', function (Blueprint $table) {
+            $table->json('life_photos')->nullable()->after('avatar')->comment('生活照片数组');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('coach_info_records', function (Blueprint $table) {
+            $table->dropColumn('life_photos');
+        });
+    }
+};