feat: 社团统一改为协会

This commit is contained in:
2026-11-11 18:21:26 +08:00
parent 651435d568
commit 902ad7e0e9
233 changed files with 920 additions and 920 deletions
@@ -29,13 +29,13 @@ public enum BpmProcessConstant {
MEMBER_BRANCH_UNION_CHANGE("会员分工会变更"),
CLUB_JOIN("社团入会申请"),
CLUB_JOIN("协会入会申请"),
CLUB_EXAMINE("社团考核"),
CLUB_EXAMINE("协会考核"),
CLUB_EVALUATE("社团评优"),
CLUB_EVALUATE("协会评优"),
CLUB_REGISTER("社团注册"),
CLUB_REGISTER("协会注册"),
PERSON_EVALUATE("评优评先申请"),
@@ -26,11 +26,11 @@ RoleConstant {
SCHOOL_UNION_WC_ADMIN("校工会工代会管理员"),
SCHOOL_UNION_DC_ADMIN("校工会民主管理员"),
SCHOOL_UNION_PROPOSAL_ADMIN("校工会提案管理员"),
SCHOOL_UNION_CLUB_ADMIN("校工会社团管理员"),
SCHOOL_UNION_CLUB_ADMIN("校工会协会管理员"),
SCHOOL_UNION_ACTIVITY_ADMIN("校工会活动管理员"),
/** 品牌活动统计、人员调整管理员,数据范围按 trainSignUp 子活动负责人关系控制。 */
SCHOOL_UNION_TRAIN_SIGN_UP_ADMIN("校工会品牌活动管理员"),
SCHOOL_UNION_ARTICLE_CLUB_ADMIN("校工会社团新闻审批管理员"),
SCHOOL_UNION_ARTICLE_CLUB_ADMIN("校工会协会新闻审批管理员"),
SCHOOL_UNION_ARTICLE_FGH_ADMIN("校工会分工会新闻审批管理员"),
SCHOOL_UNION_ARTICLE_ADMIN("校工会新闻审批管理员"),
SCHOOL_OUTLAY_ADMIN("校工会经费管理员"),
@@ -86,16 +86,16 @@ RoleConstant {
SCHOOL_HOSPITAL_LEADER("校医院负责人"),
/*社团模块*/
CLUB_MEMBER("社团会员"),
CLUB_MANAGER("社团负责人"),
CLUB_PRESIDENT("社团会长"),
CLUB_VICE_PRESIDENT("社团副会长"),
CLUB_SECRETARY("社团秘书长"),
CLUB_VICE_SECRETARY("社团副秘书长"),
// SCHOOL_UNION_CLUB_ADMIN("校工会社团管理员"),
CLUB_AUDIT_LEADER("社团分管领导"),
CLUB_OPERATOR("社团操作员"),
/*协会模块*/
CLUB_MEMBER("协会会员"),
CLUB_MANAGER("协会负责人"),
CLUB_PRESIDENT("协会会长"),
CLUB_VICE_PRESIDENT("协会副会长"),
CLUB_SECRETARY("协会秘书长"),
CLUB_VICE_SECRETARY("协会副秘书长"),
// SCHOOL_UNION_CLUB_ADMIN("校工会协会管理员"),
CLUB_AUDIT_LEADER("协会分管领导"),
CLUB_OPERATOR("协会操作员"),
/*大病基金会员*/
AID_FUND_MEMBER("大病基金会员"),
@@ -111,7 +111,7 @@ RoleConstant {
LEGAL_DOCTOR("法律顾问"),
UNION_REIMBURSEMENT_MANAGER("分工会报销负责人"),
CLUB_REIMBURSEMENT_MANAGER("社团报销负责人"),
CLUB_REIMBURSEMENT_MANAGER("协会报销负责人"),
SCHOOL_REIMBURSEMENT_MANAGER("校工会报销负责人"),
;
@@ -22,7 +22,7 @@ import org.nutz.lang.util.NutMap;
import java.util.List;
/**
* 获取社团审批人根据流程变量参数(clubId) 必传
* 获取协会审批人根据流程变量参数(clubId) 必传
*/
public class FlowClubPresidentByArgsAssignmentHandler implements AssignmentHandler {
@Override
@@ -45,7 +45,7 @@ public class FlowClubPresidentByArgsAssignmentHandler implements AssignmentHandl
@Override
public String getMessage() {
return "获取社团会长(根据args中的clubId)";
return "获取协会会长(根据args中的clubId)";
}
@Override
@@ -61,7 +61,7 @@ public class Sys_user_role {
@Column
@ColDefine(type = ColType.VARCHAR, width = 32)
@Comment("社团ID")
@Comment("协会ID")
private String clubId;
@Column
@ColDefine(type = ColType.VARCHAR, width = 32)
@@ -17,7 +17,7 @@ import org.quartz.JobExecutionException;
* @Author JyuHsin
* @Date 2026/1/22 16:56
* @Version 1.0
* @Description 每年的1月1日生成社团成员当年的缴费记录
* @Description 每年的1月1日生成协会成员当年的缴费记录
*/
@IocBean
@DisallowConcurrentExecution
@@ -56,7 +56,7 @@ public class SecurityUtil {
}
/**
* 获取当前用户社团ID
* 获取当前用户协会ID
*/
public static List<String> getClubIds() {
String clubIds = getSession().get("clubIds").toString();
@@ -115,7 +115,7 @@ public class CommonController {
@At
@SaCheckLogin
@ApiOperation("社团列表")
@ApiOperation("协会列表")
public Result clubOptions(String clubId) {
List<SysClub> sysClubs = sysClubService.dao().query(SysClub.class,
Cnd.NEW().andEX("id", "=", clubId));
@@ -355,7 +355,7 @@ public class ActivityBasicScopeController {
boolean isBranchUnionChairman = AuthUtil.hasRole(RoleConstant.BRANCH_UNION_CHAIRMAN.name());
boolean isClubPresident = AuthUtil.hasRole(RoleConstant.CLUB_PRESIDENT.name());
if (isBranchUnionChairman && isClubPresident) {
// 同时具备分工会主席和社团会长身份时,未额外筛选前默认查看两类权限范围的并集。
// 同时具备分工会主席和协会会长身份时,未额外筛选前默认查看两类权限范围的并集。
List<String> manageClubIdList = sysClubService.getMyManageClub().stream().map(SysClub::getId).toList();
SqlExpressionGroup scopeGroup = new SqlExpressionGroup();
scopeGroup.or("u.unionid", "=", SecurityUtil.getUnionId());
@@ -364,7 +364,7 @@ public class ActivityBasicScopeController {
}
cnd.and(scopeGroup);
} else if (isClubPresident) {
// 社团会长设置活动人员范围时,只允许查看自己可管理社团下的成员。
// 协会会长设置活动人员范围时,只允许查看自己可管理协会下的成员。
List<String> manageClubIdList = sysClubService.getMyManageClub().stream().map(SysClub::getId).toList();
if (manageClubIdList.isEmpty()) {
cnd.and("clubuser.clubid", "in", List.of("__EMPTY_CLUB_ID__"));
@@ -162,7 +162,7 @@ public class ActivityCultureUserStatisticsController {
if (activity_type == 40002) {
cnd.and("tissue.unionId", "=", SecurityUtil.getUnionId());
} else if (activity_type == 40003) {
// 协会会长进入社团报名统计时,只允许查看自己管理社团下的活动名称。
// 协会会长进入协会报名统计时,只允许查看自己管理协会下的活动名称。
List<SysClub> myManageClub = sysClubService.getMyManageClub();
List<String> clubIdList = myManageClub.stream().map(SysClub::getId).collect(Collectors.toList());
cnd.and("tissue.clubId", "in", clubIdList);
@@ -19,7 +19,7 @@ import java.util.List;
/**
* @author: Aaron
* @create: 2021-03-09 13:57
* @description: 社团或分工会活动校工会活动
* @description: 协会或分工会活动校工会活动
**/
@EqualsAndHashCode(callSuper = true)
@@ -147,7 +147,7 @@ public class ActivityTissue extends BaseModel implements Serializable, SysHomeCo
private String unionId;
@Column
@Comment("创建人所属社团")
@Comment("创建人所属协会")
@ColDefine(type = ColType.VARCHAR, width = 32)
private String clubId;
@@ -28,7 +28,7 @@ public class ActivityTissuePerson extends BaseModel implements Serializable {
private String id;
@Column
@Comment("分工会或社团活动ID")
@Comment("分工会或协会活动ID")
@ColDefine(type = ColType.VARCHAR, width = 32)
private String tissueId;
@@ -30,7 +30,7 @@ import java.util.List;
*/
@IocBean
@Ok("json")
@ApiOperation("活动申报,社团负责人审核")
@ApiOperation("活动申报,协会负责人审核")
@At("/platform/activityDeclare/clubPrincipal")
public class ActivityDeclareClubPrincipalController {
@@ -51,7 +51,7 @@ public class ActivityDeclareClubPrincipalController {
@At
@ApiOperation("活动申报,社团负责人审核列表")
@ApiOperation("活动申报,协会负责人审核列表")
@SaCheckPermission("activityDeclare.clubPrincipal")
public Result pageData(CommonPageParam pageParam) {
Sql sql = Sqls.create("""
@@ -222,8 +222,8 @@ public class ActivityDeclareMineController {
docData.put("fgh", approval);
});
// 社团负责人审核
doneTaskVos.stream().filter(task -> "社团负责人审核".equals(task.getDisplayName()))
// 协会负责人审核
doneTaskVos.stream().filter(task -> "协会负责人审核".equals(task.getDisplayName()))
.max(Comparator.comparing(ProcessTaskVO::getCreatedAt))
.ifPresent(v -> {
Dict taskFormData = v.getTaskFormData();
@@ -58,7 +58,7 @@ public class ActivityDeclareInfo extends BaseModel {
private String mobile;
@Column
@Comment("申报单位(校工会/二级工会名称/社团名称)")
@Comment("申报单位(校工会/二级工会名称/协会名称)")
@ColDefine(type = ColType.VARCHAR, width = 200)
private String declareUnitName;
@@ -68,7 +68,7 @@ public class ActivityDeclareInfo extends BaseModel {
private String unionId;
@Column
@Comment("社团id")
@Comment("协会id")
@ColDefine(type = ColType.VARCHAR, width = 32)
private String clubId;
@@ -25,9 +25,9 @@ public enum ActivityDeclareReimbursement {
*/
BRANCH_UNION("分工会活动"),
/**
* 社团
* 协会
*/
CLUB("社团活动");
CLUB("协会活动");
private final String typeName;
}
@@ -110,7 +110,7 @@ public class ActivityReimbursementBoardController {
list.add(new NutMap() {{
put("year", year);
put("type", "社团活动");
put("type", "协会活动");
put("num", activityReimbursementService.count(sql.setParam("type", "ACTIVITY_BUDGET_TYPE_THREE").setParam("year", year)));
}});
}
@@ -145,7 +145,7 @@ public class ActivityReimbursementBoardController {
put("num", activityReimbursementService.count(sql.setParam("type", "ACTIVITY_BUDGET_TYPE_TWO")));
}});
list.add(new NutMap() {{
put("type", "社团活动");
put("type", "协会活动");
put("num", activityReimbursementService.count(sql.setParam("type", "ACTIVITY_BUDGET_TYPE_THREE")));
}});
return Result.success(list);
@@ -191,7 +191,7 @@ public class ActivityReimbursementBoardController {
list.add(new NutMap() {{
put("year", year);
put("type", "社团费用");
put("type", "协会费用");
put("num", activityReimbursementService.list(sql.setParam("type", "ACTIVITY_BUDGET_TYPE_THREE").setParam("year", year)).get(0).getDouble("money"));
}});
}
@@ -218,7 +218,7 @@ public class ActivityReimbursementBoardController {
put("num", activityReimbursementService.count(unionSql));
}});
list.add(new NutMap() {{
put("type", "社团费用");
put("type", "协会费用");
put("num", activityReimbursementService.count(clubSql));
}});
return Result.success().addData(list);
@@ -250,7 +250,7 @@ public class ActivityReimbursementBoardController {
@At
@ApiOperation("所有社团的报销费用或活动数统计")
@ApiOperation("所有协会的报销费用或活动数统计")
@SaCheckPermission("activityReimbursement.board")
public Result allClubActivityAndMoney(Integer year, Boolean isClubMoney) {
Sql sql = Sqls.create("""
@@ -30,7 +30,7 @@ import java.util.List;
*/
@IocBean
@Ok("json")
@ApiOperation("活动报销,社团负责人审核")
@ApiOperation("活动报销,协会负责人审核")
@At("/platform/activityReimbursement/clubPrincipal")
public class ActivityReimbursementClubPrincipalController {
@@ -51,7 +51,7 @@ public class ActivityReimbursementClubPrincipalController {
@At
@ApiOperation("活动报销,社团负责人审核列表")
@ApiOperation("活动报销,协会负责人审核列表")
@SaCheckPermission("activityReimbursement.clubPrincipal")
public Result pageData(CommonPageParam pageParam) {
Sql sql = Sqls.create("""
@@ -323,8 +323,8 @@ public class ActivityReimbursementMineController {
docData.put("fgh", approval);
});
// 社团负责人审核
doneTaskVos.stream().filter(task -> "社团负责人审核".equals(task.getDisplayName()))
// 协会负责人审核
doneTaskVos.stream().filter(task -> "协会负责人审核".equals(task.getDisplayName()))
.max(Comparator.comparing(ProcessTaskVO::getCreatedAt))
.ifPresent(v -> {
Dict taskFormData = v.getTaskFormData();
@@ -141,7 +141,7 @@ public class YearPlanController {
}
@At
@ApiOperation("获取社团")
@ApiOperation("获取协会")
@SaCheckPermission("planSummary.yearPlan.manage")
public Result queryClub() {
Cnd cnd = Cnd.NEW();
@@ -51,17 +51,17 @@ public class YearPlan extends BaseModel {
private Double money;
@Column
@Comment("计划类型(40001-校活动、40002-分工会活动、40003-社团社团活动)")
@Comment("计划类型(40001-校活动、40002-分工会活动、40003-协会协会活动)")
@ColDefine(type = ColType.VARCHAR, width = 7)
private String planType;
@Column
@Comment("分工会ID或社团ID")
@Comment("分工会ID或协会ID")
@ColDefine(type = ColType.VARCHAR, width = 32)
private String tissueId;
@Column
@Comment("分工会或社团")
@Comment("分工会或协会")
@ColDefine(type = ColType.VARCHAR, width = 32)
private String tissueName;
@@ -72,12 +72,12 @@ public class YearSummary extends BaseModel {
private String cTime;
@Column
@Comment("工会/社团id")
@Comment("工会/协会id")
@ColDefine(type = ColType.VARCHAR, width = 32)
private String tissueId;
@Column
@Comment("分工会或社团")
@Comment("分工会或协会")
@ColDefine(type = ColType.VARCHAR, width = 32)
private String tissueName;
@@ -87,7 +87,7 @@ public class YearSummary extends BaseModel {
private String summaryType;
@Column
@Comment("总结来源(1-校活动、2-分工会活动、3社团社团活动)")
@Comment("总结来源(1-校活动、2-分工会活动、3协会协会活动)")
@ColDefine(type = ColType.VARCHAR, width = 32)
private String summaryFrom;
@@ -162,7 +162,7 @@ public class ActivitySchool extends BaseModel implements Serializable , SysHomeC
private Boolean close;
@Column
@Comment("活动级别(40001-校级、40002-分工会、40003-社团或社团)")
@Comment("活动级别(40001-校级、40002-分工会、40003-协会或协会)")
@ColDefine(type = ColType.INT, width = 10)
private Integer activityLevel;
@@ -198,7 +198,7 @@ public class ActivitySchool extends BaseModel implements Serializable , SysHomeC
private String belongUnionId;
@Column
@Comment("活动所属社团")
@Comment("活动所属协会")
@ColDefine(type = ColType.VARCHAR, width = 32)
private String belongClubId;
@@ -326,7 +326,7 @@ public class TrainSignUpManageController {
@At
@Ok("json:full")
@ApiOperation("查询分工会和社团")
@ApiOperation("查询分工会和协会")
@SaCheckPermission(value = {"trainSignUp.manage", "trainSignUp.applyActivity"}, mode = SaMode.OR)
public Result selectUnitAndClub() {
List<NutMap> result = new ArrayList<>();
@@ -49,9 +49,9 @@ public class ClubUserClubListController {
}
/**
* 打开移动端社团列表,共用电脑端的社团查询及入退会状态。
* 打开移动端协会列表,共用电脑端的协会查询及入退会状态。
*
* @return 无返回值,由模板渲染社团列表页面
* @return 无返回值,由模板渲染协会列表页面
*/
@At("/h5")
@Ok("beetl:/platform/zhghh5/club/list/index.html")
@@ -85,7 +85,7 @@ public class ClubUserClubListController {
@At
@SaCheckPermission(value = {"club.join.list", "h5.club.join.list", "h5.club.join.apply"}, mode = SaMode.OR)
public Result getCount() {
// 获取所有社团
// 获取所有协会
List<SysClub> list = sysClubService.query();
// 获取审核通过的
List<ProcessInstance> instanceList = sysClubService.dao().query(
@@ -51,7 +51,7 @@ import java.util.List;
@IocBean
@At("/platform/club/join/apply")
@Api("社团申请入会、退会")
@Api("协会申请入会、退会")
@Ok("json:full")
public class ClubUserJoinApplyController {
@@ -75,12 +75,12 @@ public class ClubUserJoinApplyController {
}
/**
* 移动端首次入会先选择社团,已选社团或已有申请继续进入申请表单。
* 移动端首次入会先选择协会,已选协会或已有申请继续进入申请表单。
*
* @param clubId 已选择的社团ID
* @param clubId 已选择的协会ID
* @param bizId 已有入会申请ID
* @param taskId 重新提交申请时的流程任务ID
* @return 无申请上下文时跳转社团列表,否则渲染原申请页面
* @return 无申请上下文时跳转协会列表,否则渲染原申请页面
*/
@At("/h5")
@SaCheckPermission("h5.club.join.apply")
@@ -124,7 +124,7 @@ public class ClubUserJoinApplyController {
@ApiOperation("保存申请")
@Aop(TransAop.READ_COMMITTED)
@SaCheckPermission(value = {"club.join.apply", "h5.club.join.apply"}, mode = SaMode.OR)
@SLog(tag = "社团管理系统-申请入会", msg = "保存社团入会")
@SLog(tag = "协会管理系统-申请入会", msg = "保存协会入会")
public Result save(@Param("data") ClubUserApply clubUserApply) {
clubUserApply.setRoleCode(RoleConstant.CLUB_MEMBER.name());
clubUserApply.setMode(1);
@@ -138,7 +138,7 @@ public class ClubUserJoinApplyController {
@ApiOperation("提交")
@SaCheckPermission(value = {"club.join.apply", "h5.club.join.apply"}, mode = SaMode.OR)
@Aop(TransAop.READ_COMMITTED)
@SLog(tag = "社团管理系统-申请入/退会", msg = "申请社团入/退会")
@SLog(tag = "协会管理系统-申请入/退会", msg = "申请协会入/退会")
public Result submit(@Param("data") ClubUserApply clubUserApply,
@Param("mode") Boolean mode) {
if (Boolean.TRUE.equals(mode)) {
@@ -150,14 +150,14 @@ public class ClubUserJoinApplyController {
if(mode == false) {
clubUserApply = clubUserJoinService.buildExitApply(clubUserApply.getClubId(), SecurityUtil.getUserId());
if (ObjectUtil.isEmpty(clubUserApply)) {
return Result.error("当前不是该社团成员,无法申请退出!");
return Result.error("当前不是该协会成员,无法申请退出!");
}
}
ClubUserApply userApply = dao.fetch(ClubUserApply.class, Cnd.where("userId", "=", clubUserApply.getUserId()).and("clubId", "=", clubUserApply.getClubId()).and("mode", "=", mode).desc(ClubUserApply::getApplyDate));
if (ObjectUtil.isNotEmpty(userApply) && StrUtil.isNotBlank(userApply.getId())) {
ProcessInstance processInstance = dao.fetch(ProcessInstance.class, Cnd.where(ProcessInstance::getBusinessNo, "=", userApply.getId()));
if (processInstance != null && !List.of(ProcessInstanceStateEnum.REJECT.getCode(), ProcessInstanceStateEnum.FINISHED.getCode()).contains(processInstance.getState())) {
return Result.error("您有该社团的申请记录尚未完成,请到我的申请里查看!");
return Result.error("您有该协会的申请记录尚未完成,请到我的申请里查看!");
}
}
@@ -209,7 +209,7 @@ public class ClubUserJoinApplyController {
}
@At
@ApiOperation("校验是否申请过社团")
@ApiOperation("校验是否申请过协会")
@SaCheckPermission(value = {"club.join.apply", "h5.club.join.apply"}, mode = SaMode.OR)
public Result checkApplyClub(@Valid String clubId) {
String qualificationMsg = clubUserJoinService.checkJoinQualification(SecurityUtil.getUserId());
@@ -234,10 +234,10 @@ public class ClubUserJoinApplyController {
ProcessInstance processInstance = dao.fetch(ProcessInstance.class, Cnd.where(ProcessInstance::getBusinessNo, "=", userApply.getId()));
// 申请记录存在但没有流程实例时,说明用户仅保存了申请草稿,需提示其先到“我的申请”继续提交。
if (processInstance == null) {
return Result.error(99, "您有该社团的申请记录尚未提交,请到我的申请里查看!");
return Result.error(99, "您有该协会的申请记录尚未提交,请到我的申请里查看!");
}
if (!List.of(ProcessInstanceStateEnum.REJECT.getCode(), ProcessInstanceStateEnum.FINISHED.getCode()).contains(processInstance.getState())) {
return Result.error(99, "您有该社团的申请记录尚未完成,请到我的申请里查看!");
return Result.error(99, "您有该协会的申请记录尚未完成,请到我的申请里查看!");
}
return Result.success();
}
@@ -59,8 +59,8 @@ public class ClubUserJoinMineController {
@SaCheckPermission(value = {"club.join.mine", "h5.club.join.mine"}, mode = SaMode.OR)
/**
* 我的申请分页查询。
* pageForm 为分页参数,year 为申请年度,clubName 为可选的社团名称关键字;
* 返回分页后的当前用户社团申请记录。
* pageForm 为分页参数,year 为申请年度,clubName 为可选的协会名称关键字;
* 返回分页后的当前用户协会申请记录。
*/
public Result pageData(@Valid PageForm pageForm,
@Param("year") Integer year,
@@ -135,7 +135,7 @@ public class ClubUserJoinMineController {
@SaCheckPermission(value = {"club.join.mine", "h5.club.join.mine"}, mode = SaMode.OR)
@ApiOperation("删除")
@Aop(TransAop.READ_COMMITTED)
@SLog(tag = "社团管理系统-申请入会-我的申请", msg = "删除社团入会")
@SLog(tag = "协会管理系统-申请入会-我的申请", msg = "删除协会入会")
public Result delete(@Valid String id) {
dao.delete(ClubUserApply.class, id);
dao.delete(ClubUser.class, id);
@@ -51,8 +51,8 @@ public class ClubUserMineClubController {
@At
@SaCheckPermission(value = {"club.join.mine.club", "h5.club.join.mine.club"}, mode = SaMode.OR)
/**
* 我的社团分页查询。
* pageForm 传入分页参数及可选社团名称;返回当前登录人已完成入会流程的社团列表,
* 我的协会分页查询。
* pageForm 传入分页参数及可选协会名称;返回当前登录人已完成入会流程的协会列表,
* 每条记录同时包含当前成员姓名、工号和最近一次入会申请 ID,供 H5 卡片及详情页展示。
*/
public Result pageData(@Valid ClubUserPageForm pageForm) {
@@ -79,7 +79,7 @@ public class ClubUserMineClubController {
FROM
sys_club club
LEFT JOIN club_user uc ON club.id = uc.clubId
-- 查询当前登录人的成员资料及最近一次入会申请,避免卡片标题错误显示为社团名称。
-- 查询当前登录人的成员资料及最近一次入会申请,避免卡片标题错误显示为协会名称。
LEFT JOIN club_user currentClubUser ON currentClubUser.clubId = club.id AND currentClubUser.userId = @currentUserId
LEFT JOIN sys_user currentUser ON currentUser.id = currentClubUser.userId
LEFT JOIN (
@@ -97,7 +97,7 @@ public class ClubUserMineClubController {
""");
sql.setParam("currentUserId", SecurityUtil.getUserId());
Cnd cnd = Cnd.NEW();
// 社团名称为可选搜索参数,输入关键字时按名称模糊匹配。
// 协会名称为可选搜索参数,输入关键字时按名称模糊匹配。
if (Strings.isNotBlank(pageForm.getClubName())) {
cnd.and("club.clubName", "like", "%" + pageForm.getClubName().trim() + "%");
}
@@ -52,7 +52,7 @@ public class ClubCommonController {
private SysFileService sysFileService;
/**
* 上传社团缩略图,限制图片大小并复用系统文件服务校验图片内容及保存文件。
* 上传协会缩略图,限制图片大小并复用系统文件服务校验图片内容及保存文件。
*
* @param file 用户上传的 JPG、PNG 或 GIF 图片,大小不得超过 2MB
* @return 成功时返回图片下载地址,文件无效或超过限制时返回错误提示
@@ -63,14 +63,14 @@ public class ClubCommonController {
@SaCheckPermission(value = {"club.register.apply", "club.infoManage.manage"}, mode = SaMode.OR)
public Result uploadThumbnail(@Param("file") TempFile file) {
if (file == null || StrUtil.isBlank(file.getSubmittedFileName())) {
return Result.error("请选择社团缩略图");
return Result.error("请选择协会缩略图");
}
if (file.getSize() > 2L * 1024 * 1024) {
return Result.error("社团缩略图大小不能超过2MB");
return Result.error("协会缩略图大小不能超过2MB");
}
String suffix = FileUtil.extName(file.getSubmittedFileName()).toLowerCase(Locale.ROOT);
if (!Set.of("jpg", "jpeg", "png", "gif").contains(suffix)) {
return Result.error("社团缩略图仅支持JPG、PNG、GIF图片");
return Result.error("协会缩略图仅支持JPG、PNG、GIF图片");
}
try {
return Result.success().addData(sysFileService.uploadReturnUrl(SysFileEngineTypeEnum.MINIO.getValue(), file));
@@ -81,7 +81,7 @@ public class ClubCommonController {
@At
@SaCheckLogin
/** 无请求参数;返回入会社团选项,每项包含 id、clubName 等社团字段,同一社团不重复。 */
/** 无请求参数;返回入会协会选项,每项包含 id、clubName 等协会字段,同一协会不重复。 */
public Result listClub() {
return Result.success(sysClubService.listJoinClubOptions());
}
@@ -114,7 +114,7 @@ public class ClubCommonController {
@At
@SaCheckLogin
public Result listManageClubByRole() {
// 活动人员范围设置只允许按“可管理的社团”选择,避免把仅作为成员加入的社团也展示出来。
// 活动人员范围设置只允许按“可管理的协会”选择,避免把仅作为成员加入的协会也展示出来。
List<SysClub> clubList = sysClubService.getMyManageClub();
return Result.success(clubList);
}
@@ -69,7 +69,7 @@ public class ClubEvaluateApplyController {
@At
@Aop(TransAop.READ_COMMITTED)
@SaCheckPermission("club.evaluate.apply")
@SLog(tag = "社团管理系统-社团评优", msg = "保存社团评优申请")
@SLog(tag = "协会管理系统-协会评优", msg = "保存协会评优申请")
public Result save(@Param("data") SysClubEvaluate evaluate) {
evaluateService.dao().insertOrUpdate(evaluate);
return Result.success(evaluate);
@@ -78,7 +78,7 @@ public class ClubEvaluateApplyController {
@At
@Aop(TransAop.READ_COMMITTED)
@SaCheckPermission("club.evaluate.apply")
@SLog(tag = "社团管理系统-社团评优", msg = "提交社团评优")
@SLog(tag = "协会管理系统-协会评优", msg = "提交协会评优")
public Result submit(@Valid @Param("data") SysClubEvaluate evaluate) {
evaluateService.dao().insertOrUpdate(evaluate);
@@ -51,7 +51,7 @@ public class ClubEvaluateMineController {
@At
@Aop(TransAop.READ_COMMITTED)
@SaCheckPermission("club.evaluate.mine")
@SLog(tag = "社团管理系统-社团评优", msg = "删除社团评优")
@SLog(tag = "协会管理系统-协会评优", msg = "删除协会评优")
public Result doDelete(@Valid String id) {
sysClubEvaluateService.dao().delete(SysClubEvaluate.class, id);
flowEngine.processInstanceService().deleteProcessInstanceByBusinessKey(id);
@@ -71,12 +71,12 @@ public class ClubExamineApplyController {
@SaCheckLogin
public Result getCount(String id, Integer year, String clubId) {
if(StrUtil.isBlank(clubId)) {
return Result.error("社团信息为空,请核查");
return Result.error("协会信息为空,请核查");
}
if(year == null) {
return Result.error("年份信息为空,请核查");
}
// 同一社团的年度重复申请校验以登记年度为准,不能按申请时间判断。
// 同一协会的年度重复申请校验以登记年度为准,不能按申请时间判断。
List<SysClubExamineRegister> list = dao.query(SysClubExamineRegister.class, Cnd.where("clubId", "=", clubId).and("year", "=", year).andEX("id", "!=", id));
List<ProcessInstance> instanceList = dao.query(
ProcessInstance.class,
@@ -98,7 +98,7 @@ public class ClubExamineApplyController {
// @SaCheckLogin
// public Result getClubUserNum(String clubId, Integer year) {
// if(StrUtil.isBlank(clubId)) {
// return Result.error("社团信息为空,请核查");
// return Result.error("协会信息为空,请核查");
// }
// List<NutMap> result = sysClubExamineService.getClubUserNum(clubId, year);
// return Result.success(result);
@@ -107,13 +107,13 @@ public class ClubExamineApplyController {
//
/**
* 2026年10月2日22:00点开始新开发的代码;实际整改:2026年10月3日 10:14:04;操作人:wxg。
* 接收 clubId(所选社团ID)、year(公历年度),基础校验后调用 service;
* 接收 clubId(所选协会ID)、year(公历年度),基础校验后调用 service;
* 返回 Result,data为两类计数及统计核查信息列表,异常参数返回错误提示。
*/
@At
@SaCheckLogin
public Result getClubUserNum(String clubId, Integer year) {
if (StrUtil.isBlank(clubId)) return Result.error("社团信息为空,请核查");
if (StrUtil.isBlank(clubId)) return Result.error("协会信息为空,请核查");
if (year == null || year < 1 || year > 9998) return Result.error("请选择有效统计年度");
return Result.success(sysClubExamineService.getClubUserNum(clubId, year));
}
@@ -122,7 +122,7 @@ public class ClubExamineApplyController {
@SaCheckLogin
public Result getJgUser(String clubId) {
if(StrUtil.isBlank(clubId)) {
return Result.error("社团信息为空,请核查");
return Result.error("协会信息为空,请核查");
}
List<NutMap> result = sysClubExamineService.getJgUser(clubId);
return Result.success(result);
@@ -132,7 +132,7 @@ public class ClubExamineApplyController {
@SaCheckLogin
public Result getClubMemberMoney(String clubId) {
if(StrUtil.isBlank(clubId)) {
return Result.error("社团信息为空,请核查");
return Result.error("协会信息为空,请核查");
}
int count = dao.count(ClubUser.class, Cnd.where("clubId", "=", clubId));
SysClub club = dao.fetch(SysClub.class, clubId);
@@ -160,7 +160,7 @@ public class ClubExamineApplyController {
@SaCheckLogin
public Result getLastYearSurplus(String clubId) {
if(StrUtil.isBlank(clubId)) {
return Result.error("社团信息为空,请核查");
return Result.error("协会信息为空,请核查");
}
// 上年度结余按登记年度查询,避免申请时间跨年导致取错数据。
SysClubExamineRegister register = dao.fetch(SysClubExamineRegister.class, Cnd.where("clubId", "=", clubId)
@@ -186,7 +186,7 @@ public class ClubExamineApplyController {
@At
@Aop(TransAop.READ_COMMITTED)
@SaCheckPermission("club.examine.apply")
@SLog(tag = "社团管理系统-社团年审", msg = "保存社团年审")
@SLog(tag = "协会管理系统-协会年审", msg = "保存协会年审")
public Result save(@Param("data") SysClubExamineRegister examineRegister,
@Param("incomeDetailed") String incomeDetailed,
@Param("incomeCensus") String incomeCensus) {
@@ -201,7 +201,7 @@ public class ClubExamineApplyController {
@At
@Aop(TransAop.READ_COMMITTED)
@SaCheckPermission("club.examine.apply")
@SLog(tag = "社团管理系统-社团年审", msg = "提交社团年审")
@SLog(tag = "协会管理系统-协会年审", msg = "提交协会年审")
public Result submit(@Param("data") SysClubExamineRegister examineRegister,
@Param("incomeDetailed") String incomeDetailed,
@Param("incomeCensus") String incomeCensus) {
@@ -48,7 +48,7 @@ public class ClubExamineMineController {
@At
@Aop(TransAop.READ_COMMITTED)
@SaCheckPermission("club.examine.mine")
@SLog(tag = "社团管理系统-社团年审", msg = "删除社团年审")
@SLog(tag = "协会管理系统-协会年审", msg = "删除协会年审")
public Result doDelete(@Valid String id) {
sysClubExamineService.delete(id);
sysClubExamineService.dao().clear(SysClubExamineRegisterDetailed.class, Cnd.where("registerId", "=", id));
@@ -108,7 +108,7 @@ public class ClubExamineMineController {
.bind("activityQk", activityQk).build();
try {
String fileName = Globals.MyConfig.getString("AppName") + "教职工社团年度考核登记表";
String fileName = Globals.MyConfig.getString("AppName") + "教职工协会年度考核登记表";
response.addHeader("Content-Type", "application/octet-stream");
response.addHeader("Content-Disposition", "attachment; filename=\"" + new String(fileName.getBytes(StandardCharsets.UTF_8), StandardCharsets.ISO_8859_1) + "\".docx");
XWPFTemplate.compile(officeTemplateUtil.getPath("club_examine_register"), config).render(map).writeAndClose(response.getOutputStream());
@@ -135,7 +135,7 @@ public class ClubChangeManagerController {
@At
@Aop(TransAop.READ_COMMITTED)
@SaCheckPermission("club.infoManage.change")
@SLog(tag = "社团管理系统-信息管理", msg = "提交变更理事机构")
@SLog(tag = "协会管理系统-信息管理", msg = "提交变更理事机构")
public Object submit(@Param("data") SysClubManager clubManager) {
Cnd cnd = Cnd.NEW();
cnd.and(SysClubManager::getClubId, "=", clubManager.getClubId());
@@ -146,7 +146,7 @@ public class ClubChangeManagerController {
List<String> pendingProcessIds = managerList.stream().map(SysClubManager::getId).toList();
int pendingCount = dao.count(ProcessInstance.class, Cnd.where(ProcessInstance::getBusinessNo, "in", pendingProcessIds).and(ProcessInstance::getState, "not in", List.of(ProcessInstanceStateEnum.FINISHED.getCode(), ProcessInstanceStateEnum.REJECT.getCode())));
if (pendingCount > 0) {
return Result.error("您有该社团的申请记录尚未完成,请核对!");
return Result.error("您有该协会的申请记录尚未完成,请核对!");
}
if (!AuthUtil.hasRoleOr(RoleConstant.SYSADMIN.name(), RoleConstant.SCHOOL_UNION_ADMIN.name())) {
@@ -206,7 +206,7 @@ public class ClubChangeManagerController {
@ApiOperation("删除")
@Aop(TransAop.READ_COMMITTED)
@SaCheckPermission("club.infoManage.change")
@SLog(tag = "社团管理系统-信息管理", msg = "删除变更理事机构")
@SLog(tag = "协会管理系统-信息管理", msg = "删除变更理事机构")
public Result delete(@Param("id") String id) {
dao.delete(SysClubManager.class, id);
flowEngine.processInstanceService().deleteProcessInstanceByBusinessKey(id);
@@ -111,7 +111,7 @@ public class ClubInfoManageController {
@At
@Aop(TransAop.READ_COMMITTED)
@SaCheckPermission("club.infoManage.manage")
@SLog(tag = "社团管理系统-信息管理", msg = "修改社团信息")
@SLog(tag = "协会管理系统-信息管理", msg = "修改协会信息")
public Result doSubmit(@Param("club") SysClub club) {
clubInfoManageService.dao().update(club);
return Result.success();
@@ -120,7 +120,7 @@ public class ClubInfoManageController {
@At
@Aop(TransAop.READ_COMMITTED)
@SaCheckPermission("club.infoManage.manage")
@SLog(tag = "社团管理系统-信息管理", msg = "修改缴费状态")
@SLog(tag = "协会管理系统-信息管理", msg = "修改缴费状态")
public Result updatePayed(@Valid Boolean payed, @Valid String id) {
clubInfoManageService.dao().update(ClubUser.class, Chain.make("payed", payed), Cnd.where("id", "=", id));
return Result.success();
@@ -129,7 +129,7 @@ public class ClubInfoManageController {
@At
@Aop(TransAop.READ_COMMITTED)
@SaCheckPermission("club.infoManage.manage")
@SLog(tag = "社团管理系统-信息管理", msg = "修改拨付状态")
@SLog(tag = "协会管理系统-信息管理", msg = "修改拨付状态")
public Result updateGive(@Valid Boolean giveMoney, @Valid String id) {
clubInfoManageService.dao().update(ClubUser.class, Chain.make("giveMoney", giveMoney), Cnd.where("id", "=", id));
return Result.success();
@@ -138,7 +138,7 @@ public class ClubInfoManageController {
@At
@Aop(TransAop.READ_COMMITTED)
@SaCheckPermission("club.infoManage.manage")
@SLog(tag = "社团管理系统-信息管理", msg = "退会")
@SLog(tag = "协会管理系统-信息管理", msg = "退会")
public Result exitClub(@Valid String id) {
clubInfoManageService.exitClub(id);
return Result.success();
@@ -147,7 +147,7 @@ public class ClubInfoManageController {
@At
@Aop(TransAop.READ_COMMITTED)
@SaCheckPermission("club.infoManage.manage")
@SLog(tag = "社团管理系统-信息管理", msg = "删除社团成员")
@SLog(tag = "协会管理系统-信息管理", msg = "删除协会成员")
public Result userDelete(@Valid String id) {
ClubUser clubUser = dao.fetch(ClubUser.class, id);
dao.delete(ClubUser.class,id);
@@ -188,11 +188,11 @@ public class ClubInfoManageController {
@At
@Aop(TransAop.READ_COMMITTED)
@SaCheckPermission("club.infoManage.manage")
@SLog(tag = "社团管理系统-信息管理", msg = "修改身份")
@SLog(tag = "协会管理系统-信息管理", msg = "修改身份")
public Result updateRoleCode(@Param("id") String id, @Valid String[] roleCodes, @Valid String clubId) {
List<String> roleCodeList = Arrays.asList(roleCodes);
ClubUser clubUser = clubInfoManageService.dao().fetch(ClubUser.class, id);
//查询社团是否存在会长或者秘书长
//查询协会是否存在会长或者秘书长
if(Arrays.asList(roleCodes).contains(RoleConstant.CLUB_PRESIDENT.name())) {
int count = dao.count(ClubUser.class, Cnd.where("clubId", "=", clubId)
.and(new Static("JSON_CONTAINS(roleCode, '\"%s\"')".formatted(RoleConstant.CLUB_PRESIDENT.name()))));
@@ -265,10 +265,10 @@ public class ClubInfoManageController {
@At
@Aop(TransAop.READ_COMMITTED)
@SaCheckPermission("club.infoManage.manage")
@SLog(tag = "社团管理系统-信息管理", msg = "添加社团成员")
@SLog(tag = "协会管理系统-信息管理", msg = "添加协会成员")
public Result userDoAdd(@Valid String clubId, @Valid String[] users, @Valid String roleCode, @Valid Boolean payed) {
//查询社团是否存在会长或者秘书长
//查询协会是否存在会长或者秘书长
if (List.of(RoleConstant.CLUB_PRESIDENT.name(), RoleConstant.CLUB_SECRETARY.name()).contains(roleCode)) {
int count = clubInfoManageService.dao().count(ClubUser.class, Cnd.where("clubId", "=", clubId)
.and(new Static("JSON_CONTAINS(roleCode, '\"%s\"')".formatted(roleCode))));
@@ -354,7 +354,7 @@ public class ClubInfoManageController {
}
/**
* @param clubId 左侧选中的社团ID,用于导出该社团登记表
* @param clubId 左侧选中的协会ID,用于导出该协会登记表
* @param response 成功时写入 DOCX 附件;失败由统一异常处理返回含 code/msg 的错误结果
* @return void,附件直接写入响应,不再渲染 JSON 成功结果
*/
@@ -372,9 +372,9 @@ public class ClubInfoManageController {
public void downloadUserImport(HttpServletResponse response) {
try (ByteArrayOutputStream byteArrayOutputStream = new ByteArrayOutputStream();){
EasyExcel.write(byteArrayOutputStream, ClubUserImportVo.class)
.sheet("社团会员导入模版")
.sheet("协会会员导入模版")
.doWrite(ArrayList::new);
CommonDownloadUtil.download("社团会员导入模版.xlsx", byteArrayOutputStream.toByteArray() ,response);
CommonDownloadUtil.download("协会会员导入模版.xlsx", byteArrayOutputStream.toByteArray() ,response);
} catch (Exception e) {
e.printStackTrace();
}
@@ -405,7 +405,7 @@ public class ClubInfoManageController {
continue;
}
if (clubUsers.stream().anyMatch(s -> s.getUserId().equals(user.getId()))) {
v.setErrorInfo("该用户已加入该社团");
v.setErrorInfo("该用户已加入该协会");
errorInfos.add(v);
continue;
}
@@ -28,7 +28,7 @@ import javax.validation.Valid;
@Slf4j
@IocBean
@Ok("json:full")
@Api(tags = "社团缴费记录")
@Api(tags = "协会缴费记录")
@At("/platform/club/pay")
public class ClubPayRecordController {
@@ -46,7 +46,7 @@ public class ClubPayRecordController {
@SaCheckPermission("club.infoManage.pay")
/**
* 2026年10月3日 14:33:18;操作人:wxg:接收查询条件,业务筛选交给 service。
* pageForm 为分页和姓名/工号关键字;year 为年度、clubId 为社团ID;
* pageForm 为分页和姓名/工号关键字;year 为年度、clubId 为协会ID;
* payed/assign 为缴费/拨付状态(1是、0否、空值不限);memberState 为当前会员状态(1在会、0退会、空值全部)。
* 返回 Result,data 为分页对象,包含 list、totalCount 等;list.count 为当前会员关系是否存在(1在会、0退会)。
*/
@@ -62,7 +62,7 @@ public class ClubPayRecordController {
return Result.success(payRecordService.pageData(pageForm, year, clubId, payed, assign, memberState));
}
/** 返回当前用户授权社团的下拉选项,字段包含 id、clubName、clubCode。 */
/** 返回当前用户授权协会的下拉选项,字段包含 id、clubName、clubCode。 */
@At
@SaCheckPermission("club.infoManage.pay")
public Result listClubs() {
@@ -70,9 +70,9 @@ public class ClubPayRecordController {
}
@At
@ApiOperation("修改社团成员缴费状态")
@ApiOperation("修改协会成员缴费状态")
@SaCheckPermission("club.infoManage.pay")
@SLog(tag = "社团管理系统-缴费记录", msg = "修改社团成员缴费状态")
@SLog(tag = "协会管理系统-缴费记录", msg = "修改协会成员缴费状态")
@Aop(TransAop.READ_COMMITTED)
public Result handle(@Param("ids") String[] ids,
@Param("payed") Boolean payed) {
@@ -124,7 +124,7 @@ public class ClubRefreshReportController {
@At
@Aop(TransAop.READ_COMMITTED)
@SaCheckPermission("club.infoManage.refreshReport")
@SLog(tag = "社团管理系统-信息管理", msg = "提交换届报告")
@SLog(tag = "协会管理系统-信息管理", msg = "提交换届报告")
public Object submit(@Param("data") SysClubRefresh clubRefresh) {
Cnd cnd = Cnd.NEW();
@@ -136,7 +136,7 @@ public class ClubRefreshReportController {
List<String> idList = list.stream().map(SysClubRefresh::getId).toList();
int count = dao.count(ProcessInstance.class, Cnd.where(ProcessInstance::getBusinessNo, "in", idList).and(ProcessInstance::getState, "not in", List.of(ProcessInstanceStateEnum.FINISHED.getCode(), ProcessInstanceStateEnum.REJECT.getCode())));
if (count > 0) {
return Result.error("您有该社团的申请记录尚未完成,请核对!");
return Result.error("您有该协会的申请记录尚未完成,请核对!");
}
SysClub club = clubInfoManageService.dao().fetch(SysClub.class, clubRefresh.getClubId());
@@ -178,9 +178,9 @@ public class ClubRefreshReportController {
@ApiOperation("删除")
@Aop(TransAop.READ_COMMITTED)
@SaCheckPermission("club.infoManage.refreshReport")
@SLog(tag = "社团管理系统-信息管理", msg = "删除换届报告")
@SLog(tag = "协会管理系统-信息管理", msg = "删除换届报告")
public Result delete(@Param("id") String id) {
// 历史换届记录可能与社团注册共用业务编号,必须按流程定义精确定位换届流程,避免误删注册流程。
// 历史换届记录可能与协会注册共用业务编号,必须按流程定义精确定位换届流程,避免误删注册流程。
List<Long> refreshDefineIds = dao.query(ProcessDefine.class,
Cnd.where(ProcessDefine::getName, "=", "XHHJBG"))
.stream()
@@ -32,9 +32,9 @@ import java.util.List;
@At("/platform/club/infoManage/registerImport")
@Ok("json:full")
public class ClubRegisterImportController {
private static final String[] HEADERS = {"社团名称", "社团编码(选填)", "社团类型编码", "成立日期", "会长工号", "秘书长工号",
private static final String[] HEADERS = {"协会名称", "协会编码(选填)", "协会类型编码", "成立日期", "会长工号", "秘书长工号",
"发起人工号", "副会长工号(选填)", "副秘书长工号(选填)", "联系人工号(选填)", "会费标准(选填)",
"联系电话(选填)", "联系邮箱(选填)", "社团介绍及宗旨(选填)", "活动形式(选填)", "缩略图地址(选填)",
"联系电话(选填)", "联系邮箱(选填)", "协会介绍及宗旨(选填)", "活动形式(选填)", "缩略图地址(选填)",
"申请成立报告文件ID(选填)", "章程草案文件ID(选填)", "经费管理办法文件ID(选填)", "年度计划文件ID(选填)", "其他附件文件ID(选填)"};
@Inject
private ClubRegisterImportService clubRegisterImportService;
@@ -47,27 +47,27 @@ public class ClubRegisterImportController {
@SaCheckPermission("club.infoManage.manage")
public void downloadTemplate(HttpServletResponse response) {
Workbook workbook = new XSSFWorkbook();
Sheet data = sheet(workbook, "社团导入", HEADERS);
Sheet data = sheet(workbook, "协会导入", HEADERS);
CellStyle style = workbook.createCellStyle();
style.setDataFormat(workbook.createDataFormat().getFormat("@"));
for (int i = 0; i < HEADERS.length; i++) data.setDefaultColumnStyle(i, style);
Sheet notes = sheet(workbook, "填写说明", "参数", "填写要求");
notes.setColumnWidth(1, 100 * 256);
append(notes, "导入规则", "仅读取第一个工作表,每行一个社团,最多1000行有效数据;保留表头,工号与编码按文本填写。");
append(notes, "必填", "社团名称、社团类型编码、成立日期、会长工号、秘书长工号、至少3名不同发起人工号。");
append(notes, "社团编码", "选填,留空按单个注册的年度编号规则生成;已有名称或编码直接跳过,不覆盖草稿、审批中或已解散记录。");
append(notes, "导入规则", "仅读取第一个工作表,每行一个协会,最多1000行有效数据;保留表头,工号与编码按文本填写。");
append(notes, "必填", "协会名称、协会类型编码、成立日期、会长工号、秘书长工号、至少3名不同发起人工号。");
append(notes, "协会编码", "选填,留空按单个注册的年度编号规则生成;已有名称或编码直接跳过,不覆盖草稿、审批中或已解散记录。");
append(notes, "成立日期", "按yyyy-MM-dd填写,如2026-10-23;支持Excel日期单元格。");
append(notes, "人员", "使用系统内已有工号。会长和秘书长各1人;副职可选多人,用逗号分隔,理事机构人员不得重复。");
append(notes, "发起人", "至少3名不同人员,用逗号分隔;可与理事机构人员重合。");
append(notes, "联系人", "选填工号,电话及邮箱默认取人员资料;单独填写电话、邮箱时使用填写值。");
append(notes, "社团类型", "参照社团类型工作表填写编码,不填写名称。");
append(notes, "协会类型", "参照协会类型工作表填写编码,不填写名称。");
append(notes, "其他资料", "会费标准、介绍、活动形式、缩略图地址均选填;介绍及活动形式按纯文本导入。");
append(notes, "附件", "选填系统已上传文件的ID,多文件用逗号分隔,每类最多5个;Excel不上传附件本身,留空可后续在维护页面补充。");
append(notes, "直接通过", "保存社团、发起人、理事会员、入会时间和年度缴费记录,授予社团角色;直接通过,不生成审批任务。");
append(notes, "直接通过", "保存协会、发起人、理事会员、入会时间和年度缴费记录,授予协会角色;直接通过,不生成审批任务。");
append(notes, "导入结果", "逐行独立保存,已存在的跳过,失败行回滚并显示原因,不影响其他行。");
Sheet types = sheet(workbook, "社团类型", "类型编码", "类型名称");
Sheet types = sheet(workbook, "协会类型", "类型编码", "类型名称");
for (Sys_dict type : sysDictService.getSubListByCode("CLUB_REGISTER_TYPE")) append(types, type.getCode(), type.getName());
CommonDownloadUtil.download("社团批量注册模板.xlsx", workbook, response);
CommonDownloadUtil.download("协会批量注册模板.xlsx", workbook, response);
}
@At
@@ -95,7 +95,7 @@ public class ClubRegisterImportController {
numbers.add(row.getRowNum() + 1);
}
} catch (Exception e) {
log.warn("读取社团注册导入文件失败", e);
log.warn("读取协会注册导入文件失败", e);
return Result.error("文件读取失败,请使用未加密的xls或xlsx模板,不要使用公式");
}
if (rows.isEmpty()) return Result.error("文件中没有需要导入的数据");
@@ -110,7 +110,7 @@ public class ClubRegisterImportController {
} catch (IllegalArgumentException e) {
result = NutMap.NEW().addv("status", "失败").addv("message", e.getMessage());
} catch (Exception e) {
log.error("社团批量注册失败,行号:{}", numbers.get(i), e);
log.error("协会批量注册失败,行号:{}", numbers.get(i), e);
result = NutMap.NEW().addv("status", "失败").addv("message", "保存失败,该行已回滚,请检查数据或联系管理员");
}
result.setv("rowNumber", numbers.get(i)).setv("clubName", values[0]);
@@ -123,7 +123,7 @@ public class ClubRuleUpdateController {
@At
@Aop(TransAop.READ_COMMITTED)
@SaCheckPermission("club.infoManage.ruleUpdate")
@SLog(tag = "社团管理系统-信息管理", msg = "提交章程备案")
@SLog(tag = "协会管理系统-信息管理", msg = "提交章程备案")
public Object submit(@Param("data")SysClubRule clubRule) {
Cnd cnd = Cnd.NEW();
@@ -135,7 +135,7 @@ public class ClubRuleUpdateController {
List<String> idList = list.stream().map(SysClubRule::getId).toList();
int count = dao.count(ProcessInstance.class, Cnd.where(ProcessInstance::getBusinessNo, "in", idList).and(ProcessInstance::getState, "not in", List.of(ProcessInstanceStateEnum.FINISHED.getCode(), ProcessInstanceStateEnum.REJECT.getCode())));
if (count > 0) {
return Result.error("您有该社团的申请记录尚未完成,请核对!");
return Result.error("您有该协会的申请记录尚未完成,请核对!");
}
SysClub club = clubInfoManageService.dao().fetch(SysClub.class, clubRule.getClubId());
@@ -177,7 +177,7 @@ public class ClubRuleUpdateController {
@ApiOperation("删除")
@Aop(TransAop.READ_COMMITTED)
@SaCheckPermission("club.infoManage.ruleUpdate")
@SLog(tag = "社团管理系统-信息管理", msg = "删除章程备案")
@SLog(tag = "协会管理系统-信息管理", msg = "删除章程备案")
public Result delete(@Param("id") String id) {
clubInfoManageService.dao().delete(SysClubRule.class, id);
flowEngine.processInstanceService().deleteProcessInstanceByBusinessKey(id);
@@ -201,7 +201,7 @@ public class ClubSchoolAuditReportController {
}
/**
* 使用社团名称建立目录,方便按换届报告来源查阅。
* 使用协会名称建立目录,方便按换届报告来源查阅。
*
* @param report 换届报告记录
* @return Zip 内目录名称
@@ -211,7 +211,7 @@ public class ClubSchoolAuditReportController {
}
/**
* 保留附件原始文件名;同一社团目录存在同名文件时追加序号,避免覆盖。
* 保留附件原始文件名;同一协会目录存在同名文件时追加序号,避免覆盖。
*
* @param entryName 原始 Zip 条目名称
* @param entryNames 已写入的 Zip 条目名称
@@ -22,7 +22,7 @@ import javax.validation.Valid;
* @Author: JyuHsin
* @Date: 2024/8/6 10:02
* @Version: v1.0.0
* @Description: 社团确认
* @Description: 协会确认
**/
@IocBean
@Ok("json")
@@ -31,7 +31,7 @@ import javax.validation.Valid;
**/
@IocBean
@Ok("json")
@Api("社团-我的注册")
@Api("协会-我的注册")
@At("/platform/club/register/clubMyApply")
public class ClubMyApplyController {
@@ -54,10 +54,10 @@ public class ClubMyApplyController {
}
@At
@ApiOperation("删除社团")
@ApiOperation("删除协会")
@Aop(TransAop.READ_COMMITTED)
@SaCheckPermission("club.register.myApply")
@SLog(tag = "社团管理系统-社团注册", msg = "删除社团")
@SLog(tag = "协会管理系统-协会注册", msg = "删除协会")
public Result doDelete(@Valid String id) {
sysClubService.delete(id);
sysClubService.dao().clear(SysClubSponsor.class, Cnd.where("clubId", "=", id));
@@ -42,7 +42,7 @@ import java.util.List;
* @Author: JyuHsin
* @Date: 2024/8/6 9:56
* @Version: v1.0.0
* @Description: 注册社团
* @Description: 注册协会
**/
@IocBean
@Ok("json")
@@ -67,7 +67,7 @@ public class ClubRegistApplyController {
@At
@Aop(TransAop.READ_COMMITTED)
@SaCheckPermission("club.register.apply")
@SLog(tag = "社团管理系统-社团注册", msg = "保存注册社团")
@SLog(tag = "协会管理系统-协会注册", msg = "保存注册协会")
public Result save(@Param("club") SysClub club,
@Param("::deleteIds") List<String> deleteIds,
@Param("::managePerson") List<NutMap> managePerson) {
@@ -83,7 +83,7 @@ public class ClubRegistApplyController {
@At
@Aop(TransAop.READ_COMMITTED)
@SaCheckPermission("club.register.apply")
@SLog(tag = "社团管理系统-社团注册", msg = "提交注册社团")
@SLog(tag = "协会管理系统-协会注册", msg = "提交注册协会")
public Result submit(@Param("club") SysClub club,
@Param("::deleteIds") List<String> deleteIds,
@Param("::managePerson") List<NutMap> managePerson) {
@@ -232,7 +232,7 @@ public class ClubStatisticsController {
nutMap.put("roleName", roleName);
nutMap.put("roleCode", list);
}
//获取所有社团
//获取所有协会
Cnd stCnd = Cnd.NEW();
stCnd.andEX("id", "=", clubId);
List<SysClub> clubList = sysClubService.query(stCnd);
@@ -328,7 +328,7 @@ public class ClubStatisticsController {
}
List<ExcelExportEntity> exportEntities = new ArrayList<>();
exportEntities.add(new ExcelExportEntity("社团名称", "clubName", 20));
exportEntities.add(new ExcelExportEntity("协会名称", "clubName", 20));
exportEntities.add(new ExcelExportEntity("姓名", "userName", 20));
exportEntities.add(new ExcelExportEntity("工号", "loginName", 20));
exportEntities.add(new ExcelExportEntity("性别", "sex", 20));
@@ -357,9 +357,9 @@ public class ClubStatisticsController {
List<NutMap> list = sysClubService.listMap(sql);
List<ExcelExportEntity> exportEntities = new ArrayList<>();
exportEntities.add(new ExcelExportEntity("社团名称", "clubName", 20));
exportEntities.add(new ExcelExportEntity("协会名称", "clubName", 20));
exportEntities.add(new ExcelExportEntity("编码", "clubCode", 20));
exportEntities.add(new ExcelExportEntity("社团总人数", "total", 20));
exportEntities.add(new ExcelExportEntity("协会总人数", "total", 20));
exportEntities.add(new ExcelExportEntity("在职人数", "work", 20));
exportEntities.add(new ExcelExportEntity("退休人数", "retire", 20));
exportEntities.add(new ExcelExportEntity("男", "man", 20));
@@ -368,7 +368,7 @@ public class ClubStatisticsController {
ExportParams exportParams = new ExportParams();
exportParams.setType(ExcelType.XSSF);
Workbook workbook = ExcelExportUtil.exportExcel(exportParams, exportEntities, list);
CommonDownloadUtil.download("社团统计表.xlsx", workbook, response);
CommonDownloadUtil.download("协会统计表.xlsx", workbook, response);
}
@At
@@ -380,7 +380,7 @@ public class ClubStatisticsController {
response.setHeader("Content-Disposition", "attachment;filename=" + URLUtil.encode("上传资料数据.zip"));
LinkedHashMap<String, List<JSONObject>> fileList = new LinkedHashMap<>();
//查询社团
//查询协会
List<SysClub> clubList = sysClubService.query(Cnd.NEW().andEX("id", "=", clubId));
clubList.forEach(item -> {
List<JSONObject> file = new ArrayList<>();
@@ -394,7 +394,7 @@ public class ClubStatisticsController {
fileList.put(item.getId(), file);
});
//社团年审附件
//协会年审附件
List<SysClubExamineRegister> examineList = sysClubService.dao().query(SysClubExamineRegister.class,
Cnd.NEW().andEX("clubId", "=", clubId)
.and("year(registerDate)", "=", DateUtil.thisYear()));
@@ -406,7 +406,7 @@ public class ClubStatisticsController {
}
});
//社团评优附件
//协会评优附件
List<SysClubEvaluate> evaluateList = sysClubService.dao().query(SysClubEvaluate.class, Cnd.NEW().andEX("clubId", "=", clubId)
.and("year(applyTime)", "=", DateUtil.thisYear()));
evaluateList.forEach(item -> {
@@ -439,7 +439,7 @@ public class ClubStatisticsController {
}
private Sql generateSql(String clubId, Boolean auditState, String userState, String sex, Boolean giveMoney) {
// 注册流程按社团去重后再关联,避免换届等流程复用社团ID时将会员人数重复统计。
// 注册流程按协会去重后再关联,避免换届等流程复用协会ID时将会员人数重复统计。
Sql sql = Sqls.create("""
SELECT
club.id,
@@ -25,7 +25,7 @@ public class ClubRefreshUpdateInterceptor implements FlowInterceptor {
SysClubRefresh clubRefresh = Json.fromJson(SysClubRefresh.class, formDataStr);
Dao dao = ServiceContext.find(Dao.class);
// 审核通过,将新的附件更新到社团表
// 审核通过,将新的附件更新到协会表
SysClub club = dao.fetch(SysClub.class, clubRefresh.getClubId());
club.setReplaceReport(clubRefresh.getFiles());
dao.update(club);
@@ -24,7 +24,7 @@ public class ClubRuleUpdateInterceptor implements FlowInterceptor {
SysClubRule clubRule = Json.fromJson(SysClubRule.class, formDataStr);
Dao dao = ServiceContext.find(Dao.class);
// 审核通过,将新的附件更新到社团表
// 审核通过,将新的附件更新到协会表
SysClub club = dao.fetch(SysClub.class, clubRule.getClubId());
club.setRulesFile(clubRule.getFiles());
dao.update(club);
@@ -44,7 +44,7 @@ public class ClubUserExitInterceptor implements FlowInterceptor {
// 删人
dao.clear(ClubUser.class, Cnd.where(ClubUser::getUserId, "=", clubUserApply.getUserId()).and(ClubUser::getClubId, "=", clubUserApply.getClubId()));
// 2026年10月3日 09:51:00;操作人:wxg:WF 退会完成后,同步将该社团会员的拨付字段置为 false。
// 2026年10月3日 09:51:00;操作人:wxg:WF 退会完成后,同步将该协会会员的拨付字段置为 false。
ServiceContext.find(ClubPayRecordService.class).disableExitMemberPayment(clubUserApply.getClubId(), clubUserApply.getUserId());
// 删角色
dao.clear(Sys_user_role.class, Cnd.where(Sys_user_role::getUserId, "=", clubUserApply.getUserId()).and(Sys_user_role::getClubId, "=", clubUserApply.getClubId()));
@@ -47,7 +47,7 @@ public class ClubUserJoinInterceptor implements FlowInterceptor {
clubUserApply.setJoinTime(ServiceContext.find(ClubUserJoinService.class).completeJoinApproval(
execution.getProcessInstance().getBusinessNo(), execution.getProcessTaskId()));
// 将申请信息复制一份,插入社团成员表
// 将申请信息复制一份,插入协会成员表
ClubUser clubUser = BeanUtil.copyProperties(clubUserApply, ClubUser.class);
// 读取本次已写入的入会申请时间,不能取成立时间或用插入时刻替代审核完成时间。
ClubUserApply approvedApply = dao.fetch(ClubUserApply.class, execution.getProcessInstance().getBusinessNo());
@@ -59,8 +59,8 @@ public class ClubUserJoinInterceptor implements FlowInterceptor {
ServiceContext.find(SysClubUserService.class).prepareMemberSnapshots(List.of(clubUser));
dao.insert(clubUser);
// 还要加到社团成员缴费表中
// 对了,如果同一个人,在同一年,多次加入同一社团,则只插入一条
// 还要加到协会成员缴费表中
// 对了,如果同一个人,在同一年,多次加入同一协会,则只插入一条
ClubPayRecord payRecord = dao.fetch(
ClubPayRecord.class,
Cnd.where(ClubPayRecord::getClubId, "=", clubUser.getClubId())
@@ -21,7 +21,7 @@ import java.util.Date;
@EqualsAndHashCode(callSuper = true)
@Table("club_pay_record")
@TableMeta("{'mysql-charset':'utf8mb4'}")
@Comment("社团会员缴费记录表")
@Comment("协会会员缴费记录表")
public class ClubPayRecord extends BaseModel {
@Name
@@ -36,7 +36,7 @@ public class ClubPayRecord extends BaseModel {
private Integer year;
@Column
@Comment("社团ID")
@Comment("协会ID")
@ColDefine(type = ColType.VARCHAR, width = 32)
private String clubId;
@@ -14,7 +14,7 @@ import java.util.List;
@EqualsAndHashCode(callSuper = true)
@Table("club_user")
@TableMeta("{'mysql-charset':'utf8mb4'}")
@Comment("社团会员表")
@Comment("协会会员表")
public class ClubUser extends BaseModel {
@Name
@@ -24,7 +24,7 @@ public class ClubUser extends BaseModel {
private String id;
@Column
@Comment("社团ID")
@Comment("协会ID")
@ColDefine(type = ColType.VARCHAR, width = 32)
private String clubId;
@@ -39,7 +39,7 @@ public class ClubUser extends BaseModel {
private List<String> roleCode = new ArrayList<>();
@Column
@Comment("社团职务")
@Comment("协会职务")
@ColDefine(type = ColType.VARCHAR, width = 50)
private String clubPosition;
@@ -54,7 +54,7 @@ public class ClubUser extends BaseModel {
private String avatar;
@Column
@Comment("同时参加其他社团情况")
@Comment("同时参加其他协会情况")
@ColDefine(type = ColType.VARCHAR, width = 500)
private String sameTimeJoinOtherClubSituation;
@@ -12,7 +12,7 @@ import java.util.Date;
@EqualsAndHashCode(callSuper = true)
@Table("club_user_apply")
@TableMeta("{'mysql-charset':'utf8mb4'}")
@Comment("社团申请退出申请表")
@Comment("协会申请退出申请表")
public class ClubUserApply extends BaseModel {
@Name
@@ -22,7 +22,7 @@ public class ClubUserApply extends BaseModel {
private String id;
@Column
@Comment("社团ID")
@Comment("协会ID")
@ColDefine(type = ColType.VARCHAR, width = 32)
private String clubId;
@@ -42,7 +42,7 @@ public class ClubUserApply extends BaseModel {
private Integer mode;
@Column
@Comment("社团职务")
@Comment("协会职务")
@ColDefine(type = ColType.VARCHAR, width = 50)
private String clubPosition;
@@ -67,7 +67,7 @@ public class ClubUserApply extends BaseModel {
private String avatar;
@Column
@Comment("同时参加其他社团情况")
@Comment("同时参加其他协会情况")
@ColDefine(type = ColType.VARCHAR, width = 500)
private String sameTimeJoinOtherClubSituation;
@@ -21,7 +21,7 @@ import java.util.List;
@EqualsAndHashCode(callSuper = true)
@Table("sys_club")
@TableMeta("{'mysql-charset':'utf8mb4'}")
@Comment("社团")
@Comment("协会")
public class SysClub extends BaseModel {
@Column
@@ -32,26 +32,26 @@ public class SysClub extends BaseModel {
private String id;
@Column
@Comment("社团名称")
@Comment("协会名称")
@ColDefine(type = ColType.VARCHAR, width = 100)
@NotEmpty(message = "社团名称不能为空")
@NotEmpty(message = "协会名称不能为空")
private String clubName;
@Column
@Comment("社团缩略图")
@Comment("协会缩略图")
@ColDefine(type = ColType.VARCHAR, width = 1000)
private String thumbnail;
@Column
@Comment("社团编码")
@Comment("协会编码")
@ColDefine(type = ColType.VARCHAR, width = 100)
@NotEmpty(message = "社团编码不能为空")
@NotEmpty(message = "协会编码不能为空")
private String clubCode;
@Column
@Comment("社团类型")
@Comment("协会类型")
@ColDefine(type = ColType.VARCHAR, width = 30)
@NotEmpty(message = "社团类型不能为空")
@NotEmpty(message = "协会类型不能为空")
private String clubType;
@Column
@@ -70,12 +70,12 @@ public class SysClub extends BaseModel {
private String concatPersonEmail;
@Column
@Comment("社团介绍")
@Comment("协会介绍")
@ColDefine(type = ColType.TEXT)
private String introduce;
@Column
@Comment("社团宗旨")
@Comment("协会宗旨")
@ColDefine(type = ColType.TEXT)
private String purpose;
@@ -21,7 +21,7 @@ import java.util.List;
@EqualsAndHashCode(callSuper = true)
@Table("sys_club_evaluate")
@TableMeta("{'mysql-charset':'utf8mb4'}")
@Comment("社团评优")
@Comment("协会评优")
public class SysClubEvaluate extends BaseModel {
@Column
@@ -32,9 +32,9 @@ public class SysClubEvaluate extends BaseModel {
private String id;
@Column
@Comment("社团id")
@Comment("协会id")
@ColDefine(type = ColType.VARCHAR, width = 32)
@NotEmpty(message = "社团id不能为空")
@NotEmpty(message = "协会id不能为空")
private String clubId;
@Column
@@ -20,7 +20,7 @@ import java.util.List;
@EqualsAndHashCode(callSuper = true)
@Table("sys_club_examine_register")
@TableMeta("{'mysql-charset':'utf8mb4'}")
@Comment("社团年审")
@Comment("协会年审")
public class SysClubExamineRegister extends BaseModel {
@Column
@@ -41,12 +41,12 @@ public class SysClubExamineRegister extends BaseModel {
private Integer year;
@Column
@Comment("社团id")
@Comment("协会id")
@ColDefine(type = ColType.VARCHAR, width = 32)
private String clubId;
@Column
@Comment("社团名称")
@Comment("协会名称")
@ColDefine(type = ColType.VARCHAR)
private String clubName;
@@ -109,7 +109,7 @@ public class SysClubExamineRegister extends BaseModel {
private List<JSONObject> incomeCensus;
@Column
@Comment("社团成员变化情况json")
@Comment("协会成员变化情况json")
@ColDefine(type = ColType.MYSQL_JSON)
private List<JSONObject> changeUserNum;
@@ -11,7 +11,7 @@ import org.nutz.dao.interceptor.annotation.PrevInsert;
@EqualsAndHashCode(callSuper = true)
@Table("sys_club_examine_register_detailed")
@TableMeta("{'mysql-charset':'utf8mb4'}")
@Comment("社团年审其他信息")
@Comment("协会年审其他信息")
public class SysClubExamineRegisterDetailed extends BaseModel {
@Column
@@ -19,7 +19,7 @@ import java.util.List;
@EqualsAndHashCode(callSuper = true)
@Table("sys_club_manager")
@TableMeta("{'mysql-charset':'utf8mb4'}")
@Comment("社团理事机构")
@Comment("协会理事机构")
public class SysClubManager extends BaseModel {
@Column
@@ -50,7 +50,7 @@ public class SysClubManager extends BaseModel {
private String changeUserName;
@Column
@Comment("社团id")
@Comment("协会id")
@ColDefine(type = ColType.VARCHAR, width = 32)
private String clubId;
@@ -20,7 +20,7 @@ import java.util.List;
@EqualsAndHashCode(callSuper = true)
@Table("sys_club_refresh")
@TableMeta("{'mysql-charset':'utf8mb4'}")
@Comment("社团换届报告")
@Comment("协会换届报告")
public class SysClubRefresh extends BaseModel {
@Column
@@ -41,7 +41,7 @@ public class SysClubRefresh extends BaseModel {
private String userName;
@Column
@Comment("社团id")
@Comment("协会id")
@ColDefine(type = ColType.VARCHAR, width = 32)
private String clubId;
@@ -20,7 +20,7 @@ import java.util.List;
@EqualsAndHashCode(callSuper = true)
@Table("sys_club_rule")
@TableMeta("{'mysql-charset':'utf8mb4'}")
@Comment("社团章程修订")
@Comment("协会章程修订")
public class SysClubRule extends BaseModel {
@Column
@@ -41,7 +41,7 @@ public class SysClubRule extends BaseModel {
private String userName;
@Column
@Comment("社团id")
@Comment("协会id")
@ColDefine(type = ColType.VARCHAR, width = 32)
private String clubId;
@@ -18,7 +18,7 @@ import javax.validation.constraints.NotEmpty;
@EqualsAndHashCode(callSuper = true)
@Table("sys_club_sponsor")
@TableMeta("{'mysql-charset':'utf8mb4'}")
@Comment("社团发起人")
@Comment("协会发起人")
public class SysClubSponsor extends BaseModel {
@Column
@@ -29,9 +29,9 @@ public class SysClubSponsor extends BaseModel {
private String id;
@Column
@Comment("社团id")
@Comment("协会id")
@ColDefine(type = ColType.VARCHAR, width = 32)
@NotEmpty(message = "社团不能为空")
@NotEmpty(message = "协会不能为空")
private String clubId;
@Column
@@ -34,9 +34,9 @@ public class ClubUserPageForm extends PageForm {
private Integer auditType;
private Integer source;
private Integer year;
/** 社团评优申报开始年度筛选条件。 */
/** 协会评优申报开始年度筛选条件。 */
private String applyStartYear;
/** 社团评优申报结束年度筛选条件。 */
/** 协会评优申报结束年度筛选条件。 */
private String applyEndYear;
private Boolean giveMoney;
private Integer radioType;
@@ -30,14 +30,14 @@ public interface ClubPayRecordService extends BaseService<ClubPayRecord> {
void prepareSnapshots(List<ClubPayRecord> records);
/** 2026年10月3日 09:51:00;操作人:wxg:设置缴费状态并保存拨付结果及日志。
* @param ids 非空缴费记录ID数组;只允许操作当前用户授权社团的记录
* @param ids 非空缴费记录ID数组;只允许操作当前用户授权协会的记录
* @param payed true已缴费、false未缴费,不能为空
* @return void;参数错误或记录不在授权范围时抛出异常,事务回滚
*/
void updatePayStatus(String[] ids, Boolean payed);
/** 2026年10月3日 09:51:00;操作人:wxg:退会后将该用户在指定社团的各年度缴费记录置为不拨付。
* @param clubId 退会社团ID,不能为空
/** 2026年10月3日 09:51:00;操作人:wxg:退会后将该用户在指定协会的各年度缴费记录置为不拨付。
* @param clubId 退会协会ID,不能为空
* @param userId 退会用户ID,不能为空
* @return void;保留缴费状态和人员快照,仅更新 isGiveMoney
*/
@@ -50,24 +50,24 @@ public interface ClubPayRecordService extends BaseService<ClubPayRecord> {
*/
int generateYearPayRecords(Integer year);
/** 返回当前用户可查询的社团选项,每项包含 id、clubName、clubCode;无授权社团时返回空列表。 */
/** 返回当前用户可查询的协会选项,每项包含 id、clubName、clubCode;无授权协会时返回空列表。 */
List<NutMap> getPayManageClubList();
/**
* 按权限范围分页查询缴费记录,并按社团编号及缴费记录保存的加入时间排序。
* 按权限范围分页查询缴费记录,并按协会编号及缴费记录保存的加入时间排序。
* @param pageForm 页码、每页条数及姓名/工号关键字
* @param year 缴费年度,空值表示不限制
* @param clubId 社团ID,空值表示查询全部授权社团
* @param clubId 协会ID,空值表示查询全部授权协会
* @param payed 缴费状态:1已缴费、0未缴费、空值不限
* @param assign 保存的拨付状态:1拨付、0不拨付、空值不限
* 2026年10月3日 14:33:18;操作人:wxg:在分页前按实时会员关系筛选,历史年度也使用当前会员状态。
* @param memberState 1在会、0退会、null不限;在会以同一 clubId/userId 存在 club_user 记录为准
* @return 分页记录,list 包含缴费字段、社团及人员信息、applyTime(保存的入会时间)与 assign(isGiveMoney 保存值转换为布尔值)
* @return 分页记录,list 包含缴费字段、协会及人员信息、applyTime(保存的入会时间)与 assign(isGiveMoney 保存值转换为布尔值)
*/
Pagination pageData(PageForm pageForm, Integer year, String clubId, Integer payed, Integer assign, Integer memberState);
/**
* 获取社团成员是否拨付
* 获取协会成员是否拨付
* @param userId
* @param clubId
*/
@@ -48,17 +48,17 @@ public class ClubRegisterImportService {
String name = values[0];
String code = values[1];
if (StrUtil.isBlank(name)) {
throw new IllegalArgumentException("社团名称不能为空");
throw new IllegalArgumentException("协会名称不能为空");
}
if (dao.count(SysClub.class, Cnd.where("clubName", "=", name)) > 0
|| (StrUtil.isNotBlank(code) && dao.count(SysClub.class, Cnd.where("clubCode", "=", code)) > 0)) {
return NutMap.NEW().addv("status", "跳过").addv("message", "社团名称或编码已存在,保留原记录(含草稿、审批中及已解散社团)");
return NutMap.NEW().addv("status", "跳过").addv("message", "协会名称或编码已存在,保留原记录(含草稿、审批中及已解散协会)");
}
if (name.length() > 100 || code.length() > 100) {
throw new IllegalArgumentException("社团名称和编码不能超过100个字符");
throw new IllegalArgumentException("协会名称和编码不能超过100个字符");
}
if (sysDictService.getSubListByCode("CLUB_REGISTER_TYPE").stream().noneMatch(item -> values[2].equals(item.getCode()))) {
throw new IllegalArgumentException("请选择类型对照表中的社团类型编码");
throw new IllegalArgumentException("请选择类型对照表中的协会类型编码");
}
try {
LocalDate.parse(values[3]);
@@ -82,7 +82,7 @@ public class ClubRegisterImportService {
}
ProcessDefine define = dao.fetch(ProcessDefine.class, Cnd.where("name", "=", "XHZC").and("state", "=", 1).desc("version"));
if (define == null) {
throw new IllegalArgumentException("未配置可用的社团注册定义,无法记录直接通过状态");
throw new IllegalArgumentException("未配置可用的协会注册定义,无法记录直接通过状态");
}
if (StrUtil.isBlank(code)) {
int sequence = dao.count(SysClub.class, Cnd.where("year(createTime)", "=", DateUtil.thisYear())) + 1;
@@ -116,19 +116,19 @@ public class ClubRegisterImportService {
club.setManageFile(files(values[18]));
club.setYearPlanFile(files(values[19]));
club.setFiles(files(values[20]));
// 复用单个注册:社团、发起人、理事会员资料及入会时间、年度缴费记录和快照。
// 复用单个注册:协会、发起人、理事会员资料及入会时间、年度缴费记录和快照。
sysClubService.doAdd(club, managers);
// 与注册通过后的角色授权一致,但不启动流程或创建审批任务。
for (NutMap manager : managers) {
Sys_role role = sysRoleService.getByCode(manager.getString("roleCode"));
if (role == null) throw new IllegalArgumentException("社团角色不存在:" + manager.getString("roleCode"));
if (role == null) throw new IllegalArgumentException("协会角色不存在:" + manager.getString("roleCode"));
Sys_user_role relation = new Sys_user_role();
relation.setUserId(manager.getString("userId"));
relation.setRoleId(role.getId());
relation.setClubId(club.getId());
dao.insert(relation);
}
// 现有社团查询通过已完成实例识别有效社团;保留可追溯的管理员直接通过记录。
// 现有协会查询通过已完成实例识别有效协会;保留可追溯的管理员直接通过记录。
ProcessInstance instance = new ProcessInstance();
instance.setProcessDefineId(define.getId());
instance.setBusinessNo(club.getId());
@@ -148,7 +148,7 @@ public class ClubRegisterImportService {
List<String> names = split(text);
if (required && names.size() != 1) throw new IllegalArgumentException("会长、秘书长各需填写1名人员工号");
if (!names.isEmpty() && sysRoleService.getByCode(roleCode) == null) {
throw new IllegalArgumentException("系统未配置社团角色:" + roleCode);
throw new IllegalArgumentException("系统未配置协会角色:" + roleCode);
}
for (String name : names) {
Sys_user user = findUser(name);
@@ -21,27 +21,27 @@ public interface ClubUserJoinService extends BaseService<ClubUserApply> {
/**
* 构造退会申请数据。
* 当用户没有历史入会申请记录时,使用当前社团成员关系和人员基础信息兜底生成一份退会申请,
* 以保证会长等通过社团注册直接入会的人员也能正常发起退会流程。
* 当用户没有历史入会申请记录时,使用当前协会成员关系和人员基础信息兜底生成一份退会申请,
* 以保证会长等通过协会注册直接入会的人员也能正常发起退会流程。
*
* @param clubId 社团ID
* @param clubId 协会ID
* @param userId 用户ID
* @return 退会申请对象,不存在当前成员关系时返回null
*/
ClubUserApply buildExitApply(String clubId, String userId);
/**
* 获取社团成员的入会时间,优先取当前 club_user.joinTime。
* 旧会员关系尚无入会时间时,保留历史申请及社团创办时间的原有回退规则。
* 获取协会成员的入会时间,优先取当前 club_user.joinTime。
* 旧会员关系尚无入会时间时,保留历史申请及协会创办时间的原有回退规则。
*
* @param clubId 社团ID
* @param clubId 协会ID
* @param userId 用户ID
* @return 入会时间
*/
java.util.Date resolveJoinTime(String clubId, String userId);
/**
* 校验当前用户是否满足申请加入社团的资格。
* 校验当前用户是否满足申请加入协会的资格。
*
* @param userId 用户ID
* @return 校验不通过时返回提示语,通过时返回null
@@ -17,7 +17,7 @@ public interface SysClubExamineService extends BaseService<SysClubExamineRegiste
// /**
// * 按会员入会、退休、退会时间统计指定年度的在职和退休人数变化。
// *
// * @param clubId 社团ID
// * @param clubId 协会ID
// * @param year 统计年度
// * @return 在职和退休人员的年初、增加、减少、年末人数
// */
@@ -26,7 +26,7 @@ public interface SysClubExamineService extends BaseService<SysClubExamineRegiste
//
/**
* 2026年10月2日22:00点开始新开发的代码;实际整改:2026年10月3日 10:14:04;操作人:wxg。
* @param clubId 所选社团ID,不能为空
* @param clubId 所选协会ID,不能为空
* @param year 所选公历年度,1至9998;按该年1月1日至下一年1月1日左闭右开统计
* @return 两类人员计数列表:yearFirstNum年初、yearAddNum增加、yearReduceNum减少、thisYearNum公式年末;
* personType为类别,userState仅兼容已有查看页标签;statisticsWarnings为核查提示,
@@ -25,7 +25,7 @@ public interface SysClubInfoManageService extends BaseService<ClubCommonPageVo>
/**
* 修改时间:2026年10月2日 23:06:55;操作人:wxg。
* 当前会员查询前,用已完成 WF 入会流程的最近一次会长同意审核时间补齐空入会时间。
* @param pageForm clubId 为选中社团ID;radioType=4 查历史成员且不补齐,其他值查当前会员;
* @param pageForm clubId 为选中协会ID;radioType=4 查历史成员且不补齐,其他值查当前会员;
* 姓名/工号、人员类型、在职状态、入会日期范围及分页排序参数用于列表筛选
* @return 会员分页对象,list 中 joinTime 为会员关系保存的入会时间;历史成员仍取申请表时间
*/
@@ -38,7 +38,7 @@ public interface SysClubInfoManageService extends BaseService<ClubCommonPageVo>
ClubUserJoinVo exitManageInfo(String id);
/**
* 管理端直接退会,同时新增系统处理记录并清理当前社团会员关系及角色关联。
* 管理端直接退会,同时新增系统处理记录并清理当前协会会员关系及角色关联。
* @param membershipId club_user 的会员关系ID,不是用户ID或申请ID
* @return void;会员关系不存在或已退会时抛出异常,事务回滚
*/
@@ -24,8 +24,8 @@ import java.util.List;
public interface SysClubService extends BaseService<SysClub> {
/**
* 获取入会申请的社团下拉选项,供 PC 与 H5 共用。
* @return 存在已完成 WF 流程的社团列表,每项为 SysClub,包含 id、clubName 等社团字段;同一社团只返回一次
* 获取入会申请的协会下拉选项,供 PC 与 H5 共用。
* @return 存在已完成 WF 流程的协会列表,每项为 SysClub,包含 id、clubName 等协会字段;同一协会只返回一次
*/
List<SysClub> listJoinClubOptions();
@@ -19,7 +19,7 @@ public interface SysClubUserService extends BaseService<ClubUser> {
/**
* 为直接新增的会员关系设置本批次的后端确认时间,不覆盖已有入会时间。
* @param members 手工录入、导入或社团创建时直接新增的会员关系;不得传入审核入会记录
* @param members 手工录入、导入或协会创建时直接新增的会员关系;不得传入审核入会记录
* @return void;仅填写列表内 joinTime 为空的对象,由调用方在同一事务中保存
*/
void prepareDirectJoinTimes(List<ClubUser> members);
@@ -114,11 +114,11 @@ public class ClubPayRecordServiceImpl extends BaseServiceImpl<ClubPayRecord> imp
if (records == null || records.isEmpty()) {
return;
}
// 新增记录须明确所属年度、社团和人员,避免缺失参数形成不受限制的批量查询。
// 新增记录须明确所属年度、协会和人员,避免缺失参数形成不受限制的批量查询。
for (ClubPayRecord record : records) {
if (record == null || record.getYear() == null || record.getYear() < 1 || record.getYear() > 9998
|| StrUtil.isBlank(record.getClubId()) || StrUtil.isBlank(record.getUserId())) {
throw new IllegalArgumentException("缴费记录必须提供有效年度、社团和用户");
throw new IllegalArgumentException("缴费记录必须提供有效年度、协会和用户");
}
}
List<String> userIds = records.stream().map(ClubPayRecord::getUserId).distinct().toList();
@@ -193,15 +193,15 @@ public class ClubPayRecordServiceImpl extends BaseServiceImpl<ClubPayRecord> imp
return records.size();
}
/** 校工会社团管理员与系统管理员可查看全部社团缴费记录。 */
/** 校工会协会管理员与系统管理员可查看全部协会缴费记录。 */
private boolean canManageAllPayClubs() {
return AuthUtil.hasRoleOr(RoleConstant.SYSADMIN.name(), RoleConstant.SCHOOL_UNION_CLUB_ADMIN.name());
}
/** 普通菜单授权用户仅能查看其有效角色关联的社团;无关联时显式返回空范围。 */
/** 普通菜单授权用户仅能查看其有效角色关联的协会;无关联时显式返回空范围。 */
private void addPayClubScope(Cnd cnd, String clubField) {
if (!canManageAllPayClubs()) {
// 用户ID使用 SQL 参数绑定,社团集合交给 Cnd 处理,避免空集合被可选条件忽略。
// 用户ID使用 SQL 参数绑定,协会集合交给 Cnd 处理,避免空集合被可选条件忽略。
Sql scopeSql = Sqls.create("""
SELECT DISTINCT ur.clubId FROM sys_user_role ur
INNER JOIN sys_role r ON r.id = ur.roleId AND r.disabled = false
@@ -246,7 +246,7 @@ public class ClubPayRecordServiceImpl extends BaseServiceImpl<ClubPayRecord> imp
addPayClubScope(cnd, "cpr.clubId");
cnd.andEX("cpr.payed", "=", payed);
// 在分页前筛选,保证总条数及页数准确;EXISTS 不会因重复会员关系增加缴费记录条数。
// 与列表 count 标签一致,只看该人员在该社团的当前关系,不依赖退会申请或缴费记录年份。
// 与列表 count 标签一致,只看该人员在该协会的当前关系,不依赖退会申请或缴费记录年份。
if (memberState != null) {
String membershipExists = "EXISTS (SELECT 1 FROM club_user membership "
+ "WHERE membership.clubId = cpr.clubId AND membership.userId = cpr.userId)";
@@ -263,7 +263,7 @@ public class ClubPayRecordServiceImpl extends BaseServiceImpl<ClubPayRecord> imp
cnd.and(new Static("(" + ASSIGNED_SQL + ") = " + (assign == 0 ? 0 : 1)));
}
// 全社团管理角色先按社团编号分组;普通角色仅在授权社团内按加入时间倒序。
// 全协会管理角色先按协会编号分组;普通角色仅在授权协会内按加入时间倒序。
if (canManageAllPayClubs()) {
cnd.asc("c.clubCode");
cnd.asc("c.id");
@@ -336,7 +336,7 @@ public class ClubPayRecordServiceImpl extends BaseServiceImpl<ClubPayRecord> imp
public void disableExitMemberPayment(String clubId, String userId) {
// 2026年10月3日 09:51:00;操作人:wxg:退会影响实时会员关系对应的各年度名单,保留原缴费状态。
if (StrUtil.isBlank(clubId) || StrUtil.isBlank(userId)) {
throw new IllegalArgumentException("退会社团和用户不能为空");
throw new IllegalArgumentException("退会协会和用户不能为空");
}
Sql sql = Sqls.create("UPDATE club_pay_record SET isGiveMoney = false WHERE clubId = @clubId AND userId = @userId");
sql.setParam("clubId", clubId);
@@ -108,7 +108,7 @@ public class ClubUserJoinServiceImpl extends BaseServiceImpl<ClubUserApply> impl
return latestApply;
}
// 对于会长等注册社团时直接入会的人员,没有申请记录时从当前成员信息兜底生成退会申请。
// 对于会长等注册协会时直接入会的人员,没有申请记录时从当前成员信息兜底生成退会申请。
ClubUser clubUser = currentMember;
if (clubUser == null) {
return null;
@@ -140,7 +140,7 @@ public class SysClubExamineServiceImpl extends BaseServiceImpl<SysClubExamineReg
// .setParam("clubId", clubId);
// List<NutMap> applications = listMap(applySql);
// if (!applications.isEmpty()) {
// // 流程状态改为按当前社团申请批量查询,避免相关子查询对流程实例表重复扫描。
// // 流程状态改为按当前协会申请批量查询,避免相关子查询对流程实例表重复扫描。
// List<String> applicationIds = applications.stream()
// .map(application -> application.getString("id"))
// .filter(StrUtil::isNotBlank)
@@ -313,14 +313,14 @@ public class SysClubExamineServiceImpl extends BaseServiceImpl<SysClubExamineReg
@Override
public List<NutMap> getClubUserNum(String clubId, Integer year) {
if (StrUtil.isBlank(clubId) || year == null || year < 1 || year > 9998) {
throw new IllegalArgumentException("请选择有效社团和统计年度");
throw new IllegalArgumentException("请选择有效协会和统计年度");
}
MemberChangeStatistics stats = new MemberChangeStatistics(year);
// 年初基数来自当年名单,不受缴费、拨付或当前退会状态影响;同一会员按 userId 去重。
List<NutMap> roster = listMap(Sqls.create("SELECT userId, joinTime, personType, retireDate, operateLogs FROM club_pay_record WHERE clubId = @clubId AND year = @year")
.setParam("clubId", clubId).setParam("year", year));
if (roster.isEmpty()) {
stats.invalidate(year + "年度该社团没有缴费名单,请检查年度名单生成计划任务及名单数据,不能将缺失名单视为年初零人。");
stats.invalidate(year + "年度该协会没有缴费名单,请检查年度名单生成计划任务及名单数据,不能将缺失名单视为年初零人。");
return stats.result();
}
boolean generated = roster.stream().anyMatch(row -> {
@@ -328,7 +328,7 @@ public class SysClubExamineServiceImpl extends BaseServiceImpl<SysClubExamineReg
return logs != null && logs.contains("缴费管理-定时任务自动设置");
});
if (!generated) {
stats.warnings.add("未发现该社团年度名单的定时生成记录,请检查计划任务及名单完整性;手工入会记录不能证明年度名单已完整生成。");
stats.warnings.add("未发现该协会年度名单的定时生成记录,请检查计划任务及名单完整性;手工入会记录不能证明年度名单已完整生成。");
}
Map<String, NutMap> snapshots = new java.util.LinkedHashMap<>();
Map<String, AnnualMemberPeriod> periods = new java.util.LinkedHashMap<>();
@@ -378,7 +378,7 @@ public class SysClubExamineServiceImpl extends BaseServiceImpl<SysClubExamineReg
if (member.getTime("joinTime") == null) {
if (!snapshots.containsKey(member.getString("userId"))) stats.invalidate("当前会员存在加入时间缺失,无法确定年度增加,请核查。");
} else {
// 手工录入、导入和成立社团时加入的成员没有 mode=1,也需要计入可靠的年度增加。
// 手工录入、导入和成立协会时加入的成员没有 mode=1,也需要计入可靠的年度增加。
addAnnualPeriod(periods, member.getString("userId"), member.getTime("joinTime"), stats);
}
}
@@ -549,7 +549,7 @@ public class SysClubExamineServiceImpl extends BaseServiceImpl<SysClubExamineReg
@Override
public List<NutMap> getJgUser(String clubId) {
// 构建社团成员查询SQL,理事机构成员优先展示,普通成员随后展示。
// 构建协会成员查询SQL,理事机构成员优先展示,普通成员随后展示。
Sql sql = Sqls.create("""
SELECT
cl.*,
@@ -638,13 +638,13 @@ public class SysClubExamineServiceImpl extends BaseServiceImpl<SysClubExamineReg
@Override
public Pagination<ClubExaminePageVo> minePageData(ClubUserPageForm pageForm) {
Cnd cnd = Cnd.NEW();
// 非系统管理员,仅查询自己管理的社团(空集合判断避免in查询异常)
// 非系统管理员,仅查询自己管理的协会(空集合判断避免in查询异常)
if (!AuthUtil.hasRole(RoleConstant.SYSADMIN.name())) {
List<SysClub> myManageClub = sysClubService.getMyManageClub();
if (!Lang.isEmpty(myManageClub)) {
cnd.and("info.clubId", "in", myManageClub.stream().map(SysClub::getId).collect(Collectors.toList()));
} else {
// 无管理社团,返回空分页结果
// 无管理协会,返回空分页结果
return new Pagination<>(pageForm.getPageNumber(), pageForm.getPageSize(), 0, new ArrayList<>());
}
}
@@ -719,7 +719,7 @@ public class SysClubExamineServiceImpl extends BaseServiceImpl<SysClubExamineReg
@Override
public ClubExamineVo findOne(String id) {
// 构建单条考核登记查询SQL(关联社团、联系人信息)
// 构建单条考核登记查询SQL(关联协会、联系人信息)
Sql sql = Sqls.create("""
SELECT
scer.*,
@@ -750,7 +750,7 @@ public class SysClubExamineServiceImpl extends BaseServiceImpl<SysClubExamineReg
a.auditOpinion,
a.auditSign,
CASE
WHEN a.id = scer.clubAuditId THEN '社团审核'
WHEN a.id = scer.clubAuditId THEN '协会审核'
WHEN a.id = scer.clubLeaderAuditId THEN '会长审核'
WHEN a.id = scer.schoolAuditId THEN '校工会审核'
END AS auditName
@@ -982,7 +982,7 @@ public class SysClubExamineServiceImpl extends BaseServiceImpl<SysClubExamineReg
}
/**
* 构建分页查询基础条件(年度、社团ID)
* 构建分页查询基础条件(年度、协会ID)
* @param cnd 条件对象
* @param pageForm 分页参数
* @param tableAlias 表别名
@@ -207,7 +207,7 @@ public class SysClubInfoManageServiceImpl extends BaseServiceImpl<ClubCommonPage
/**
* 2026年10月3日 12:01:28;操作人:wxg:当前会员以 club_user 分页,查询期间不补齐或修改数据库。
* @param pageForm clubId 为选中社团ID;radioType=4 查历史成员,其他值查当前会员;
* @param pageForm clubId 为选中协会ID;radioType=4 查历史成员,其他值查当前会员;
* searchKeyword 匹配会员表姓名/工号,personType/userState 筛选当前用户资料;
* focusMembers=true 同时筛选当前人员类型为自聘人员或其他的会员,false/空值不限制;
* joinDateStart/joinDateEnd 为 yyyy-MM-dd,pageNumber/pageSize 为分页参数,排序只允许列表字段
@@ -219,7 +219,7 @@ public class SysClubInfoManageServiceImpl extends BaseServiceImpl<ClubCommonPage
return historyMemberPageData(pageForm);
}
if (StrUtil.isBlank(pageForm.getClubId())) {
throw new IllegalArgumentException("请选择社团后查询会员信息");
throw new IllegalArgumentException("请选择协会后查询会员信息");
}
// 姓名、工号、电话及入会时间使用持久化字段;列排序需要其他资料时才关联用户表。
Map<String, String> sortColumns = Map.of(
@@ -242,7 +242,7 @@ public class SysClubInfoManageServiceImpl extends BaseServiceImpl<ClubCommonPage
sql.setVar("userJoin", needsUnitSort ? "LEFT JOIN vw_user u ON u.id = scu.userId"
: needsUser ? "LEFT JOIN sys_user u ON u.id = scu.userId" : "");
Cnd cnd = Cnd.where("scu.clubId", "=", pageForm.getClubId());
// 在分页和总数统计前同时筛选两类人员,保持当前社团及其他查询条件的限制。
// 在分页和总数统计前同时筛选两类人员,保持当前协会及其他查询条件的限制。
if (Boolean.TRUE.equals(pageForm.getFocusMembers())) {
cnd.and("u.personType", "in", List.of("自聘人员", "其他"));
}
@@ -290,7 +290,7 @@ public class SysClubInfoManageServiceImpl extends BaseServiceImpl<ClubCommonPage
/**
* 2026年10月3日 12:01:28;操作人:wxg:分页后批量获取本页其他资料,避免把完整用户视图带入默认统计和分页。
* @param members 当前页会员关系;空页不查询,姓名/工号/电话/入会时间始终保留会员表值
* @param clubId 当前选中社团ID,用于补充社团名称
* @param clubId 当前选中协会ID,用于补充协会名称
*/
private void fillMemberPageDetails(List<ClubUserCommonPageVo> members, String clubId) {
if (members.isEmpty()) return;
@@ -322,8 +322,8 @@ public class SysClubInfoManageServiceImpl extends BaseServiceImpl<ClubCommonPage
}
/**
* 当前社团历史退会记录分页;每次退会保留一行,不按人员去重,也不要求关联 WF 已完成流程。
* @param pageForm clubId 为当前社团ID;姓名/工号、人员类型、在职状态及 yyyy-MM-dd 入会日期范围为可选筛选;
* 当前协会历史退会记录分页;每次退会保留一行,不按人员去重,也不要求关联 WF 已完成流程。
* @param pageForm clubId 为当前协会ID;姓名/工号、人员类型、在职状态及 yyyy-MM-dd 入会日期范围为可选筛选;
* focusMembers=true 筛选当前人员类型为自聘人员或其他的历史成员,false/空值不限制;
* pageNumber/pageSize 为分页参数,pageOrderName/pageOrderBy 为列排序参数
* @return 会员展示分页对象;id 为申请ID,joinTime/exitTime 来自申请,人员资料取用户视图当前值
@@ -493,7 +493,7 @@ public class SysClubInfoManageServiceImpl extends BaseServiceImpl<ClubCommonPage
* 退会申请审批完成后会删除club_user成员关系,因此退会管理以退会申请记录为主数据源。
* 同时保留旧sys_club_user表中已退会的数据,避免历史直接移出记录无法查询。
* 2026年10月3日 19:42:45;操作人:wxg:mode=2 为系统处理,无需 WF;mode=0 通过 EXISTS 判断 WF 完成,避免一对多重复。
* 同一用户、社团存在以上申请时不再重复展示旧历史表记录;每条申请仍独立保留,列表与详情共用。
* 同一用户、协会存在以上申请时不再重复展示旧历史表记录;每条申请仍独立保留,列表与详情共用。
*
* @return 退会管理列表和详情共用的数据来源SQL
*/
@@ -597,7 +597,7 @@ public class SysClubInfoManageServiceImpl extends BaseServiceImpl<ClubCommonPage
NutMap nutMap = NutMap.NEW();
nutMap.put("id", "0");
nutMap.put("clubName", Globals.AppName);
// 社团管理树只按社团编号展示,避免影响公共社团列表的原有排序。
// 协会管理树只按协会编号展示,避免影响公共协会列表的原有排序。
List<SysClub> clubList = sysClubService.getMyManageClub().stream()
.sorted(Comparator.comparing(SysClub::getClubCode, Comparator.nullsLast(String::compareTo)))
.toList();
@@ -608,7 +608,7 @@ public class SysClubInfoManageServiceImpl extends BaseServiceImpl<ClubCommonPage
/**
* 按现有成员排序渲染 clubRegis Word 模板,模板读取为空时提前阻止解析及下载。
* @param clubId 当前选中社团ID,登记表包含该社团资料和成员信息
* @param clubId 当前选中协会ID,登记表包含该协会资料和成员信息
* @param response 写入生成的 DOCX 附件;模板或渲染失败时抛出中文业务异常
* @return void,文件内容通过响应输出,错误结果由统一异常处理返回
*/
@@ -687,17 +687,17 @@ public class SysClubInfoManageServiceImpl extends BaseServiceImpl<ClubCommonPage
// 文件存储读取失败会返回空内容,先校验再交给 POI,避免显示英文 EmptyFileException。
byte[] templateBytes = templateStream == null ? new byte[0] : templateStream.readAllBytes();
if (templateBytes.length == 0) {
throw new BaseException("社团登记表模板读取失败,请检查模板文件及文件存储服务。");
throw new BaseException("协会登记表模板读取失败,请检查模板文件及文件存储服务。");
}
XWPFTemplate.compile(new ByteArrayInputStream(templateBytes), config).render(docData).writeAndClose(byteArrayOutputStream);
CommonDownloadUtil.download("教职工文体社团登记表(" + clubInfo.getString("clubName") + ").docx", byteArrayOutputStream.toByteArray(), response);
CommonDownloadUtil.download("教职工文体协会登记表(" + clubInfo.getString("clubName") + ").docx", byteArrayOutputStream.toByteArray(), response);
} catch (BaseException e) {
// 保留模板配置及空文件校验的具体提示,同时记录完整异常以便排查。
log.error("社团登记表导出失败,id:{}", clubId, e);
log.error("协会登记表导出失败,id:{}", clubId, e);
throw e;
} catch (IOException | RuntimeException e) {
log.error("社团登记表导出失败,id:{}", clubId, e);
throw new BaseException("社团登记表生成失败,请检查模板是否为有效的 Word 文件或联系管理员。");
log.error("协会登记表导出失败,id:{}", clubId, e);
throw new BaseException("协会登记表生成失败,请检查模板是否为有效的 Word 文件或联系管理员。");
}
}
}
@@ -72,7 +72,7 @@ public class SysClubServiceImpl extends BaseServiceImpl<SysClub> implements SysC
@Override
public List<SysClub> listJoinClubOptions() {
// 注册、换届等流程可能使用同一社团ID作为业务号;仅判断流程存在,避免联表将社团重复返回。
// 注册、换届等流程可能使用同一协会ID作为业务号;仅判断流程存在,避免联表将协会重复返回。
Sql sql = Sqls.create("""
SELECT c.*
FROM sys_club c
@@ -100,7 +100,7 @@ public class SysClubServiceImpl extends BaseServiceImpl<SysClub> implements SysC
LEFT JOIN sys_user u on club.concatPerson = u.id
$condition
""").setParam("userId", SecurityUtil.getUserId());
// 同一社团可能关联注册、换届等多个已完成 WF 流程;仅检查流程存在,避免列表和分页总数重复。
// 同一协会可能关联注册、换届等多个已完成 WF 流程;仅检查流程存在,避免列表和分页总数重复。
cnd.and(new Static("EXISTS (SELECT 1 FROM wf_process_instance ins WHERE ins.businessNo = club.id AND ins.state = %s)"
.formatted(ProcessInstanceStateEnum.FINISHED.getCode())));
sql.setCondition(cnd);
@@ -112,7 +112,7 @@ public class SysClubServiceImpl extends BaseServiceImpl<SysClub> implements SysC
if (StrUtil.isBlank(clubId)) {
return new ClubRegisterVo();
}
// 与社团列表保持一致,按社团成员角色汇总会长、秘书长姓名,避免多名任职人员导致详情记录重复。
// 与协会列表保持一致,按协会成员角色汇总会长、秘书长姓名,避免多名任职人员导致详情记录重复。
Sql sql = Sqls.create("""
SELECT
club.*,
@@ -225,12 +225,12 @@ public class SysClubServiceImpl extends BaseServiceImpl<SysClub> implements SysC
log.set("operatorUserId", SecurityUtil.getUserId());
log.set("operatorUserName", SecurityUtil.getUserUsername());
log.set("operatorTime", DateUtil.now());
log.set("operatorType", "社团创建");
log.set("operatorType", "协会创建");
log.set("oldValue", null);
log.set("newValue", false);
record.setOperateLogs(List.of(log));
// 2026年10月3日 09:05:37;操作人:wxg:社团创建直接入会的成员同样保存缴费快照。
// 2026年10月3日 09:05:37;操作人:wxg:协会创建直接入会的成员同样保存缴费快照。
payRecordService.prepareSnapshots(List.of(record));
dao().insert(record);
}
@@ -242,7 +242,7 @@ public class SysClubServiceImpl extends BaseServiceImpl<SysClub> implements SysC
@Override
@Aop(TransAop.READ_COMMITTED)
public SysClub doEdit(SysClub club, List<String> deleteIds, List<NutMap> managePerson) {
// 修改社团表
// 修改协会表
dao().update(club);
// 修改发起人表
dao().clear(SysClubSponsor.class, Cnd.where("clubId", "=", club.getId()));
@@ -264,7 +264,7 @@ public class SysClubServiceImpl extends BaseServiceImpl<SysClub> implements SysC
.filter(member -> java.util.Objects.equals(member.getUserId(), clubUser.getUserId()))
.findFirst()
.ifPresent(member -> {
// 2026年10月3日 12:01:28;操作人:wxg:编辑社团重建既有会员关系时保留原入会时间及人员资料。
// 2026年10月3日 12:01:28;操作人:wxg:编辑协会重建既有会员关系时保留原入会时间及人员资料。
clubUser.setJoinTime(member.getJoinTime());
clubUser.setUserName(member.getUserName());
clubUser.setLoginName(member.getLoginName());
@@ -323,7 +323,7 @@ public class SysClubServiceImpl extends BaseServiceImpl<SysClub> implements SysC
}
cnd.andEX("year(info.createTime)", "=", pageForm.getYear());
cnd.and("info.userId", "=", SecurityUtil.getUserId());
// 我的注册列表默认按社团编码升序展示,点击表头时按用户选择的方向排序。
// 我的注册列表默认按协会编码升序展示,点击表头时按用户选择的方向排序。
if (StrUtil.isAllBlank(pageForm.getPageOrderName(), pageForm.getPageOrderBy())) {
cnd.asc("info.clubCode");
} else if ("clubCode".equals(pageForm.getPageOrderName())) {
@@ -229,7 +229,7 @@ public class SysClubUserServiceImpl extends BaseServiceImpl<ClubUser> implements
@Override
public void clubUser2Scope(String clubId, List<String> users) {
// 添加社团成员,需要增加到品牌活动的组别去,wcnm
// 添加协会成员,需要增加到品牌活动的组别去,wcnm
List<TrainSignUpActivity> list = dao().query(TrainSignUpActivity.class, Cnd.NEW());
List<TrainSignUpActivity> activityList = new ArrayList<>();
for (TrainSignUpActivity activity : list) {
@@ -17,9 +17,9 @@ public class ClubEvaluatePageVo {
private String foundTime;
private String typeName;
private Date applyTime;
/** 社团评优申报开始年度。 */
/** 协会评优申报开始年度。 */
private String applyStartYear;
/** 社团评优申报结束年度。 */
/** 协会评优申报结束年度。 */
private String applyEndYear;
private String instanceId;
@@ -101,14 +101,14 @@ public class ArticleAnalysisController {
.trend(null)
.build());
// 获取参与社团数量
// 获取参与协会数量
Sql clubCountSql = Sqls.create("SELECT COUNT(distinct clubId) FROM article $condition");
Cnd clubCountCondition = buildStatisticsCondition(startDate, endDate, unionId, clubId);
clubCountCondition.and("clubId", "IS NOT", null);
clubCountSql.setCondition(clubCountCondition);
long clubCount = articleService.count(clubCountSql);
list.add(ArticleAnalysisOverviewVO.builder()
.label("参与社团")
.label("参与协会")
.value(clubCount)
.icon("el-icon-office-building")
.bgColor("rgba(230, 162, 60, 0.1)")
@@ -118,7 +118,7 @@ public class ArticleAnalysisController {
}
/**
* 构建概览统计的筛选条件,与图表接口保持相同的时间范围、分工会和社团口径。
* 构建概览统计的筛选条件,与图表接口保持相同的时间范围、分工会和协会口径。
*/
private Cnd buildStatisticsCondition(Date startDate, Date endDate, String unionId, String clubId) {
Cnd cnd = Cnd.NEW();
@@ -148,7 +148,7 @@ public class ArticleAnalysisController {
@At
@SaCheckPermission("article.analysis")
@ApiOperation(value = "社团投稿分布")
@ApiOperation(value = "协会投稿分布")
public Result clubDistribution(Date startDate, Date endDate, String unionId, String clubId) {
List<NutMap> clubDistribution = articleAnalysisService.getClubDistribution(startDate, endDate, unionId, clubId);
return Result.success(clubDistribution);
@@ -41,7 +41,7 @@ import java.util.Map;
@IocBean
@At("/platform/article/clubApproval")
@Api("新闻投稿社团审核")
@Api("新闻投稿协会审核")
@Ok("json:full")
public class ArticleClubApprovalController {
@Inject
@@ -140,7 +140,7 @@ public class ArticleFirstExamineController {
} else if (result.equals("BACK_TO_CLUB")) {
String branchClubApprovalLoginName = commonService.findUserLoginNameByRoleCode(RoleConstant.CLUB_PRESIDENT, Cnd.where(Sys_user_role::getClubId, "=", article.getClubId()));
if (StrUtil.isBlank(branchClubApprovalLoginName)) {
return Result.error("社团未配置审批人,请联系社团!");
return Result.error("协会未配置审批人,请联系协会!");
}
assignments.add(branchClubApprovalLoginName);
} else if (result.equals("PASS")) {
@@ -135,7 +135,7 @@ public class ArticleWriteController {
roles.add("ARTICLE_ORIGIN_UNION");
}
//查询自己所加入的社团
//查询自己所加入的协会
List<ClubUser> clubUsers = dao.query(ClubUser.class, Cnd.where(ClubUser::getUserId, "=", SecurityUtil.getUserId()));
if (!clubUsers.isEmpty()) {
roles.add("ARTICLE_ORIGIN_CLUB");
@@ -75,12 +75,12 @@ public class Article extends BaseModel {
private String unitName;
@Column
@Comment("社团名称")
@Comment("协会名称")
@ColDefine(type = ColType.VARCHAR, width = 100)
private String clubName;
@Column
@Comment("社团id")
@Comment("协会id")
@ColDefine(type = ColType.VARCHAR, width = 32)
private String clubId;
@@ -23,7 +23,7 @@ public class ArticleInfoPageParam extends PageForm {
@ApiModelProperty("单位")
private String unitId;
@ApiModelProperty("社团")
@ApiModelProperty("协会")
private String clubId;
@ApiModelProperty("稿件来源")
@@ -21,7 +21,7 @@ public interface ArticleAnalysisService extends BaseService<Article> {
List<NutMap> getUnionDistribution(Date startDate, Date endDate, String unionId, String clubId);
/**
* 获取社团投稿分布
* 获取协会投稿分布
*/
List<NutMap> getClubDistribution(Date startDate, Date endDate, String unionId, String clubId);
@@ -69,7 +69,7 @@ public class ArticleAnalysisServiceImpl extends BaseServiceImpl<Article> impleme
}
/**
* 获取社团投稿分布
* 获取协会投稿分布
*/
@Override
public List<NutMap> getClubDistribution(Date startDate, Date endDate, String unionId, String clubId) {
@@ -96,7 +96,7 @@ public class ArticleAnalysisServiceImpl extends BaseServiceImpl<Article> impleme
* @param startDate 查询开始日期,为空时不限制开始时间
* @param endDate 查询结束日期,为空时不限制结束时间
* @param unionId 分工会 ID,为空时查询全部分工会
* @param clubId 社团 ID,为空时查询全部社团
* @param clubId 协会 ID,为空时查询全部协会
* @return 可直接设置到统计 SQL 的查询条件
*/
private Cnd buildStatisticsCondition(Date startDate, Date endDate, String unionId, String clubId) {
@@ -48,10 +48,10 @@ public class ArticleInfoPageVO extends BpmTaskApprovalVo {
@ApiModelProperty("投稿人单位")
private String unitName;
@ApiModelProperty("投稿人社团")
@ApiModelProperty("投稿人协会")
private String clubName;
@ApiModelProperty("投稿人社团ID")
@ApiModelProperty("投稿人协会ID")
private String clubId;
@ApiModelProperty("投稿时间")
@@ -133,7 +133,7 @@ public class UnionCareDataCon {
double totalBudgetMoney3 = mapList3.stream().mapToDouble(map -> map.getDouble("totalBudgetMoney")).sum();
list.add(new HashMap<String, Object>() {{
put("year", year);
put("type", "社团经费");
put("type", "协会经费");
put("value", totalBudgetMoney3);
}});
@@ -122,12 +122,12 @@ public class EvaluateApply extends BaseModel {
private String unionId;
@Column
@Comment("社团")
@Comment("协会")
@ColDefine(type = ColType.VARCHAR, width = 100)
private String clubName;
@Column
@Comment("社团ID")
@Comment("协会ID")
@ColDefine(type = ColType.VARCHAR, width = 32)
private String clubId;
@@ -137,7 +137,7 @@ public class EvaluateApply extends BaseModel {
private Date applyDateTime;
@Column
@Comment("是否社团类型的荣誉")
@Comment("是否协会类型的荣誉")
@ColDefine(type = ColType.BOOLEAN)
private Boolean isClub;
@@ -152,7 +152,7 @@ public class ActivityBudgetApplyController {
@At
@ApiOperation("查询社团,超级管理员查全部的")
@ApiOperation("查询协会,超级管理员查全部的")
@SaCheckLogin
public Result listClub(){
Cnd cnd = Cnd.NEW();
@@ -79,7 +79,7 @@ public class ActivityBudgetQueryStatisticsController {
entities.add(new ExcelExportEntity("分工会", "unionName", 20));
}else if (outlayManageSource.equals("ACTIVITY_BUDGET_TYPE_THREE")) {
entities.add(new ExcelExportEntity("编码", "clubCode", 20));
entities.add(new ExcelExportEntity("社团名称", "clubName", 20));
entities.add(new ExcelExportEntity("协会名称", "clubName", 20));
}
ExcelExportEntity draftCodeEntity = new ExcelExportEntity("预算金额", "totalBudgetMoney", 20);
draftCodeEntity.setType(10);
@@ -87,7 +87,7 @@ public class ActivityBudget extends BaseModel implements Serializable {
private String unionId;
@Column
@Comment("创建人所属社团")
@Comment("创建人所属协会")
@ColDefine(type = ColType.VARCHAR, width = 32)
private String clubId;
@@ -180,7 +180,7 @@ public class ActivityBudgetServiceImpl extends BaseServiceImpl<ActivityBudget> i
}
} else if (activityBudget.getOutlayManageSource().equals("ACTIVITY_BUDGET_TYPE_THREE")) {
//如果不等于校工会预算才往表里面加预算
//代表社团可能用的是校工会的预算
//代表协会可能用的是校工会的预算
if (!activityBudget.getIsSchoolBudget()) {
*//* jf_club jfClub = dao.fetch(jf_club.class, Cnd.where("year", "=", DateUtil.getYear())
.and("club_id", "=", activityBudget.getClubId()));
@@ -47,7 +47,7 @@ public class ActivityBudgetTemp extends ExcelImportError {
@ExcelProperty("审核意见")
private String auditOpinion;
@ExcelProperty("申报单位(仅社团申报时可在下拉菜单中选择,其他类型不用填写)")
@ExcelProperty("申报单位(仅协会申报时可在下拉菜单中选择,其他类型不用填写)")
private String helpUnitName;
@@ -38,7 +38,7 @@ import java.util.Objects;
@At("/platform/outlay/outlayManage/backHistory")
@Ok("json:full")
@Slf4j
@Api(tags = "社团经费查询")
@Api(tags = "协会经费查询")
public class OutlayManageClubBackHistoryController {
@@ -121,7 +121,7 @@ public class OutlayManageClubBackHistoryController {
exportEntities.add(new ExcelExportEntity("在职状态", "userState", 20));
exportEntities.add(new ExcelExportEntity("是否拨付", "isGiveMoney", 20));
exportEntities.add(new ExcelExportEntity("是否缴费", "payed", 20));
exportEntities.add(new ExcelExportEntity("所在社团", "clubName", 20));
exportEntities.add(new ExcelExportEntity("所在协会", "clubName", 20));
exportEntities.add(new ExcelExportEntity("身份", "roleName", 20));
try {
@@ -47,7 +47,7 @@ import java.util.stream.Collectors;
@At("/platform/outlay/outlayManage/clubManage")
@Ok("json:full")
@Slf4j
@Api(tags = "社团经费预算管理")
@Api(tags = "协会经费预算管理")
public class OutlayManageClubController {
@Inject
@@ -111,20 +111,20 @@ public class OutlayManageClubController {
@At
@ApiOperation("重置预算")
@SaCheckPermission("outlay.outlayManage.club.manage")
@SLog(tag = "社团预算分配", msg = "重置了预算分配的金额:${args[0]}")
@SLog(tag = "协会预算分配", msg = "重置了预算分配的金额:${args[0]}")
public Result resetOutlay(Integer year) {
int count = baseService.dao().clear(OutlayManageClub.class, Cnd.where("year", "=", year));
return Result.success(count);
}
/**
* 2026年10月3日 16:23:13;操作人:wxg:年度分配只委托 service,避免 WF 一对多关联造成重复社团预算。
* 2026年10月3日 16:23:13;操作人:wxg:年度分配只委托 service,避免 WF 一对多关联造成重复协会预算。
* 无业务参数,年度固定为系统当前年;返回 Result.success,新增及重复检查在同一事务完成。
*/
@At
@ApiOperation("下发预算")
@SaCheckPermission("outlay.outlayManage.club.manage")
@SLog(tag = "社团预算分配", msg = "根据申报的金额修改本年的预算预算")
@SLog(tag = "协会预算分配", msg = "根据申报的金额修改本年的预算预算")
@Aop(TransAop.READ_COMMITTED)
public Result issuedOutlay() {
clubQueryService.generateCurrentYearAllocation();
@@ -134,7 +134,7 @@ public class OutlayManageClubController {
@At
@ApiOperation("给没有核对的人发送核对提醒")
@SaCheckPermission("outlay.outlayManage.club.manage")
@SLog(tag = "社团预算分配", msg = "给没有核对的人发送核对提醒")
@SLog(tag = "协会预算分配", msg = "给没有核对的人发送核对提醒")
public Result doMsg() {
List<OutlayManageClub> manageClubList = baseService.dao().query(OutlayManageClub.class,
Cnd.where(OutlayManageClub::getYear, "=", DateUtil.thisYear())
@@ -46,13 +46,13 @@ import java.util.Objects;
/**
* @author zhf
* @date 2026/2/5 09:44
* @description 社团经费查询
* @description 协会经费查询
*/
@IocBean
@At("/platform/outlay/outlayManage/query")
@Ok("json:full")
@Slf4j
@Api(tags = "社团经费查询")
@Api(tags = "协会经费查询")
public class OutlayManageClubQueryController {
@Inject
@@ -81,7 +81,7 @@ public class OutlayManageClubQueryController {
""");
cnd.andEX("year", "=", year);
// if (!AuthUtil.hasRoleOr(RoleConstant.SYSADMIN.name(), RoleConstant.SCHOOL_UNION_ADMIN.name())) {
// 现逻辑:系统管理员、校工会社团管理员可查看全部社团分页数据,会长仅查看自己负责的社团。
// 现逻辑:系统管理员、校工会协会管理员可查看全部协会分页数据,会长仅查看自己负责的协会。
if (!AuthUtil.hasRoleOr(RoleConstant.SYSADMIN.name(), RoleConstant.SCHOOL_UNION_CLUB_ADMIN.name())) {
List<String> roleIds = sysRoleService.getRoleIdsByCode(List.of(RoleConstant.CLUB_PRESIDENT, RoleConstant.CLUB_SECRETARY));
List<Sys_user_role> userRoles = clubQueryService.dao().query(Sys_user_role.class,
@@ -98,15 +98,15 @@ public class OutlayManageClubQueryController {
}
/**
* 导出社团拨付核对汇总表。
* 导出协会拨付核对汇总表。
*
* @param year 统计年度,未传时默认当前年度
* @param clubId 社团主键,可为空;为空时导出当前用户权限范围内的全部社团
* @param clubId 协会主键,可为空;为空时导出当前用户权限范围内的全部协会
* @param response 下载响应,返回 XSSF Excel 文件流
*/
@At
@Ok("void")
@ApiOperation("导出社团拨付核对汇总表")
@ApiOperation("导出协会拨付核对汇总表")
@SaCheckPermission("outlay.outlayManage.club.query")
public void exportSummary(Integer year, String clubId, HttpServletResponse response) {
clubQueryService.exportSummary(year, clubId, response);
@@ -116,7 +116,7 @@ public class OutlayManageClubQueryController {
@At
@ApiOperation("提交核对")
@SaCheckPermission("outlay.outlayManage.club.query")
@SLog(tag = "社团经费查询", msg = "提交核对")
@SLog(tag = "协会经费查询", msg = "提交核对")
public Result doAudit(String id) {
clubQueryService.dao().update(OutlayManageClub.class,
Chain.make("isCheck", true),
@@ -128,7 +128,7 @@ public class OutlayManageClubQueryController {
@At
@ApiOperation("取消核对")
@SaCheckPermission("outlay.outlayManage.club.query")
@SLog(tag = "社团经费查询", msg = "取消核对")
@SLog(tag = "协会经费查询", msg = "取消核对")
public Result cancelAudit(String id) {
clubQueryService.dao().update(OutlayManageClub.class,
Chain.make("isCheck", false),
@@ -140,7 +140,7 @@ public class OutlayManageClubQueryController {
@At
@ApiOperation("更新拨付金额")
@SaCheckPermission("outlay.outlayManage.club.query")
@SLog(tag = "社团经费查询", msg = "更新拨付金额")
@SLog(tag = "协会经费查询", msg = "更新拨付金额")
public Result doMoney(String clubId) {
clubQueryService.doMoney(clubId);
@@ -163,7 +163,7 @@ public class OutlayManageClubQueryController {
* 查询已拨付未拨付人员列表
*
* @param pageForm
* @param clubId 社团id
* @param clubId 协会id
* @param type historyUserNum 全部、historyGiveMoneyNum 已拨付、historyNotGiveMoneyNum 未拨付
* @param year
* @return
@@ -233,7 +233,7 @@ public class OutlayManageClubQueryController {
InputStream is = sysOfficeTemplateUtil.getTemplate("jfClubUserBack");
TemplateExportParams exportParams = new TemplateExportParams(is, null);
Workbook workbook = ExcelExportUtil.exportExcel(exportParams, map);
CommonDownloadUtil.download(Globals.MyConfig.getString("schoolName") + "教职工社团会员统计表.xlsx", workbook, response);
CommonDownloadUtil.download(Globals.MyConfig.getString("schoolName") + "教职工协会会员统计表.xlsx", workbook, response);
} catch (Exception e) {
log.error("导出Excel汇总表失败", e);
throw new RuntimeException("导出Excel汇总表失败:" + e.getMessage());
@@ -41,7 +41,7 @@ import java.util.List;
@At("/platform/outlay/outlayManage/clubUseDetail")
@Ok("json:full")
@Slf4j
@Api(tags = "社团预算使用明细")
@Api(tags = "协会预算使用明细")
public class OutlayManageClubUseDetailController {
@Inject
@@ -92,15 +92,15 @@ public class OutlayManageClubUseDetailController {
}
/**
* 导出社团预算使用情况汇总表。
* 导出协会预算使用情况汇总表。
*
* @param year 统计年度,未传时默认当前年度
* @param clubId 社团主键,可为空;为空时导出当前用户权限范围内的全部社团
* @param clubId 协会主键,可为空;为空时导出当前用户权限范围内的全部协会
* @param response 下载响应,返回 XSSF Excel 文件流
*/
@At
@Ok("void")
@ApiOperation("导出社团预算使用情况")
@ApiOperation("导出协会预算使用情况")
@SaCheckPermission("outlay.outlayManage.club.useDetail")
public void doExport(Integer year, String clubId, HttpServletResponse response) {
outlayUseDetailService.exportClubUseDetail(year, clubId, response);
@@ -108,7 +108,7 @@ public class OutlayManageClubUseDetailController {
@At
@ApiOperation("某个社团预算使用详情")
@ApiOperation("某个协会预算使用详情")
@SaCheckPermission("outlay.outlayManage.club.useDetail")
public Result detailInfo(PageForm pageForm, String outlayManageId) {
Sql sql = Sqls.create("""
@@ -120,10 +120,10 @@ public class OutlayManageClubUseDetailController {
@At
@ApiOperation("删除社团预算详情")
@ApiOperation("删除协会预算详情")
@Aop(TransAop.READ_COMMITTED)
@SaCheckPermission("outlay.outlayManage.club.useDetail")
@SLog(tag = "社团预算使用详情", msg = "删除了社团预算使用详情:${args[0]}")
@SLog(tag = "协会预算使用详情", msg = "删除了协会预算使用详情:${args[0]}")
public Result doDeleteDetail(String id) {
outlayUseDetailService.doDeleteDetail(id,"club");
return Result.success();
@@ -131,10 +131,10 @@ public class OutlayManageClubUseDetailController {
@At
@ApiOperation("编辑社团预算详情")
@ApiOperation("编辑协会预算详情")
@Aop(TransAop.READ_COMMITTED)
@SaCheckPermission("outlay.outlayManage.club.useDetail")
@SLog(tag = "社团预算使用详情", msg = "编辑了社团预算使用详情:${args[0]}")
@SLog(tag = "协会预算使用详情", msg = "编辑了协会预算使用详情:${args[0]}")
public Result doEditDetail(OutlayUseDetail outlayUseDetail) {
outlayUseDetailService.doEditDetail(outlayUseDetail,"club");
return Result.success();
@@ -31,7 +31,7 @@ public class OutlayClubUserBackHistory extends BaseModel implements Serializable
private String id;
@Column
@Comment("社团ID")
@Comment("协会ID")
@ColDefine(type = ColType.VARCHAR, width = 32)
private String clubId;
@@ -17,7 +17,7 @@ import java.math.BigDecimal;
@EqualsAndHashCode(callSuper = true)
@Table("outlay_manage_club")
@TableMeta("{'mysql-charset':'utf8mb4'}")
@Comment("社团经费管理")
@Comment("协会经费管理")
public class OutlayManageClub extends BaseModel implements Serializable {
@Column
@@ -51,7 +51,7 @@ public class OutlayManageClub extends BaseModel implements Serializable {
private BigDecimal userAvgMoney;
@Column
@Comment("上年度社团人数")
@Comment("上年度协会人数")
@Default("0")
@ColDefine(type = ColType.INT)
private Integer historyUserNum;
@@ -69,17 +69,17 @@ public class OutlayManageClub extends BaseModel implements Serializable {
private Integer historyNotGiveMoneyNum;
@Column
@Comment("社团ID")
@Comment("协会ID")
@ColDefine(type = ColType.VARCHAR, width = 32)
private String clubId;
@Column
@Comment("社团名称")
@Comment("协会名称")
@ColDefine(type = ColType.VARCHAR)
private String clubName;
@Column
@Comment("社团code")
@Comment("协会code")
@ColDefine(type = ColType.VARCHAR, width = 32)
private String clubCode;
@@ -10,9 +10,9 @@ import javax.servlet.http.HttpServletResponse;
public interface OutlayManageClubQueryService extends BaseService {
/**
* 2026年10月3日 16:23:13;操作人:wxg:生成当前年度社团预算,同年度同社团已存在时跳过,不覆盖金额和核对状态。
* 社团须存在已完成 WF 流程;保留原年度人数统计和拨付金额规则。
* @return 本次实际新增的预算记录条数,重复调用且没有新增社团时为 0
* 2026年10月3日 16:23:13;操作人:wxg:生成当前年度协会预算,同年度同协会已存在时跳过,不覆盖金额和核对状态。
* 协会须存在已完成 WF 流程;保留原年度人数统计和拨付金额规则。
* @return 本次实际新增的预算记录条数,重复调用且没有新增协会时为 0
*/
int generateCurrentYearAllocation();
@@ -21,10 +21,10 @@ public interface OutlayManageClubQueryService extends BaseService {
Sql backUserSql(PageForm pageForm, String clubId, String type, Integer year, String payed);
/**
* 导出社团拨付核对汇总表。
* 导出协会拨付核对汇总表。
*
* @param year 统计年度,未传时默认当前年度
* @param clubId 社团主键,可为空;为空时导出当前用户权限范围内的全部社团
* @param clubId 协会主键,可为空;为空时导出当前用户权限范围内的全部协会
* @param response 下载响应,用于向浏览器输出 XSSF Excel 文件
*/
void exportSummary(Integer year, String clubId, HttpServletResponse response);
@@ -17,10 +17,10 @@ public interface OutlayUseDetailService extends BaseService<OutlayUseDetail> {
void doEditDetail(OutlayUseDetail outlayUseDetail,String outlayType);
/**
* 导出社团预算使用情况汇总表。
* 导出协会预算使用情况汇总表。
*
* @param year 统计年度
* @param clubId 社团主键,可为空;为空时导出当前用户权限范围内的全部社团
* @param clubId 协会主键,可为空;为空时导出当前用户权限范围内的全部协会
* @param response 下载响应,用于向浏览器输出 XSSF Excel 文件
*/
void exportClubUseDetail(Integer year, String clubId, HttpServletResponse response);
@@ -60,13 +60,13 @@ public class OutlayManageClubQueryServiceImpl extends BaseServiceImpl implements
super(dao);
}
/** 2026年10月3日 16:23:13;操作人:wxg:WF 仅用于判断存在;锁定社团并检查已有年度预算,连续或并发分配不重复新增。 */
/** 2026年10月3日 16:23:13;操作人:wxg:WF 仅用于判断存在;锁定协会并检查已有年度预算,连续或并发分配不重复新增。 */
@Override
@Aop(TransAop.READ_COMMITTED)
public int generateCurrentYearAllocation() {
int year = DateUtil.thisYear();
// 同一事务先按固定顺序锁定候选社团,串行处理分配请求,随后读取最新年度预算。
// 不改动 WF 流程,不增加索引;多个已完成流程不会增加候选社团行数。
// 同一事务先按固定顺序锁定候选协会,串行处理分配请求,随后读取最新年度预算。
// 不改动 WF 流程,不增加索引;多个已完成流程不会增加候选协会行数。
Sql lockSql = Sqls.create("""
SELECT c.id FROM sys_club c
WHERE EXISTS (
@@ -117,7 +117,7 @@ public class OutlayManageClubQueryServiceImpl extends BaseServiceImpl implements
List<OutlayManageClub> budgets = new ArrayList<>();
for (NutMap club : clubList) {
String clubId = club.getString("id");
// 新增社团若在候选锁定后完成审批,则留到下次处理;既有预算不得重置或覆盖。
// 新增协会若在候选锁定后完成审批,则留到下次处理;既有预算不得重置或覆盖。
if (!lockedClubs.contains(clubId) || !recordedClubs.add(clubId)) continue;
OutlayManageClub budget = new OutlayManageClub();
budget.setYear(year);
@@ -285,12 +285,12 @@ public class OutlayManageClubQueryServiceImpl extends BaseServiceImpl implements
}
/**
* 导出当前用户可查询的社团拨付核对汇总数据。
* 导出当前用户可查询的协会拨付核对汇总数据。
* 年审人数、可拨付人数和不可拨付人数分别取当前年度记录中的历史统计值;
* 拨付标准依据现有规则计算:0 人为 0 元,1 至 49 人为 3000 元,50 人及以上为 5000 元。
*
* @param year 统计年度,未传时使用当前年度
* @param clubId 社团主键,可为空
* @param clubId 协会主键,可为空
* @param response 下载响应,用于输出 Excel 文件
*/
@Override
@@ -319,7 +319,7 @@ public class OutlayManageClubQueryServiceImpl extends BaseServiceImpl implements
}
List<ExcelExportEntity> exportEntities = new ArrayList<>();
exportEntities.add(new ExcelExportEntity("社团名称", "clubName", 25));
exportEntities.add(new ExcelExportEntity("协会名称", "clubName", 25));
exportEntities.add(new ExcelExportEntity("年审人数", "historyUserNum", 15));
exportEntities.add(new ExcelExportEntity("可拨付人数", "historyGiveMoneyNum", 15));
exportEntities.add(new ExcelExportEntity("不可拨付人数", "historyNotGiveMoneyNum", 15));
@@ -330,11 +330,11 @@ public class OutlayManageClubQueryServiceImpl extends BaseServiceImpl implements
ExportParams exportParams = new ExportParams();
exportParams.setType(ExcelType.XSSF);
Workbook workbook = ExcelExportUtil.exportExcel(exportParams, exportEntities, summaryList);
CommonDownloadUtil.download(queryYear + "年社团拨付核对汇总.xlsx", workbook, response);
CommonDownloadUtil.download(queryYear + "年协会拨付核对汇总.xlsx", workbook, response);
}
/**
* 根据可拨付人数返回社团年度拨付标准。
* 根据可拨付人数返回协会年度拨付标准。
*
* @param giveMoneyNum 可拨付人数
* @return 对应的拨付标准金额
@@ -61,11 +61,11 @@ public class OutlayUseDetailServiceImpl extends BaseServiceImpl<OutlayUseDetail>
}
/**
* 按社团预算使用页面的查询口径导出汇总数据。
* 按协会预算使用页面的查询口径导出汇总数据。
* 剩余额度由分配总额度减已使用额度计算,避免导出内容与页面展示不一致。
*
* @param year 统计年度,未传时使用当前年度
* @param clubId 社团主键,可为空
* @param clubId 协会主键,可为空
* @param response 下载响应,用于输出 Excel 文件
*/
@Override
@@ -96,8 +96,8 @@ public class OutlayUseDetailServiceImpl extends BaseServiceImpl<OutlayUseDetail>
List<ExcelExportEntity> exportEntities = new ArrayList<>();
exportEntities.add(new ExcelExportEntity("年度", "year", 15));
exportEntities.add(new ExcelExportEntity("社团名称", "clubName", 25));
exportEntities.add(new ExcelExportEntity("社团编码", "clubCode", 20));
exportEntities.add(new ExcelExportEntity("协会名称", "clubName", 25));
exportEntities.add(new ExcelExportEntity("协会编码", "clubCode", 20));
exportEntities.add(new ExcelExportEntity("分配总额度(元)", "totalQuota", 18));
exportEntities.add(new ExcelExportEntity("已使用额度(元)", "usedQuota", 18));
exportEntities.add(new ExcelExportEntity("剩余额度(元)", "surplusQuota", 18));
@@ -105,7 +105,7 @@ public class OutlayUseDetailServiceImpl extends BaseServiceImpl<OutlayUseDetail>
ExportParams exportParams = new ExportParams();
exportParams.setType(ExcelType.XSSF);
Workbook workbook = ExcelExportUtil.exportExcel(exportParams, exportEntities, clubUseDetailList);
CommonDownloadUtil.download(queryYear + "年社团预算使用情况.xlsx", workbook, response);
CommonDownloadUtil.download(queryYear + "年协会预算使用情况.xlsx", workbook, response);
}
/**
@@ -42,7 +42,7 @@ import java.util.List;
@IocBean
@Ok("json:full")
@Slf4j
@Api(tags = "费用报销管理-社团审核")
@Api(tags = "费用报销管理-协会审核")
@At("/platform/outlay/reimburse/clubAudit")
public class OutlayReimburseClubAuditController {
@@ -136,7 +136,7 @@ public class OutlayReimburseClubAuditController {
@At
@ApiOperation("社团审核")
@ApiOperation("协会审核")
@SaCheckPermission(value = {"outlay.reimburse.clubAudit", "h5.outlay.reimburse.clubAudit"}, mode = SaMode.OR)
public Result submit(@Param("data") OutlayReimburse outlayReimburse) {
// 开启流程实例

Some files were not shown because too many files have changed in this diff Show More