77 lines
3.0 KiB
Python
77 lines
3.0 KiB
Python
"""班级模块出入参（需求 2.4）。"""
|
||
|
||
from __future__ import annotations
|
||
|
||
from datetime import date
|
||
|
||
from pydantic import BaseModel, Field, field_validator
|
||
|
||
from app.schema.common import ORMBase, STRIP_VALIDATOR
|
||
|
||
|
||
class _ClazzBase(BaseModel):
|
||
name: str = Field(..., min_length=1, max_length=50, description="班级名称")
|
||
direction: str | None = Field(None, max_length=50, description="班级方向")
|
||
open_date: str | None = Field(None, description="开课时间 YYYY-MM-DD")
|
||
close_date: str | None = Field(None, description="结课时间 YYYY-MM-DD")
|
||
classroom: str | None = Field(None, max_length=30, description="教室")
|
||
capacity: int | None = Field(40, ge=1, le=500, description="计划招生人数")
|
||
status: int = Field(1, ge=1, le=3, description="状态 1=在读 2=已结课 3=已解散")
|
||
head_teacher_id: int | None = Field(None, description="班主任（老师ID）")
|
||
advisor_id: int | None = Field(None, description="带班顾问ID")
|
||
teacher_ids: list[int] = Field(default_factory=list, description="授课老师ID列表（多对多）")
|
||
description: str | None = Field(None, description="班级说明")
|
||
|
||
_v_strip = STRIP_VALIDATOR
|
||
|
||
@field_validator("open_date", "close_date", mode="before")
|
||
@classmethod
|
||
def _date_like(cls, v): # noqa: ANN001, ANN201
|
||
if v is None or isinstance(v, str):
|
||
return v
|
||
if isinstance(v, date):
|
||
return v.isoformat()
|
||
return v
|
||
|
||
|
||
class ClazzCreate(_ClazzBase):
|
||
class_no: str | None = Field(None, max_length=30, description="班级编号，不传按 方向缩写+年份+序号 生成")
|
||
|
||
|
||
class ClazzUpdate(BaseModel):
|
||
name: str | None = Field(None, min_length=1, max_length=50, description="班级名称")
|
||
direction: str | None = None
|
||
open_date: str | None = None
|
||
close_date: str | None = None
|
||
classroom: str | None = None
|
||
capacity: int | None = Field(None, ge=1, le=500)
|
||
status: int | None = Field(None, ge=1, le=3, description="状态 1=在读 2=已结课 3=已解散")
|
||
head_teacher_id: int | None = None
|
||
advisor_id: int | None = None
|
||
teacher_ids: list[int] | None = Field(None, description="传了就整体替换授课老师")
|
||
description: str | None = None
|
||
|
||
_v_strip = STRIP_VALIDATOR
|
||
|
||
|
||
class ClazzOut(ORMBase):
|
||
id: int
|
||
class_no: str = Field(..., description="班级编号")
|
||
name: str
|
||
direction: str | None = None
|
||
open_date: date | None = None
|
||
close_date: date | None = None
|
||
classroom: str | None = None
|
||
capacity: int | None = None
|
||
status: int
|
||
status_text: str
|
||
|
||
head_teacher_id: int | None = None
|
||
head_teacher_name: str | None = None
|
||
advisor_id: int | None = None
|
||
advisor_name: str | None = None
|
||
teacher_ids: list[int] = Field(default_factory=list, description="授课老师ID")
|
||
teacher_names: list[str] = Field(default_factory=list, description="授课老师姓名")
|
||
description: str | None = None
|
||
student_count: int = Field(0, description="班级在读人数")
|