feat(models): 添加模型类文档注释并实现MarkdownFileVO扩展功能

- 为Grouping、Image、MarkdownFile、RegistrationCode、SystemSetting、User等模型类添加详细的PHP文档注释
- 为各个模型类添加公共属性定义，包括分组、图片、笔记、注册码、系统设置和用户相关字段
- 实现MarkdownFileVO视图对象类，扩展MarkdownFile模型以支持分组名称查询
- 在MarkdownController中使用MarkdownFileVO替代原模型获取包含分组名称的数据
- 添加TrashItemVo视图对象用于回收站项目的展示
- 添加UpdatePasswordBo业务对象用于密码更新请求处理
- 为RegistrationCode模型添加按ID和代码查询的方法及详细验证功能
- 为SystemSetting模型添加带描述的设置获取和设置方法

biji-php/src/Controllers/MarkdownController.php

@@ -5,6 +5,7 @@ namespace App\Controllers;
 use Psr\Http\Message\ResponseInterface as Response;
 use Psr\Http\Message\ServerRequestInterface as Request;
 use App\Models\MarkdownFile;
+use App\Models\MarkdownFileVO;
 use App\Utils\Response as ApiResponse;
 
 class MarkdownController
@@ -98,8 +99,9 @@ class MarkdownController
 
     public function getRecent(Request $request, Response $response)
     {
-        $model = new MarkdownFile();
-        $files = $model->getRecent(12);
+        // 使用 MarkdownFileVO 获取包含分组名称的数据
+        $voModel = new MarkdownFileVO();
+        $files = $voModel->getRecentWithGrouping(12);
 
         $response->getBody()->write(ApiResponse::json(ApiResponse::success($files)));
         return $response->withHeader('Content-Type', 'application/json; charset=utf-8');