班级api,schema,dao

2026-09-21 22:09:19 +08:00
parent 01fee950bf
commit 725e123668
4 changed files with 66 additions and 46 deletions
@@ -1,24 +1,27 @@
+# 班级schema模块
 from pydantic import BaseModel           # 导入pydantic模块下的BaseModel类
 from datetime import datetime,date       # 导入datetime模块下的datetime,date类


 # ————定义"创建班级"的"请求体"模型————
-class ClassCreate( BaseModel ):
-    class_no: str
-    class_name: str
+class ClassCreate( BaseModel ):         # "创建"班级信息的请求体模型
+    class_no: str                       # 班级编号"，不可为空
+    class_name: str                     # 班级名字"，不可为空
+    start_date : date|None = None       # 班级开课日期"，可以为空，默认为空
+    end_date : date|None = None         # 班级结课日期"，可以为空，默认为空
+    remark : str|None = None            # 班级备注"，可以为空，默认为空

 # ————定义"更新班级"的"请求体"模型————
-class ClassUpdate( BaseModel ):
-    class_no: str|None = None
-    class_name: str|None = None
-    start_date : date|None = None
-    end_date : date|None = None
-    created_at : datetime|None = None
-    update_at : datetime|None = None
+class ClassUpdate( BaseModel ):          # "更新"班级信息的请求体模型
+    class_no: str|None = None            # 班级编号，可以为空，默认为空
+    class_name: str|None = None          # 班级名字，可以为空，默认为空
+    start_date : date|None = None        # 班级开课日期，可以为空，默认为空
+    end_date : date|None = None          # 班级结课日期，可以为空，默认为空
+    remark: str|None = None               # 班级备注，可以为空，默认为空

 # ————定义"班级"的"响应体"模型————
-class ClassResponse( BaseModel ):
-    code:int = 200
-    detail:str = '执行成功'
-    total:int = 0
-    data:str|dict|list|tuple
+class ClassResponse( BaseModel ):        # 班级信息的响应体模型
+    code:int = 200                       # 状态码，默认200
+    detail:str = '执行成功'                # 提示信息
+    total:int = 0                        # 数据总条数，默认为0
+    data:str|dict|list|tuple             # 返回的数据