fix(admin): getTeams「已激活」口径修正为「至少一名成员激活」

R90续三:需求方确认该筛选的设计目的是「确认小组是否已有人激活可以参赛」,
故 partial(部分激活)应归入已激活侧查看,旧口径「全员激活」与之不符。

- 行字段 activated:activatedCount === memberCount → activatedCount > 0
- 新增 allActivated 字段保留严格「全员激活」语义(不丢信息)
- summary 新增筛选后三态分布 filteredActivated / filteredPartial / filteredInactive
- 筛选逻辑零改动:语义收敛在行字段 activated 上,筛选仍按该字段判定
- 同步修正方法头 JSDoc 与筛选/summary 段注释

预期副作用:选中「已有成员激活」时 filteredMemberActivated 恒等于全集
memberActivated(inactive 组贡献 0)⇒ 原先「选手列表激活 4 人 / 小组视图 3 人」
的差额(= partial 组内已激活成员)不再出现。

生产已部署并复验:线上 33 项断言 ALL_PASS,activated=true 由 2 组变为 3 组
(2 全员 + 1 部分)、成员激活 3 → 4;服务器侧 MySQL 只读交叉复核一致。
This commit is contained in:
2026-10-09 15:53:20 +08:00
parent 26a29b2214
commit 29ce734ffa

View File

@@ -260,9 +260,11 @@ class AdminService extends Service {
* 同一选手若两处都有归属,**只计一次**(以 aggregation 为准,避免重复计数)。
* - **学校名称**取自 `aggregation.organization_cn`。同一小组理论上同校;
* 若出现多校(异常数据),并列展示并置 `schoolConflict=true` 供排查,**不静默取一个**。
* - **激活判据**:`activated` = 组内**全部**成员 `contestants.activated=1`。
* 三个细分状态:`activated`(全激活)/ `partial`(部分激活)/ `inactive`(全未激活)。
* ⚠️ `partial` 在「已激活/未激活」二选一筛选里归入**未激活**(因为尚未全员可登录)。
* - **三态判定**(字段 `status`):`activated`(全员激活)/ `partial`(部分激活)/ `inactive`(全未激活)。
* - **🔴「已激活」语义(R90 续三修正)**:行字段 `activated` = 组内**至少 1 名**成员已激活
* —— 设计目的即为「确认该小组是否已有人激活、**可以参赛**」,故 `partial` 归入**已激活**侧,
* 仅 `inactive` 归入**未激活**侧(旧口径「全员激活」与产品语义不符,已修正)。
* 严格「全员激活」语义另存于 `allActivated`;前端表格按 `status` 渲染三态标签,显示不受影响。
* - **测试数据口径**:默认 `includeTest=false` ⇒ 只统计 `test_flag=0` 的成员;
* 某小组若成员全为测试数据,则该小组整体不出现(这正是「生产口径」想要的)。
*
@@ -270,6 +272,7 @@ class AdminService extends Service {
* @returns {Promise<Object>} { list, summary, filteredTotal, filters }
* summary 为**筛选前全集**口径,含 total/activated/partial/inactive/memberTotal/memberActivated
* 以及 R90 增补的 memberActivatedInPartial / filteredTotal / filteredMemberTotal / filteredMemberActivated
* 与 R90 续三增补的 filteredActivated / filteredPartial / filteredInactive(筛选后三态分布)
*/
async getTeams(options = {}) {
const { ctx } = this;
@@ -366,7 +369,12 @@ class AdminService extends Service {
schoolConflict: b.schools.size > 1,
memberCount,
activatedCount,
activated: memberCount > 0 && activatedCount === memberCount,
// 🔴 R90 续三:「已激活」= 组内**至少 1 名**成员已激活(= 可以参赛),partial 归入已激活侧。
// 旧口径「全员激活」与产品语义(确认小组是否已有人激活可参赛)不符,已修正。
// 筛选逻辑随之无需改动(下方 list 过滤仍按本字段判定)。
activated: memberCount > 0 && activatedCount > 0,
// 严格「全员激活」语义(前端表格按 status 渲染三态标签,本项供需严格判定的场景)
allActivated: memberCount > 0 && activatedCount === memberCount,
status,
});
}
@@ -390,6 +398,8 @@ class AdminService extends Service {
});
// 筛选(与 getAccounts 的 activated 归一化同理:前端 el-select 传字符串)
// 🔴 R90 续三口径:activated=true ⇒「至少 1 名成员已激活」= activated 组 + partial 组(可参赛);
// activated=false ⇒ 仅 inactive 组(无任何成员激活)。判据统一挂在行字段 activated 上。
let list = all;
if ([true, 1, '1', 'true'].includes(activated)) {
list = all.filter(t => t.activated === true);
@@ -399,9 +409,12 @@ class AdminService extends Service {
// R90:给前端「双口径」汇总用(人工测试反馈:筛选后小组数 3 与成员激活数 4 看似矛盾)。
// 既有 6 个字段语义一律不变(仍为**筛选前全集**口径),仅新增下列字段:
// · memberActivatedInPartial —— 「部分激活」组内已激活的成员数(∅=恒为全集口径)。
// 它是「成员激活总数 − 筛选出的已激活组成员数」差额的来源,正是消除歧义的关键量。
// · memberActivatedInPartial —— 「部分激活」组内已激活的成员数(恒为全集口径)。
// · filteredTotal / filteredMemberTotal / filteredMemberActivated —— **当前筛选后**口径。
// R90 续三:口径修正为「activated = 至少 1 名成员激活」后,选中「已激活」时 partial 组一并纳入
// ⇒ filteredMemberActivated 恒等于全集 memberActivated(inactive 组贡献 0),
// 「选手列表激活人数」与「已激活小组成员数」不再有差额。
// 另补 filteredActivated / filteredPartial / filteredInactive,供前端展示筛选后三态分布。
const allSummary = summarize(all);
const filteredSummary = summarize(list);
@@ -415,6 +428,10 @@ class AdminService extends Service {
filteredTotal: filteredSummary.total,
filteredMemberTotal: filteredSummary.memberTotal,
filteredMemberActivated: filteredSummary.memberActivated,
// R90 续三:筛选后三态分布(选中「已激活」时 = 全员激活 + 部分激活)
filteredActivated: filteredSummary.activated,
filteredPartial: filteredSummary.partial,
filteredInactive: filteredSummary.inactive,
},
// summary 作用于**筛选前**的全集(给总览用);filteredTotal 说明筛选后条数
filteredTotal: list.length,