教师

2025-09-19 17:10:05 +08:00
parent 211588d3ce
commit 0a6ba2c566
9 changed files with 489 additions and 3 deletions
--- a/app/Controller/TeacherController.php
+++ b/app/Controller/TeacherController.php
@@ -0,0 +1,162 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Controller;
+
+use Aether\AetherController;
+use Aether\AetherResponse;
+use App\Exception\BusinessException;
+use App\Model\Teacher;
+use App\Validator\TeacherValidator;
+use Hyperf\Di\Annotation\Inject;
+use Hyperf\HttpServer\Contract\RequestInterface;
+
+/**
+ * @Controller(prefix="/api/v1/teacher")
+ */
+class TeacherController extends AetherController
+{
+    #[Inject]
+    protected TeacherValidator $validator;
+
+    /**
+     * 创建教师.
+     * @PostMapping(path="")
+     */
+    public function create(RequestInterface $request): array
+    {
+        $data = $request->all();
+        $validator = $this->validator->validateCreate($data);
+        if ($validator->fails()) {
+            throw new BusinessException(400, $validator->errors()->first());
+        }
+
+        $teacher = new Teacher();
+        $teacher->fill($data);
+        $teacher->save();
+
+        return AetherResponse::success($teacher->toArray(), '教师创建成功');
+    }
+
+    /**
+     * 获取教师详情.
+     * @GetMapping(path="/{id}")
+     */
+    public function get(int $id): array
+    {
+        $teacher = Teacher::find($id);
+        if (! $teacher) {
+            throw new BusinessException(10101);
+        }
+
+        return AetherResponse::success($teacher->toArray());
+    }
+
+    /**
+     * 更新教师信息.
+     * @PutMapping(path="/{id}")
+     */
+    public function update(int $id, RequestInterface $request): array
+    {
+        $data = $request->all();
+        $data['id'] = $id;
+
+        $validator = $this->validator->validateUpdate($data);
+        if ($validator->fails()) {
+            throw new BusinessException(400, $validator->errors()->first());
+        }
+
+        $teacher = Teacher::find($id);
+        if (! $teacher) {
+            throw new BusinessException(10101);
+        }
+
+        $teacher->fill($data);
+        $teacher->save();
+
+        return AetherResponse::success($teacher->toArray(), '教师信息更新成功');
+    }
+
+    /**
+     * 删除教师.
+     * @DeleteMapping(path="/{id}")
+     */
+    public function delete(int $id): array
+    {
+        $teacher = Teacher::find($id);
+        if (! $teacher) {
+            throw new BusinessException(10101);
+        }
+
+        $teacher->delete();
+        return AetherResponse::success(null, '教师删除成功');
+    }
+
+    /**
+     * 教师列表.
+     * @GetMapping(path="/list")
+     */
+    public function list(RequestInterface $request): array
+    {
+        $data = $request->all();
+        $validator = $this->validator->validateQuery($data);
+        if ($validator->fails()) {
+            throw new BusinessException(400, $validator->errors()->first());
+        }
+
+        $query = Teacher::query();
+
+        if (! empty($data['id'])) {
+            $query->where('id', $data['id']);
+        }
+        if (! empty($data['name'])) {
+            $query->where('name', 'like', "%{$data['name']}%");
+        }
+        if (isset($data['campus_id'])) {
+            $query->where('campus_id', $data['campus_id']);
+        }
+        if (! empty($data['major_subject'])) {
+            $query->where('major_subject', 'like', "%{$data['major_subject']}%");
+        }
+        if (isset($data['status'])) {
+            $query->where('status', $data['status']);
+        }
+
+        $page = $data['page'] ?? 1;
+        $size = $data['size'] ?? 20;
+
+        $total = $query->count();
+        $list = $query->forPage($page, $size)->get()->toArray();
+
+        return AetherResponse::success([
+            'total' => $total,
+            'page' => $page,
+            'size' => $size,
+            'list' => $list,
+        ]);
+    }
+
+    /**
+     * 搜索教师.
+     * @GetMapping(path="/search")
+     */
+    public function search(RequestInterface $request): array
+    {
+        $keyword = $request->input('keyword', '');
+        $page = (int) $request->input('page', 1);
+        $size = (int) $request->input('size', 20);
+
+        $query = Teacher::search($keyword)->enabled();
+
+        $total = $query->count();
+        $list = $query->forPage($page, $size)->get()->toArray();
+
+        return AetherResponse::success([
+            'total' => $total,
+            'page' => $page,
+            'size' => $size,
+            'list' => $list,
+        ]);
+    }
+}