64 lines
2.1 KiB
Python
64 lines
2.1 KiB
Python
|
"""成绩模块出入参（需求 2.2）。"""
|
|||
|
|
|
|||
|
|
from __future__ import annotations
|
|||
|
|
|
|||
|
|
from datetime import date
|
|||
|
|
from decimal import Decimal
|
|||
|
|
|
|||
|
|
from pydantic import BaseModel, Field, field_validator
|
|||
|
|
|
|||
|
|
from app.schema.common import ORMBase, STRIP_VALIDATOR
|
|||
|
|
|
|||
|
|
|
|||
|
|
class ScoreCreate(BaseModel):
|
|||
|
|
stu_id: int = Field(..., description="学生ID")
|
|||
|
|
exam_seq: int = Field(..., ge=1, le=99, description="考核序次，如 1=第一次考核")
|
|||
|
|
score: Decimal = Field(..., ge=0, le=1000, description="成绩")
|
|||
|
|
exam_name: str | None = Field(None, max_length=50, description="考核名称")
|
|||
|
|
exam_date: str | None = Field(None, description="考核日期 YYYY-MM-DD")
|
|||
|
|
remark: str | None = Field(None, max_length=255, description="备注")
|
|||
|
|
|
|||
|
|
_v_strip = STRIP_VALIDATOR
|
|||
|
|
|
|||
|
|
|
|||
|
|
class ScoreBatchCreate(BaseModel):
|
|||
|
|
"""一个学生一次性录入多次考核成绩。"""
|
|||
|
|
|
|||
|
|
stu_id: int = Field(..., description="学生ID")
|
|||
|
|
scores: list[ScoreCreate] = Field(..., min_length=1, description="成绩列表")
|
|||
|
|
|
|||
|
|
@field_validator("scores")
|
|||
|
|
@classmethod
|
|||
|
|
def _same_student(cls, v, info): # noqa: ANN001, ANN201
|
|||
|
|
return v
|
|||
|
|
|
|||
|
|
|
|||
|
|
class ScoreUpdate(BaseModel):
|
|||
|
|
score: Decimal | None = Field(None, ge=0, le=1000, description="新成绩")
|
|||
|
|
exam_name: str | None = None
|
|||
|
|
exam_date: str | None = None
|
|||
|
|
remark: str | None = None
|
|||
|
|
|
|||
|
|
|
|||
|
|
class ScoreOut(ORMBase):
|
|||
|
|
id: int
|
|||
|
|
stu_id: int
|
|||
|
|
student_name: str | None = Field(None, description="学生姓名（JOIN）")
|
|||
|
|
class_name: str | None = Field(None, description="班级名称（JOIN）")
|
|||
|
|
exam_seq: int
|
|||
|
|
exam_name: str | None = None
|
|||
|
|
exam_date: date | None = None
|
|||
|
|
score: float
|
|||
|
|
flag: int
|
|||
|
|
is_warning: bool = Field(False, description="是否低于红线")
|
|||
|
|
remark: str | None = None
|
|||
|
|
|
|||
|
|
|
|||
|
|
class ScoreRecordResult(BaseModel):
|
|||
|
|
"""录入结果：把红线预警顺手带回去，前端可以直接弹提示。"""
|
|||
|
|
|
|||
|
|
record: ScoreOut
|
|||
|
|
warning: bool = Field(False, description="是否触发红线预警")
|
|||
|
|
warning_msg: str | None = Field(None, description="预警文案")
|
|||
|
|
avg_score: float | None = Field(None, description="录入后该生平均分")
|