修改文件结构,统一文档格式

This commit is contained in:
ylweng
2025-09-01 02:42:03 +08:00
parent 2bd1d8c032
commit abc1184f81
151 changed files with 870 additions and 589 deletions

View File

@@ -20,6 +20,7 @@ const userController = require('../controllers/userController');
* - id
* - username
* - email
* - password
* properties:
* id:
* type: integer
@@ -30,10 +31,36 @@ const userController = require('../controllers/userController');
* email:
* type: string
* description: 邮箱地址
* password:
* type: string
* description: 密码(加密存储)
* phone:
* type: string
* description: 手机号码
* avatar:
* type: string
* description: 头像URL
* status:
* type: string
* enum: [active, inactive, suspended]
* description: 用户状态
* createdAt:
* type: string
* format: date-time
* description: 创建时间
* updatedAt:
* type: string
* format: date-time
* description: 更新时间
* example:
* id: 1
* username: "john_doe"
* email: "john@example.com"
* phone: "13800138000"
* avatar: "/uploads/avatars/default.png"
* status: "active"
* createdAt: "2024-01-01T00:00:00.000Z"
* updatedAt: "2024-01-01T00:00:00.000Z"
*/
/**