Skip to content
GitLab
Menu
Projects
Groups
Snippets
Loading...
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in
Toggle navigation
Menu
Open sidebar
邬吉朋
practical_train
Commits
2fea7e12
Commit
2fea7e12
authored
Aug 17, 2026
by
wujipeng
Browse files
管理员-教务管理-班级管理
parent
39ea4860
Changes
24
Hide whitespace changes
Inline
Side-by-side
practical-business/src/main/resources/com/platform/business/mapper/ClassMapper.xml
View file @
2fea7e12
...
@@ -30,4 +30,245 @@
...
@@ -30,4 +30,245 @@
c.name,
c.name,
c.level
c.level
</select>
</select>
<!--
管理员端卡片列表。状态由起止日期和服务端传入的业务日期动态筛选,
不依赖容易失真的持久化状态字段。该查询同时供导航树使用,树接口不启动分页。
-->
<select
id=
"selectAdminClasses"
resultType=
"com.platform.business.model.vo.ClassAdminCardVO"
>
select
c.id,
c.name,
c.occupation,
c.training_year as trainingYear,
cast(c.level as char) as levelId,
sl.name as levelName,
c.start_date as startDate,
c.end_date as endDate,
c.capacity,
(select count(*) from class_student cs_member where cs_member.class_id = c.id) as studentCount
from class c
left join sys_level sl on cast(sl.id as char) = c.level
<where>
<if
test=
"query.keyword != null and query.keyword != ''"
>
and c.name like concat('%', #{query.keyword}, '%')
</if>
<if
test=
"query.occupation != null and query.occupation != ''"
>
and c.occupation = #{query.occupation}
</if>
<if
test=
"query.trainingYear != null"
>
and c.training_year = #{query.trainingYear}
</if>
<if
test=
"query.levelId != null"
>
and c.level = cast(#{query.levelId} as char)
</if>
<choose>
<when
test=
'query.status == "UPCOMING"'
>
and c.start_date is not null and c.end_date is not null
and c.start_date
>
#{today}
</when>
<when
test=
'query.status == "ONGOING"'
>
and c.start_date is not null and c.end_date is not null
and c.start_date
<
= #{today} and c.end_date
>
= #{today}
</when>
<when
test=
'query.status == "ENDED"'
>
and c.start_date is not null and c.end_date is not null
and c.end_date
<
#{today}
</when>
<when
test=
'query.status == "UNKNOWN"'
>
and (c.start_date is null or c.end_date is null)
</when>
</choose>
</where>
order by c.training_year desc, c.occupation asc, sl.id asc, c.name asc, c.id asc
</select>
<!--
班级详情基础信息和全班出勤率。请假计入应出勤分母,只有NORMAL/LATE计入分子,
与现有出勤管理模块的统计口径保持一致;没有有效记录时attendanceRate返回NULL。
-->
<select
id=
"selectAdminDetail"
resultType=
"com.platform.business.model.vo.ClassAdminDetailVO"
>
select
c.id,
c.name,
c.occupation,
c.training_year as trainingYear,
cast(c.level as char) as levelId,
sl.name as levelName,
c.start_date as startDate,
c.end_date as endDate,
c.capacity,
c.head_teacher_id as headTeacherId,
teacher.nick_name as headTeacherName,
c.location,
c.remark,
(select count(*) from class_student cs_member where cs_member.class_id = c.id) as studentCount,
attendance.attendanceRate
from class c
left join sys_level sl on cast(sl.id as char) = c.level
left join user teacher on teacher.id = c.head_teacher_id
left join (
select
subject.class_id,
round(sum(case when record.status in ('NORMAL', 'LATE') then 1 else 0 end)
* 100.0 / count(record.id), 2) as attendanceRate
from class_subject_attendance record
inner join class_subject subject on subject.id = record.subject_id
where record.status in ('NORMAL', 'LATE', 'ABSENT', 'LEAVE')
group by subject.class_id
) attendance on attendance.class_id = c.id
where c.id = #{classId}
</select>
<!-- 同名、同类型且由同一教师授课的多次排课合并为详情页的一门逻辑课程。 -->
<select
id=
"selectAdminCourses"
resultType=
"com.platform.business.model.vo.ClassAdminCourseVO"
>
select
subject.subject_name as subjectName,
subject.type,
coalesce(sum(subject.subject_hour), 0) as totalHours,
subject.teacher_id as teacherId,
teacher.nick_name as teacherName,
min(subject.date) as firstDate,
max(subject.date) as lastDate
from class_subject subject
left join user teacher on teacher.id = subject.teacher_id
where subject.class_id = #{classId}
group by subject.subject_name, subject.type, subject.teacher_id, teacher.nick_name
order by min(subject.date) asc, subject.subject_name asc, subject.teacher_id asc
</select>
<!--
只选择最近一场整场成绩已发布的考试,并仅统计考生侧同样已发布且分数非空的记录。
60分为及格线;没有有效分数时通过率返回NULL。
-->
<select
id=
"selectLatestPublishedExam"
resultType=
"com.platform.business.model.vo.ClassAdminExamVO"
>
select
latest.id as examId,
latest.name as examName,
latest.exam_time as examTime,
case when count(student.id) = 0 then null
else round(sum(case when student.score
>
= 60 then 1 else 0 end)
* 100.0 / count(student.id), 2)
end as passRate
from (
select exam.id, exam.name, exam.exam_time
from exam
where exam.class_id = #{classId}
and exam.mark_flag = 1
order by exam.exam_time desc, exam.id desc
limit 1
) latest
left join exam_student student
on student.exam_id = latest.id
and student.mark_flag = 1
and student.score is not null
group by latest.id, latest.name, latest.exam_time
</select>
<!--
学员名单一次性关联个人出勤率和指定的最近已发布考试成绩,
避免详情页按学员循环访问数据库造成N+1查询。
-->
<select
id=
"selectAdminStudents"
resultType=
"com.platform.business.model.vo.ClassAdminStudentVO"
>
select
cs_member.id as relationId,
cs_member.user_id as userId,
student.nick_name as name,
student.phone_number as phone,
attendance.attendanceRate,
examResult.examScore
from class_student cs_member
left join user student on student.id = cs_member.user_id
left join (
select
record.user_id,
round(sum(case when record.status in ('NORMAL', 'LATE') then 1 else 0 end)
* 100.0 / count(record.id), 2) as attendanceRate
from class_subject_attendance record
inner join class_subject subject on subject.id = record.subject_id
where subject.class_id = #{classId}
and record.status in ('NORMAL', 'LATE', 'ABSENT', 'LEAVE')
group by record.user_id
) attendance on attendance.user_id = cs_member.user_id
left join (
select student_id, max(score) as examScore
from exam_student
where exam_id = #{examId,jdbcType=INTEGER}
and mark_flag = 1
and score is not null
group by student_id
) examResult on examResult.student_id = cs_member.user_id
where cs_member.class_id = #{classId}
order by student.nick_name asc, student.phone_number asc, cs_member.id asc
</select>
<!-- 只向班级表单暴露能归属到污水或污泥工种的启用等级。 -->
<select
id=
"selectAdminLevelOptions"
resultType=
"com.platform.business.model.vo.ClassAdminOptionVO"
>
select
cast(level.id as char) as value,
level.name as label,
case when level.name like '污水%' then '污水'
when level.name like '污泥%' then '污泥'
else null end as parentValue,
null as extra
from sys_level level
where coalesce(level.hidde_flag, 0) = 0
and (level.name like '污水%' or level.name like '污泥%')
order by parentValue asc, level.id asc
</select>
<!-- 班主任候选人必须是未删除且在phone_role中具有“教师”角色的系统用户。 -->
<select
id=
"selectAdminHeadTeacherOptions"
resultType=
"com.platform.business.model.vo.ClassAdminOptionVO"
>
select distinct
teacher.id as value,
coalesce(nullif(teacher.nick_name, ''), teacher.username) as label,
null as parentValue,
teacher.phone_number as extra
from user teacher
inner join phone_role pr
on pr.phone = teacher.phone_number and pr.role_name = '教师'
where coalesce(teacher.del_flag, 0) = 0
order by label asc, teacher.phone_number asc
</select>
<select
id=
"selectAdminTrainingYears"
resultType=
"java.lang.Integer"
>
select distinct training_year
from class
where training_year is not null
order by training_year desc
</select>
<select
id=
"countAdminDuplicateName"
resultType=
"java.lang.Integer"
>
select count(*)
from class
where training_year = #{trainingYear}
and name = #{name}
<if
test=
"excludeId != null"
>
and id != #{excludeId}
</if>
</select>
<select
id=
"countAdminStudents"
resultType=
"java.lang.Integer"
>
select count(*) from class_student where class_id = #{classId}
</select>
<!--
不使用MyBatis-Plus默认的非空字段更新策略,因为班主任、地点、计划人数和备注
都允许在编辑时主动清空。学员和排课关系不在此SQL中处理。
-->
<update
id=
"updateAdminClass"
parameterType=
"com.platform.business.model.entity.ClassEntity"
>
update class
set name = #{name},
occupation = #{occupation},
training_year = #{trainingYear},
level = #{level},
start_date = #{startDate},
end_date = #{endDate},
head_teacher_id = #{headTeacherId,jdbcType=VARCHAR},
location = #{location,jdbcType=VARCHAR},
capacity = #{capacity,jdbcType=INTEGER},
remark = #{remark,jdbcType=VARCHAR},
update_time = #{updateTime}
where id = #{id}
</update>
</mapper>
</mapper>
practical-business/src/main/resources/sql/class_management.sql
0 → 100644
View file @
2fea7e12
-- 管理员端“教务管理-班级管理”增量数据库脚本(MySQL 5.7+/8.0)。
--
-- 设计说明:
-- 1. 项目已经存在class表,因此使用information_schema逐项判断列和索引,脚本可重复执行。
-- 2. 新字段暂时允许NULL,以便旧班级在无法可靠推断工种或培训日期时继续正常查询;
-- 新增和编辑接口会在应用层强制校验完整字段。
-- 3. 项目现有业务表普遍不配置外键,本脚本保持相同风格,由服务层校验班主任、等级和关系数据。
delimiter
$$
drop
procedure
if
exists
migrate_class_management
$$
create
procedure
migrate_class_management
()
begin
if
not
exists
(
select
1
from
information_schema
.
columns
where
table_schema
=
database
()
and
table_name
=
'class'
and
column_name
=
'occupation'
)
then
alter
table
`class`
add
column
occupation
varchar
(
32
)
null
comment
'工种:污水/污泥'
after
level
;
end
if
;
if
not
exists
(
select
1
from
information_schema
.
columns
where
table_schema
=
database
()
and
table_name
=
'class'
and
column_name
=
'training_year'
)
then
alter
table
`class`
add
column
training_year
smallint
null
comment
'培训年度'
after
occupation
;
end
if
;
if
not
exists
(
select
1
from
information_schema
.
columns
where
table_schema
=
database
()
and
table_name
=
'class'
and
column_name
=
'start_date'
)
then
alter
table
`class`
add
column
start_date
date
null
comment
'培训开始日期'
after
training_year
;
end
if
;
if
not
exists
(
select
1
from
information_schema
.
columns
where
table_schema
=
database
()
and
table_name
=
'class'
and
column_name
=
'end_date'
)
then
alter
table
`class`
add
column
end_date
date
null
comment
'培训结束日期'
after
start_date
;
end
if
;
if
not
exists
(
select
1
from
information_schema
.
columns
where
table_schema
=
database
()
and
table_name
=
'class'
and
column_name
=
'head_teacher_id'
)
then
alter
table
`class`
add
column
head_teacher_id
varchar
(
64
)
null
comment
'班主任用户ID'
after
end_date
;
end
if
;
if
not
exists
(
select
1
from
information_schema
.
columns
where
table_schema
=
database
()
and
table_name
=
'class'
and
column_name
=
'location'
)
then
alter
table
`class`
add
column
location
varchar
(
255
)
null
comment
'培训地点'
after
head_teacher_id
;
end
if
;
if
not
exists
(
select
1
from
information_schema
.
columns
where
table_schema
=
database
()
and
table_name
=
'class'
and
column_name
=
'capacity'
)
then
alter
table
`class`
add
column
capacity
int
null
comment
'计划人数,管理端限制1到200'
after
location
;
end
if
;
if
not
exists
(
select
1
from
information_schema
.
columns
where
table_schema
=
database
()
and
table_name
=
'class'
and
column_name
=
'remark'
)
then
alter
table
`class`
add
column
remark
varchar
(
1000
)
null
comment
'班级备注'
after
capacity
;
end
if
;
if
not
exists
(
select
1
from
information_schema
.
columns
where
table_schema
=
database
()
and
table_name
=
'class'
and
column_name
=
'update_time'
)
then
alter
table
`class`
add
column
update_time
datetime
null
comment
'更新时间'
after
create_time
;
end
if
;
if
not
exists
(
select
1
from
information_schema
.
statistics
where
table_schema
=
database
()
and
table_name
=
'class'
and
index_name
=
'idx_class_group'
)
then
alter
table
`class`
add
index
idx_class_group
(
occupation
,
training_year
,
level
);
end
if
;
if
not
exists
(
select
1
from
information_schema
.
statistics
where
table_schema
=
database
()
and
table_name
=
'class'
and
index_name
=
'idx_class_year_name'
)
then
alter
table
`class`
add
index
idx_class_year_name
(
training_year
,
name
);
end
if
;
if
not
exists
(
select
1
from
information_schema
.
statistics
where
table_schema
=
database
()
and
table_name
=
'class'
and
index_name
=
'idx_class_head_teacher'
)
then
alter
table
`class`
add
index
idx_class_head_teacher
(
head_teacher_id
);
end
if
;
end
$$
call
migrate_class_management
()
$$
drop
procedure
if
exists
migrate_class_management
$$
delimiter
;
-- 从既有等级、排课和学员关系中尽力回填旧班级。无法可靠推断的值保持NULL,避免写入伪造数据。
update
`class`
c
left
join
sys_level
level_info
on
cast
(
level_info
.
id
as
char
)
=
c
.
level
left
join
(
select
class_id
,
min
(
date
)
as
first_date
,
max
(
date
)
as
last_date
from
class_subject
group
by
class_id
)
schedule
on
schedule
.
class_id
=
c
.
id
left
join
(
select
class_id
,
count
(
*
)
as
actual_count
from
class_student
group
by
class_id
)
members
on
members
.
class_id
=
c
.
id
set
c
.
occupation
=
coalesce
(
nullif
(
trim
(
c
.
occupation
),
''
),
case
when
level_info
.
name
like
'污水%'
then
'污水'
when
level_info
.
name
like
'污泥%'
then
'污泥'
else
null
end
),
c
.
start_date
=
coalesce
(
c
.
start_date
,
schedule
.
first_date
),
c
.
end_date
=
coalesce
(
c
.
end_date
,
schedule
.
last_date
),
c
.
training_year
=
coalesce
(
c
.
training_year
,
year
(
schedule
.
first_date
),
year
(
c
.
create_time
)),
c
.
capacity
=
coalesce
(
c
.
capacity
,
case
when
members
.
actual_count
>
0
then
members
.
actual_count
else
null
end
);
-- 执行后可用以下查询定位仍需人工补齐的旧班级。查询只读,不会阻断迁移。
select
id
,
name
,
occupation
,
training_year
,
start_date
,
end_date
,
capacity
from
`class`
where
occupation
is
null
or
training_year
is
null
or
start_date
is
null
or
end_date
is
null
;
practical-business/src/test/java/com/platform/business/controller/ClassAdminControllerTest.java
0 → 100644
View file @
2fea7e12
package
com.platform.business.controller
;
import
com.platform.business.constant.ClassAdminConstants
;
import
com.platform.business.model.dto.ClassAdminQueryDTO
;
import
com.platform.business.model.entity.UserEntity
;
import
com.platform.business.model.vo.ClassAdminOptionsVO
;
import
com.platform.business.service.AuthenticatedUserService
;
import
com.platform.business.service.ClassAdminService
;
import
com.platform.exception.BusinessException
;
import
org.junit.jupiter.api.BeforeEach
;
import
org.junit.jupiter.api.Test
;
import
org.junit.jupiter.api.extension.ExtendWith
;
import
org.mockito.Mock
;
import
org.mockito.junit.jupiter.MockitoExtension
;
import
org.springframework.mock.web.MockHttpServletRequest
;
import
org.springframework.test.util.ReflectionTestUtils
;
import
static
org
.
junit
.
jupiter
.
api
.
Assertions
.
assertEquals
;
import
static
org
.
junit
.
jupiter
.
api
.
Assertions
.
assertThrows
;
import
static
org
.
mockito
.
Mockito
.
doThrow
;
import
static
org
.
mockito
.
Mockito
.
verify
;
import
static
org
.
mockito
.
Mockito
.
when
;
/** 班级管理控制器的分页边界和管理员鉴权测试。 */
@ExtendWith
(
MockitoExtension
.
class
)
class
ClassAdminControllerTest
{
@Mock
private
ClassAdminService
classAdminService
;
@Mock
private
AuthenticatedUserService
authenticatedUserService
;
private
ClassAdminController
controller
;
@BeforeEach
void
setUp
()
{
controller
=
new
ClassAdminController
();
ReflectionTestUtils
.
setField
(
controller
,
"classAdminService"
,
classAdminService
);
ReflectionTestUtils
.
setField
(
controller
,
"authenticatedUserService"
,
authenticatedUserService
);
}
@Test
void
normalizePageShouldApplyDefaultsAndMaximum
()
{
ClassAdminQueryDTO
defaults
=
new
ClassAdminQueryDTO
();
controller
.
normalizePage
(
defaults
);
assertEquals
(
ClassAdminConstants
.
DEFAULT_PAGE_NUM
,
defaults
.
getPageNum
());
assertEquals
(
ClassAdminConstants
.
DEFAULT_PAGE_SIZE
,
defaults
.
getPageSize
());
ClassAdminQueryDTO
oversized
=
new
ClassAdminQueryDTO
();
oversized
.
setPageNum
(
3
);
oversized
.
setPageSize
(
500
);
controller
.
normalizePage
(
oversized
);
assertEquals
(
3
,
oversized
.
getPageNum
());
assertEquals
(
ClassAdminConstants
.
MAX_PAGE_SIZE
,
oversized
.
getPageSize
());
}
@Test
void
optionsShouldResolveJwtAndRequireAdminBeforeCallingService
()
{
MockHttpServletRequest
request
=
new
MockHttpServletRequest
();
UserEntity
administrator
=
new
UserEntity
();
when
(
authenticatedUserService
.
current
(
request
)).
thenReturn
(
administrator
);
when
(
classAdminService
.
options
()).
thenReturn
(
new
ClassAdminOptionsVO
());
controller
.
options
(
request
);
verify
(
authenticatedUserService
).
requireAdmin
(
administrator
);
verify
(
classAdminService
).
options
();
}
@Test
void
optionsShouldStopWhenCurrentUserIsNotAdmin
()
{
MockHttpServletRequest
request
=
new
MockHttpServletRequest
();
UserEntity
student
=
new
UserEntity
();
when
(
authenticatedUserService
.
current
(
request
)).
thenReturn
(
student
);
doThrow
(
new
BusinessException
(
"只有管理员可以访问管理端接口"
))
.
when
(
authenticatedUserService
).
requireAdmin
(
student
);
assertThrows
(
BusinessException
.
class
,
()
->
controller
.
options
(
request
));
}
}
practical-business/src/test/java/com/platform/business/service/impl/ClassAdminServiceImplTest.java
0 → 100644
View file @
2fea7e12
package
com.platform.business.service.impl
;
import
com.platform.business.constant.ClassAdminConstants
;
import
com.platform.business.mapper.ClassMapper
;
import
com.platform.business.model.dto.ClassAdminSaveDTO
;
import
com.platform.business.model.entity.ClassEntity
;
import
com.platform.business.model.entity.SysLevelEntity
;
import
com.platform.business.model.entity.SysPhoneRoleEntity
;
import
com.platform.business.model.entity.UserEntity
;
import
com.platform.business.model.vo.ClassAdminCourseVO
;
import
com.platform.business.model.vo.ClassAdminDetailVO
;
import
com.platform.business.model.vo.ClassAdminExamVO
;
import
com.platform.business.model.vo.ClassAdminStudentVO
;
import
com.platform.business.service.SysLevelService
;
import
com.platform.business.service.SysPhoneRoleService
;
import
com.platform.business.service.UserService
;
import
com.platform.exception.BusinessException
;
import
org.junit.jupiter.api.Test
;
import
org.junit.jupiter.api.extension.ExtendWith
;
import
org.junit.jupiter.params.ParameterizedTest
;
import
org.junit.jupiter.params.provider.CsvSource
;
import
org.mockito.ArgumentCaptor
;
import
org.mockito.InjectMocks
;
import
org.mockito.Mock
;
import
org.mockito.junit.jupiter.MockitoExtension
;
import
java.math.BigDecimal
;
import
java.sql.Date
;
import
java.time.LocalDate
;
import
java.util.Collections
;
import
static
org
.
junit
.
jupiter
.
api
.
Assertions
.
assertEquals
;
import
static
org
.
junit
.
jupiter
.
api
.
Assertions
.
assertNull
;
import
static
org
.
junit
.
jupiter
.
api
.
Assertions
.
assertThrows
;
import
static
org
.
mockito
.
ArgumentMatchers
.
any
;
import
static
org
.
mockito
.
ArgumentMatchers
.
eq
;
import
static
org
.
mockito
.
Mockito
.
never
;
import
static
org
.
mockito
.
Mockito
.
verify
;
import
static
org
.
mockito
.
Mockito
.
when
;
/** 管理员端班级管理核心校验、状态和详情聚合测试。 */
@ExtendWith
(
MockitoExtension
.
class
)
class
ClassAdminServiceImplTest
{
@Mock
private
ClassMapper
classMapper
;
@Mock
private
SysLevelService
sysLevelService
;
@Mock
private
UserService
userService
;
@Mock
private
SysPhoneRoleService
phoneRoleService
;
@InjectMocks
private
ClassAdminServiceImpl
service
;
@Test
void
createShouldNormalizeAndPersistEditableFields
()
{
mockValidLevel
();
when
(
classMapper
.
countAdminDuplicateName
(
2026
,
"污水处理一级三班"
,
null
)).
thenReturn
(
0
);
when
(
classMapper
.
insert
(
any
(
ClassEntity
.
class
))).
thenAnswer
(
invocation
->
{
ClassEntity
entity
=
invocation
.
getArgument
(
0
);
entity
.
setId
(
10
);
return
1
;
});
mockEmptyDetail
(
10
,
Date
.
valueOf
(
"2026-09-01"
),
Date
.
valueOf
(
"2027-01-31"
));
ClassAdminSaveDTO
request
=
validRequest
();
request
.
setName
(
" 污水处理一级三班 "
);
request
.
setLocation
(
" A栋301 "
);
ClassAdminDetailVO
result
=
service
.
create
(
request
);
ArgumentCaptor
<
ClassEntity
>
captor
=
ArgumentCaptor
.
forClass
(
ClassEntity
.
class
);
verify
(
classMapper
).
insert
(
captor
.
capture
());
assertEquals
(
"污水处理一级三班"
,
captor
.
getValue
().
getName
());
assertEquals
(
"A栋301"
,
captor
.
getValue
().
getLocation
());
assertEquals
(
"1"
,
captor
.
getValue
().
getLevel
());
assertEquals
(
10
,
result
.
getId
());
}
@Test
void
createShouldRejectInvalidDateRangeAndDuplicateName
()
{
mockValidLevel
();
ClassAdminSaveDTO
invalidDates
=
validRequest
();
invalidDates
.
setStartDate
(
Date
.
valueOf
(
"2026-10-01"
));
invalidDates
.
setEndDate
(
Date
.
valueOf
(
"2026-09-01"
));
assertThrows
(
BusinessException
.
class
,
()
->
service
.
create
(
invalidDates
));
verify
(
classMapper
,
never
()).
insert
(
any
());
ClassAdminSaveDTO
duplicate
=
validRequest
();
when
(
classMapper
.
countAdminDuplicateName
(
2026
,
duplicate
.
getName
(),
null
)).
thenReturn
(
1
);
assertThrows
(
BusinessException
.
class
,
()
->
service
.
create
(
duplicate
));
}
@Test
void
createShouldRejectHiddenOrMismatchedLevel
()
{
SysLevelEntity
hidden
=
level
(
"污水一级"
);
hidden
.
setHiddeFlag
(
true
);
when
(
sysLevelService
.
getById
(
1
)).
thenReturn
(
hidden
);
assertThrows
(
BusinessException
.
class
,
()
->
service
.
create
(
validRequest
()));
SysLevelEntity
sludge
=
level
(
"污泥一级"
);
when
(
sysLevelService
.
getById
(
1
)).
thenReturn
(
sludge
);
assertThrows
(
BusinessException
.
class
,
()
->
service
.
create
(
validRequest
()));
verify
(
classMapper
,
never
()).
insert
(
any
());
}
@Test
void
createShouldRejectHeadTeacherWithoutTeacherRole
()
{
mockValidLevel
();
ClassAdminSaveDTO
request
=
validRequest
();
request
.
setHeadTeacherId
(
"user-1"
);
UserEntity
user
=
new
UserEntity
();
user
.
setId
(
"user-1"
);
user
.
setPhoneNumber
(
"13800000000"
);
when
(
userService
.
getById
(
"user-1"
)).
thenReturn
(
user
);
SysPhoneRoleEntity
adminRole
=
new
SysPhoneRoleEntity
();
adminRole
.
setRoleName
(
"管理员"
);
when
(
phoneRoleService
.
queryByPhone
(
"13800000000"
))
.
thenReturn
(
Collections
.
singletonList
(
adminRole
));
assertThrows
(
BusinessException
.
class
,
()
->
service
.
create
(
request
));
verify
(
classMapper
,
never
()).
insert
(
any
());
}
@Test
void
updateShouldRejectCapacityBelowActualStudents
()
{
when
(
classMapper
.
selectById
(
7
)).
thenReturn
(
new
ClassEntity
());
when
(
classMapper
.
countAdminStudents
(
7
)).
thenReturn
(
35
);
mockValidLevel
();
ClassAdminSaveDTO
request
=
validRequest
();
request
.
setCapacity
(
34
);
assertThrows
(
BusinessException
.
class
,
()
->
service
.
update
(
7
,
request
));
verify
(
classMapper
,
never
()).
updateAdminClass
(
any
());
}
@Test
void
updateShouldExplicitlyClearOptionalFields
()
{
when
(
classMapper
.
selectById
(
7
)).
thenReturn
(
new
ClassEntity
());
when
(
classMapper
.
countAdminStudents
(
7
)).
thenReturn
(
10
);
mockValidLevel
();
when
(
classMapper
.
countAdminDuplicateName
(
2026
,
"污水处理一级三班"
,
7
)).
thenReturn
(
0
);
when
(
classMapper
.
updateAdminClass
(
any
(
ClassEntity
.
class
))).
thenReturn
(
1
);
mockEmptyDetail
(
7
,
Date
.
valueOf
(
"2026-09-01"
),
Date
.
valueOf
(
"2027-01-31"
));
ClassAdminSaveDTO
request
=
validRequest
();
request
.
setHeadTeacherId
(
" "
);
request
.
setLocation
(
" "
);
request
.
setCapacity
(
null
);
request
.
setRemark
(
" "
);
service
.
update
(
7
,
request
);
ArgumentCaptor
<
ClassEntity
>
captor
=
ArgumentCaptor
.
forClass
(
ClassEntity
.
class
);
verify
(
classMapper
).
updateAdminClass
(
captor
.
capture
());
assertNull
(
captor
.
getValue
().
getHeadTeacherId
());
assertNull
(
captor
.
getValue
().
getLocation
());
assertNull
(
captor
.
getValue
().
getCapacity
());
assertNull
(
captor
.
getValue
().
getRemark
());
}
@Test
void
detailShouldUseLatestPublishedExamAndRealAggregates
()
{
ClassAdminDetailVO
detail
=
baseDetail
(
8
,
Date
.
valueOf
(
LocalDate
.
now
(
ClassAdminConstants
.
BUSINESS_ZONE
).
minusDays
(
1
)),
Date
.
valueOf
(
LocalDate
.
now
(
ClassAdminConstants
.
BUSINESS_ZONE
).
plusDays
(
1
)));
detail
.
setAttendanceRate
(
new
BigDecimal
(
"82.50"
));
when
(
classMapper
.
selectAdminDetail
(
8
)).
thenReturn
(
detail
);
ClassAdminCourseVO
course
=
new
ClassAdminCourseVO
();
course
.
setFirstDate
(
detail
.
getStartDate
());
course
.
setLastDate
(
detail
.
getEndDate
());
when
(
classMapper
.
selectAdminCourses
(
8
)).
thenReturn
(
Collections
.
singletonList
(
course
));
ClassAdminExamVO
exam
=
new
ClassAdminExamVO
();
exam
.
setExamId
(
99
);
exam
.
setExamName
(
"结业考试"
);
exam
.
setPassRate
(
new
BigDecimal
(
"50.00"
));
when
(
classMapper
.
selectLatestPublishedExam
(
8
)).
thenReturn
(
exam
);
ClassAdminStudentVO
student
=
new
ClassAdminStudentVO
();
student
.
setExamScore
(
60
D
);
when
(
classMapper
.
selectAdminStudents
(
8
,
99
))
.
thenReturn
(
Collections
.
singletonList
(
student
));
ClassAdminDetailVO
result
=
service
.
detail
(
8
);
assertEquals
(
"ONGOING"
,
result
.
getStatus
());
assertEquals
(
1
,
result
.
getCourseCount
());
assertEquals
(
new
BigDecimal
(
"82.50"
),
result
.
getAttendanceRate
());
assertEquals
(
new
BigDecimal
(
"50.00"
),
result
.
getPassRate
());
assertEquals
(
99
,
result
.
getLatestExamId
());
assertEquals
(
"ACTIVE"
,
result
.
getStudents
().
get
(
0
).
getLearningStatus
());
verify
(
classMapper
).
selectAdminStudents
(
8
,
99
);
}
@Test
void
detailShouldKeepRatesNullWhenNoAttendanceOrPublishedExamExists
()
{
mockEmptyDetail
(
9
,
null
,
null
);
ClassAdminDetailVO
result
=
service
.
detail
(
9
);
assertEquals
(
"UNKNOWN"
,
result
.
getStatus
());
assertNull
(
result
.
getAttendanceRate
());
assertNull
(
result
.
getPassRate
());
assertNull
(
result
.
getLatestExamId
());
verify
(
classMapper
).
selectAdminStudents
(
9
,
null
);
}
@ParameterizedTest
@CsvSource
({
"2026-08-18,2026-08-19,2026-08-20,UPCOMING"
,
"2026-08-18,2026-08-18,2026-08-20,ONGOING"
,
"2026-08-20,2026-08-18,2026-08-20,ONGOING"
,
"2026-08-21,2026-08-18,2026-08-20,ENDED"
})
void
resolveClassStatusShouldCoverDateBoundaries
(
String
today
,
String
start
,
String
end
,
String
expected
)
{
assertEquals
(
expected
,
ClassAdminServiceImpl
.
resolveClassStatus
(
Date
.
valueOf
(
start
),
Date
.
valueOf
(
end
),
LocalDate
.
parse
(
today
)));
}
@Test
void
resolveClassStatusShouldReturnUnknownWhenLegacyDatesAreMissing
()
{
assertEquals
(
"UNKNOWN"
,
ClassAdminServiceImpl
.
resolveClassStatus
(
null
,
Date
.
valueOf
(
"2026-08-20"
),
LocalDate
.
parse
(
"2026-08-18"
)));
}
private
void
mockValidLevel
()
{
when
(
sysLevelService
.
getById
(
1
)).
thenReturn
(
level
(
"污水一级"
));
}
private
SysLevelEntity
level
(
String
name
)
{
SysLevelEntity
level
=
new
SysLevelEntity
();
level
.
setId
(
1
);
level
.
setName
(
name
);
level
.
setHiddeFlag
(
false
);
return
level
;
}
private
ClassAdminSaveDTO
validRequest
()
{
ClassAdminSaveDTO
request
=
new
ClassAdminSaveDTO
();
request
.
setName
(
"污水处理一级三班"
);
request
.
setOccupation
(
"污水"
);
request
.
setTrainingYear
(
2026
);
request
.
setLevelId
(
1
);
request
.
setStartDate
(
Date
.
valueOf
(
"2026-09-01"
));
request
.
setEndDate
(
Date
.
valueOf
(
"2027-01-31"
));
request
.
setCapacity
(
35
);
return
request
;
}
private
void
mockEmptyDetail
(
Integer
id
,
java
.
util
.
Date
start
,
java
.
util
.
Date
end
)
{
when
(
classMapper
.
selectAdminDetail
(
id
)).
thenReturn
(
baseDetail
(
id
,
start
,
end
));
when
(
classMapper
.
selectAdminCourses
(
id
)).
thenReturn
(
Collections
.
emptyList
());
when
(
classMapper
.
selectAdminStudents
(
eq
(
id
),
any
())).
thenReturn
(
Collections
.
emptyList
());
}
private
ClassAdminDetailVO
baseDetail
(
Integer
id
,
java
.
util
.
Date
start
,
java
.
util
.
Date
end
)
{
ClassAdminDetailVO
detail
=
new
ClassAdminDetailVO
();
detail
.
setId
(
id
);
detail
.
setName
(
"测试班级"
);
detail
.
setStartDate
(
start
);
detail
.
setEndDate
(
end
);
return
detail
;
}
}
Prev
1
2
Next
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
.
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment