feat: 【site】生成swagger.json

https://e.gitee.com/liweijia/dashboard?issue=I6UGPB

支持unit.name 翻译respons中的字段

Author: Mz

src/Mpociot/ApiDoc/Generators/LaravelGenerator.php

@@ -330,7 +330,7 @@ protected function getSwaggerTransformerResponse($tags)
             if (empty($tables)) {
 //                $tables = \DB::getDoctrineSchemaManager()->listTableNames();
             }
-            $this->addComment($datas, $tables, $columnComments, $returnData);
+            $this->addComment($datas, $tables, $columnComments, null, $returnData);
             return \response(json_encode($returnData));
         } catch (\Exception $e) {
             \Log::info('LaravelGenerator::getSwaggerTransformerResponse::', [$e->getMessage()]);
@@ -353,11 +353,18 @@ private function getColumns($tables)
 
     protected function getComment(array $tables, array $columnComments, string $field)
     {
-        $comment = null;
         if (isset($columnComments[$field]) && $columnComments[$field]) {
             return $columnComments[$field];
+        } else {
+            $arrField = explode('.', $field);
+            $name = $arrField[1] ?? null;
+            if ($name && !is_numeric($name) && isset($columnComments[$name]) && $columnComments[$name]) {
+                return $columnComments[$name];
+            }
+            return null;
         }
 
+        return null;
         $columns = $this->getColumns($tables);
         foreach ($columns as $column) {
             if (isset($columnComments[$field]) && $columnComments[$field]) {
@@ -373,19 +380,23 @@ protected function getComment(array $tables, array $columnComments, string $fiel
         return $comment;
     }
 
-    private function addComment($datas, $tables, $columnComments, &$returnData)
+    private function addComment($datas, $tables, $columnComments, $parentKey = null, &$returnData)
     {
         foreach ($datas as $key => $data) {
+            $newKey = $key;
+            if ($parentKey) {
+                $newKey = $parentKey . '.' . $key;
+            }
+
             if (in_array(gettype($data), ['object', 'array'])) {
-                $this->addComment($data, $tables, $columnComments, $returnData[$key]);
-                $returnData[$key]['_____description'] = $this->getComment($tables, $columnComments, $key);
+                $this->addComment($data, $tables, $columnComments, $key, $returnData[$key]);
+                $returnData[$key]['_____description'] = $this->getComment($tables, $columnComments, $newKey);
             } else {
-
                 $returnData[$key] = [
                     '_____key' => Uuid::uuid4()->toString(),
                     'value' => $data,
                     'type' => gettype($data),
-                    'description' => $this->getComment($tables, $columnComments, $key),
+                    'description' => $this->getComment($tables, $columnComments, $newKey),
                 ];
             }
         }