fix: example改为字段描述和example

packages/server/src/controllers/GroupController.ts

@@ -1,4 +1,4 @@
-import {Controller, Get, Route, Response, Tags, Request, Security, OperationId, Example} from 'tsoa';
+import {Controller, Get, Route, Response, Tags, Request, Security, OperationId} from 'tsoa';
 import {ApiError, ApiResponse} from '../types/api';
 import type {Request as ExpressRequest} from 'express';
 import axios from "axios";
@@ -50,23 +50,6 @@ export class GroupController extends Controller {
   @Response<ApiResponse<UserInfo[]>>(200, 'Success')
   @Response<ApiResponse<null>>(400, 'Bad Request')
   @Response<ApiResponse<null>>(401, 'Unauthorized')
-  @Example<ApiResponse<UserInfo[]>>({
-    code: 200,
-    message: 'success',
-    data: [
-      {
-        userId: 123,
-        nickname: 'John Doe',
-        avatarUrl: 'https://example.com/avatar.jpg',
-        gender: 'MALE',
-        nimToken: 'nim_token_123',
-        nimAccountId: 'nim_account_123',
-        token: 'user_token_123',
-        updatedAt: '2024-01-01 00:00:00',
-        createdAt: '2024-01-01 00:00:00',
-      },
-    ],
-  })
   public async getGroupMembers(@Request() req: ExpressRequest): Promise<ApiResponse<UserInfo[]>> {
     const user = req.user;
     const groupId = req.headers.groupid;

packages/server/src/controllers/TestController.ts

@@ -1,4 +1,4 @@
-import {Controller, Get, Route, Response, Tags, OperationId, Example} from 'tsoa';
+import {Controller, Get, Route, Response, Tags, OperationId} from 'tsoa';
 import type { ApiResponse } from '../types/api';
 
 @Route('api')
@@ -12,11 +12,6 @@ export class TestController extends Controller {
   @Get('/test')
   @OperationId('Test_GetTest') // MUST: Specify operationId for better API documentation
   @Response<ApiResponse>(200, 'Success')
-  @Example<ApiResponse>({
-    code: 200,
-    message: 'success',
-    data: null,
-  })
   public async getTest(): Promise<ApiResponse> {
     return {
       code: 200,

packages/server/src/controllers/UserController.ts

@@ -1,4 +1,4 @@
-import {Controller, Get, Route, Response, Tags, Example, Request, Security, OperationId} from 'tsoa';
+import {Controller, Get, Route, Response, Tags, Request, Security, OperationId} from 'tsoa';
 import type { ApiResponse } from '../types/api';
 import type { Request as ExpressRequest } from 'express';
 import type {UserInfo} from "../types/user";
@@ -17,21 +17,6 @@ export class UserController extends Controller {
   @Security('jwt')
   @Response<ApiResponse<UserInfo>>(200, 'Success')
   @Response(401, 'Unauthorized')
-  @Example<ApiResponse<UserInfo>>({
-    code: 200,
-    message: 'success',
-    data: {
-      userId: 123,
-      nickname: 'John Doe',
-      avatarUrl: 'https://example.com/avatar.jpg',
-      gender: 'MALE',
-      nimToken: 'nim_token_123',
-      nimAccountId: 'nim_account_123',
-      token: 'user_token_123',
-      updatedAt: '2024-01-01 00:00:00',
-      createdAt: '2024-01-01 00:00:00',
-    }
-  })
   public async getUserGroupInfo(@Request() req: ExpressRequest): Promise<ApiResponse<Omit<UserInfo, 'token'>>> {
     const { token, ...rest } = req.user;
     return {

packages/server/src/types/api.ts

@@ -1,6 +1,18 @@
+/**
+ * Standard API response structure
+ */
 export interface ApiResponse<T = any> {
+  /**
+   * HTTP status code, e.g., 200 for success, 400 for client error, 500 for server error
+   */
   code: number;
+  /**
+   * Response message, e.g., "success" or error description
+   */
   message: string;
+  /**
+   * Response data; can be null if no data is returned
+   */
   data: T | null;
 }
 

packages/server/src/types/user.ts

@@ -1,11 +1,41 @@
+/**
+ * User information interface
+ */
 export interface UserInfo {
+  /**
+   * User ID
+   */
   userId: number;
+  /**
+   * User nickname
+   */
   nickname: string;
+  /**
+   * Avatar URL
+   * @example "https://example.com/avatar.jpg"
+   */
   avatarUrl: string;
   gender: 'MALE' | 'FEMALE' | 'UNKNOWN';
-  nimToken: string; // NetEase Cloud Communication token
-  nimAccountId: string; // NetEase Cloud Communication account ID
-  token: string; // Authentication token
-  updatedAt: string; // yyyy-MM-dd HH:mm:ss
-  createdAt: string; // yyyy-MM-dd HH:mm:ss
+  /**
+   * NetEase Cloud Communication token
+   */
+  nimToken: string;
+  /**
+   * NetEase Cloud Communication account ID
+   */
+  nimAccountId: string;
+  /**
+   * Authentication token
+   */
+  token: string;
+  /**
+   * Last update time yyyy-MM-dd HH:mm:ss
+   * @example "2023-10-05 14:48:00"
+   */
+  updatedAt: string;
+  /**
+   * Account creation time yyyy-MM-dd HH:mm:ss
+   * @example "2023-10-05 14:48:00"
+   */
+  createdAt: string;
 }