feat(账号到期+公司超管): 级联过期判定、过期停任务巡检与两端续费提醒弹窗
需求两条:站点超管可开设其他公司的超级管理员(站点超管看全站、公司超管只看本公司、 组内管理员仍只看本组);账号要有过期时间,管理员过期后名下普通账户一并停用、 正在跑的任务也要停掉。落库只有 users.expires_at(V146,NULL=永不过期),级联一律现算, 不写"上级过期就把下级置成过期"那种续费也救不回来的数据。 - AccountExpiryService:生效到期 = min(自身, 本公司公司超管, 成员表组长, 创建人)。 登录拦 403(文案给续费提示)、每次请求鉴权拦 401(前端按下线踢回登录页),super_admin 永不适用。级联口径与数据可见范围同源(成员表基本未用、实际按 created_by_id 派生)。 - ExpiredAccountTaskStopService:每分钟把过期账号(含级联成员)名下 biz_file_task PENDING/SCHEDULED/RUNNING → FAILED,含未领取的 PENDING(防内部通道继续派发)。原因文案 刻意不以「客户端异常中断」开头,否则会被 TaskResumeService 自动复活。品牌采集与跟价循环 不在那张表上,经 ExpiredAccountTaskStopSpi 由各自模块停:品牌 pending/running→cancelled 且 UPDATE 的 WHERE 二次核对状态(抢到行后被客户端推进成完成的行不得误杀),跟价循环只置 stop_requested=1、沿用用户点「停止循环」那条收尾路径,绝不动 status。任务心跳接口保持匿名 不走 requireUser,所以过期账号的客户端仍能拿到 alive=false 协作停止。 - 角色 company_super_admin:由站点超管开设(唯一要显式选公司的建号场景),建号/授菜单/改用户/ 看数据四条链路都按"本公司"收口;公司超管之间、以及公司超管与站点超管互相碰不得。 - 续费提醒:剩余 <5 天在数富后台与用户端弹窗,只能收起不能关闭(无关闭按钮,收起态是右下角 浮标),续费到 ≥5 天自动消失。后台读 /api/admin/current-user 的 expiresAt/daysToExpire; 用户端无 Pinia,走 localStorage 的 account_expires_at(登录/check_login 落键、被顶下线清键, 换账号不残留)。只反映账号自身到期,弹窗不做任何级联推断。 - V146 撞掉了 V145 那批的一条护栏:它按"db/ 里不许出现 V146__ 前缀"编死号位,被一条正常的 前向迁移占用就红。改成钉动作——剥注释后的可执行 SQL 不得写 flyway_schema_history(回滚 一律是扫描路径外的人工补丁),并把盘点文档改 V146 时丢掉的 V145 文件名补回去。 验证(本会话亲跑,不是转述):后端定向 14 类 123/0(同一轮 mvn 里连批次③的 4 类 53 例、以及既有 ShopDataCrawl/SimilarAsin 两条回归对照 21 例一起跑,合计 197 例 0 红);admin-frontend-vue 本批定向 44/0(弹窗 7 + 公司建号/列表/入口/日期默认 21 + 角色 task-48/task-251 16),全量 1726 例里那 1 支红是另一条 会话刻意留的「公司 tab 接线缺口」尺子(点名 admin_task_center 等 6 页,与本批无关); frontend-vue 弹窗 9/0、全量 710/0。变异自证两批共 34 点:弹窗语义 16 点全杀(阈值 5、只能收起 不能关闭、挂载点含"注释掉挂载"、落键/清键链路),本批 SPI+迁移护栏 17 点全杀(含 G2 反向: 前向迁移只在注释里提 flyway_schema_history 必须照样绿),注入文件还原 dirty=0、探针残留 0。
This commit is contained in:
+150
@@ -0,0 +1,150 @@
|
||||
package com.nanri.aiimage.modules.task.service;
|
||||
|
||||
import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
|
||||
import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
|
||||
import com.nanri.aiimage.common.mapper.AdminUserMapper;
|
||||
import com.nanri.aiimage.common.mapper.ShopManageGroupMapper;
|
||||
import com.nanri.aiimage.common.model.entity.AdminUserEntity;
|
||||
import com.nanri.aiimage.common.service.CompanyScopeSupport;
|
||||
import com.nanri.aiimage.common.service.DistributedJobLockService;
|
||||
import com.nanri.aiimage.modules.task.mapper.FileTaskMapper;
|
||||
import com.nanri.aiimage.modules.task.model.entity.FileTaskEntity;
|
||||
import com.nanri.aiimage.modules.task.spi.ExpiredAccountTaskStopSpi;
|
||||
import lombok.RequiredArgsConstructor;
|
||||
import lombok.extern.slf4j.Slf4j;
|
||||
import org.springframework.scheduling.annotation.Scheduled;
|
||||
import org.springframework.stereotype.Service;
|
||||
|
||||
import java.time.Duration;
|
||||
import java.time.LocalDateTime;
|
||||
import java.util.LinkedHashSet;
|
||||
import java.util.List;
|
||||
import java.util.Set;
|
||||
|
||||
/**
|
||||
* 账号过期停任务巡检(V146,2026-10-05)。
|
||||
*
|
||||
* <p>到期那一刻起,登录与全部鉴权请求已被 {@code AccountExpiryService} 拦下;但客户端
|
||||
* <b>已经在跑的任务</b>不会自己停——客户端唯一的"服务端发令"停止通道是心跳返回 alive=false,
|
||||
* 而它只看任务状态。本巡检每分钟把过期账号(含级联成员)名下的活跃任务置终态:
|
||||
* biz_file_task PENDING/SCHEDULED/RUNNING → FAILED(含未领取的 PENDING,防内部通道继续派发);
|
||||
* 品牌/跟价循环经 {@link ExpiredAccountTaskStopSpi} 由各业务模块自行停止。</p>
|
||||
*
|
||||
* <p>级联口径与登录侧 {@code AccountExpiryService} 严格一致:管理员过期 → 名下子账户
|
||||
* (created_by_id)+ 所带分组的成员表成员;公司超管过期 → 全公司成员。置终态原因固定为
|
||||
* {@link #STOP_REASON}(刻意不以「客户端异常中断」开头,绝不触发 TaskResumeService 自动续跑)。
|
||||
* 续费后任务不会复活,需要用户重新发起。</p>
|
||||
*/
|
||||
@Slf4j
|
||||
@Service
|
||||
@RequiredArgsConstructor
|
||||
public class ExpiredAccountTaskStopService {
|
||||
|
||||
/** ASCII 标记,供 _prod_watch.py 按 docker logs grep(中文在容器里可能变编码,签名必须 ASCII)。 */
|
||||
static final String MARKER = "EXPIRED_ACCOUNT_TASKS_STOPPED";
|
||||
/** 刻意避开 TaskResumeService 的「客户端异常中断」前缀,过期停止的任务不许被自动复活。 */
|
||||
public static final String STOP_REASON = "账号已过期,任务已自动停止";
|
||||
|
||||
private static final String STATUS_PENDING = "PENDING";
|
||||
private static final String STATUS_SCHEDULED = "SCHEDULED";
|
||||
private static final String STATUS_RUNNING = "RUNNING";
|
||||
private static final String STATUS_FAILED = "FAILED";
|
||||
private static final int BATCH_LIMIT = 500;
|
||||
|
||||
private final AdminUserMapper adminUserMapper;
|
||||
private final ShopManageGroupMapper shopManageGroupMapper;
|
||||
private final CompanyScopeSupport companyScopeSupport;
|
||||
private final FileTaskMapper fileTaskMapper;
|
||||
private final DistributedJobLockService distributedJobLockService;
|
||||
private final List<ExpiredAccountTaskStopSpi> moduleStops;
|
||||
|
||||
@Scheduled(fixedDelay = 60 * 1000, initialDelay = 45 * 1000)
|
||||
public void stopTasksOfExpiredAccounts() {
|
||||
var lock = distributedJobLockService.tryLock("expired-account-task-stop", Duration.ofSeconds(55));
|
||||
if (lock == null) {
|
||||
return;
|
||||
}
|
||||
try (lock) {
|
||||
runOnce();
|
||||
} catch (Exception ex) {
|
||||
log.warn("[expired-account-stop] 巡检失败 msg={}", ex.getMessage(), ex);
|
||||
}
|
||||
}
|
||||
|
||||
void runOnce() {
|
||||
LocalDateTime now = LocalDateTime.now();
|
||||
List<AdminUserEntity> boundary = adminUserMapper.selectList(new LambdaQueryWrapper<AdminUserEntity>()
|
||||
.select(AdminUserEntity::getId, AdminUserEntity::getRole,
|
||||
AdminUserEntity::getCompanyId, AdminUserEntity::getCreatedById)
|
||||
.isNotNull(AdminUserEntity::getExpiresAt)
|
||||
.le(AdminUserEntity::getExpiresAt, now)
|
||||
.ne(AdminUserEntity::getRole, "super_admin"));
|
||||
if (boundary.isEmpty()) {
|
||||
return;
|
||||
}
|
||||
Set<Long> affected = resolveAffectedUserIds(boundary);
|
||||
if (affected.isEmpty()) {
|
||||
return;
|
||||
}
|
||||
int fileTaskCount = stopFileTasks(affected, now);
|
||||
int moduleCount = 0;
|
||||
for (ExpiredAccountTaskStopSpi spi : moduleStops) {
|
||||
moduleCount += spi.stopActiveTasks(affected, STOP_REASON);
|
||||
}
|
||||
if (fileTaskCount > 0 || moduleCount > 0) {
|
||||
log.warn("{} 账号过期已停止任务 expiredUsers={} fileTasks={} moduleStops={}",
|
||||
MARKER, affected.size(), fileTaskCount, moduleCount);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 过期账号 → 需要连带停任务的成员集合。与登录侧级联判定同口径:
|
||||
* 公司超管过期圈全公司;管理员过期圈名下子账户 + 所带分组的成员表成员;普通用户只有自己。
|
||||
*/
|
||||
private Set<Long> resolveAffectedUserIds(List<AdminUserEntity> boundary) {
|
||||
LinkedHashSet<Long> affected = new LinkedHashSet<>();
|
||||
for (AdminUserEntity account : boundary) {
|
||||
if (account.getId() == null) {
|
||||
continue;
|
||||
}
|
||||
affected.add(account.getId());
|
||||
String role = account.getRole() == null ? "" : account.getRole();
|
||||
if ("company_super_admin".equals(role)) {
|
||||
if (account.getCompanyId() != null && account.getCompanyId() > 0) {
|
||||
affected.addAll(companyScopeSupport.memberUserIds(account.getCompanyId()));
|
||||
}
|
||||
} else if ("admin".equals(role) || role.isEmpty()) {
|
||||
// 名下子账户(组员归属的主链路:按创建人派生)
|
||||
adminUserMapper.selectList(new LambdaQueryWrapper<AdminUserEntity>()
|
||||
.select(AdminUserEntity::getId)
|
||||
.eq(AdminUserEntity::getCreatedById, account.getId()))
|
||||
.forEach(member -> {
|
||||
if (member.getId() != null) {
|
||||
affected.add(member.getId());
|
||||
}
|
||||
});
|
||||
// 成员表直挂的成员(手工绑进分组、创建人不是该管理员的兜底)
|
||||
affected.addAll(shopManageGroupMapper.selectManagedMemberUserIds(account.getId()));
|
||||
}
|
||||
}
|
||||
return affected;
|
||||
}
|
||||
|
||||
/** biz_file_task:PENDING/SCHEDULED/RUNNING → FAILED。先查 id 再条件更新,照 StaleTaskRepairService 的写法。 */
|
||||
private int stopFileTasks(Set<Long> userIds, LocalDateTime now) {
|
||||
List<FileTaskEntity> active = fileTaskMapper.selectList(new LambdaQueryWrapper<FileTaskEntity>()
|
||||
.select(FileTaskEntity::getId)
|
||||
.in(FileTaskEntity::getUserId, userIds)
|
||||
.in(FileTaskEntity::getStatus, STATUS_PENDING, STATUS_SCHEDULED, STATUS_RUNNING)
|
||||
.last("limit " + BATCH_LIMIT));
|
||||
if (active.isEmpty()) {
|
||||
return 0;
|
||||
}
|
||||
return fileTaskMapper.update(null, new LambdaUpdateWrapper<FileTaskEntity>()
|
||||
.in(FileTaskEntity::getId, active.stream().map(FileTaskEntity::getId).toList())
|
||||
.in(FileTaskEntity::getStatus, STATUS_PENDING, STATUS_SCHEDULED, STATUS_RUNNING)
|
||||
.set(FileTaskEntity::getStatus, STATUS_FAILED)
|
||||
.set(FileTaskEntity::getErrorMessage, STOP_REASON)
|
||||
.set(FileTaskEntity::getFinishedAt, now));
|
||||
}
|
||||
}
|
||||
+25
@@ -0,0 +1,25 @@
|
||||
package com.nanri.aiimage.modules.task.spi;
|
||||
|
||||
import java.util.Collection;
|
||||
|
||||
/**
|
||||
* 账号过期时停止「独立于 biz_file_task 的任务载体」(2026-10-05,G5 同款:task 模块不 import 业务模块)。
|
||||
*
|
||||
* <p>{@code ExpiredAccountTaskStopService} 每分钟把过期账号(含级联)名下的 biz_file_task
|
||||
* 置终态;品牌任务(brand_crawl_tasks)与跟价循环(biz_price_track_loop_run)不在那张表里,
|
||||
* 由各业务模块实现本 SPI 自行停止——谁的数据谁停,task 侧只发令。</p>
|
||||
*/
|
||||
public interface ExpiredAccountTaskStopSpi {
|
||||
|
||||
/** 实现负责的模块标识(日志归因用)。 */
|
||||
String moduleType();
|
||||
|
||||
/**
|
||||
* 把属于这些用户的活跃任务停止。要求幂等:非活跃状态的行一律不动。
|
||||
*
|
||||
* @param userIds 过期账号及其级联成员(登录侧会全部拦截,这里只负责在跑的任务)
|
||||
* @param reason 写进 errorMessage 的统一文案(勿以「客户端异常中断」开头,避免被自动续跑复活)
|
||||
* @return 实际发生变更的行数(0 = 本轮无事发生,调用方据此决定是否打日志)
|
||||
*/
|
||||
int stopActiveTasks(Collection<Long> userIds, String reason);
|
||||
}
|
||||
Reference in New Issue
Block a user