Merge remote-tracking branch 'origin/main'

src/main/java/com/budwk/app/base/constant/RoleConstant.java

@@ -50,6 +50,7 @@ RoleConstant {
     BRANCH_UNION_WENTI_WY("分工会文体委员"),
     BRANCH_UNION_SHENGGHUO_WY("分工会生活委员"),
     BRANCH_UNION_TIAOJIE_WY("分工会调解委员"),
+    BRANCH_UNION_WENTI_SPORTS("分工会文体福利委员"),
 
 	UNIT_PARTY_SECRETARY("单位党委书记"),
 

src/main/java/com/budwk/app/sys/services/impl/SysDataUnitPullServiceImpl.java

@@ -15,6 +15,7 @@ import com.budwk.app.sys.utils.DataCenterUtil;
 import lombok.extern.slf4j.Slf4j;
 import org.apache.commons.lang3.StringUtils;
 import org.nutz.aop.interceptor.ioc.TransAop;
+import org.nutz.dao.Cnd;
 import org.nutz.dao.Dao;
 import org.nutz.dao.Sqls;
 import org.nutz.dao.sql.Sql;
@@ -84,10 +85,15 @@ public class SysDataUnitPullServiceImpl extends BaseServiceImpl<Sys_unit> implem
         // 需要更新的单位
         List<Sys_unit> updateList = new ArrayList<>();
 
+        List<Sys_unit> sysUnits = dao().query(Sys_unit.class, Cnd.NEW());
+
         // 拉取过来的数据，全部的单位，一万四千多条，这里只保留 “部门类”
         List<JSONObject> data = jsonBody.getJSONArray("data").stream()
                 .map(o -> (JSONObject) o)
-                .filter(row -> StrUtil.isNotBlank(row.getStr("bmlb")) && Objects.equals("隶属部门类", row.getStr("bmlb")))
+                .filter(row ->
+                        sysUnits.stream().anyMatch(e -> row.getStr("zzjgdm").equals(e.getId()))
+                                || (StrUtil.isNotBlank(row.getStr("bmlb")) && Objects.equals("隶属部门类", row.getStr("bmlb")))
+                )
                 .toList();
 
         Map<String, String> api2db = Arrays.stream(Api2UnitFiledMap.values())

src/main/java/com/budwk/app/sys/services/impl/SysDataUserPullServiceImpl.java

@@ -193,13 +193,23 @@ public class SysDataUserPullServiceImpl extends BaseServiceImpl<Sys_user_source>
                 // 判断财务信息有没有值,
                 if (financeUserMap.containsKey(sysUser.getLoginname())) {
                     NutMap nutMap = financeUserMap.get(sysUser.getLoginname());
-                    sysUser.setMember(true);
-                    sysUser.setWelfareMember(true);
-                    sysUser.setPreparationMemberFee(BigDecimal.valueOf(nutMap.getDouble("preparationMemberFee")));
-                    sysUser.setContractMemberFee(BigDecimal.valueOf(nutMap.getDouble("contractMemberFee")));
+                    if(BigDecimal.valueOf(nutMap.getDouble("preparationMemberFee")).doubleValue()>0
+                            || BigDecimal.valueOf(nutMap.getDouble("contractMemberFee")).doubleValue()>0){
+                        sysUser.setMember(true);
+                        sysUser.setWelfareMember(true);
+                        sysUser.setPreparationMemberFee(BigDecimal.valueOf(nutMap.getDouble("preparationMemberFee")));
+                        sysUser.setContractMemberFee(BigDecimal.valueOf(nutMap.getDouble("contractMemberFee")));
+                    } else {
+                        sysUser.setMember(false);
+                        sysUser.setWelfareMember(false);
+                        sysUser.setPreparationMemberFee(new BigDecimal(0));
+                        sysUser.setContractMemberFee(new BigDecimal(0));
+                    }
                 } else {
                     sysUser.setMember(false);
                     sysUser.setWelfareMember(false);
+                    sysUser.setPreparationMemberFee(new BigDecimal(0));
+                    sysUser.setContractMemberFee(new BigDecimal(0));
                 }
 
                 return sysUser;

src/main/java/com/budwk/app/zhgh/activity/basic/models/ActivityUserScope.java

@@ -20,7 +20,8 @@ import java.io.Serializable;
 @Comment("活动人员范围设置")
 @TableIndexes({
         @Index(name = "INDEX_ACTIVITY_USER_SCOPE_GROUPID", fields = {"groupId"}, unique = false),
-        @Index(name = "INDEX_ACTIVITY_USER_SCOPE_USERID", fields = {"userId"}, unique = false)
+        @Index(name = "INDEX_ACTIVITY_USER_SCOPE_USERID", fields = {"userId"}, unique = false),
+        @Index(name = "INDEX_ACTIVITY_USER_SCOPE_GROUPID_USERID", fields = {"groupId", "userId"}, unique = false)
 })
 public class ActivityUserScope extends BaseModel implements Serializable {
 
@@ -46,6 +47,16 @@ public class ActivityUserScope extends BaseModel implements Serializable {
     @Comment("userid")
     private String userId;
 
+    @Column
+    @ColDefine(type = ColType.INT, width = 2)
+    @Comment("分组类型 1.结果分组 2.SQL条件分组")
+    private Integer groupType;
+
+    @Column
+    @ColDefine(customType = "longtext")
+    @Comment("SQL条件分组保存的查询SQL")
+    private String groupSql;
+
     @Column
     @ColDefine(type = ColType.VARCHAR, width = 32)
     @Comment("创建人")

src/main/java/com/budwk/app/zhgh/activity/basic/service/ActivityBasicScopeService.java

@@ -21,4 +21,49 @@ public interface ActivityBasicScopeService extends BaseService<ActivityUserScope
      */
     void largeDataInsert(List<ActivityUserScope> list) ;
 
+    /**
+     * 查询分组基础信息。
+     * SQL条件分组与结果分组都只从同一张 activity_user_scope 表读取。
+     */
+    ActivityUserScope getGroupInfo(Integer groupId);
+
+    /**
+     * 查询分组类型，未配置时默认按结果分组处理。
+     */
+    Integer getGroupType(Integer groupId);
+
+    /**
+     * 构造分组对应的人员ID子查询。
+     * 结果分组直接取 activity_user_scope.userId，SQL条件分组则按保存的 groupSql 动态生成查询。
+     */
+    Sql buildGroupUserIdSubSql(Integer groupId);
+
+    /**
+     * 构造可直接拼接到业务SQL中的人员ID子查询文本。
+     * 仅用于已有大量原生SQL场景，避免每个模块重复拼接 groupSql 逻辑。
+     */
+    String buildGroupUserIdSubSqlText(Integer groupId);
+
+    /**
+     * 查询分组当前命中的人员ID列表。
+     */
+    List<String> listGroupUserIds(Integer groupId);
+
+    /**
+     * 判断指定用户是否在某个分组内。
+     * SQL条件分组会按保存的 groupSql 动态校验，而不是依赖落库的 userId 明细。
+     */
+    boolean isUserInGroup(Integer groupId, String userId);
+
+    /**
+     * 批量过滤出当前用户可见的分组ID。
+     * 用于列表页先查活动、再按活动分组做二次权限过滤的场景。
+     */
+    List<Integer> filterGroupIdsByUser(List<Integer> groupIds, String userId);
+
+    /**
+     * SQL条件分组删除人员时，不再删除主表记录，而是把排除条件追加到已保存的 groupSql 中。
+     */
+    void excludeUsersFromSqlGroup(Integer groupId, List<String> userIds);
+
 }

src/main/java/com/budwk/app/zhgh/activity/basic/service/impl/ActivityBasicScopeServiceImpl.java

@@ -1,6 +1,7 @@
 package com.budwk.app.zhgh.activity.basic.service.impl;
 
 import cn.hutool.core.collection.CollectionUtil;
+import cn.hutool.core.util.StrUtil;
 import com.budwk.app.base.service.impl.BaseServiceImpl;
 import com.budwk.app.base.utils.DateUtil;
 import com.budwk.app.zhgh.activity.basic.models.ActivityUserScope;
@@ -8,17 +9,20 @@ import com.budwk.app.zhgh.activity.basic.service.ActivityBasicScopeService;
 import lombok.extern.slf4j.Slf4j;
 import org.nutz.dao.Cnd;
 import org.nutz.dao.Dao;
+import org.nutz.dao.Sqls;
 import org.nutz.dao.impl.NutTxDao;
 import org.nutz.dao.sql.Sql;
 import org.nutz.ioc.loader.annotation.IocBean;
 
 import java.util.ArrayList;
+import java.util.LinkedHashSet;
 import java.util.List;
 import java.util.concurrent.Callable;
 import java.util.concurrent.ExecutorService;
 import java.util.concurrent.Executors;
 import java.util.concurrent.Future;
 import java.util.concurrent.atomic.AtomicInteger;
+import java.util.stream.Collectors;
 
 /**
  * @author zxy
@@ -29,6 +33,7 @@ import java.util.concurrent.atomic.AtomicInteger;
 @Slf4j
 public class ActivityBasicScopeServiceImpl extends BaseServiceImpl<ActivityUserScope> implements ActivityBasicScopeService {
 
+    private static final int GROUP_TYPE_RESULT = 1;
 
     public ActivityBasicScopeServiceImpl(Dao dao) {
         super(dao);
@@ -80,4 +85,122 @@ public class ActivityBasicScopeServiceImpl extends BaseServiceImpl<ActivityUserS
         }
         log.info("结束时间" + DateUtil.getDateTime());
     }
+
+    @Override
+    public ActivityUserScope getGroupInfo(Integer groupId) {
+        if (groupId == null) {
+            return null;
+        }
+        List<ActivityUserScope> list = dao().query(ActivityUserScope.class, Cnd.where("groupId", "=", groupId).desc("id"));
+        return CollectionUtil.isEmpty(list) ? null : list.get(0);
+    }
+
+    @Override
+    public Integer getGroupType(Integer groupId) {
+        ActivityUserScope userScope = getGroupInfo(groupId);
+        if (userScope == null || userScope.getGroupType() == null) {
+            return GROUP_TYPE_RESULT;
+        }
+        return userScope.getGroupType();
+    }
+
+    @Override
+    public Sql buildGroupUserIdSubSql(Integer groupId) {
+        return Sqls.create(buildGroupUserIdSubSqlText(groupId));
+    }
+
+    @Override
+    public String buildGroupUserIdSubSqlText(Integer groupId) {
+        ActivityUserScope groupInfo = getGroupInfo(groupId);
+        if (groupInfo == null) {
+            return "SELECT NULL AS userId WHERE 1 = 0";
+        }
+        if (GROUP_TYPE_RESULT == getGroupType(groupId)) {
+            return "SELECT userId FROM activity_user_scope WHERE groupId = " + groupId + " AND userId IS NOT NULL";
+        }
+        if (StrUtil.isBlank(groupInfo.getGroupSql())) {
+            return "SELECT NULL AS userId WHERE 1 = 0";
+        }
+        return """
+                SELECT DISTINCT
+                    u.id AS userId
+                FROM
+                    `vw_user` u
+                    LEFT JOIN sys_user_role sur ON sur.userid = u.id
+                    LEFT JOIN club_user clubuser ON clubuser.userid = u.id
+                WHERE
+                """ + groupInfo.getGroupSql();
+    }
+
+    @Override
+    public List<String> listGroupUserIds(Integer groupId) {
+        Sql sql = Sqls.queryString(buildGroupUserIdSubSqlText(groupId));
+        dao().execute(sql);
+        String[] userIds = (String[]) sql.getResult();
+        return userIds == null ? new ArrayList<>() : List.of(userIds);
+    }
+
+    @Override
+    public boolean isUserInGroup(Integer groupId, String userId) {
+        if (groupId == null || StrUtil.isBlank(userId)) {
+            return false;
+        }
+        if (GROUP_TYPE_RESULT == getGroupType(groupId)) {
+            return dao().count(ActivityUserScope.class, Cnd.where("groupId", "=", groupId).and("userId", "=", userId)) > 0;
+        }
+        ActivityUserScope groupInfo = getGroupInfo(groupId);
+        if (groupInfo == null || StrUtil.isBlank(groupInfo.getGroupSql())) {
+            return false;
+        }
+        Sql sql = Sqls.create("""
+                SELECT
+                    COUNT(1)
+                FROM
+                    `vw_user` u
+                    LEFT JOIN sys_user_role sur ON sur.userid = u.id
+                    LEFT JOIN club_user clubuser ON clubuser.userid = u.id
+                WHERE
+                    u.id = @userId
+                    AND
+                """ + "(" + groupInfo.getGroupSql() + ")");
+        sql.setParam("userId", userId);
+        return count(sql) > 0;
+    }
+
+    @Override
+    public List<Integer> filterGroupIdsByUser(List<Integer> groupIds, String userId) {
+        LinkedHashSet<Integer> result = new LinkedHashSet<>();
+        if (CollectionUtil.isEmpty(groupIds) || StrUtil.isBlank(userId)) {
+            return new ArrayList<>(result);
+        }
+        groupIds.stream()
+                .filter(groupId -> groupId != null)
+                .distinct()
+                .forEach(groupId -> {
+                    if (isUserInGroup(groupId, userId)) {
+                        result.add(groupId);
+                    }
+                });
+        return new ArrayList<>(result);
+    }
+
+    @Override
+    public void excludeUsersFromSqlGroup(Integer groupId, List<String> userIds) {
+        ActivityUserScope groupInfo = getGroupInfo(groupId);
+        if (groupInfo == null || getGroupType(groupId) != 2 || CollectionUtil.isEmpty(userIds) || StrUtil.isBlank(groupInfo.getGroupSql())) {
+            return;
+        }
+        String excludeUserSql = userIds.stream()
+                .filter(StrUtil::isNotBlank)
+                .distinct()
+                .map(userId -> "'" + StrUtil.replace(userId, "'", "''") + "'")
+                .collect(Collectors.joining(","));
+        if (StrUtil.isBlank(excludeUserSql)) {
+            return;
+        }
+        // SQL分组只有一条主记录，删除人员时通过追加排除条件持久化删除结果。
+        String groupSql = "(" + groupInfo.getGroupSql() + ") AND u.id NOT IN (" + excludeUserSql + ")";
+        groupInfo.setGroupSql(groupSql);
+        dao().updateIgnoreNull(groupInfo);
+    }
 }

src/main/java/com/budwk/app/zhgh/activity/culture/controller/ActivityCultureInfoManageController.java

@@ -127,7 +127,7 @@ public class ActivityCultureInfoManageController {
     @At
     @Ok("json:full")
     @ApiOperation("通知报名人员")
-    @SaCheckPermission("trainSignUp.manage")
+    @SaCheckPermission("infoManage.school.manage")
     public Result sendNotify(@Param("activityId") String activityId, @Param("content") String content) {
         if (StrUtil.isBlank(activityId) || StrUtil.isBlank(content)) {
             return Result.error("参数不完整");

src/main/java/com/budwk/app/zhgh/dayofficework/tour/controller/TourBranchUserAssignmentController.java

@@ -0,0 +1,176 @@
+package com.budwk.app.zhgh.dayofficework.tour.controller;
+
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import cn.hutool.core.util.StrUtil;
+import com.budwk.app.base.annotation.SLog;
+import com.budwk.app.base.param.PageForm;
+import com.budwk.app.base.result.Result;
+import com.budwk.app.zhgh.dayofficework.tour.service.TourUserAssignmentService;
+import org.nutz.aop.interceptor.ioc.TransAop;
+import org.nutz.ioc.aop.Aop;
+import org.nutz.ioc.loader.annotation.Inject;
+import org.nutz.ioc.loader.annotation.IocBean;
+import org.nutz.json.Json;
+import org.nutz.lang.Lang;
+import org.nutz.mvc.annotation.At;
+import org.nutz.mvc.annotation.Ok;
+import org.nutz.mvc.annotation.Param;
+
+import java.util.Collections;
+import java.util.List;
+
+@IocBean
+@Ok("json:full")
+@At("/platform/tour/branchUserAssignment")
+public class TourBranchUserAssignmentController {
+
+    @Inject
+    private TourUserAssignmentService tourUserAssignmentService;
+
+    /**
+     * 分工会人员分配列表入口。
+     */
+    @At("")
+    @Ok("beetl:/platform/zhgh/dayofficework/Tour/branchUserAssignment/index.html")
+    @SaCheckPermission("tour.branchUserAssignment")
+    public void index() {
+    }
+
+    /**
+     * 分页查询当前登录人所在分工会的分配记录，列表数据只来自人员分配表。
+     */
+    @At
+    @SaCheckPermission("tour.branchUserAssignment")
+    public Result pageData(PageForm pageForm, Integer year, String settingId, String matterId,
+                           String personType, String keyword) {
+        return Result.success(tourUserAssignmentService.branchAssignmentPage(pageForm, year, settingId, matterId,
+                personType, keyword));
+    }
+
+    /**
+     * 分页查询候选人员，候选范围由疗休养配置可参加人员范围和当前登录人所在分工会共同决定。
+     */
+    @At
+    @SaCheckPermission("tour.branchUserAssignment")
+    public Result candidatePageData(PageForm pageForm, String settingId, String keyword) {
+        return Result.success(tourUserAssignmentService.branchCandidatePage(pageForm, settingId, keyword));
+    }
+
+    /**
+     * 查询可用于分配的疗休养配置。
+     */
+    @At
+    @SaCheckPermission("tour.branchUserAssignment")
+    public Result settingOptions(Integer year) {
+        return Result.success(tourUserAssignmentService.listEnabledSettingOptions(year));
+    }
+
+    /**
+     * 查询分工会可分配线路选项，选项携带事项、线路和旅行社快照信息。
+     */
+    @At
+    @SaCheckPermission("tour.branchUserAssignment")
+    public Result matterOptions(String settingId) {
+        return Result.success(tourUserAssignmentService.listMatterOptions(settingId));
+    }
+
+    /**
+     * 查询当前登录人所在分工会在指定配置下的名额使用情况。
+     */
+    @At
+    @SaCheckPermission("tour.branchUserAssignment")
+    public Result quotaInfo(String settingId) {
+        return Result.success(tourUserAssignmentService.branchQuotaInfo(settingId));
+    }
+
+    /**
+     * 保存分工会人员分配，保存时数据来源固定为 BRANCH_UNION。
+     */
+    @At
+    @Aop(TransAop.READ_COMMITTED)
+    @SaCheckPermission("tour.branchUserAssignment")
+    @SLog(type = "tour", tag = "疗休养分工会人员分配", msg = "保存分工会人员分配")
+    public Result doAssign(String settingId, String matterId, String personType, @Param("userIds") String userIds) {
+        List<String> parsedUserIds;
+        try {
+            parsedUserIds = parseUserIds(userIds);
+        } catch (Exception e) {
+            return Result.error("人员参数错误");
+        }
+        try {
+            return Result.success(tourUserAssignmentService.assignBranchUsers(settingId, matterId, personType, parsedUserIds));
+        } catch (IllegalArgumentException e) {
+            return Result.error(e.getMessage());
+        }
+    }
+
+    /**
+     * 切换当前分工会人员分配记录的正式/替补状态，具体名额和台账保护规则由 service 统一处理。
+     */
+    @At
+    @Aop(TransAop.READ_COMMITTED)
+    @SaCheckPermission("tour.branchUserAssignment")
+    @SLog(type = "tour", tag = "疗休养分工会人员分配", msg = "切换分工会人员类型")
+    public Result switchPersonType(String id, String personType) {
+        try {
+            return Result.success(tourUserAssignmentService.switchCurrentBranchPersonType(id, personType));
+        } catch (IllegalArgumentException e) {
+            return Result.error(e.getMessage());
+        }
+    }
+
+    /**
+     * 恢复当前分工会已取消退出的人员分配记录，只恢复状态，不恢复已删除台账。
+     */
+    @At
+    @Aop(TransAop.READ_COMMITTED)
+    @SaCheckPermission("tour.branchUserAssignment.cancelRestore")
+    @SLog(type = "tour", tag = "疗休养分工会人员分配", msg = "取消退出分工会人员分配")
+    public Result restoreCancel(String id) {
+        try {
+            tourUserAssignmentService.restoreCurrentBranchCancelledAssignment(id);
+            return Result.success();
+        } catch (IllegalArgumentException e) {
+            return Result.error(e.getMessage());
+        }
+    }
+
+    /**
+     * 删除前检查该分配记录是否已经存在对应报名台账。
+     */
+    @At
+    @SaCheckPermission("tour.branchUserAssignment")
+    public Result deleteInfo(String id) {
+        if (StrUtil.isBlank(id)) {
+            return Result.error("参数错误");
+        }
+        return Result.success(tourUserAssignmentService.branchDeleteInfo(id));
+    }
+
+    /**
+     * 删除分工会人员分配记录，只删除 BRANCH_UNION 来源的数据。
+     */
+    @At
+    @Aop(TransAop.READ_COMMITTED)
+    @SaCheckPermission("tour.branchUserAssignment")
+    @SLog(type = "tour", tag = "疗休养分工会人员分配", msg = "删除分工会人员分配")
+    public Result doDelete(String id, Boolean deleteLedger) {
+        if (StrUtil.isBlank(id)) {
+            return Result.error("参数错误");
+        }
+        try {
+            tourUserAssignmentService.deleteCurrentBranchAssignment(id, Boolean.TRUE.equals(deleteLedger));
+            return Result.success();
+        } catch (IllegalArgumentException e) {
+            return Result.error(e.getMessage());
+        }
+    }
+
+    private List<String> parseUserIds(String userIds) {
+        if (StrUtil.isBlank(userIds)) {
+            return Collections.emptyList();
+        }
+        List<String> list = Json.fromJsonAsList(String.class, userIds);
+        return Lang.isEmpty(list) ? Collections.emptyList() : list;
+    }
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/controller/TourGroupController.java

@@ -0,0 +1,670 @@
+package com.budwk.app.zhgh.dayofficework.tour.controller;
+
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import cn.hutool.core.util.StrUtil;
+import com.budwk.app.base.constant.RoleConstant;
+import com.budwk.app.base.page.Pagination;
+import com.budwk.app.base.param.PageForm;
+import com.budwk.app.base.result.Result;
+import com.budwk.app.base.utils.CommonDownloadUtil;
+import com.budwk.app.sys.models.Sys_union;
+import com.budwk.app.web.commons.auth.utils.AuthUtil;
+import com.budwk.app.web.commons.auth.utils.SecurityUtil;
+import com.budwk.app.zhgh.dayofficework.tour.service.TourLedgerService;
+import com.budwk.app.zhgh.dayofficework.tour.service.TourMatterService;
+import org.apache.poi.hssf.usermodel.HSSFWorkbook;
+import org.apache.poi.ss.usermodel.BorderStyle;
+import org.apache.poi.ss.usermodel.Cell;
+import org.apache.poi.ss.usermodel.CellStyle;
+import org.apache.poi.ss.usermodel.Font;
+import org.apache.poi.ss.usermodel.HorizontalAlignment;
+import org.apache.poi.ss.usermodel.Row;
+import org.apache.poi.ss.usermodel.Sheet;
+import org.apache.poi.ss.usermodel.VerticalAlignment;
+import org.apache.poi.ss.usermodel.Workbook;
+import org.apache.poi.ss.util.CellRangeAddress;
+import org.nutz.dao.Cnd;
+import org.nutz.dao.Sqls;
+import org.nutz.dao.sql.Sql;
+import org.nutz.dao.util.cri.SqlExpressionGroup;
+import org.nutz.ioc.loader.annotation.Inject;
+import org.nutz.ioc.loader.annotation.IocBean;
+import org.nutz.lang.util.NutMap;
+import org.nutz.mvc.annotation.At;
+import org.nutz.mvc.annotation.Ok;
+
+import javax.servlet.http.HttpServletResponse;
+import java.time.LocalDate;
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+@IocBean
+@Ok("json:full")
+@At("/platform/tour/group")
+public class TourGroupController {
+
+    @Inject
+    private TourMatterService tourMatterService;
+
+    @Inject
+    private TourLedgerService tourLedgerService;
+
+    @At("")
+    @Ok("beetl:/platform/zhgh/dayofficework/Tour/group/index.html")
+    @SaCheckPermission("tour.group")
+    public void index() {
+    }
+
+    @At
+    @SaCheckPermission("tour.group")
+    public Result pageData(PageForm pageForm, Integer year, String lineName, String lineType, String unionId) {
+        if (StrUtil.isBlank(pageForm.getPageOrderName())) {
+            pageForm.defaultSortAsc("lineName");
+        }
+        Cnd cnd = buildQueryCnd(year, lineName, lineType, unionId);
+
+        Sql countSql = Sqls.create("""
+                SELECT COUNT(1)
+                FROM tour_matter m
+                INNER JOIN tour_line l ON l.id = m.lineId
+                LEFT JOIN sys_union u ON u.id = m.unionId
+                $condition
+                """);
+        countSql.setCondition(cnd);
+        countSql.setCallback(Sqls.callback.integer());
+        tourMatterService.dao().execute(countSql);
+        int count = countSql.getInt();
+
+        Sql listSql = Sqls.create("""
+                SELECT
+                    m.id AS matterId,
+                    m.`year`,
+                    m.matterName,
+                    m.unionId,
+                    COALESCE(u.name, '校工会') AS unionName,
+                    m.lineId,
+                    l.lineName,
+                    l.lineType,
+                    l.directFamilyUnitLine,
+                    m.travelStartTime,
+                    m.travelEndTime,
+                    CASE
+                        WHEN IFNULL(m.travelStartTime, '') <> '' AND IFNULL(m.travelEndTime, '') <> ''
+                        THEN CONCAT(m.travelStartTime, ' 至 ', m.travelEndTime)
+                        ELSE ''
+                    END AS travelPeriod,
+                    m.minGroupPeople,
+                    m.maxGroupPeople,
+                    IFNULL(sc.signupCount, 0) AS signupCount,
+                    CASE
+                        WHEN m.maxGroupPeople IS NOT NULL AND m.maxGroupPeople > 0 AND IFNULL(sc.signupCount, 0) > m.maxGroupPeople THEN 'over'
+                        WHEN m.minGroupPeople IS NOT NULL AND m.minGroupPeople > 0 AND IFNULL(sc.signupCount, 0) >= m.minGroupPeople THEN 'formed'
+                        ELSE 'unformed'
+                    END AS groupStatus,
+                    CASE
+                        WHEN m.maxGroupPeople IS NOT NULL AND m.maxGroupPeople > 0 AND IFNULL(sc.signupCount, 0) > m.maxGroupPeople THEN '超员'
+                        WHEN m.minGroupPeople IS NOT NULL AND m.minGroupPeople > 0 AND IFNULL(sc.signupCount, 0) >= m.minGroupPeople THEN '已成团'
+                        ELSE '未成团'
+                    END AS groupStatusName
+                FROM tour_matter m
+                INNER JOIN tour_line l ON l.id = m.lineId
+                LEFT JOIN sys_union u ON u.id = m.unionId
+                LEFT JOIN (
+                    SELECT t.matterId, SUM(1 + IFNULL(f.familyCount, 0)) AS signupCount
+                    FROM tour_ledger t
+                    LEFT JOIN (
+                        SELECT ledgerId, COUNT(1) AS familyCount
+                        FROM tour_ledger_family
+                        WHERE delFlag = 0
+                        GROUP BY ledgerId
+                    ) f ON f.ledgerId = t.id
+                    WHERE t.delFlag = 0
+                      AND t.matterId IS NOT NULL
+                      AND t.matterId <> ''
+                    GROUP BY t.matterId
+                ) sc ON sc.matterId = m.id
+                $condition
+                ORDER BY $orderColumn $orderBy, m.`year` DESC, m.travelStartTime ASC, l.lineName ASC, m.createdAt DESC
+                """);
+        listSql.setCondition(cnd);
+        listSql.setVar("orderColumn", getOrderColumn(pageForm.getPageOrderName()));
+        listSql.setVar("orderBy", "descending".equals(pageForm.getPageOrderBy()) ? "desc" : "asc");
+        listSql.setPager(tourMatterService.dao().createPager(pageForm.getPageNumber(), pageForm.getPageSize()));
+        listSql.setCallback(Sqls.callback.maps());
+        tourMatterService.dao().execute(listSql);
+
+        Pagination<NutMap> pagination = new Pagination<>(pageForm.getPageNumber(), pageForm.getPageSize(), count, listSql.getList(NutMap.class));
+        return Result.success(pagination);
+    }
+
+    @At
+    @SaCheckPermission("tour.group")
+    public Result unionOptions() {
+        Cnd cnd = Cnd.NEW();
+        cnd.asc("unionCode");
+        cnd.asc("name");
+        return Result.success(tourMatterService.dao().query(Sys_union.class, cnd));
+    }
+
+    @At
+    @SaCheckPermission("tour.group")
+    public Result lineTypeOptions(Integer year) {
+        Cnd cnd = buildQueryCnd(year, null, null, null);
+        Sql sql = Sqls.create("""
+                SELECT DISTINCT l.lineType
+                FROM tour_matter m
+                INNER JOIN tour_line l ON l.id = m.lineId
+                LEFT JOIN sys_union u ON u.id = m.unionId
+                $condition
+                ORDER BY l.lineType ASC
+                """);
+        sql.setCondition(cnd);
+        sql.setCallback(Sqls.callback.maps());
+        tourMatterService.dao().execute(sql);
+        return Result.success(sql.getList(NutMap.class));
+    }
+
+    @At
+    @SaCheckPermission("tour.group")
+    public Result signupPageData(PageForm pageForm, String matterId, String keyword, String unionId) {
+        if (StrUtil.isBlank(matterId)) {
+            return Result.error("参数错误");
+        }
+        if (StrUtil.isBlank(pageForm.getPageOrderName())) {
+            pageForm.defaultSortDesc("signupTime");
+        }
+        Cnd cnd = buildSignupQueryCnd(matterId, keyword, unionId);
+        Sql countSql = Sqls.create("""
+                SELECT COUNT(1)
+                FROM tour_ledger t
+                INNER JOIN tour_matter m ON m.id = t.matterId
+                INNER JOIN tour_line l ON l.id = m.lineId
+                $condition
+                """);
+        countSql.setCondition(cnd);
+        countSql.setCallback(Sqls.callback.integer());
+        tourLedgerService.dao().execute(countSql);
+        int count = countSql.getInt();
+
+        Sql listSql = Sqls.create("""
+                SELECT
+                    t.id,
+                    t.jobNo,
+                    t.userName,
+                    '' AS mobile,
+                    t.idCard,
+                    t.unionId,
+                    t.unionName,
+                    t.signupTime
+                FROM tour_ledger t
+                INNER JOIN tour_matter m ON m.id = t.matterId
+                INNER JOIN tour_line l ON l.id = m.lineId
+                $condition
+                ORDER BY $orderColumn $orderBy, t.signupTime DESC, t.createdAt DESC
+                """);
+        listSql.setCondition(cnd);
+        listSql.setVar("orderColumn", getSignupOrderColumn(pageForm.getPageOrderName()));
+        listSql.setVar("orderBy", "ascending".equals(pageForm.getPageOrderBy()) ? "asc" : "desc");
+        listSql.setPager(tourLedgerService.dao().createPager(pageForm.getPageNumber(), pageForm.getPageSize()));
+        listSql.setCallback(Sqls.callback.maps());
+        tourLedgerService.dao().execute(listSql);
+
+        List<NutMap> list = listSql.getList(NutMap.class);
+        fillSignupMobile(list);
+        fillSignupFamilies(list);
+        Pagination<NutMap> pagination = new Pagination<>(pageForm.getPageNumber(), pageForm.getPageSize(), count, list);
+        return Result.success(pagination);
+    }
+
+    @At
+    @Ok("void")
+    @SaCheckPermission("tour.group")
+    public void exportParticipants(String matterId, HttpServletResponse response) {
+        if (StrUtil.isBlank(matterId)) {
+            return;
+        }
+        NutMap matter = fetchExportMatter(matterId);
+        if (matter == null || matter.isEmpty()) {
+            return;
+        }
+        List<NutMap> list = queryExportParticipants(matterId);
+        Workbook workbook = buildParticipantsWorkbook(matter, list);
+        String lineName = StrUtil.blankToDefault(matter.getString("lineName", ""), "线路");
+        CommonDownloadUtil.download(lineName + "参加人员名单.xls", workbook, response);
+    }
+
+    private Cnd buildSignupQueryCnd(String matterId, String keyword, String unionId) {
+        Cnd cnd = Cnd.NEW();
+        cnd.and("t.delFlag", "=", false);
+        cnd.and("t.matterId", "=", matterId);
+        cnd.and("m.delFlag", "=", false);
+        cnd.and("m.enabled", "=", true);
+        cnd.and("m.lineId", "IS NOT", null);
+        cnd.and("m.lineId", "<>", "");
+        cnd.and("l.delFlag", "=", false);
+        cnd.and("l.enabled", "=", true);
+        if (StrUtil.isNotBlank(keyword)) {
+            SqlExpressionGroup keywordGroup = new SqlExpressionGroup();
+            keywordGroup.orLike("t.userName", keyword.trim());
+            keywordGroup.orLike("t.jobNo", keyword.trim());
+            cnd.and(keywordGroup);
+        }
+        cnd.andEX("t.unionId", "=", unionId);
+        applyMatterDataScope(cnd);
+        return cnd;
+    }
+
+    private NutMap fetchExportMatter(String matterId) {
+        Cnd cnd = Cnd.NEW();
+        cnd.and("m.delFlag", "=", false);
+        cnd.and("m.enabled", "=", true);
+        cnd.and("m.id", "=", matterId);
+        cnd.and("m.lineId", "IS NOT", null);
+        cnd.and("m.lineId", "<>", "");
+        cnd.and("l.delFlag", "=", false);
+        cnd.and("l.enabled", "=", true);
+        applyMatterDataScope(cnd);
+
+        Sql sql = Sqls.create("""
+                SELECT
+                    m.id AS matterId,
+                    m.`year`,
+                    m.unionId,
+                    COALESCE(u.name, '校工会') AS unionName,
+                    l.lineName,
+                    l.lineType,
+                    m.travelStartTime,
+                    m.travelEndTime,
+                    CASE
+                        WHEN IFNULL(m.travelStartTime, '') <> '' AND IFNULL(m.travelEndTime, '') <> ''
+                        THEN CONCAT(m.travelStartTime, ' 至 ', m.travelEndTime)
+                        ELSE ''
+                    END AS travelPeriod
+                FROM tour_matter m
+                INNER JOIN tour_line l ON l.id = m.lineId
+                LEFT JOIN sys_union u ON u.id = m.unionId
+                $condition
+                """);
+        sql.setCondition(cnd);
+        sql.setCallback(Sqls.callback.map());
+        tourMatterService.dao().execute(sql);
+        return sql.getObject(NutMap.class);
+    }
+
+    private List<NutMap> queryExportParticipants(String matterId) {
+        Cnd cnd = buildSignupQueryCnd(matterId, null, null);
+        Sql sql = Sqls.create("""
+                SELECT
+                    t.id AS ledgerId,
+                    t.jobNo,
+                    t.userName,
+                    t.idCard,
+                    vu.mobile,
+                    t.unionName,
+                    l.lineName,
+                    CASE
+                        WHEN IFNULL(m.travelStartTime, '') <> '' AND IFNULL(m.travelEndTime, '') <> ''
+                        THEN CONCAT(m.travelStartTime, ' 至 ', m.travelEndTime)
+                        ELSE ''
+                    END AS travelPeriod,
+                    t.signupTime
+                FROM tour_ledger t
+                INNER JOIN tour_matter m ON m.id = t.matterId
+                INNER JOIN tour_line l ON l.id = m.lineId
+                LEFT JOIN vw_user vu ON vu.loginname = t.jobNo
+                $condition
+                ORDER BY t.signupTime DESC, t.createdAt DESC
+                """);
+        sql.setCondition(cnd);
+        sql.setCallback(Sqls.callback.maps());
+        tourLedgerService.dao().execute(sql);
+        List<NutMap> list = sql.getList(NutMap.class);
+        fillExportFamilies(list);
+        return list;
+    }
+
+    private void fillExportFamilies(List<NutMap> list) {
+        if (list == null || list.isEmpty()) {
+            return;
+        }
+        List<String> ledgerIds = new ArrayList<>();
+        for (NutMap item : list) {
+            String ledgerId = item.getString("ledgerId", "");
+            if (StrUtil.isNotBlank(ledgerId)) {
+                ledgerIds.add(ledgerId);
+            }
+        }
+        if (ledgerIds.isEmpty()) {
+            return;
+        }
+        Sql sql = Sqls.create("""
+                SELECT
+                    ledgerId,
+                    familyName,
+                    relationship,
+                    idCard
+                FROM tour_ledger_family
+                WHERE delFlag = 0
+                  AND ledgerId IN (@ledgerIds)
+                ORDER BY createdAt ASC
+                """);
+        sql.setParam("ledgerIds", ledgerIds.toArray(new String[0]));
+        sql.setCallback(Sqls.callback.maps());
+        tourLedgerService.dao().execute(sql);
+
+        Map<String, List<NutMap>> familyMap = new HashMap<>();
+        for (NutMap family : sql.getList(NutMap.class)) {
+            familyMap.computeIfAbsent(family.getString("ledgerId", ""), key -> new ArrayList<>()).add(family);
+        }
+        for (NutMap item : list) {
+            item.put("families", familyMap.getOrDefault(item.getString("ledgerId", ""), List.of()));
+        }
+    }
+
+    /**
+     * 给报名人员列表挂载家属子列表；当前家属台账未保存手机号，mobile 字段先返回空值供前端占位。
+     */
+    private void fillSignupFamilies(List<NutMap> list) {
+        if (list == null || list.isEmpty()) {
+            return;
+        }
+        List<String> ledgerIds = new ArrayList<>();
+        for (NutMap item : list) {
+            String ledgerId = item.getString("id", "");
+            if (StrUtil.isNotBlank(ledgerId)) {
+                ledgerIds.add(ledgerId);
+            }
+        }
+        if (ledgerIds.isEmpty()) {
+            return;
+        }
+        Sql sql = Sqls.create("""
+                SELECT
+                    ledgerId,
+                    familyName,
+                    age,
+                    gender,
+                    '' AS mobile,
+                    idCard,
+                    relationship
+                FROM tour_ledger_family
+                WHERE delFlag = 0
+                  AND ledgerId IN (@ledgerIds)
+                ORDER BY createdAt ASC
+                """);
+        sql.setParam("ledgerIds", ledgerIds.toArray(new String[0]));
+        sql.setCallback(Sqls.callback.maps());
+        tourLedgerService.dao().execute(sql);
+
+        Map<String, List<NutMap>> familyMap = new HashMap<>();
+        for (NutMap family : sql.getList(NutMap.class)) {
+            familyMap.computeIfAbsent(family.getString("ledgerId", ""), key -> new ArrayList<>()).add(family);
+        }
+        for (NutMap item : list) {
+            item.put("families", familyMap.getOrDefault(item.getString("id", ""), List.of()));
+        }
+    }
+
+    private Workbook buildParticipantsWorkbook(NutMap matter, List<NutMap> list) {
+        Workbook workbook = new HSSFWorkbook();
+        Sheet sheet = workbook.createSheet("参加人员名单");
+        sheet.addMergedRegion(new CellRangeAddress(0, 0, 0, 10));
+        sheet.addMergedRegion(new CellRangeAddress(1, 1, 0, 10));
+
+        double[] widths = {6, 14, 12, 22, 16, 24, 34, 26, 12, 12, 16};
+        for (int i = 0; i < widths.length; i++) {
+            sheet.setColumnWidth(i, (int) (widths[i] * 256));
+        }
+
+        CellStyle titleStyle = createStyle(workbook, "黑体", (short) 16, true, HorizontalAlignment.CENTER, false, false);
+        CellStyle unionStyle = createStyle(workbook, "宋体", (short) 12, true, HorizontalAlignment.LEFT, false, false);
+        CellStyle headerStyle = createStyle(workbook, "宋体", (short) 11, true, HorizontalAlignment.CENTER, true, true);
+        CellStyle bodyStyle = createStyle(workbook, "宋体", (short) 11, false, HorizontalAlignment.CENTER, true, true);
+
+        Row titleRow = sheet.createRow(0);
+        titleRow.setHeightInPoints(30);
+        setCell(titleRow, 0, StrUtil.blankToDefault(matter.getString("lineName", ""), ""), titleStyle);
+        fillMergedCells(titleRow, 1, 10, titleStyle);
+
+        Row unionRow = sheet.createRow(1);
+        unionRow.setHeightInPoints(26);
+        setCell(unionRow, 0, "分工会：" + StrUtil.blankToDefault(matter.getString("unionName", ""), ""), unionStyle);
+        fillMergedCells(unionRow, 1, 10, unionStyle);
+
+        String[] headers = {"序号", "工号", "姓名", "身份证号码", "电话号码", "所属分工会", "所选线路名称", "疗休养时间", "亲属关系", "姓名", "备注"};
+        Row headerRow = sheet.createRow(2);
+        headerRow.setHeightInPoints(35);
+        for (int i = 0; i < headers.length; i++) {
+            setCell(headerRow, i, headers[i], headerStyle);
+        }
+
+        int rowIndex = 3;
+        int seq = 1;
+        for (NutMap item : list == null ? List.<NutMap>of() : list) {
+            Row staffRow = sheet.createRow(rowIndex++);
+            staffRow.setHeightInPoints(24);
+            setParticipantRow(staffRow, seq++, item.getString("jobNo", ""), item.getString("userName", ""),
+                    item.getString("idCard", ""), item.getString("mobile", ""), item.getString("unionName", ""),
+                    item.getString("lineName", matter.getString("lineName", "")), item.getString("travelPeriod", matter.getString("travelPeriod", "")),
+                    "", item.getString("userName", ""), bodyStyle);
+
+            Object familiesObj = item.get("families");
+            if (familiesObj instanceof List<?> families) {
+                for (Object obj : families) {
+                    if (!(obj instanceof NutMap family)) {
+                        continue;
+                    }
+                    Row familyRow = sheet.createRow(rowIndex++);
+                    familyRow.setHeightInPoints(24);
+                    setParticipantRow(familyRow, seq++, "", family.getString("familyName", ""),
+                            family.getString("idCard", ""), "", "",
+                            item.getString("lineName", matter.getString("lineName", "")),
+                            item.getString("travelPeriod", matter.getString("travelPeriod", "")),
+                            family.getString("relationship", ""), item.getString("userName", ""), bodyStyle);
+                }
+            }
+        }
+
+        int minRows = Math.max(rowIndex, 23);
+        while (rowIndex < minRows) {
+            Row row = sheet.createRow(rowIndex++);
+            row.setHeightInPoints(24);
+            for (int i = 0; i < headers.length; i++) {
+                setCell(row, i, "", bodyStyle);
+            }
+        }
+        return workbook;
+    }
+
+    private void setParticipantRow(Row row, int seq, String jobNo, String userName, String idCard, String mobile,
+                                   String unionName, String lineName, String travelPeriod, String relationship,
+                                   String participantName, CellStyle style) {
+        setCell(row, 0, String.valueOf(seq), style);
+        setCell(row, 1, jobNo, style);
+        setCell(row, 2, userName, style);
+        setCell(row, 3, idCard, style);
+        setCell(row, 4, mobile, style);
+        setCell(row, 5, unionName, style);
+        setCell(row, 6, lineName, style);
+        setCell(row, 7, travelPeriod, style);
+        setCell(row, 8, relationship, style);
+        setCell(row, 9, participantName, style);
+        setCell(row, 10, "", style);
+    }
+
+    private CellStyle createStyle(Workbook workbook, String fontName, short fontSize, boolean bold, HorizontalAlignment alignment, boolean wrap, boolean border) {
+        Font font = workbook.createFont();
+        font.setFontName(fontName);
+        font.setFontHeightInPoints(fontSize);
+        font.setBold(bold);
+
+        CellStyle style = workbook.createCellStyle();
+        style.setFont(font);
+        style.setAlignment(alignment);
+        style.setVerticalAlignment(VerticalAlignment.CENTER);
+        style.setWrapText(wrap);
+        if (border) {
+            style.setBorderLeft(BorderStyle.THIN);
+            style.setBorderTop(BorderStyle.THIN);
+            style.setBorderRight(BorderStyle.THIN);
+            style.setBorderBottom(BorderStyle.THIN);
+        }
+        return style;
+    }
+
+    private void setCell(Row row, int col, String value, CellStyle style) {
+        Cell cell = row.createCell(col);
+        cell.setCellValue(StrUtil.blankToDefault(value, ""));
+        cell.setCellStyle(style);
+    }
+
+    private void fillMergedCells(Row row, int startCol, int endCol, CellStyle style) {
+        for (int i = startCol; i <= endCol; i++) {
+            setCell(row, i, "", style);
+        }
+    }
+
+    private void fillSignupMobile(List<NutMap> list) {
+        if (list == null || list.isEmpty()) {
+            return;
+        }
+        List<String> jobNos = new ArrayList<>();
+        for (NutMap item : list) {
+            String jobNo = item.getString("jobNo", "");
+            if (StrUtil.isNotBlank(jobNo) && !jobNos.contains(jobNo)) {
+                jobNos.add(jobNo);
+            }
+        }
+        if (jobNos.isEmpty()) {
+            return;
+        }
+
+        Sql sql = Sqls.create("SELECT loginname, mobile FROM vw_user WHERE loginname IN (@jobNos)");
+        sql.setParam("jobNos", jobNos.toArray(new String[0]));
+        sql.setCallback(Sqls.callback.maps());
+        tourLedgerService.dao().execute(sql);
+
+        Map<String, String> mobileMap = new HashMap<>();
+        for (NutMap user : sql.getList(NutMap.class)) {
+            mobileMap.put(user.getString("loginname", ""), user.getString("mobile", ""));
+        }
+        for (NutMap item : list) {
+            item.put("mobile", mobileMap.getOrDefault(item.getString("jobNo", ""), ""));
+        }
+    }
+
+    private Cnd buildQueryCnd(Integer year, String lineName, String lineType, String unionId) {
+        Cnd cnd = Cnd.NEW();
+        cnd.and("m.delFlag", "=", false);
+        cnd.and("m.enabled", "=", true);
+        cnd.and("m.lineId", "IS NOT", null);
+        cnd.and("m.lineId", "<>", "");
+        cnd.and("l.delFlag", "=", false);
+        cnd.and("l.enabled", "=", true);
+        cnd.andEX("m.`year`", "=", year == null ? LocalDate.now().getYear() : year);
+        cnd.and(Cnd.likeEX("l.lineName", lineName));
+        cnd.andEX("l.lineType", "=", lineType);
+        cnd.andEX("m.unionId", "=", unionId);
+        applyMatterDataScope(cnd);
+        return cnd;
+    }
+
+    /**
+     * 线路成团按事项归属控制数据范围：校工会查看全部；分工会查看本工会事项；其它角色仅查看自己创建的事项。
+     */
+    private void applyMatterDataScope(Cnd cnd) {
+        if (hasSchoolUnionScope()) {
+            return;
+        }
+        if (hasBranchUnionScope()) {
+            cnd.and("m.unionId", "=", SecurityUtil.getUnionId());
+            return;
+        }
+        SqlExpressionGroup creatorGroup = new SqlExpressionGroup();
+        creatorGroup.or("m.creatorUserId", "=", SecurityUtil.getUserId());
+        creatorGroup.or("m.createdBy", "=", SecurityUtil.getUserId());
+        cnd.and(creatorGroup);
+    }
+
+    private boolean hasSchoolUnionScope() {
+        return AuthUtil.hasRole(RoleConstant.SYSADMIN.name())
+                || AuthUtil.hasRole(RoleConstant.SCHOOL_UNION_ADMIN.name())
+                || AuthUtil.hasRole(RoleConstant.SCHOOL_UNION_CHAIRMAN.name())
+                || AuthUtil.hasRole(RoleConstant.SCHOOL_UNION_VICE_CHAIRMAN.name())
+                || AuthUtil.hasRole(RoleConstant.SCHOOL_UNION_WELFARE_ADMIN.name())
+                || AuthUtil.hasRole(RoleConstant.SCHOOL_UNION_MEMBER_ADMIN.name())
+                || AuthUtil.hasRole(RoleConstant.SCHOOL_UNION_TC_ADMIN.name())
+                || AuthUtil.hasRole(RoleConstant.SCHOOL_UNION_WC_ADMIN.name())
+                || AuthUtil.hasRole(RoleConstant.SCHOOL_UNION_DC_ADMIN.name())
+                || AuthUtil.hasRole(RoleConstant.SCHOOL_UNION_PROPOSAL_ADMIN.name())
+                || AuthUtil.hasRole(RoleConstant.SCHOOL_UNION_CLUB_ADMIN.name())
+                || AuthUtil.hasRole(RoleConstant.SCHOOL_UNION_ACTIVITY_ADMIN.name());
+    }
+
+    private boolean hasBranchUnionScope() {
+        return AuthUtil.hasRole(RoleConstant.BRANCH_UNION_ADMIN.name())
+                || AuthUtil.hasRole(RoleConstant.BRANCH_UNION_CHAIRMAN.name())
+                || AuthUtil.hasRole(RoleConstant.BRANCH_UNION_VICE_CHAIRMAN.name())
+                || AuthUtil.hasRole(RoleConstant.BRANCH_UNION_OPERATOR.name())
+                || AuthUtil.hasRole(RoleConstant.BRANCH_UNION_GROUP_LEADER.name())
+                || AuthUtil.hasRole(RoleConstant.BRANCH_UNION_ARTICLE_WRITER.name())
+                || AuthUtil.hasRole(RoleConstant.BRANCH_UNION_WY.name())
+                || AuthUtil.hasRole(RoleConstant.BRANCH_UNION_ZUZHI_WY.name())
+                || AuthUtil.hasRole(RoleConstant.BRANCH_UNION_XUANCHUAN_WY.name())
+                || AuthUtil.hasRole(RoleConstant.BRANCH_UNION_NVGONG_WY.name())
+                || AuthUtil.hasRole(RoleConstant.BRANCH_UNION_QINGNIAN_WY.name())
+                || AuthUtil.hasRole(RoleConstant.BRANCH_UNION_WENTI_WY.name())
+                || AuthUtil.hasRole(RoleConstant.BRANCH_UNION_SHENGGHUO_WY.name())
+                || AuthUtil.hasRole(RoleConstant.BRANCH_UNION_TIAOJIE_WY.name())
+                || AuthUtil.hasRole(RoleConstant.BRANCH_UNION_WENTI_SPORTS.name());
+    }
+
+    private String getOrderColumn(String orderName) {
+        if ("lineName".equals(orderName)) {
+            return "l.lineName";
+        }
+        if ("travelPeriod".equals(orderName)) {
+            return "m.travelStartTime";
+        }
+        if ("matterName".equals(orderName)) {
+            return "m.matterName";
+        }
+        if ("unionName".equals(orderName)) {
+            return "u.name";
+        }
+        if ("lineType".equals(orderName)) {
+            return "l.lineType";
+        }
+        if ("signupCount".equals(orderName)) {
+            return "signupCount";
+        }
+        if ("minGroupPeople".equals(orderName)) {
+            return "m.minGroupPeople";
+        }
+        if ("maxGroupPeople".equals(orderName)) {
+            return "m.maxGroupPeople";
+        }
+        if ("groupStatusName".equals(orderName)) {
+            return "groupStatus";
+        }
+        return "l.lineName";
+    }
+
+    private String getSignupOrderColumn(String orderName) {
+        if ("jobNo".equals(orderName)) {
+            return "t.jobNo";
+        }
+        if ("userName".equals(orderName)) {
+            return "t.userName";
+        }
+        if ("idCard".equals(orderName)) {
+            return "t.idCard";
+        }
+        if ("unionName".equals(orderName)) {
+            return "t.unionName";
+        }
+        return "t.signupTime";
+    }
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/controller/TourLeaveApplyController.java

@@ -0,0 +1,78 @@
+package com.budwk.app.zhgh.dayofficework.tour.controller;
+
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import com.budwk.app.base.annotation.SLog;
+import com.budwk.app.base.param.PageForm;
+import com.budwk.app.base.result.Result;
+import com.budwk.app.zhgh.dayofficework.tour.service.TourLeaveApplyService;
+import org.nutz.aop.interceptor.ioc.TransAop;
+import org.nutz.ioc.aop.Aop;
+import org.nutz.ioc.loader.annotation.Inject;
+import org.nutz.ioc.loader.annotation.IocBean;
+import org.nutz.mvc.annotation.At;
+import org.nutz.mvc.annotation.Ok;
+
+@IocBean
+@Ok("json:full")
+@At("/platform/tour/leaveApply")
+public class TourLeaveApplyController {
+
+    @Inject
+    private TourLeaveApplyService leaveApplyService;
+
+    @At("")
+    @Ok("beetl:/platform/zhgh/dayofficework/Tour/leaveApply/index.html")
+    @SaCheckPermission("tour.leaveApply")
+    public void index() {
+    }
+
+    /**
+     * 查询人员分配表中的退出取消数据，旧退出申请表不再作为业务来源。
+     */
+    @At
+    @SaCheckPermission("tour.leaveApply")
+    public Result pageData(PageForm pageForm, String keyword, String unionName, String status) {
+        return Result.success(leaveApplyService.pageData(pageForm, keyword, unionName, status));
+    }
+
+    /**
+     * 查询当前登录人在取消管理页的可操作权限，供前端控制按钮显示。
+     */
+    @At
+    @SaCheckPermission("tour.leaveApply")
+    public Result permissionInfo() {
+        return Result.success(leaveApplyService.permissionInfo());
+    }
+
+    /**
+     * 取消人员分配记录：标记已退出，并同步删除该人员对应路线的报名台账。
+     */
+    @At
+    @Aop(TransAop.READ_COMMITTED)
+    @SaCheckPermission("tour.leaveApply")
+    @SLog(type = "tour", tag = "疗休养退出取消", msg = "取消疗休养人员分配")
+    public Result doCancel(String id) {
+        try {
+            leaveApplyService.cancelAssignment(id);
+            return Result.success();
+        } catch (IllegalArgumentException e) {
+            return Result.error(e.getMessage());
+        }
+    }
+
+    /**
+     * 恢复人员分配记录退出状态，只恢复人员分配表状态，不恢复已删除台账。
+     */
+    @At
+    @Aop(TransAop.READ_COMMITTED)
+    @SaCheckPermission("tour.branchUserAssignment.cancelRestore")
+    @SLog(type = "tour", tag = "疗休养退出取消", msg = "恢复疗休养人员分配退出状态")
+    public Result doRestore(String id) {
+        try {
+            leaveApplyService.restoreAssignment(id);
+            return Result.success();
+        } catch (IllegalArgumentException e) {
+            return Result.error(e.getMessage());
+        }
+    }
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/controller/TourLineController.java

@@ -0,0 +1,297 @@
+package com.budwk.app.zhgh.dayofficework.tour.controller;
+
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import cn.hutool.core.util.StrUtil;
+import com.budwk.app.base.annotation.SLog;
+import com.budwk.app.base.constant.RoleConstant;
+import com.budwk.app.base.page.Pagination;
+import com.budwk.app.base.param.PageForm;
+import com.budwk.app.base.result.Result;
+import com.budwk.app.sys.models.Sys_dict;
+import com.budwk.app.sys.services.SysDictService;
+import com.budwk.app.sys.views.View_user;
+import com.budwk.app.web.commons.auth.utils.AuthUtil;
+import com.budwk.app.web.commons.auth.utils.SecurityUtil;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourLine;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourTravelAgency;
+import com.budwk.app.zhgh.dayofficework.tour.service.TourLineService;
+import org.nutz.aop.interceptor.ioc.TransAop;
+import org.nutz.dao.Cnd;
+import org.nutz.dao.Sqls;
+import org.nutz.dao.sql.Sql;
+import org.nutz.dao.util.cri.SqlExpressionGroup;
+import org.nutz.ioc.aop.Aop;
+import org.nutz.ioc.loader.annotation.Inject;
+import org.nutz.ioc.loader.annotation.IocBean;
+import org.nutz.lang.util.NutMap;
+import org.nutz.mvc.annotation.At;
+import org.nutz.mvc.annotation.Ok;
+
+import java.util.Collections;
+import java.util.List;
+import java.util.stream.Collectors;
+
+@IocBean
+@Ok("json:full")
+@At("/platform/tour/route")
+public class TourLineController {
+
+    @Inject
+    private TourLineService tourLineService;
+
+    @Inject
+    private SysDictService sysDictService;
+
+    @At("")
+    @Ok("beetl:/platform/zhgh/dayofficework/Tour/route/index.html")
+    @SaCheckPermission("tour.route")
+    public void index() {
+    }
+
+    @At
+    @SaCheckPermission("tour.route")
+    public Result pageData(PageForm pageForm, Integer year, String lineName, String lotId) {
+        if (StrUtil.isBlank(pageForm.getPageOrderName())) {
+            pageForm.defaultSortDesc("enabled");
+        }
+
+        Cnd cnd = Cnd.NEW();
+        cnd.and("l.delFlag", "=", false);
+        cnd.andEX("l.`year`", "=", year);
+        cnd.and(Cnd.likeEX("l.lineName", lineName));
+        cnd.andEX("l.lotId", "=", lotId);
+        boolean sysAdmin = AuthUtil.hasRole(RoleConstant.SYSADMIN.name());
+        boolean branchUnionScope = !sysAdmin && AuthUtil.hasRole(RoleConstant.BRANCH_UNION_CHAIRMAN.name());
+        applyDataScope(cnd, sysAdmin, branchUnionScope);
+        String creatorJoin = branchUnionScope ? """
+                LEFT JOIN sys_unit lineUnit ON lineUnit.id = l.unitId
+                LEFT JOIN sys_user creatorUser ON creatorUser.id = COALESCE(NULLIF(l.creatorUserId, ''), l.createdBy)
+                LEFT JOIN sys_unit creatorUnit ON creatorUnit.id = creatorUser.unitId
+                """ : "";
+
+        Sql countSql = Sqls.create("""
+                SELECT COUNT(1)
+                FROM tour_line l
+                $creatorJoin
+                $condition
+                """);
+        countSql.setVar("creatorJoin", creatorJoin);
+        countSql.setCondition(cnd);
+        countSql.setCallback(Sqls.callback.integer());
+        tourLineService.dao().execute(countSql);
+        int count = countSql.getInt();
+
+        Sql listSql = Sqls.create("""
+                SELECT
+                    l.*,
+                    a.agencyName AS travelAgencyName,
+                    lot.lotName AS lotName
+                FROM tour_line l
+                LEFT JOIN tour_travel_agency a ON a.id = l.travelAgencyId
+                LEFT JOIN tour_setting_lot lot ON lot.id = l.lotId
+                $creatorJoin
+                $condition
+                ORDER BY $orderColumn $orderBy, l.`year` DESC, l.lineCode ASC, l.createdAt DESC
+                """);
+        listSql.setVar("creatorJoin", creatorJoin);
+        listSql.setCondition(cnd);
+        listSql.setVar("orderColumn", getOrderColumn(pageForm.getPageOrderName()));
+        listSql.setVar("orderBy", "descending".equals(pageForm.getPageOrderBy()) ? "desc" : "asc");
+        listSql.setPager(tourLineService.dao().createPager(pageForm.getPageNumber(), pageForm.getPageSize()));
+        listSql.setCallback(Sqls.callback.maps());
+        tourLineService.dao().execute(listSql);
+
+        Pagination<NutMap> pagination = new Pagination<>(pageForm.getPageNumber(), pageForm.getPageSize(), count, listSql.getList(NutMap.class));
+        return Result.success(pagination);
+    }
+
+    @At
+    @SaCheckPermission("tour.route")
+    public Result detail(String id) {
+        if (StrUtil.isBlank(id)) {
+            return Result.error("参数错误");
+        }
+        TourLine line = tourLineService.fetch(id);
+        return line == null ? Result.error("线路不存在") : Result.success(line);
+    }
+
+    @At
+    @SaCheckPermission("tour.route")
+    public Result travelAgencyOptions(Integer year) {
+        Cnd cnd = Cnd.where(TourTravelAgency::getEnabled, "=", true);
+        cnd.andEX(TourTravelAgency::getYear, "=", year);
+        cnd.asc(TourTravelAgency::getAgencyCode).asc(TourTravelAgency::getAgencyName);
+        return Result.success(tourLineService.dao().query(TourTravelAgency.class, cnd));
+    }
+
+    @At
+    @SaCheckPermission("tour.route")
+    public Result lotOptions(Integer year) {
+        Cnd cnd = Cnd.NEW();
+        cnd.andEX("s.`year`", "=", year);
+        Sql sql = Sqls.create("""
+                SELECT lot.id, lot.lotName, lot.lotValue, lot.activityCost
+                FROM tour_setting_lot lot
+                INNER JOIN tour_setting s ON s.id = lot.settingId
+                $condition
+                ORDER BY lot.lotValue DESC, lot.lotName ASC
+                """);
+        sql.setCondition(cnd);
+        sql.setCallback(Sqls.callback.maps());
+        tourLineService.dao().execute(sql);
+        return Result.success(sql.getList(NutMap.class));
+    }
+
+    @At
+    @SaCheckPermission("tour.route")
+    public Result lineTypeOptions() {
+        List<Sys_dict> list = sysDictService.getSubListByCode("lineType");
+        if (list == null) {
+            return Result.success(Collections.emptyList());
+        }
+        return Result.success(list.stream().filter(item -> !item.isDisabled()).collect(Collectors.toList()));
+    }
+
+    @At
+    @Aop(TransAop.READ_COMMITTED)
+    @SaCheckPermission("tour.route")
+    @SLog(type = "tour", tag = "线路管理", msg = "保存线路信息")
+    public Result doSubmit(TourLine line) {
+        Result checkResult = check(line);
+        if (checkResult != null) {
+            return checkResult;
+        }
+
+        Cnd sameCodeCnd = Cnd.where(TourLine::getYear, "=", line.getYear())
+                .and(TourLine::getLineCode, "=", line.getLineCode());
+        if (StrUtil.isNotBlank(line.getId())) {
+            sameCodeCnd.and(TourLine::getId, "<>", line.getId());
+        }
+        if (tourLineService.count(sameCodeCnd) > 0) {
+            return Result.error("同年度下线路编号已存在");
+        }
+        if (line.getEnabled() == null) {
+            line.setEnabled(true);
+        }
+        if (line.getOpenFlag() == null) {
+            line.setOpenFlag(true);
+        }
+        if (line.getDirectFamilyUnitLine() == null) {
+            line.setDirectFamilyUnitLine(false);
+        }
+        if (StrUtil.isBlank(line.getId())) {
+            fillCreatorInfo(line, null);
+            tourLineService.insert(line);
+        } else {
+            fillCreatorInfo(line, tourLineService.fetch(line.getId()));
+            tourLineService.updateIgnoreNull(line);
+        }
+        return Result.success();
+    }
+
+    @At
+    @Aop(TransAop.READ_COMMITTED)
+    @SaCheckPermission("tour.route")
+    @SLog(type = "tour", tag = "线路管理", msg = "删除线路信息")
+    public Result doDelete(String id) {
+        if (StrUtil.isBlank(id)) {
+            return Result.error("参数错误");
+        }
+        tourLineService.delete(id);
+        return Result.success();
+    }
+
+    private Result check(TourLine line) {
+        if (line == null) {
+            return Result.error("参数错误");
+        }
+        if (line.getYear() == null) {
+            return Result.error("创建年度不能为空");
+        }
+        if (StrUtil.isBlank(line.getTravelAgencyId())) {
+            return Result.error("旅行社名称不能为空");
+        }
+        if (StrUtil.isBlank(line.getLineName())) {
+            return Result.error("线路名称不能为空");
+        }
+        if (StrUtil.isBlank(line.getLineCode())) {
+            return Result.error("线路编号不能为空");
+        }
+        if (StrUtil.isBlank(line.getLineType())) {
+            return Result.error("线路类型不能为空");
+        }
+        if (StrUtil.isBlank(line.getLotId())) {
+            return Result.error("时间标段不能为空");
+        }
+        if (StrUtil.isBlank(line.getMobileThumb())) {
+            return Result.error("移动端缩略图不能为空");
+        }
+        return null;
+    }
+
+    /**
+     * 创建人和所在单位由当前登录人生成，编辑时保留原创建信息。
+     */
+    private void fillCreatorInfo(TourLine line, TourLine oldLine) {
+        if (oldLine != null) {
+            line.setCreatorUserId(defaultIfBlank(oldLine.getCreatorUserId(), SecurityUtil.getUserId()));
+            line.setCreatorName(defaultIfBlank(oldLine.getCreatorName(), SecurityUtil.getUserUsername()));
+            line.setUnitId(defaultIfBlank(oldLine.getUnitId(), SecurityUtil.getUnitId()));
+            line.setUnitName(defaultIfBlank(oldLine.getUnitName(), getCurrentUnitName()));
+            return;
+        }
+        line.setCreatorUserId(SecurityUtil.getUserId());
+        line.setCreatorName(SecurityUtil.getUserUsername());
+        line.setUnitId(SecurityUtil.getUnitId());
+        line.setUnitName(getCurrentUnitName());
+    }
+
+    private String getCurrentUnitName() {
+        View_user user = tourLineService.dao().fetch(View_user.class, Cnd.where("id", "=", SecurityUtil.getUserId()));
+        return user == null ? "" : defaultIfBlank(user.getUnitName(), "");
+    }
+
+    private String defaultIfBlank(String value, String defaultValue) {
+        return StrUtil.isBlank(value) ? defaultValue : value;
+    }
+
+    /**
+     * 线路数据范围：
+     * SYSADMIN 可查看全部；分工会主席查看本工会创建的线路；其它角色保持原逻辑，仅查看自己创建的线路。
+     */
+    private void applyDataScope(Cnd cnd, boolean sysAdmin, boolean branchUnionScope) {
+        if (sysAdmin) {
+            return;
+        }
+        if (branchUnionScope) {
+            SqlExpressionGroup unionGroup = new SqlExpressionGroup();
+            unionGroup.or("lineUnit.unionId", "=", SecurityUtil.getUnionId());
+            unionGroup.or("creatorUnit.unionId", "=", SecurityUtil.getUnionId());
+            cnd.and(unionGroup);
+            return;
+        }
+        SqlExpressionGroup creatorGroup = new SqlExpressionGroup();
+        creatorGroup.or("l.creatorUserId", "=", SecurityUtil.getUserId());
+        creatorGroup.or("l.createdBy", "=", SecurityUtil.getUserId());
+        cnd.and(creatorGroup);
+    }
+
+    private String getOrderColumn(String orderName) {
+        if ("year".equals(orderName)) {
+            return "l.`year`";
+        }
+        if ("lineCode".equals(orderName)) {
+            return "l.lineCode";
+        }
+        if ("lotName".equals(orderName)) {
+            return "lot.lotName";
+        }
+        if ("lineType".equals(orderName)) {
+            return "l.lineType";
+        }
+        if ("enabled".equals(orderName)) {
+            return "l.enabled";
+        }
+        return "l.`year`";
+    }
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/controller/TourMatterController.java

@@ -0,0 +1,456 @@
+package com.budwk.app.zhgh.dayofficework.tour.controller;
+
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import cn.hutool.core.util.StrUtil;
+import com.budwk.app.base.annotation.SLog;
+import com.budwk.app.base.constant.RoleConstant;
+import com.budwk.app.base.page.Pagination;
+import com.budwk.app.base.param.PageForm;
+import com.budwk.app.base.result.Result;
+import com.budwk.app.sys.models.Sys_dict;
+import com.budwk.app.sys.models.Sys_union;
+import com.budwk.app.sys.services.SysDictService;
+import com.budwk.app.web.commons.auth.utils.AuthUtil;
+import com.budwk.app.web.commons.auth.utils.SecurityUtil;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourLedger;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourMatter;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourSetting;
+import com.budwk.app.zhgh.dayofficework.tour.service.TourMatterService;
+import org.nutz.aop.interceptor.ioc.TransAop;
+import org.nutz.dao.Cnd;
+import org.nutz.dao.Sqls;
+import org.nutz.dao.sql.Sql;
+import org.nutz.dao.util.cri.SqlExpressionGroup;
+import org.nutz.ioc.aop.Aop;
+import org.nutz.ioc.loader.annotation.Inject;
+import org.nutz.ioc.loader.annotation.IocBean;
+import org.nutz.lang.util.NutMap;
+import org.nutz.mvc.annotation.At;
+import org.nutz.mvc.annotation.Ok;
+
+import java.util.Collections;
+import java.util.List;
+import java.util.stream.Collectors;
+
+@IocBean
+@Ok("json:full")
+@At("/platform/tour/matter")
+public class TourMatterController {
+
+    private static final String MOBILE_PATTERN = "^1[3-9]\\d{9}$";
+
+    @Inject
+    private TourMatterService tourMatterService;
+
+    @Inject
+    private SysDictService sysDictService;
+
+    @At("")
+    @Ok("beetl:/platform/zhgh/dayofficework/Tour/matter/index.html")
+    @SaCheckPermission("tour.matter")
+    public void index() {
+    }
+
+    @At
+    @SaCheckPermission("tour.matter")
+    public Result pageData(PageForm pageForm, Integer year, String matterName, String unionId, String organizationType) {
+        Cnd cnd = Cnd.NEW();
+        cnd.and("m.delFlag", "=", false);
+        cnd.andEX("m.`year`", "=", year);
+        cnd.and(Cnd.likeEX("m.matterName", matterName));
+        cnd.andEX("m.unionId", "=", unionId);
+        cnd.andEX("m.organizationType", "=", organizationType);
+        applyMatterDataScope(cnd);
+
+        Sql countSql = Sqls.create("""
+                SELECT COUNT(1)
+                FROM tour_matter m
+                $condition
+                """);
+        countSql.setCondition(cnd);
+        countSql.setCallback(Sqls.callback.integer());
+        tourMatterService.dao().execute(countSql);
+        int count = countSql.getInt();
+
+        Sql listSql = Sqls.create("""
+                SELECT
+                    m.*,
+                    s.configName AS settingName,
+                    u.name AS unionName,
+                    d.name AS organizationTypeName,
+                    l.lineName AS lineName,
+                    l.lineType AS lineType,
+                    l.directFamilyUnitLine AS directFamilyUnitLine
+                FROM tour_matter m
+                LEFT JOIN tour_setting s ON s.id = m.settingId
+                LEFT JOIN sys_union u ON u.id = m.unionId
+                LEFT JOIN tour_line l ON l.id = m.lineId
+                LEFT JOIN sys_dict d ON d.`code` = m.organizationType
+                    AND d.parentId = (SELECT id FROM sys_dict WHERE `code` = 'organizationType' LIMIT 1)
+                $condition
+                ORDER BY $orderColumn $orderBy, m.`year` DESC, m.createdAt DESC
+                """);
+        listSql.setCondition(cnd);
+        listSql.setVar("orderColumn", getOrderColumn(pageForm.getPageOrderName()));
+        listSql.setVar("orderBy", "descending".equals(pageForm.getPageOrderBy()) ? "desc" : "asc");
+        listSql.setPager(tourMatterService.dao().createPager(pageForm.getPageNumber(), pageForm.getPageSize()));
+        listSql.setCallback(Sqls.callback.maps());
+        tourMatterService.dao().execute(listSql);
+
+        Pagination<NutMap> pagination = new Pagination<>(pageForm.getPageNumber(), pageForm.getPageSize(), count, listSql.getList(NutMap.class));
+        return Result.success(pagination);
+    }
+
+    @At
+    @SaCheckPermission("tour.matter")
+    public Result detail(String id) {
+        if (StrUtil.isBlank(id)) {
+            return Result.error("参数错误");
+        }
+        TourMatter matter = tourMatterService.fetch(id);
+        return matter == null ? Result.error("事项不存在") : Result.success(matter);
+    }
+
+    @At
+    @SaCheckPermission("tour.matter")
+    public Result settingOptions(Integer year) {
+        Cnd cnd = Cnd.where(TourSetting::getEnabled, "=", true);
+        cnd.andEX(TourSetting::getYear, "=", year);
+        cnd.desc(TourSetting::getCreatedAt);
+        cnd.desc(TourSetting::getUpdatedAt);
+        cnd.asc(TourSetting::getConfigName);
+        return Result.success(tourMatterService.dao().query(TourSetting.class, cnd));
+    }
+
+    @At
+    @SaCheckPermission("tour.matter")
+    public Result unionOptions() {
+        Cnd cnd = Cnd.NEW();
+        cnd.asc("unionCode");
+        cnd.asc("name");
+        return Result.success(tourMatterService.dao().query(Sys_union.class, cnd));
+    }
+
+    @At
+    @SaCheckPermission("tour.matter")
+    public Result lineOptions(Integer year) {
+        Cnd cnd = Cnd.NEW();
+        cnd.and("l.delFlag", "=", false);
+        cnd.and("l.enabled", "=", true);
+        cnd.and("l.openFlag", "=", true);
+
+        Sql sql = Sqls.create("""
+                SELECT
+                    l.*,
+                    lot.lotName AS lotName,
+                    lot.lotValue AS lotValue,
+                    lot.lotValue AS lotDays,
+                    lot.activityCost AS activityCost
+                FROM tour_line l
+                LEFT JOIN tour_setting_lot lot ON lot.id = l.lotId
+                $condition
+                ORDER BY l.lineCode ASC, l.lineName ASC
+                """);
+        sql.setCondition(cnd);
+        sql.setCallback(Sqls.callback.maps());
+        tourMatterService.dao().execute(sql);
+        return Result.success(sql.getList(NutMap.class));
+    }
+
+    @At
+    @SaCheckPermission("tour.matter")
+    public Result organizationTypeOptions() {
+        List<Sys_dict> list = sysDictService.getSubListByCode("organizationType");
+        if (list == null) {
+            return Result.success(Collections.emptyList());
+        }
+        return Result.success(list.stream().filter(item -> !item.isDisabled()).collect(Collectors.toList()));
+    }
+
+    @At
+    @Aop(TransAop.READ_COMMITTED)
+    @SaCheckPermission("tour.matter")
+    @SLog(type = "tour", tag = "疗休养事项", msg = "保存疗休养事项")
+    public Result doSubmit(TourMatter matter) {
+        Result checkResult = check(matter);
+        if (checkResult != null) {
+            return checkResult;
+        }
+
+        Cnd sameNameCnd = Cnd.where(TourMatter::getYear, "=", matter.getYear())
+                .and(TourMatter::getMatterName, "=", matter.getMatterName());
+        if (StrUtil.isNotBlank(matter.getId())) {
+            sameNameCnd.and(TourMatter::getId, "<>", matter.getId());
+        }
+        if (tourMatterService.count(sameNameCnd) > 0) {
+            return Result.error("同年度下事项名称已存在");
+        }
+        if (matter.getEnabled() == null) {
+            matter.setEnabled(true);
+        }
+        fillCreatorAndUnion(matter);
+        if (StrUtil.isBlank(matter.getId())) {
+            tourMatterService.insert(matter);
+        } else {
+            tourMatterService.updateIgnoreNull(matter);
+        }
+        return Result.success();
+    }
+
+    @At
+    @Aop(TransAop.READ_COMMITTED)
+    @SaCheckPermission("tour.matter")
+    @SLog(type = "tour", tag = "疗休养事项", msg = "删除疗休养事项")
+    public Result doDelete(String id) {
+        if (StrUtil.isBlank(id)) {
+            return Result.error("参数错误");
+        }
+        TourMatter matter = tourMatterService.fetch(id);
+        if (matter == null) {
+            return Result.error("事项不存在");
+        }
+        long signupCount = countSignup(id);
+        if (signupCount > 0) {
+            return Result.error("当前事项对应线路已有人员报名，不能删除");
+        }
+        tourMatterService.delete(id);
+        return Result.success();
+    }
+
+    @At
+    @SaCheckPermission("tour.matter")
+    public Result deleteInfo(String id) {
+        if (StrUtil.isBlank(id)) {
+            return Result.error("参数错误");
+        }
+        TourMatter matter = tourMatterService.fetch(id);
+        if (matter == null) {
+            return Result.error("事项不存在");
+        }
+        long signupCount = countSignup(id);
+        return Result.success(NutMap.NEW()
+                .addv("signupCount", signupCount)
+                .addv("canDelete", signupCount <= 0)
+                .addv("message", signupCount > 0 ? "当前事项已有人员报名，不能删除" : "当前事项暂无人员报名，可删除"));
+    }
+
+    @At
+    @SaCheckPermission("tour.matter")
+    public Result lineConfig(String matterId) {
+        if (StrUtil.isBlank(matterId)) {
+            return Result.error("参数错误");
+        }
+        TourMatter matter = tourMatterService.fetch(matterId);
+        return matter == null ? Result.error("事项不存在") : Result.success(matter);
+    }
+
+    @At
+    @SaCheckPermission("tour.matter")
+    public Result settingPeople(String matterId) {
+        if (StrUtil.isBlank(matterId)) {
+            return Result.error("参数错误");
+        }
+        TourMatter matter = tourMatterService.fetch(matterId);
+        if (matter == null || StrUtil.isBlank(matter.getSettingId())) {
+            return Result.success(NutMap.NEW());
+        }
+        TourSetting setting = tourMatterService.dao().fetch(TourSetting.class, matter.getSettingId());
+        if (setting == null) {
+            return Result.success(NutMap.NEW());
+        }
+        return Result.success(NutMap.NEW()
+                .addv("minGroupPeople", setting.getMinGroupPeople())
+                .addv("maxGroupPeople", setting.getMaxGroupPeople()));
+    }
+
+    @At
+    @SaCheckPermission("tour.matter")
+    public Result settingBoardingPlaces(String settingId) {
+        if (StrUtil.isBlank(settingId)) {
+            return Result.error("参数错误");
+        }
+        TourSetting setting = tourMatterService.dao().fetch(TourSetting.class, settingId);
+        if (setting == null) {
+            return Result.error("疗休养配置不存在");
+        }
+        return Result.success(NutMap.NEW().addv("boardingPlace", StrUtil.blankToDefault(setting.getBoardingPlace(), "[]")));
+    }
+
+    @At
+    @Aop(TransAop.READ_COMMITTED)
+    @SaCheckPermission("tour.matter")
+    @SLog(type = "tour", tag = "疗休养事项", msg = "保存事项线路配置")
+    public Result lineConfigDoSubmit(TourMatter matter) {
+        Result checkResult = checkLineConfig(matter);
+        if (checkResult != null) {
+            return checkResult;
+        }
+        TourMatter oldMatter = tourMatterService.fetch(matter.getId());
+        if (oldMatter == null) {
+            return Result.error("事项不存在");
+        }
+        oldMatter.setLineId(matter.getLineId());
+        // 默认乘车地点来自疗休养配置中的乘车地点列表，后续代报名和自主报名会优先带出该值。
+        oldMatter.setDefaultBoardingPlace(matter.getDefaultBoardingPlace());
+        oldMatter.setSignupStartTime(matter.getSignupStartTime());
+        oldMatter.setSignupEndTime(matter.getSignupEndTime());
+        oldMatter.setTravelStartTime(matter.getTravelStartTime());
+        oldMatter.setTravelEndTime(matter.getTravelEndTime());
+        oldMatter.setContactName(matter.getContactName());
+        oldMatter.setContactPhone(matter.getContactPhone());
+        oldMatter.setMinGroupPeople(matter.getMinGroupPeople());
+        oldMatter.setMaxGroupPeople(matter.getMaxGroupPeople());
+        oldMatter.setEstimatedCost(matter.getEstimatedCost());
+        tourMatterService.update(oldMatter);
+        return Result.success();
+    }
+
+    private Result check(TourMatter matter) {
+        if (matter == null) {
+            return Result.error("参数错误");
+        }
+        if (matter.getYear() == null) {
+            return Result.error("年度不能为空");
+        }
+        if (StrUtil.isBlank(matter.getMatterName())) {
+            return Result.error("事项名称不能为空");
+        }
+        if (StrUtil.isBlank(matter.getSettingId())) {
+            return Result.error("疗休养配置不能为空");
+        }
+        if (StrUtil.isBlank(matter.getOrganizationType())) {
+            return Result.error("组织形式不能为空");
+        }
+        if (!"schoolUnion".equals(matter.getOrganizationType()) && StrUtil.isBlank(matter.getUnionId())) {
+            return Result.error("所属工会不能为空");
+        }
+        return null;
+    }
+
+    private Result checkLineConfig(TourMatter matter) {
+        if (matter == null) {
+            return Result.error("参数错误");
+        }
+        if (StrUtil.isBlank(matter.getId())) {
+            return Result.error("事项不能为空");
+        }
+        if (StrUtil.isBlank(matter.getLineId())) {
+            return Result.error("线路不能为空");
+        }
+        if (StrUtil.isBlank(matter.getSignupStartTime()) || StrUtil.isBlank(matter.getSignupEndTime())
+                || StrUtil.isBlank(matter.getTravelStartTime()) || StrUtil.isBlank(matter.getTravelEndTime())) {
+            return Result.error("时间不能为空");
+        }
+        if (matter.getSignupStartTime().compareTo(matter.getSignupEndTime()) >= 0) {
+            return Result.error("报名开始时间必须小于报名结束时间");
+        }
+        if (matter.getTravelStartTime().compareTo(matter.getTravelEndTime()) > 0) {
+            return Result.error("出行开始时间不能晚于出行结束时间");
+        }
+        if (matter.getSignupEndTime().compareTo(matter.getTravelStartTime()) >= 0) {
+            return Result.error("报名结束时间必须小于出行开始时间");
+        }
+        if (StrUtil.isBlank(matter.getContactName())) {
+            return Result.error("联系人不能为空");
+        }
+        if (StrUtil.isBlank(matter.getContactPhone()) || !matter.getContactPhone().matches(MOBILE_PATTERN)) {
+            return Result.error("联系方式格式不正确");
+        }
+        if (matter.getMinGroupPeople() == null || matter.getMinGroupPeople() <= 0) {
+            return Result.error("最少成团人数必须大于0");
+        }
+        if (matter.getMaxGroupPeople() == null || matter.getMaxGroupPeople() <= 0) {
+            return Result.error("最多成团人数必须大于0");
+        }
+        if (matter.getMinGroupPeople() > matter.getMaxGroupPeople()) {
+            return Result.error("最少成团人数不能大于最多成团人数");
+        }
+        if (matter.getEstimatedCost() == null || matter.getEstimatedCost().signum() < 0) {
+            return Result.error("预计费用不能小于0");
+        }
+        return null;
+    }
+
+    private void fillCreatorAndUnion(TourMatter matter) {
+        if (StrUtil.isBlank(matter.getId())) {
+            matter.setCreatorUserId(SecurityUtil.getUserId());
+            matter.setCreatorName(SecurityUtil.getUserUsername());
+        } else {
+            TourMatter oldMatter = tourMatterService.fetch(matter.getId());
+            if (oldMatter != null) {
+                matter.setCreatorUserId(oldMatter.getCreatorUserId());
+                matter.setCreatorName(oldMatter.getCreatorName());
+            }
+        }
+        if ("schoolUnion".equals(matter.getOrganizationType())) {
+            matter.setUnionId("");
+        }
+    }
+
+    private long countSignup(String matterId) {
+        return tourMatterService.dao().count(TourLedger.class, Cnd.where(TourLedger::getDelFlag, "=", false)
+                .and(TourLedger::getMatterId, "=", matterId));
+    }
+
+    /**
+     * 事项数据范围：SYSADMIN 查看全部；分工会主席查看本工会事项；其它角色仅查看自己创建的事项。
+     */
+    private void applyMatterDataScope(Cnd cnd) {
+        if (AuthUtil.hasRole(RoleConstant.SYSADMIN.name())) {
+            return;
+        }
+        if (AuthUtil.hasRole(RoleConstant.BRANCH_UNION_CHAIRMAN.name())) {
+            cnd.and("m.unionId", "=", SecurityUtil.getUnionId());
+            return;
+        }
+        SqlExpressionGroup creatorGroup = new SqlExpressionGroup();
+        creatorGroup.or("m.creatorUserId", "=", SecurityUtil.getUserId());
+        creatorGroup.or("m.createdBy", "=", SecurityUtil.getUserId());
+        cnd.and(creatorGroup);
+    }
+
+    /**
+     * 事项批次选择线路时沿用线路管理的数据范围，避免在事项页面选到权限外线路。
+     */
+    private void applyLineDataScope(Cnd cnd, boolean sysAdmin, boolean branchUnionScope) {
+        if (sysAdmin) {
+            return;
+        }
+        if (branchUnionScope) {
+            SqlExpressionGroup unionGroup = new SqlExpressionGroup();
+            unionGroup.or("lineUnit.unionId", "=", SecurityUtil.getUnionId());
+            unionGroup.or("creatorUnit.unionId", "=", SecurityUtil.getUnionId());
+            cnd.and(unionGroup);
+            return;
+        }
+        SqlExpressionGroup creatorGroup = new SqlExpressionGroup();
+        creatorGroup.or("l.creatorUserId", "=", SecurityUtil.getUserId());
+        creatorGroup.or("l.createdBy", "=", SecurityUtil.getUserId());
+        cnd.and(creatorGroup);
+    }
+
+    private String getOrderColumn(String orderName) {
+        if ("year".equals(orderName)) {
+            return "m.`year`";
+        }
+        if ("matterName".equals(orderName)) {
+            return "m.matterName";
+        }
+        if ("unionName".equals(orderName)) {
+            return "u.name";
+        }
+        if ("lineName".equals(orderName)) {
+            return "l.lineName";
+        }
+        if ("settingName".equals(orderName)) {
+            return "s.configName";
+        }
+        if ("organizationTypeName".equals(orderName)) {
+            return "d.location";
+        }
+        if ("enabled".equals(orderName)) {
+            return "m.enabled";
+        }
+        return "m.`year`";
+    }
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/controller/TourPlaceholderController.java

@@ -0,0 +1,13 @@
+package com.budwk.app.zhgh.dayofficework.tour.controller;
+
+import org.nutz.ioc.loader.annotation.IocBean;
+import org.nutz.mvc.annotation.At;
+
+/**
+ * 分阶段建设的菜单占位入口。
+ */
+@IocBean
+@At("/platform/tour")
+public class TourPlaceholderController {
+
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/controller/TourSchoolUnionApprovalController.java

@@ -0,0 +1,581 @@
+package com.budwk.app.zhgh.dayofficework.tour.controller;
+
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import cn.dev33.satoken.annotation.SaMode;
+import cn.hutool.core.util.StrUtil;
+import com.budwk.app.base.page.Pagination;
+import com.budwk.app.base.param.PageForm;
+import com.budwk.app.base.result.Result;
+import com.budwk.app.flow.enums.ProcessTaskStateEnum;
+import com.budwk.app.web.commons.auth.utils.SecurityUtil;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourLedger;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourLedgerDirectRelative;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourLedgerFamily;
+import com.budwk.app.zhgh.dayofficework.tour.service.TourLedgerDirectRelativeService;
+import com.budwk.app.zhgh.dayofficework.tour.service.TourLedgerFamilyService;
+import com.budwk.app.zhgh.dayofficework.tour.service.TourLedgerService;
+import org.nutz.dao.Cnd;
+import org.nutz.dao.Sqls;
+import org.nutz.dao.sql.Sql;
+import org.nutz.dao.util.cri.SqlExpressionGroup;
+import org.nutz.ioc.loader.annotation.Inject;
+import org.nutz.ioc.loader.annotation.IocBean;
+import org.nutz.lang.util.NutMap;
+import org.nutz.mvc.annotation.At;
+import org.nutz.mvc.annotation.Ok;
+
+import java.time.LocalDate;
+import java.util.List;
+
+@IocBean
+@Ok("json:full")
+@At("/platform/tour/schoolUnionApproval")
+public class TourSchoolUnionApprovalController {
+
+    private static final String WORKFLOW_KEY = "LXYBZXQSXL";
+    private static final String TASK_DISPLAY_NAME = "校工会审核";
+
+    @Inject
+    private TourLedgerService tourLedgerService;
+
+    @Inject
+    private TourLedgerFamilyService tourLedgerFamilyService;
+
+    @Inject
+    private TourLedgerDirectRelativeService tourLedgerDirectRelativeService;
+
+    @At("")
+    @Ok("beetl:/platform/zhgh/dayofficework/Tour/schoolUnionApproval/index.html")
+    @SaCheckPermission(value = {"tour.schoolUnionApproval", "h5.tour.schoolUnionApproval"}, mode = SaMode.OR)
+    public void index() {
+    }
+
+    @At("/h5")
+    @Ok("beetl:/platform/zhghh5/dayofficework/tour/schoolUnionApproval/index.html")
+    @SaCheckPermission(value = {"tour.schoolUnionApproval", "h5.tour.schoolUnionApproval"}, mode = SaMode.OR)
+    public void h5() {
+    }
+
+    @At
+    @SaCheckPermission(value = {"tour.schoolUnionApproval", "h5.tour.schoolUnionApproval"}, mode = SaMode.OR)
+    public Result pageData(PageForm pageForm, Boolean audit, Integer startYear, Integer endYear, String keyword, String unionId, String lineId, String travelPeriod, String lineType) {
+        Cnd cnd = buildAuditCnd(audit, startYear, endYear, keyword, unionId, lineId, travelPeriod, lineType);
+
+        Sql countSql = Sqls.create("""
+                SELECT COUNT(DISTINCT task.id)
+                FROM wf_process_task task
+                LEFT JOIN wf_process_instance ins ON ins.id = task.processInstanceId
+                LEFT JOIN wf_process_define def ON def.id = ins.processDefineId
+                LEFT JOIN wf_process_task_actor ta ON ta.processTaskId = task.id
+                INNER JOIN tour_ledger t ON t.id = ins.businessNo
+                LEFT JOIN tour_matter m ON m.id = t.matterId AND m.delFlag = 0
+                LEFT JOIN tour_line l ON l.id = t.lineId AND l.delFlag = 0
+                $condition
+                """);
+        countSql.setCondition(cnd);
+        countSql.setCallback(Sqls.callback.integer());
+        tourLedgerService.dao().execute(countSql);
+        int count = countSql.getInt();
+
+        Sql listSql = Sqls.create("""
+                SELECT
+                    t.*,
+                    ins.id AS instanceId,
+                    ins.businessNo,
+                    ins.state AS instanceState,
+                    ins.variable AS instanceVariable,
+                    ins.processDefineId AS instanceProcessDefineId,
+                    task.id AS taskId,
+                    task.taskName AS taskKey,
+                    task.displayName AS taskName,
+                    task.taskType,
+                    task.performType AS taskPerformType,
+                    task.taskState,
+                    task.finishTime,
+                    task.taskParentId,
+                    task.variable AS taskVariable,
+                    IFNULL(GROUP_CONCAT(DISTINCT nt.displayName), '结束') AS curTaskName,
+                    CASE
+                        WHEN m.id IS NULL THEN COALESCE(NULLIF(l.lineName, ''), t.lineName)
+                        ELSE CONCAT(
+                            COALESCE(NULLIF(l.lineName, ''), t.lineName),
+                            '（',
+                            CASE
+                                WHEN IFNULL(m.unionId, '') = '' THEN '校工会'
+                                ELSE IFNULL(mu.name, '')
+                            END,
+                            '）'
+                        )
+                    END AS currentLineName,
+                    CASE
+                        WHEN IFNULL(m.travelStartTime, '') <> '' AND IFNULL(m.travelEndTime, '') <> ''
+                        THEN CONCAT(m.travelStartTime, ' 至 ', m.travelEndTime)
+                        ELSE tp.travelPeriod
+                    END AS travelPeriod,
+                    IFNULL(f.familyCount, 0) AS familyCount
+                FROM wf_process_task task
+                LEFT JOIN wf_process_instance ins ON ins.id = task.processInstanceId
+                LEFT JOIN wf_process_define def ON def.id = ins.processDefineId
+                LEFT JOIN wf_process_task_actor ta ON ta.processTaskId = task.id
+                INNER JOIN tour_ledger t ON t.id = ins.businessNo
+                LEFT JOIN wf_process_task nt ON nt.processInstanceId = ins.id AND nt.taskState = 10
+                LEFT JOIN (
+                    SELECT ledgerId, COUNT(1) AS familyCount
+                    FROM tour_ledger_family
+                    WHERE delFlag = 0
+                    GROUP BY ledgerId
+                ) f ON f.ledgerId = t.id
+                LEFT JOIN tour_matter m ON m.id = t.matterId AND m.delFlag = 0
+                LEFT JOIN tour_line l ON l.id = t.lineId AND l.delFlag = 0
+                LEFT JOIN sys_union mu ON mu.id = m.unionId
+                LEFT JOIN (
+                    SELECT
+                        `year`,
+                        lineId,
+                        GROUP_CONCAT(
+                            DISTINCT CASE
+                                WHEN IFNULL(travelStartTime, '') <> '' AND IFNULL(travelEndTime, '') <> ''
+                                THEN CONCAT(travelStartTime, ' 至 ', travelEndTime)
+                                ELSE NULL
+                            END
+                            ORDER BY travelStartTime ASC
+                            SEPARATOR '；'
+                        ) AS travelPeriod
+                    FROM tour_matter
+                    WHERE delFlag = 0
+                      AND lineId IS NOT NULL
+                      AND lineId <> ''
+                    GROUP BY `year`, lineId
+                ) tp ON (t.matterId IS NULL OR t.matterId = '') AND tp.`year` = t.`year` AND tp.lineId = t.lineId
+                $condition
+                GROUP BY task.id
+                ORDER BY $orderColumn $orderBy, task.createdAt DESC, t.signupTime DESC, t.createdAt DESC
+                """);
+        listSql.setCondition(cnd);
+        listSql.setVar("orderColumn", getOrderColumn(pageForm.getPageOrderName()));
+        listSql.setVar("orderBy", "ascending".equals(pageForm.getPageOrderBy()) ? "asc" : "desc");
+        listSql.setPager(tourLedgerService.dao().createPager(pageForm.getPageNumber(), pageForm.getPageSize()));
+        listSql.setCallback(Sqls.callback.maps());
+        tourLedgerService.dao().execute(listSql);
+
+        List<NutMap> list = listSql.getList(NutMap.class);
+        list.forEach(item -> item.put("lineName", item.getString("currentLineName")));
+        Pagination<NutMap> pagination = new Pagination<>(pageForm.getPageNumber(), pageForm.getPageSize(), count, list);
+        return Result.success(pagination);
+    }
+
+    @At
+    @SaCheckPermission(value = {"tour.schoolUnionApproval", "h5.tour.schoolUnionApproval"}, mode = SaMode.OR)
+    public Result detail(String id) {
+        TourLedger ledger = fetchAuditLedger(id);
+        if (ledger == null) {
+            return Result.error("报名记录不存在或无权查看");
+        }
+        ledger.setLineName(getCurrentLineName(ledger));
+        Cnd familyCnd = Cnd.where(TourLedgerFamily::getLedgerId, "=", ledger.getId())
+                .and(TourLedgerFamily::getDelFlag, "=", false);
+        familyCnd.asc(TourLedgerFamily::getCreatedAt);
+        TourLedgerDirectRelative directRelative = tourLedgerDirectRelativeService.fetch(
+                Cnd.where(TourLedgerDirectRelative::getLedgerId, "=", ledger.getId())
+                        .and(TourLedgerDirectRelative::getDelFlag, "=", false));
+        NutMap signupConfig = getSignupConfig(ledger);
+        return Result.success(NutMap.NEW()
+                .addv("ledger", ledger)
+                .addv("travelPeriod", getTravelPeriod(ledger))
+                .addv("families", tourLedgerFamilyService.query(familyCnd))
+                .addv("directRelative", directRelative)
+                .addv("allowFamily", signupConfig.getBoolean("allowFamily", false))
+                .addv("fillBedInfo", signupConfig.getBoolean("fillBedInfo", true))
+                .addv("directFamilyUnitLine", signupConfig.getBoolean("directFamilyUnitLine", false)));
+    }
+
+    @At
+    @SaCheckPermission(value = {"tour.schoolUnionApproval", "h5.tour.schoolUnionApproval"}, mode = SaMode.OR)
+    public Result unionOptions(Boolean audit, Integer startYear, Integer endYear, String keyword, String lineId, String travelPeriod, String lineType) {
+        Cnd cnd = buildAuditCnd(audit, startYear, endYear, keyword, null, lineId, travelPeriod, lineType);
+        cnd.and("t.unionId", "IS NOT", null);
+        cnd.and("t.unionId", "<>", "");
+
+        Sql sql = Sqls.create("""
+                SELECT DISTINCT
+                    t.unionId AS id,
+                    COALESCE(NULLIF(u.name, ''), t.unionName) AS name,
+                    u.unionCode
+                FROM wf_process_task task
+                LEFT JOIN wf_process_instance ins ON ins.id = task.processInstanceId
+                LEFT JOIN wf_process_define def ON def.id = ins.processDefineId
+                LEFT JOIN wf_process_task_actor ta ON ta.processTaskId = task.id
+                INNER JOIN tour_ledger t ON t.id = ins.businessNo
+                LEFT JOIN tour_matter m ON m.id = t.matterId AND m.delFlag = 0
+                LEFT JOIN tour_line l ON l.id = t.lineId AND l.delFlag = 0
+                LEFT JOIN sys_union u ON u.id = t.unionId
+                $condition
+                ORDER BY u.unionCode ASC, name ASC
+                """);
+        sql.setCondition(cnd);
+        sql.setCallback(Sqls.callback.maps());
+        tourLedgerService.dao().execute(sql);
+        return Result.success(sql.getList(NutMap.class));
+    }
+
+    @At
+    @SaCheckPermission(value = {"tour.schoolUnionApproval", "h5.tour.schoolUnionApproval"}, mode = SaMode.OR)
+    public Result lineOptions(Boolean audit, Integer startYear, Integer endYear, String travelPeriod, String lineType, String unionId, String keyword) {
+        Cnd cnd = buildAuditCnd(audit, startYear, endYear, keyword, unionId, null, travelPeriod, lineType);
+        cnd.and("t.lineName", "IS NOT", null);
+        cnd.and("t.lineName", "<>", "");
+
+        Sql sql = Sqls.create("""
+                SELECT DISTINCT
+                    CASE
+                        WHEN IFNULL(t.lineId, '') <> '' THEN CONCAT(t.lineId, '|', IFNULL(m.unionId, ''))
+                        ELSE CONCAT('legacy:', t.lineName, '|', IFNULL(m.unionId, ''))
+                    END AS lineId,
+                    CASE
+                        WHEN m.id IS NULL THEN COALESCE(NULLIF(l.lineName, ''), t.lineName)
+                        ELSE CONCAT(
+                            COALESCE(NULLIF(l.lineName, ''), t.lineName),
+                            '（',
+                            CASE
+                                WHEN IFNULL(m.unionId, '') = '' THEN '校工会'
+                                ELSE IFNULL(mu.name, '')
+                            END,
+                            '）'
+                        )
+                    END AS lineName
+                FROM wf_process_task task
+                LEFT JOIN wf_process_instance ins ON ins.id = task.processInstanceId
+                LEFT JOIN wf_process_define def ON def.id = ins.processDefineId
+                LEFT JOIN wf_process_task_actor ta ON ta.processTaskId = task.id
+                INNER JOIN tour_ledger t ON t.id = ins.businessNo
+                LEFT JOIN tour_matter m ON m.id = t.matterId AND m.delFlag = 0
+                LEFT JOIN tour_line l ON l.id = t.lineId AND l.delFlag = 0
+                LEFT JOIN sys_union mu ON mu.id = m.unionId
+                $condition
+                ORDER BY lineName ASC
+                """);
+        sql.setCondition(cnd);
+        sql.setCallback(Sqls.callback.maps());
+        tourLedgerService.dao().execute(sql);
+        return Result.success(sql.getList(NutMap.class));
+    }
+
+    @At
+    @SaCheckPermission(value = {"tour.schoolUnionApproval", "h5.tour.schoolUnionApproval"}, mode = SaMode.OR)
+    public Result travelPeriodOptions(Boolean audit, Integer startYear, Integer endYear, String lineId, String lineType, String unionId, String keyword) {
+        Cnd cnd = buildAuditCnd(audit, startYear, endYear, keyword, unionId, lineId, null, lineType);
+        cnd.and("m.travelStartTime", "IS NOT", null);
+        cnd.and("m.travelStartTime", "<>", "");
+        cnd.and("m.travelEndTime", "IS NOT", null);
+        cnd.and("m.travelEndTime", "<>", "");
+
+        Sql sql = Sqls.create("""
+                SELECT DISTINCT CONCAT(m.travelStartTime, ' 至 ', m.travelEndTime) AS travelPeriod
+                FROM wf_process_task task
+                LEFT JOIN wf_process_instance ins ON ins.id = task.processInstanceId
+                LEFT JOIN wf_process_define def ON def.id = ins.processDefineId
+                LEFT JOIN wf_process_task_actor ta ON ta.processTaskId = task.id
+                INNER JOIN tour_ledger t ON t.id = ins.businessNo
+                LEFT JOIN tour_matter m ON m.id = t.matterId AND m.delFlag = 0
+                LEFT JOIN tour_line l ON l.id = t.lineId AND l.delFlag = 0
+                $condition
+                ORDER BY travelPeriod ASC
+                """);
+        sql.setCondition(cnd);
+        sql.setCallback(Sqls.callback.maps());
+        tourLedgerService.dao().execute(sql);
+        return Result.success(sql.getList(NutMap.class));
+    }
+
+    @At
+    @SaCheckPermission(value = {"tour.schoolUnionApproval", "h5.tour.schoolUnionApproval"}, mode = SaMode.OR)
+    public Result lineTypeOptions(Boolean audit, Integer startYear, Integer endYear, String lineId, String travelPeriod, String unionId, String keyword) {
+        Cnd cnd = buildAuditCnd(audit, startYear, endYear, keyword, unionId, lineId, travelPeriod, null);
+        cnd.and("t.lineType", "IS NOT", null);
+        cnd.and("t.lineType", "<>", "");
+
+        Sql sql = Sqls.create("""
+                SELECT DISTINCT t.lineType
+                FROM wf_process_task task
+                LEFT JOIN wf_process_instance ins ON ins.id = task.processInstanceId
+                LEFT JOIN wf_process_define def ON def.id = ins.processDefineId
+                LEFT JOIN wf_process_task_actor ta ON ta.processTaskId = task.id
+                INNER JOIN tour_ledger t ON t.id = ins.businessNo
+                LEFT JOIN tour_matter m ON m.id = t.matterId AND m.delFlag = 0
+                LEFT JOIN tour_line l ON l.id = t.lineId AND l.delFlag = 0
+                $condition
+                ORDER BY t.lineType ASC
+                """);
+        sql.setCondition(cnd);
+        sql.setCallback(Sqls.callback.maps());
+        tourLedgerService.dao().execute(sql);
+        return Result.success(sql.getList(NutMap.class));
+    }
+
+    private Cnd buildAuditCnd(Boolean audit, Integer startYear, Integer endYear, String keyword, String unionId, String lineId, String travelPeriod, String lineType) {
+        Cnd cnd = Cnd.NEW();
+        cnd.and("t.delFlag", "=", false);
+        cnd.and("def.name", "=", WORKFLOW_KEY);
+        cnd.and("task.displayName", "=", TASK_DISPLAY_NAME);
+        cnd.and("ta.actorId", "in", List.of(SecurityUtil.getUserId()));
+        appendAuditStateFilter(cnd, audit);
+        cnd.andEX("t.`year`", ">=", startYear);
+        cnd.andEX("t.`year`", "<=", endYear == null ? LocalDate.now().getYear() : endYear);
+        cnd.andEX("t.unionId", "=", unionId);
+        cnd.andEX("t.lineType", "=", lineType);
+        appendLineFilter(cnd, lineId);
+        appendTravelPeriodFilter(cnd, travelPeriod);
+        appendKeywordFilter(cnd, keyword);
+        return cnd;
+    }
+
+    private void appendAuditStateFilter(Cnd cnd, Boolean audit) {
+        if (Boolean.TRUE.equals(audit)) {
+            cnd.and("task.taskState", "in", List.of(
+                    ProcessTaskStateEnum.FINISHED.getCode(),
+                    ProcessTaskStateEnum.WITHDRAW.getCode(),
+                    ProcessTaskStateEnum.INTERRUPT.getCode()));
+            return;
+        }
+        cnd.and("task.taskState", "=", ProcessTaskStateEnum.DOING.getCode());
+    }
+
+    private void appendKeywordFilter(Cnd cnd, String keyword) {
+        if (StrUtil.isBlank(keyword)) {
+            return;
+        }
+        SqlExpressionGroup group = new SqlExpressionGroup();
+        group.orLike("t.userName", keyword.trim());
+        group.orLike("t.jobNo", keyword.trim());
+        group.orLike("t.lineName", keyword.trim());
+        group.orLike("l.lineName", keyword.trim());
+        cnd.and(group);
+    }
+
+    private void appendTravelPeriodFilter(Cnd cnd, String travelPeriod) {
+        if (StrUtil.isBlank(travelPeriod)) {
+            return;
+        }
+        cnd.and("CONCAT(m.travelStartTime, ' 至 ', m.travelEndTime)", "=", travelPeriod);
+    }
+
+    private void appendLineFilter(Cnd cnd, String lineId) {
+        if (StrUtil.isBlank(lineId)) {
+            return;
+        }
+        LineFilter lineFilter = parseLineFilter(lineId);
+        if (lineFilter.getLineId().startsWith("legacy:")) {
+            SqlExpressionGroup legacyGroup = new SqlExpressionGroup();
+            legacyGroup.or("t.lineId", "IS", null);
+            legacyGroup.or("t.lineId", "=", "");
+            cnd.and(legacyGroup);
+            cnd.and("t.lineName", "=", lineFilter.getLineId().substring("legacy:".length()));
+        } else {
+            cnd.and("t.lineId", "=", lineFilter.getLineId());
+        }
+        appendMatterUnionFilter(cnd, lineFilter.getUnionId());
+    }
+
+    private LineFilter parseLineFilter(String value) {
+        int delimiterIndex = value.indexOf("|");
+        if (delimiterIndex < 0) {
+            return new LineFilter(value, null);
+        }
+        return new LineFilter(value.substring(0, delimiterIndex), value.substring(delimiterIndex + 1));
+    }
+
+    private void appendMatterUnionFilter(Cnd cnd, String unionId) {
+        if (unionId == null) {
+            return;
+        }
+        if (StrUtil.isBlank(unionId)) {
+            SqlExpressionGroup group = new SqlExpressionGroup();
+            group.or("m.unionId", "IS", null);
+            group.or("m.unionId", "=", "");
+            cnd.and(group);
+            return;
+        }
+        cnd.and("m.unionId", "=", unionId);
+    }
+
+    private String getOrderColumn(String orderName) {
+        if ("jobNo".equals(orderName)) {
+            return "t.jobNo";
+        }
+        if ("userName".equals(orderName)) {
+            return "t.userName";
+        }
+        if ("lineName".equals(orderName)) {
+            return """
+                    CASE
+                        WHEN m.id IS NULL THEN COALESCE(NULLIF(l.lineName, ''), t.lineName)
+                        ELSE CONCAT(
+                            COALESCE(NULLIF(l.lineName, ''), t.lineName),
+                            '（',
+                            CASE
+                                WHEN IFNULL(m.unionId, '') = '' THEN '校工会'
+                                ELSE IFNULL(mu.name, '')
+                            END,
+                            '）'
+                        )
+                    END
+                    """;
+        }
+        if ("travelPeriod".equals(orderName)) {
+            return "COALESCE(m.travelStartTime, tp.travelPeriod)";
+        }
+        if ("lineType".equals(orderName)) {
+            return "t.lineType";
+        }
+        if ("signupTime".equals(orderName)) {
+            return "t.signupTime";
+        }
+        if ("familyCount".equals(orderName)) {
+            return "familyCount";
+        }
+        if ("instanceState".equals(orderName)) {
+            return "ins.state";
+        }
+        return "task.createdAt";
+    }
+
+    private TourLedger fetchAuditLedger(String id) {
+        if (StrUtil.isBlank(id)) {
+            return null;
+        }
+        Sql sql = Sqls.create("""
+                SELECT COUNT(1)
+                FROM wf_process_task task
+                LEFT JOIN wf_process_instance ins ON ins.id = task.processInstanceId
+                LEFT JOIN wf_process_define def ON def.id = ins.processDefineId
+                LEFT JOIN wf_process_task_actor ta ON ta.processTaskId = task.id
+                INNER JOIN tour_ledger t ON t.id = ins.businessNo
+                WHERE t.delFlag = 0
+                  AND t.id = @id
+                  AND def.name = @workflowKey
+                  AND task.displayName = @taskDisplayName
+                  AND ta.actorId = @actorId
+                """);
+        sql.setParam("id", id);
+        sql.setParam("workflowKey", WORKFLOW_KEY);
+        sql.setParam("taskDisplayName", TASK_DISPLAY_NAME);
+        sql.setParam("actorId", SecurityUtil.getUserId());
+        sql.setCallback(Sqls.callback.integer());
+        tourLedgerService.dao().execute(sql);
+        return sql.getInt() > 0 ? tourLedgerService.fetch(id) : null;
+    }
+
+    private String getCurrentLineName(TourLedger ledger) {
+        if (ledger == null) {
+            return "";
+        }
+        Sql sql = Sqls.create("""
+                SELECT CASE
+                    WHEN m.id IS NULL THEN COALESCE(NULLIF(l.lineName, ''), t.lineName)
+                    ELSE CONCAT(
+                        COALESCE(NULLIF(l.lineName, ''), t.lineName),
+                        '（',
+                        CASE
+                            WHEN IFNULL(m.unionId, '') = '' THEN '校工会'
+                            ELSE IFNULL(mu.name, '')
+                        END,
+                        '）'
+                    )
+                END AS lineName
+                FROM tour_ledger t
+                LEFT JOIN tour_matter m ON m.id = t.matterId AND m.delFlag = 0
+                LEFT JOIN tour_line l ON l.id = t.lineId AND l.delFlag = 0
+                LEFT JOIN sys_union mu ON mu.id = m.unionId
+                WHERE t.id = @ledgerId
+                """);
+        sql.setParam("ledgerId", ledger.getId());
+        sql.setCallback(Sqls.callback.str());
+        tourLedgerService.dao().execute(sql);
+        return StrUtil.blankToDefault(sql.getString(), ledger.getLineName());
+    }
+
+    private String getTravelPeriod(TourLedger ledger) {
+        if (ledger == null || ledger.getYear() == null || StrUtil.isBlank(ledger.getLineId())) {
+            return "";
+        }
+        if (StrUtil.isNotBlank(ledger.getMatterId())) {
+            Sql exactSql = Sqls.create("""
+                    SELECT CASE
+                        WHEN IFNULL(travelStartTime, '') <> '' AND IFNULL(travelEndTime, '') <> ''
+                        THEN CONCAT(travelStartTime, ' 至 ', travelEndTime)
+                        ELSE ''
+                    END AS travelPeriod
+                    FROM tour_matter
+                    WHERE delFlag = 0
+                      AND id = @matterId
+                    """);
+            exactSql.setParam("matterId", ledger.getMatterId());
+            exactSql.setCallback(Sqls.callback.str());
+            tourLedgerService.dao().execute(exactSql);
+            return exactSql.getString();
+        }
+        Sql sql = Sqls.create("""
+                SELECT GROUP_CONCAT(
+                    DISTINCT CASE
+                        WHEN IFNULL(travelStartTime, '') <> '' AND IFNULL(travelEndTime, '') <> ''
+                        THEN CONCAT(travelStartTime, ' 至 ', travelEndTime)
+                        ELSE NULL
+                    END
+                    ORDER BY travelStartTime ASC
+                    SEPARATOR '；'
+                ) AS travelPeriod
+                FROM tour_matter
+                WHERE delFlag = 0
+                  AND `year` = @year
+                  AND lineId = @lineId
+                """);
+        sql.setParam("year", ledger.getYear());
+        sql.setParam("lineId", ledger.getLineId());
+        sql.setCallback(Sqls.callback.str());
+        tourLedgerService.dao().execute(sql);
+        return sql.getString();
+    }
+
+    private NutMap getSignupConfig(TourLedger ledger) {
+        if (ledger == null || StrUtil.isBlank(ledger.getLineId())) {
+            return NutMap.NEW().addv("allowFamily", false).addv("fillBedInfo", true).addv("directFamilyUnitLine", false);
+        }
+        Sql sql = Sqls.create("""
+                SELECT
+                    IFNULL(s.allowFamily, 0) AS allowFamily,
+                    IFNULL(s.fillBedInfo, 1) AS fillBedInfo,
+                    IFNULL(l.directFamilyUnitLine, 0) AS directFamilyUnitLine
+                FROM tour_ledger t
+                LEFT JOIN tour_matter m ON m.id = t.matterId AND m.delFlag = 0
+                LEFT JOIN tour_setting s ON s.id = m.settingId AND s.delFlag = 0
+                LEFT JOIN tour_line l ON l.id = t.lineId AND l.delFlag = 0
+                WHERE t.id = @ledgerId
+                """);
+        sql.setParam("ledgerId", ledger.getId());
+        sql.setCallback(Sqls.callback.map());
+        tourLedgerService.dao().execute(sql);
+        NutMap map = sql.getObject(NutMap.class);
+        if (map == null || map.isEmpty()) {
+            return NutMap.NEW().addv("allowFamily", false).addv("fillBedInfo", true).addv("directFamilyUnitLine", false);
+        }
+        return map;
+    }
+
+    private static class LineFilter {
+        private final String lineId;
+        private final String unionId;
+
+        private LineFilter(String lineId, String unionId) {
+            this.lineId = lineId;
+            this.unionId = unionId;
+        }
+
+        private String getLineId() {
+            return lineId;
+        }
+
+        private String getUnionId() {
+            return unionId;
+        }
+    }
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/controller/TourSchoolUserAssignmentController.java

@@ -0,0 +1,207 @@
+package com.budwk.app.zhgh.dayofficework.tour.controller;
+
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import cn.hutool.core.util.StrUtil;
+import com.budwk.app.base.annotation.SLog;
+import com.budwk.app.base.param.PageForm;
+import com.budwk.app.base.result.Result;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourUserAssignment;
+import com.budwk.app.zhgh.dayofficework.tour.service.TourUserAssignmentService;
+import org.nutz.aop.interceptor.ioc.TransAop;
+import org.nutz.ioc.aop.Aop;
+import org.nutz.ioc.loader.annotation.Inject;
+import org.nutz.ioc.loader.annotation.IocBean;
+import org.nutz.json.Json;
+import org.nutz.lang.Lang;
+import org.nutz.lang.util.NutMap;
+import org.nutz.mvc.annotation.At;
+import org.nutz.mvc.annotation.Ok;
+import org.nutz.mvc.annotation.Param;
+
+import java.util.Collections;
+import java.util.List;
+
+@IocBean
+@Ok("json:full")
+@At("/platform/tour/schoolUserAssignment")
+public class TourSchoolUserAssignmentController {
+
+    @Inject
+    private TourUserAssignmentService tourUserAssignmentService;
+
+    /**
+     * 校工会人员分配列表入口。
+     */
+    @At("")
+    @Ok("beetl:/platform/zhgh/dayofficework/Tour/schoolUserAssignment/index.html")
+    @SaCheckPermission("tour.schoolUserAssignment")
+    public void index() {
+    }
+
+    /**
+     * 分页查询校工会分配记录，列表数据只来自人员分配表。
+     */
+    @At
+    @SaCheckPermission("tour.schoolUserAssignment")
+    public Result pageData(PageForm pageForm, Integer year, String settingId, String matterId, String unionId,
+                           String personType, String keyword) {
+        return Result.success(tourUserAssignmentService.schoolAssignmentPage(pageForm, year, settingId, matterId,
+                unionId, personType, keyword));
+    }
+
+    /**
+     * 分页查询候选人员，候选范围由疗休养配置的可参加人员范围决定。
+     */
+    @At
+    @SaCheckPermission("tour.schoolUserAssignment")
+    public Result candidatePageData(PageForm pageForm, String settingId, String unionId, String keyword) {
+        return Result.success(tourUserAssignmentService.schoolCandidatePage(pageForm, settingId, unionId, keyword));
+    }
+
+    /**
+     * 查询可用于分配的疗休养配置。
+     */
+    @At
+    @SaCheckPermission("tour.schoolUserAssignment")
+    public Result settingOptions(Integer year) {
+        return Result.success(tourUserAssignmentService.listEnabledSettingOptions(year));
+    }
+
+    /**
+     * 查询校工会可分配线路选项，选项携带事项、线路和旅行社快照信息。
+     */
+    @At
+    @SaCheckPermission("tour.schoolUserAssignment")
+    public Result matterOptions(String settingId) {
+        return Result.success(tourUserAssignmentService.listMatterOptions(settingId));
+    }
+
+    /**
+     * 查询分工会选项，供筛选和候选人员过滤使用。
+     */
+    @At
+    @SaCheckPermission("tour.schoolUserAssignment")
+    public Result unionOptions() {
+        return Result.success(tourUserAssignmentService.listUnionOptions());
+    }
+
+    /**
+     * 保存校工会人员分配，保存时数据来源固定为 SCHOOL_UNION。
+     */
+    @At
+    @Aop(TransAop.READ_COMMITTED)
+    @SaCheckPermission("tour.schoolUserAssignment")
+    @SLog(type = "tour", tag = "疗休养校工会人员分配", msg = "保存校工会人员分配")
+    public Result doAssign(String settingId, String matterId, String personType, @Param("userIds") String userIds) {
+        List<String> parsedUserIds;
+        try {
+            parsedUserIds = parseUserIds(userIds);
+        } catch (Exception e) {
+            return Result.error("人员参数错误");
+        }
+        try {
+            return Result.success(tourUserAssignmentService.assignSchoolUsers(settingId, matterId, personType, parsedUserIds));
+        } catch (IllegalArgumentException e) {
+            return Result.error(e.getMessage());
+        }
+    }
+
+    /**
+     * 保存校工会人员分配明细，支持弹窗候选列表中每个人单独选择分配线路。
+     */
+    @At
+    @Aop(TransAop.READ_COMMITTED)
+    @SaCheckPermission("tour.schoolUserAssignment")
+    @SLog(type = "tour", tag = "疗休养校工会人员分配", msg = "保存校工会人员分配明细")
+    public Result doAssignItems(String settingId, @Param("assignItems") String assignItems) {
+        List<NutMap> parsedItems;
+        try {
+            parsedItems = parseAssignItems(assignItems);
+        } catch (Exception e) {
+            return Result.error("人员分配明细参数错误");
+        }
+        try {
+            return Result.success(tourUserAssignmentService.assignSchoolUsers(settingId, parsedItems));
+        } catch (IllegalArgumentException e) {
+            return Result.error(e.getMessage());
+        }
+    }
+
+    /**
+     * 给校工会已分配人员补选分配线路，具体回写分配表和写台账逻辑由 service 统一处理。
+     */
+    @At
+    @Aop(TransAop.READ_COMMITTED)
+    @SaCheckPermission("tour.schoolUserAssignment")
+    @SLog(type = "tour", tag = "疗休养校工会人员分配", msg = "选择校工会分配事项")
+    public Result selectMatter(String id, String matterId) {
+        try {
+            return Result.success(tourUserAssignmentService.selectSchoolAssignmentMatter(id, matterId));
+        } catch (IllegalArgumentException e) {
+            return Result.error(e.getMessage());
+        }
+    }
+
+    /**
+     * 恢复校工会已取消退出的人员分配记录，只恢复状态，不恢复已删除台账。
+     */
+    @At
+    @Aop(TransAop.READ_COMMITTED)
+    @SaCheckPermission("tour.schoolUserAssignment.cancelRestore")
+    @SLog(type = "tour", tag = "疗休养校工会人员分配", msg = "取消退出校工会人员分配")
+    public Result restoreCancel(String id) {
+        try {
+            tourUserAssignmentService.restoreCancelledAssignmentBySource(id, TourUserAssignment.ASSIGN_SOURCE_SCHOOL_UNION);
+            return Result.success();
+        } catch (IllegalArgumentException e) {
+            return Result.error(e.getMessage());
+        }
+    }
+
+    /**
+     * 删除前检查该分配记录是否已经存在对应报名台账。
+     */
+    @At
+    @SaCheckPermission("tour.schoolUserAssignment")
+    public Result deleteInfo(String id) {
+        if (StrUtil.isBlank(id)) {
+            return Result.error("参数错误");
+        }
+        return Result.success(tourUserAssignmentService.schoolDeleteInfo(id));
+    }
+
+    /**
+     * 删除校工会人员分配记录，只删除 SCHOOL_UNION 来源的数据。
+     */
+    @At
+    @Aop(TransAop.READ_COMMITTED)
+    @SaCheckPermission("tour.schoolUserAssignment")
+    @SLog(type = "tour", tag = "疗休养校工会人员分配", msg = "删除校工会人员分配")
+    public Result doDelete(String id, Boolean deleteLedger) {
+        if (StrUtil.isBlank(id)) {
+            return Result.error("参数错误");
+        }
+        try {
+            tourUserAssignmentService.deleteBySource(id, TourUserAssignment.ASSIGN_SOURCE_SCHOOL_UNION, Boolean.TRUE.equals(deleteLedger));
+            return Result.success();
+        } catch (IllegalArgumentException e) {
+            return Result.error(e.getMessage());
+        }
+    }
+
+    private List<String> parseUserIds(String userIds) {
+        if (StrUtil.isBlank(userIds)) {
+            return Collections.emptyList();
+        }
+        List<String> list = Json.fromJsonAsList(String.class, userIds);
+        return Lang.isEmpty(list) ? Collections.emptyList() : list;
+    }
+
+    private List<NutMap> parseAssignItems(String assignItems) {
+        if (StrUtil.isBlank(assignItems)) {
+            return Collections.emptyList();
+        }
+        List<NutMap> list = Json.fromJsonAsList(NutMap.class, assignItems);
+        return Lang.isEmpty(list) ? Collections.emptyList() : list;
+    }
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/controller/TourSettingController.java

@@ -0,0 +1,325 @@
+package com.budwk.app.zhgh.dayofficework.tour.controller;
+
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import cn.hutool.core.util.StrUtil;
+import com.budwk.app.base.annotation.SLog;
+import com.budwk.app.base.page.Pagination;
+import com.budwk.app.base.param.PageForm;
+import com.budwk.app.base.result.Result;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourSetting;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourSettingLot;
+import com.budwk.app.zhgh.dayofficework.tour.service.TourSettingService;
+import com.budwk.app.zhgh.dayofficework.tour.service.TourUserAssignmentService;
+import org.nutz.aop.interceptor.ioc.TransAop;
+import org.nutz.dao.Cnd;
+import org.nutz.ioc.aop.Aop;
+import org.nutz.ioc.loader.annotation.Inject;
+import org.nutz.ioc.loader.annotation.IocBean;
+import org.nutz.json.Json;
+import org.nutz.lang.Lang;
+import org.nutz.lang.util.NutMap;
+import org.nutz.mvc.annotation.At;
+import org.nutz.mvc.annotation.Ok;
+import org.nutz.mvc.annotation.Param;
+
+import java.util.Collections;
+import java.util.List;
+import java.util.stream.Collectors;
+
+@IocBean
+@Ok("json:full")
+@At("/platform/tour/setting")
+public class TourSettingController {
+
+    private static final String SIGNUP_ELIGIBILITY_MODE_SCOPE_GROUP = "SCOPE_GROUP";
+    private static final String SIGNUP_ELIGIBILITY_MODE_ASSIGNED_USER = "ASSIGNED_USER";
+
+    @Inject
+    private TourSettingService tourSettingService;
+
+    @Inject
+    private TourUserAssignmentService tourUserAssignmentService;
+
+    @At("")
+    @Ok("beetl:/platform/zhgh/dayofficework/Tour/setting/index.html")
+    @SaCheckPermission("tour.setting")
+    public void index() {
+    }
+
+    @At
+    @SaCheckPermission("tour.setting")
+    public Result pageData(PageForm pageForm, Integer year, String configName) {
+        Cnd cnd = Cnd.NEW();
+        cnd.andEX(TourSetting::getYear, "=", year);
+        cnd.and(Cnd.likeEX(TourSetting::getConfigName, configName));
+
+        cnd.desc(TourSetting::getYear).asc(TourSetting::getSortNo).desc(TourSetting::getCreatedAt);
+        Pagination<TourSetting> pagination = tourSettingService.listPage(
+                pageForm.getPageNumber(),
+                pageForm.getPageSize(),
+                TourSetting.class,
+                cnd
+        );
+        return Result.success(pagination);
+    }
+
+    @At
+    @SaCheckPermission("tour.setting")
+    public Result detail(String id) {
+        if (StrUtil.isBlank(id)) {
+            return Result.error("参数错误");
+        }
+        TourSetting tourSetting = tourSettingService.fetch(id);
+        if (tourSetting == null) {
+            return Result.error("配置不存在");
+        }
+        // 编辑页面需要一起带出标段，按标段值倒序保持与老疗休养配置一致。
+        Cnd lotCnd = Cnd.NEW();
+        lotCnd.desc(TourSettingLot::getLotValue);
+        tourSettingService.dao().fetchLinks(tourSetting, "lots", lotCnd);
+        tourSetting.setUnionQuotas(tourSettingService.listUnionQuotaRows(id));
+        return Result.success(tourSetting);
+    }
+
+    @At
+    @SaCheckPermission("tour.setting")
+    public Result previousYearInfo(Integer year) {
+        if (year == null) {
+            return Result.error("请先选择年度");
+        }
+        List<TourSetting> settings = tourSettingService.query(Cnd.where(TourSetting::getYear, "=", year - 1)
+                .and(TourSetting::getDelFlag, "=", false)
+                .desc(TourSetting::getUpdatedAt)
+                .desc(TourSetting::getCreatedAt));
+        if (Lang.isEmpty(settings)) {
+            return Result.error("未找到上一年度配置");
+        }
+        TourSetting tourSetting = settings.get(0);
+        Cnd lotCnd = Cnd.NEW();
+        lotCnd.desc(TourSettingLot::getLotValue);
+        tourSettingService.dao().fetchLinks(tourSetting, "lots", lotCnd);
+        tourSetting.setUnionQuotas(tourSettingService.listUnionQuotaRows(tourSetting.getId()));
+        return Result.success(tourSetting);
+    }
+
+    @At
+    @SaCheckPermission("tour.setting")
+    public Result unionQuotaRows(String settingId) {
+        // 新增配置时 settingId 为空，service 会返回所有分工会的空名额行；编辑时合并已保存名额。
+        return Result.success(tourSettingService.listUnionQuotaRows(settingId));
+    }
+
+    @At
+    @SaCheckPermission("tour.setting")
+    public Result unionQuotaOverview(String settingId) {
+        int schoolFormalAssignedCount = tourUserAssignmentService.countSchoolFormalAssignedUsers(settingId);
+        return Result.success(NutMap.NEW().addv("schoolFormalAssignedCount", schoolFormalAssignedCount));
+    }
+
+    @At
+    @Aop(TransAop.READ_COMMITTED)
+    @SaCheckPermission("tour.setting")
+    @SLog(type = "tour", tag = "疗休养设置", msg = "保存疗休养配置")
+    public Result doSubmit(TourSetting tourSetting,
+                           @Param(value = "lots") String lots,
+                           @Param(value = "unionQuotas") String unionQuotas,
+                           @Param(value = "lotDeleteList") String[] lotDeleteList) {
+        Result checkResult = check(tourSetting);
+        if (checkResult != null) {
+            return checkResult;
+        }
+
+        Cnd sameNameCnd = Cnd.where(TourSetting::getYear, "=", tourSetting.getYear())
+                .and(TourSetting::getConfigName, "=", tourSetting.getConfigName());
+        if (StrUtil.isNotBlank(tourSetting.getId())) {
+            sameNameCnd.and(TourSetting::getId, "<>", tourSetting.getId());
+        }
+        if (tourSettingService.count(sameNameCnd) > 0) {
+            return Result.error("同年度下配置名称已存在");
+        }
+
+        // 布尔值给默认值，避免前端未传时出现空状态。
+        int schoolFormalAssignedCount = tourUserAssignmentService.countSchoolFormalAssignedUsers(tourSetting.getId());
+        int branchTotalQuota = Math.max(defaultInt(tourSetting.getTravelPeopleQuota()) - schoolFormalAssignedCount, 0);
+        String quotaLimitMessage = tourSettingService.checkBranchFormalQuotaLimit(unionQuotas, branchTotalQuota);
+        if (StrUtil.isNotBlank(quotaLimitMessage)) {
+            return Result.error(quotaLimitMessage);
+        }
+
+        if (tourSetting.getEnabled() == null) {
+            tourSetting.setEnabled(true);
+        }
+        if (tourSetting.getAllowFamily() == null) {
+            tourSetting.setAllowFamily(false);
+        }
+        if (tourSetting.getFillBedInfo() == null) {
+            tourSetting.setFillBedInfo(true);
+        }
+        // 报名资格校验方式默认按人员分配表校验，后续报名校验切换会读取该配置。
+        if (StrUtil.isBlank(tourSetting.getSignupEligibilityMode())) {
+            tourSetting.setSignupEligibilityMode(SIGNUP_ELIGIBILITY_MODE_ASSIGNED_USER);
+        }
+        if (StrUtil.isBlank(tourSetting.getOutProvinceRatioType())) {
+            tourSetting.setOutProvinceRatioType("当年报名人数");
+        }
+        if (!"固定人数".equals(tourSetting.getOutProvinceRatioType())) {
+            tourSetting.setOutProvinceFixedPeople(0);
+        }
+        // 前端按项目既有约定把子表数组序列化提交，这里显式解析，避免自动绑定漏掉标段。
+        if (StrUtil.isNotBlank(lots)) {
+            try {
+                tourSetting.setLots(Json.fromJsonAsList(TourSettingLot.class, lots));
+            } catch (Exception e) {
+                return Result.error("标段值和标段费用必须为整数");
+            }
+        }
+        tourSetting.setLots(normalizeLots(tourSetting));
+        Result lotCheckResult = checkLots(tourSetting.getLots());
+        if (lotCheckResult != null) {
+            return lotCheckResult;
+        }
+        if (StrUtil.isBlank(tourSetting.getId())) {
+            if (Lang.isEmpty(tourSetting.getLots())) {
+                tourSettingService.insert(tourSetting);
+            } else {
+                tourSettingService.insertWith(tourSetting, "lots");
+            }
+            tourSettingService.saveUnionQuotas(tourSetting.getId(), unionQuotas);
+        } else {
+            // 编辑时先处理页面删除的标段，再保存配置和当前标段行。
+            if (Lang.isNotEmpty(lotDeleteList)) {
+                tourSettingService.dao().clear(TourSettingLot.class, Cnd.where(TourSettingLot::getId, "in", lotDeleteList));
+            }
+            tourSettingService.updateIgnoreNull(tourSetting);
+            saveLots(tourSetting);
+            tourSettingService.saveUnionQuotas(tourSetting.getId(), unionQuotas);
+        }
+        return Result.success();
+    }
+
+    @At
+    @Aop(TransAop.READ_COMMITTED)
+    @SaCheckPermission("tour.setting")
+    @SLog(type = "tour", tag = "疗休养设置", msg = "删除疗休养配置")
+    public Result doDelete(String id) {
+        if (StrUtil.isBlank(id)) {
+            return Result.error("参数错误");
+        }
+        tourSettingService.dao().clear(TourSettingLot.class, Cnd.where(TourSettingLot::getSettingId, "=", id));
+        tourSettingService.clearUnionQuotas(id);
+        tourUserAssignmentService.clearBySettingId(id);
+        tourSettingService.delete(id);
+        return Result.success();
+    }
+
+    private List<TourSettingLot> normalizeLots(TourSetting tourSetting) {
+        if (tourSetting == null || Lang.isEmpty(tourSetting.getLots())) {
+            return Collections.emptyList();
+        }
+        // 过滤前端空行，避免误写入只有ID或空字段的标段记录。
+        return tourSetting.getLots().stream()
+                .filter(item -> item != null
+                        && (StrUtil.isNotBlank(item.getLotName())
+                        || StrUtil.isNotBlank(item.getLotValue())
+                        || item.getActivityCost() != null))
+                .peek(item -> item.setSettingId(tourSetting.getId()))
+                .collect(Collectors.toList());
+    }
+
+    private void saveLots(TourSetting tourSetting) {
+        List<TourSettingLot> lots = tourSetting.getLots();
+        if (Lang.isEmpty(lots)) {
+            return;
+        }
+        lots.forEach(item -> item.setSettingId(tourSetting.getId()));
+        tourSettingService.dao().insertOrUpdate(lots);
+    }
+
+    private Result check(TourSetting tourSetting) {
+        if (tourSetting == null) {
+            return Result.error("参数错误");
+        }
+        if (tourSetting.getYear() == null) {
+            return Result.error("年度不能为空");
+        }
+        if (StrUtil.isBlank(tourSetting.getConfigName())) {
+            return Result.error("配置名称不能为空");
+        }
+        Result boardingPlaceCheck = normalizeBoardingPlace(tourSetting);
+        if (boardingPlaceCheck != null) {
+            return boardingPlaceCheck;
+        }
+        if (tourSetting.getTravelPeopleQuota() != null && tourSetting.getTravelPeopleQuota() < 0) {
+            return Result.error("出行人数指标不能小于0");
+        }
+        if (StrUtil.isNotBlank(tourSetting.getSignupEligibilityMode())
+                && !SIGNUP_ELIGIBILITY_MODE_SCOPE_GROUP.equals(tourSetting.getSignupEligibilityMode())
+                && !SIGNUP_ELIGIBILITY_MODE_ASSIGNED_USER.equals(tourSetting.getSignupEligibilityMode())) {
+            return Result.error("报名资格校验方式不正确");
+        }
+        if (tourSetting.getMinGroupPeople() != null && tourSetting.getMaxGroupPeople() != null
+                && tourSetting.getMinGroupPeople() > tourSetting.getMaxGroupPeople()) {
+            return Result.error("最少成团人数不能大于最多成团人数");
+        }
+        if (tourSetting.getCycleStartYear() != null && tourSetting.getCycleEndYear() != null
+                && tourSetting.getCycleStartYear() > tourSetting.getCycleEndYear()) {
+            return Result.error("周期开始年度不能大于周期结束年度");
+        }
+        if (StrUtil.isNotBlank(tourSetting.getOutProvinceRatioType())
+                && !"当年参加人数".equals(tourSetting.getOutProvinceRatioType())
+                && !"当年报名人数".equals(tourSetting.getOutProvinceRatioType())
+                && !"可参加教职工人数".equals(tourSetting.getOutProvinceRatioType())
+                && !"固定人数".equals(tourSetting.getOutProvinceRatioType())) {
+            return Result.error("省外人数占比类型不正确");
+        }
+        if ("固定人数".equals(tourSetting.getOutProvinceRatioType())
+                && (tourSetting.getOutProvinceFixedPeople() == null || tourSetting.getOutProvinceFixedPeople() < 0)) {
+            return Result.error("固定人数必须大于等于0");
+        }
+        return null;
+    }
+
+    private int defaultInt(Integer value) {
+        return value == null || value < 0 ? 0 : value;
+    }
+
+    private Result normalizeBoardingPlace(TourSetting tourSetting) {
+        if (StrUtil.isBlank(tourSetting.getBoardingPlace())) {
+            tourSetting.setBoardingPlace("[]");
+            return null;
+        }
+        try {
+            List<NutMap> rows = Json.fromJsonAsList(NutMap.class, tourSetting.getBoardingPlace());
+            if (Lang.isEmpty(rows)) {
+                tourSetting.setBoardingPlace("[]");
+                return null;
+            }
+            // 乘车路线以 JSON 数组保存，只保留有效路线名称，避免页面空行写入配置。
+            List<NutMap> normalizedRows = rows.stream()
+                    .filter(item -> item != null && StrUtil.isNotBlank(item.getString("name")))
+                    .map(item -> NutMap.NEW().addv("name", item.getString("name").trim()))
+                    .collect(Collectors.toList());
+            tourSetting.setBoardingPlace(Json.toJson(normalizedRows));
+            return null;
+        } catch (Exception e) {
+            return Result.error("乘车路线格式不正确");
+        }
+    }
+
+    private Result checkLots(List<TourSettingLot> lots) {
+        if (Lang.isEmpty(lots)) {
+            return null;
+        }
+        for (int i = 0; i < lots.size(); i++) {
+            TourSettingLot lot = lots.get(i);
+            String rowNo = "第" + (i + 1) + "行";
+            if (StrUtil.isBlank(lot.getLotValue()) || !lot.getLotValue().matches("^\\d+$")) {
+                return Result.error(rowNo + "标段值必须为整数");
+            }
+            if (lot.getActivityCost() == null || lot.getActivityCost() < 0) {
+                return Result.error(rowNo + "标段费用必须为整数");
+            }
+        }
+        return null;
+    }
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/controller/TourTravelAgencyController.java

@@ -0,0 +1,160 @@
+package com.budwk.app.zhgh.dayofficework.tour.controller;
+
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import cn.hutool.core.util.StrUtil;
+import com.budwk.app.base.annotation.SLog;
+import com.budwk.app.base.page.Pagination;
+import com.budwk.app.base.param.PageForm;
+import com.budwk.app.base.result.Result;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourTravelAgency;
+import com.budwk.app.zhgh.dayofficework.tour.service.TourTravelAgencyService;
+import org.nutz.aop.interceptor.ioc.TransAop;
+import org.nutz.dao.Cnd;
+import org.nutz.ioc.aop.Aop;
+import org.nutz.ioc.loader.annotation.Inject;
+import org.nutz.ioc.loader.annotation.IocBean;
+import org.nutz.mvc.annotation.At;
+import org.nutz.mvc.annotation.Ok;
+
+@IocBean
+@Ok("json:full")
+@At("/platform/tour/travelAgency")
+public class TourTravelAgencyController {
+
+    private static final String MOBILE_PATTERN = "^1[3-9]\\d{9}$";
+    private static final String EMAIL_PATTERN = "^[A-Za-z0-9+_.-]+@[A-Za-z0-9.-]+$";
+
+    @Inject
+    private TourTravelAgencyService travelAgencyService;
+
+    @At("")
+    @Ok("beetl:/platform/zhgh/dayofficework/Tour/travelAgency/index.html")
+    @SaCheckPermission("tour.travelAgency")
+    public void index() {
+    }
+
+    @At
+    @SaCheckPermission("tour.travelAgency")
+    public Result pageData(PageForm pageForm, Integer year, String agencyName, String contactName, String contactPhone) {
+        Cnd cnd = Cnd.NEW();
+        cnd.andEX(TourTravelAgency::getYear, "=", year);
+        cnd.and(Cnd.likeEX(TourTravelAgency::getAgencyName, agencyName));
+        cnd.and(Cnd.likeEX(TourTravelAgency::getContactName, contactName));
+        cnd.and(Cnd.likeEX(TourTravelAgency::getContactPhone, contactPhone));
+        applyOrder(cnd, pageForm);
+        Pagination<TourTravelAgency> pagination = travelAgencyService.listPage(
+                pageForm.getPageNumber(),
+                pageForm.getPageSize(),
+                TourTravelAgency.class,
+                cnd
+        );
+        return Result.success(pagination);
+    }
+
+    @At
+    @SaCheckPermission("tour.travelAgency")
+    public Result detail(String id) {
+        if (StrUtil.isBlank(id)) {
+            return Result.error("参数错误");
+        }
+        TourTravelAgency agency = travelAgencyService.fetch(id);
+        return agency == null ? Result.error("旅行社不存在") : Result.success(agency);
+    }
+
+    @At
+    @Aop(TransAop.READ_COMMITTED)
+    @SaCheckPermission("tour.travelAgency")
+    @SLog(type = "tour", tag = "旅行社管理", msg = "保存旅行社信息")
+    public Result doSubmit(TourTravelAgency agency) {
+        Result checkResult = check(agency);
+        if (checkResult != null) {
+            return checkResult;
+        }
+
+        Cnd sameCodeCnd = Cnd.where(TourTravelAgency::getYear, "=", agency.getYear())
+                .and(TourTravelAgency::getAgencyCode, "=", agency.getAgencyCode());
+        if (StrUtil.isNotBlank(agency.getId())) {
+            sameCodeCnd.and(TourTravelAgency::getId, "<>", agency.getId());
+        }
+        if (travelAgencyService.count(sameCodeCnd) > 0) {
+            return Result.error("同年度下旅行社编号已存在");
+        }
+        if (agency.getEnabled() == null) {
+            agency.setEnabled(true);
+        }
+        if (StrUtil.isBlank(agency.getId())) {
+            travelAgencyService.insert(agency);
+        } else {
+            travelAgencyService.updateIgnoreNull(agency);
+        }
+        return Result.success();
+    }
+
+    @At
+    @Aop(TransAop.READ_COMMITTED)
+    @SaCheckPermission("tour.travelAgency")
+    @SLog(type = "tour", tag = "旅行社管理", msg = "删除旅行社信息")
+    public Result doDelete(String id) {
+        if (StrUtil.isBlank(id)) {
+            return Result.error("参数错误");
+        }
+        travelAgencyService.delete(id);
+        return Result.success();
+    }
+
+    private Result check(TourTravelAgency agency) {
+        if (agency == null) {
+            return Result.error("参数错误");
+        }
+        if (agency.getYear() == null) {
+            return Result.error("年度不能为空");
+        }
+        if (StrUtil.isBlank(agency.getAgencyName())) {
+            return Result.error("旅行社名称不能为空");
+        }
+        if (StrUtil.isBlank(agency.getAgencyCode())) {
+            return Result.error("旅行社编号不能为空");
+        }
+        if (StrUtil.isBlank(agency.getContactName())) {
+            return Result.error("联系人不能为空");
+        }
+        if (StrUtil.isBlank(agency.getContactPhone())) {
+            return Result.error("联系人手机不能为空");
+        }
+        if (!agency.getContactPhone().matches(MOBILE_PATTERN)) {
+            return Result.error("联系人手机格式不正确");
+        }
+        if (StrUtil.isBlank(agency.getEmail())) {
+            return Result.error("邮箱不能为空");
+        }
+        if (!agency.getEmail().matches(EMAIL_PATTERN)) {
+            return Result.error("邮箱格式不正确");
+        }
+        return null;
+    }
+
+    private void applyOrder(Cnd cnd, PageForm pageForm) {
+        String orderName = pageForm.getPageOrderName();
+        String orderBy = pageForm.getPageOrderBy();
+        if (StrUtil.isBlank(orderName)) {
+            cnd.asc(TourTravelAgency::getYear).asc(TourTravelAgency::getAgencyCode).desc(TourTravelAgency::getCreatedAt);
+            return;
+        }
+        boolean descending = "descending".equals(orderBy);
+        if ("year".equals(orderName)) {
+            if (descending) {
+                cnd.desc(TourTravelAgency::getYear);
+            } else {
+                cnd.asc(TourTravelAgency::getYear);
+            }
+        } else if ("agencyCode".equals(orderName)) {
+            if (descending) {
+                cnd.desc(TourTravelAgency::getAgencyCode);
+            } else {
+                cnd.asc(TourTravelAgency::getAgencyCode);
+            }
+        } else {
+            cnd.asc(TourTravelAgency::getYear).asc(TourTravelAgency::getAgencyCode).desc(TourTravelAgency::getCreatedAt);
+        }
+    }
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/controller/TourUnionApprovalController.java

@@ -0,0 +1,581 @@
+package com.budwk.app.zhgh.dayofficework.tour.controller;
+
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import cn.dev33.satoken.annotation.SaMode;
+import cn.hutool.core.util.StrUtil;
+import com.budwk.app.base.page.Pagination;
+import com.budwk.app.base.param.PageForm;
+import com.budwk.app.base.result.Result;
+import com.budwk.app.flow.enums.ProcessTaskStateEnum;
+import com.budwk.app.web.commons.auth.utils.SecurityUtil;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourLedger;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourLedgerDirectRelative;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourLedgerFamily;
+import com.budwk.app.zhgh.dayofficework.tour.service.TourLedgerDirectRelativeService;
+import com.budwk.app.zhgh.dayofficework.tour.service.TourLedgerFamilyService;
+import com.budwk.app.zhgh.dayofficework.tour.service.TourLedgerService;
+import org.nutz.dao.Cnd;
+import org.nutz.dao.Sqls;
+import org.nutz.dao.sql.Sql;
+import org.nutz.dao.util.cri.SqlExpressionGroup;
+import org.nutz.ioc.loader.annotation.Inject;
+import org.nutz.ioc.loader.annotation.IocBean;
+import org.nutz.lang.util.NutMap;
+import org.nutz.mvc.annotation.At;
+import org.nutz.mvc.annotation.Ok;
+
+import java.time.LocalDate;
+import java.util.List;
+
+@IocBean
+@Ok("json:full")
+@At("/platform/tour/unionApproval")
+public class TourUnionApprovalController {
+
+    private static final String WORKFLOW_KEY = "LXYBZXQSXL";
+    private static final String TASK_DISPLAY_NAME = "分工会审核";
+
+    @Inject
+    private TourLedgerService tourLedgerService;
+
+    @Inject
+    private TourLedgerFamilyService tourLedgerFamilyService;
+
+    @Inject
+    private TourLedgerDirectRelativeService tourLedgerDirectRelativeService;
+
+    @At("")
+    @Ok("beetl:/platform/zhgh/dayofficework/Tour/unionApproval/index.html")
+    @SaCheckPermission(value = {"tour.unionApproval", "h5.tour.unionApproval"}, mode = SaMode.OR)
+    public void index() {
+    }
+
+    @At("/h5")
+    @Ok("beetl:/platform/zhghh5/dayofficework/tour/unionApproval/index.html")
+    @SaCheckPermission(value = {"tour.unionApproval", "h5.tour.unionApproval"}, mode = SaMode.OR)
+    public void h5() {
+    }
+
+    @At
+    @SaCheckPermission(value = {"tour.unionApproval", "h5.tour.unionApproval"}, mode = SaMode.OR)
+    public Result pageData(PageForm pageForm, Boolean audit, Integer startYear, Integer endYear, String keyword, String unionId, String lineId, String travelPeriod, String lineType) {
+        Cnd cnd = buildAuditCnd(audit, startYear, endYear, keyword, unionId, lineId, travelPeriod, lineType);
+
+        Sql countSql = Sqls.create("""
+                SELECT COUNT(DISTINCT task.id)
+                FROM wf_process_task task
+                LEFT JOIN wf_process_instance ins ON ins.id = task.processInstanceId
+                LEFT JOIN wf_process_define def ON def.id = ins.processDefineId
+                LEFT JOIN wf_process_task_actor ta ON ta.processTaskId = task.id
+                INNER JOIN tour_ledger t ON t.id = ins.businessNo
+                LEFT JOIN tour_matter m ON m.id = t.matterId AND m.delFlag = 0
+                LEFT JOIN tour_line l ON l.id = t.lineId AND l.delFlag = 0
+                $condition
+                """);
+        countSql.setCondition(cnd);
+        countSql.setCallback(Sqls.callback.integer());
+        tourLedgerService.dao().execute(countSql);
+        int count = countSql.getInt();
+
+        Sql listSql = Sqls.create("""
+                SELECT
+                    t.*,
+                    ins.id AS instanceId,
+                    ins.businessNo,
+                    ins.state AS instanceState,
+                    ins.variable AS instanceVariable,
+                    ins.processDefineId AS instanceProcessDefineId,
+                    task.id AS taskId,
+                    task.taskName AS taskKey,
+                    task.displayName AS taskName,
+                    task.taskType,
+                    task.performType AS taskPerformType,
+                    task.taskState,
+                    task.finishTime,
+                    task.taskParentId,
+                    task.variable AS taskVariable,
+                    IFNULL(GROUP_CONCAT(DISTINCT nt.displayName), '结束') AS curTaskName,
+                    CASE
+                        WHEN m.id IS NULL THEN COALESCE(NULLIF(l.lineName, ''), t.lineName)
+                        ELSE CONCAT(
+                            COALESCE(NULLIF(l.lineName, ''), t.lineName),
+                            '（',
+                            CASE
+                                WHEN IFNULL(m.unionId, '') = '' THEN '校工会'
+                                ELSE IFNULL(mu.name, '')
+                            END,
+                            '）'
+                        )
+                    END AS currentLineName,
+                    CASE
+                        WHEN IFNULL(m.travelStartTime, '') <> '' AND IFNULL(m.travelEndTime, '') <> ''
+                        THEN CONCAT(m.travelStartTime, ' 至 ', m.travelEndTime)
+                        ELSE tp.travelPeriod
+                    END AS travelPeriod,
+                    IFNULL(f.familyCount, 0) AS familyCount
+                FROM wf_process_task task
+                LEFT JOIN wf_process_instance ins ON ins.id = task.processInstanceId
+                LEFT JOIN wf_process_define def ON def.id = ins.processDefineId
+                LEFT JOIN wf_process_task_actor ta ON ta.processTaskId = task.id
+                INNER JOIN tour_ledger t ON t.id = ins.businessNo
+                LEFT JOIN wf_process_task nt ON nt.processInstanceId = ins.id AND nt.taskState = 10
+                LEFT JOIN (
+                    SELECT ledgerId, COUNT(1) AS familyCount
+                    FROM tour_ledger_family
+                    WHERE delFlag = 0
+                    GROUP BY ledgerId
+                ) f ON f.ledgerId = t.id
+                LEFT JOIN tour_matter m ON m.id = t.matterId AND m.delFlag = 0
+                LEFT JOIN tour_line l ON l.id = t.lineId AND l.delFlag = 0
+                LEFT JOIN sys_union mu ON mu.id = m.unionId
+                LEFT JOIN (
+                    SELECT
+                        `year`,
+                        lineId,
+                        GROUP_CONCAT(
+                            DISTINCT CASE
+                                WHEN IFNULL(travelStartTime, '') <> '' AND IFNULL(travelEndTime, '') <> ''
+                                THEN CONCAT(travelStartTime, ' 至 ', travelEndTime)
+                                ELSE NULL
+                            END
+                            ORDER BY travelStartTime ASC
+                            SEPARATOR '；'
+                        ) AS travelPeriod
+                    FROM tour_matter
+                    WHERE delFlag = 0
+                      AND lineId IS NOT NULL
+                      AND lineId <> ''
+                    GROUP BY `year`, lineId
+                ) tp ON (t.matterId IS NULL OR t.matterId = '') AND tp.`year` = t.`year` AND tp.lineId = t.lineId
+                $condition
+                GROUP BY task.id
+                ORDER BY $orderColumn $orderBy, task.createdAt DESC, t.signupTime DESC, t.createdAt DESC
+                """);
+        listSql.setCondition(cnd);
+        listSql.setVar("orderColumn", getOrderColumn(pageForm.getPageOrderName()));
+        listSql.setVar("orderBy", "ascending".equals(pageForm.getPageOrderBy()) ? "asc" : "desc");
+        listSql.setPager(tourLedgerService.dao().createPager(pageForm.getPageNumber(), pageForm.getPageSize()));
+        listSql.setCallback(Sqls.callback.maps());
+        tourLedgerService.dao().execute(listSql);
+
+        List<NutMap> list = listSql.getList(NutMap.class);
+        list.forEach(item -> item.put("lineName", item.getString("currentLineName")));
+        Pagination<NutMap> pagination = new Pagination<>(pageForm.getPageNumber(), pageForm.getPageSize(), count, list);
+        return Result.success(pagination);
+    }
+
+    @At
+    @SaCheckPermission(value = {"tour.unionApproval", "h5.tour.unionApproval"}, mode = SaMode.OR)
+    public Result detail(String id) {
+        TourLedger ledger = fetchAuditLedger(id);
+        if (ledger == null) {
+            return Result.error("报名记录不存在或无权查看");
+        }
+        ledger.setLineName(getCurrentLineName(ledger));
+        Cnd familyCnd = Cnd.where(TourLedgerFamily::getLedgerId, "=", ledger.getId())
+                .and(TourLedgerFamily::getDelFlag, "=", false);
+        familyCnd.asc(TourLedgerFamily::getCreatedAt);
+        TourLedgerDirectRelative directRelative = tourLedgerDirectRelativeService.fetch(
+                Cnd.where(TourLedgerDirectRelative::getLedgerId, "=", ledger.getId())
+                        .and(TourLedgerDirectRelative::getDelFlag, "=", false));
+        NutMap signupConfig = getSignupConfig(ledger);
+        return Result.success(NutMap.NEW()
+                .addv("ledger", ledger)
+                .addv("travelPeriod", getTravelPeriod(ledger))
+                .addv("families", tourLedgerFamilyService.query(familyCnd))
+                .addv("directRelative", directRelative)
+                .addv("allowFamily", signupConfig.getBoolean("allowFamily", false))
+                .addv("fillBedInfo", signupConfig.getBoolean("fillBedInfo", true))
+                .addv("directFamilyUnitLine", signupConfig.getBoolean("directFamilyUnitLine", false)));
+    }
+
+    @At
+    @SaCheckPermission(value = {"tour.unionApproval", "h5.tour.unionApproval"}, mode = SaMode.OR)
+    public Result unionOptions(Boolean audit, Integer startYear, Integer endYear, String keyword, String lineId, String travelPeriod, String lineType) {
+        Cnd cnd = buildAuditCnd(audit, startYear, endYear, keyword, null, lineId, travelPeriod, lineType);
+        cnd.and("t.unionId", "IS NOT", null);
+        cnd.and("t.unionId", "<>", "");
+
+        Sql sql = Sqls.create("""
+                SELECT DISTINCT
+                    t.unionId AS id,
+                    COALESCE(NULLIF(u.name, ''), t.unionName) AS name,
+                    u.unionCode
+                FROM wf_process_task task
+                LEFT JOIN wf_process_instance ins ON ins.id = task.processInstanceId
+                LEFT JOIN wf_process_define def ON def.id = ins.processDefineId
+                LEFT JOIN wf_process_task_actor ta ON ta.processTaskId = task.id
+                INNER JOIN tour_ledger t ON t.id = ins.businessNo
+                LEFT JOIN tour_matter m ON m.id = t.matterId AND m.delFlag = 0
+                LEFT JOIN tour_line l ON l.id = t.lineId AND l.delFlag = 0
+                LEFT JOIN sys_union u ON u.id = t.unionId
+                $condition
+                ORDER BY u.unionCode ASC, name ASC
+                """);
+        sql.setCondition(cnd);
+        sql.setCallback(Sqls.callback.maps());
+        tourLedgerService.dao().execute(sql);
+        return Result.success(sql.getList(NutMap.class));
+    }
+
+    @At
+    @SaCheckPermission(value = {"tour.unionApproval", "h5.tour.unionApproval"}, mode = SaMode.OR)
+    public Result lineOptions(Boolean audit, Integer startYear, Integer endYear, String travelPeriod, String lineType, String unionId, String keyword) {
+        Cnd cnd = buildAuditCnd(audit, startYear, endYear, keyword, unionId, null, travelPeriod, lineType);
+        cnd.and("t.lineName", "IS NOT", null);
+        cnd.and("t.lineName", "<>", "");
+
+        Sql sql = Sqls.create("""
+                SELECT DISTINCT
+                    CASE
+                        WHEN IFNULL(t.lineId, '') <> '' THEN CONCAT(t.lineId, '|', IFNULL(m.unionId, ''))
+                        ELSE CONCAT('legacy:', t.lineName, '|', IFNULL(m.unionId, ''))
+                    END AS lineId,
+                    CASE
+                        WHEN m.id IS NULL THEN COALESCE(NULLIF(l.lineName, ''), t.lineName)
+                        ELSE CONCAT(
+                            COALESCE(NULLIF(l.lineName, ''), t.lineName),
+                            '（',
+                            CASE
+                                WHEN IFNULL(m.unionId, '') = '' THEN '校工会'
+                                ELSE IFNULL(mu.name, '')
+                            END,
+                            '）'
+                        )
+                    END AS lineName
+                FROM wf_process_task task
+                LEFT JOIN wf_process_instance ins ON ins.id = task.processInstanceId
+                LEFT JOIN wf_process_define def ON def.id = ins.processDefineId
+                LEFT JOIN wf_process_task_actor ta ON ta.processTaskId = task.id
+                INNER JOIN tour_ledger t ON t.id = ins.businessNo
+                LEFT JOIN tour_matter m ON m.id = t.matterId AND m.delFlag = 0
+                LEFT JOIN tour_line l ON l.id = t.lineId AND l.delFlag = 0
+                LEFT JOIN sys_union mu ON mu.id = m.unionId
+                $condition
+                ORDER BY lineName ASC
+                """);
+        sql.setCondition(cnd);
+        sql.setCallback(Sqls.callback.maps());
+        tourLedgerService.dao().execute(sql);
+        return Result.success(sql.getList(NutMap.class));
+    }
+
+    @At
+    @SaCheckPermission(value = {"tour.unionApproval", "h5.tour.unionApproval"}, mode = SaMode.OR)
+    public Result travelPeriodOptions(Boolean audit, Integer startYear, Integer endYear, String lineId, String lineType, String unionId, String keyword) {
+        Cnd cnd = buildAuditCnd(audit, startYear, endYear, keyword, unionId, lineId, null, lineType);
+        cnd.and("m.travelStartTime", "IS NOT", null);
+        cnd.and("m.travelStartTime", "<>", "");
+        cnd.and("m.travelEndTime", "IS NOT", null);
+        cnd.and("m.travelEndTime", "<>", "");
+
+        Sql sql = Sqls.create("""
+                SELECT DISTINCT CONCAT(m.travelStartTime, ' 至 ', m.travelEndTime) AS travelPeriod
+                FROM wf_process_task task
+                LEFT JOIN wf_process_instance ins ON ins.id = task.processInstanceId
+                LEFT JOIN wf_process_define def ON def.id = ins.processDefineId
+                LEFT JOIN wf_process_task_actor ta ON ta.processTaskId = task.id
+                INNER JOIN tour_ledger t ON t.id = ins.businessNo
+                LEFT JOIN tour_matter m ON m.id = t.matterId AND m.delFlag = 0
+                LEFT JOIN tour_line l ON l.id = t.lineId AND l.delFlag = 0
+                $condition
+                ORDER BY travelPeriod ASC
+                """);
+        sql.setCondition(cnd);
+        sql.setCallback(Sqls.callback.maps());
+        tourLedgerService.dao().execute(sql);
+        return Result.success(sql.getList(NutMap.class));
+    }
+
+    @At
+    @SaCheckPermission(value = {"tour.unionApproval", "h5.tour.unionApproval"}, mode = SaMode.OR)
+    public Result lineTypeOptions(Boolean audit, Integer startYear, Integer endYear, String lineId, String travelPeriod, String unionId, String keyword) {
+        Cnd cnd = buildAuditCnd(audit, startYear, endYear, keyword, unionId, lineId, travelPeriod, null);
+        cnd.and("t.lineType", "IS NOT", null);
+        cnd.and("t.lineType", "<>", "");
+
+        Sql sql = Sqls.create("""
+                SELECT DISTINCT t.lineType
+                FROM wf_process_task task
+                LEFT JOIN wf_process_instance ins ON ins.id = task.processInstanceId
+                LEFT JOIN wf_process_define def ON def.id = ins.processDefineId
+                LEFT JOIN wf_process_task_actor ta ON ta.processTaskId = task.id
+                INNER JOIN tour_ledger t ON t.id = ins.businessNo
+                LEFT JOIN tour_matter m ON m.id = t.matterId AND m.delFlag = 0
+                LEFT JOIN tour_line l ON l.id = t.lineId AND l.delFlag = 0
+                $condition
+                ORDER BY t.lineType ASC
+                """);
+        sql.setCondition(cnd);
+        sql.setCallback(Sqls.callback.maps());
+        tourLedgerService.dao().execute(sql);
+        return Result.success(sql.getList(NutMap.class));
+    }
+
+    private Cnd buildAuditCnd(Boolean audit, Integer startYear, Integer endYear, String keyword, String unionId, String lineId, String travelPeriod, String lineType) {
+        Cnd cnd = Cnd.NEW();
+        cnd.and("t.delFlag", "=", false);
+        cnd.and("def.name", "=", WORKFLOW_KEY);
+        cnd.and("task.displayName", "=", TASK_DISPLAY_NAME);
+        cnd.and("ta.actorId", "in", List.of(SecurityUtil.getUserId()));
+        appendAuditStateFilter(cnd, audit);
+        cnd.andEX("t.`year`", ">=", startYear);
+        cnd.andEX("t.`year`", "<=", endYear == null ? LocalDate.now().getYear() : endYear);
+        cnd.andEX("t.unionId", "=", unionId);
+        cnd.andEX("t.lineType", "=", lineType);
+        appendLineFilter(cnd, lineId);
+        appendTravelPeriodFilter(cnd, travelPeriod);
+        appendKeywordFilter(cnd, keyword);
+        return cnd;
+    }
+
+    private void appendAuditStateFilter(Cnd cnd, Boolean audit) {
+        if (Boolean.TRUE.equals(audit)) {
+            cnd.and("task.taskState", "in", List.of(
+                    ProcessTaskStateEnum.FINISHED.getCode(),
+                    ProcessTaskStateEnum.WITHDRAW.getCode(),
+                    ProcessTaskStateEnum.INTERRUPT.getCode()));
+            return;
+        }
+        cnd.and("task.taskState", "=", ProcessTaskStateEnum.DOING.getCode());
+    }
+
+    private void appendKeywordFilter(Cnd cnd, String keyword) {
+        if (StrUtil.isBlank(keyword)) {
+            return;
+        }
+        SqlExpressionGroup group = new SqlExpressionGroup();
+        group.orLike("t.userName", keyword.trim());
+        group.orLike("t.jobNo", keyword.trim());
+        group.orLike("t.lineName", keyword.trim());
+        group.orLike("l.lineName", keyword.trim());
+        cnd.and(group);
+    }
+
+    private void appendTravelPeriodFilter(Cnd cnd, String travelPeriod) {
+        if (StrUtil.isBlank(travelPeriod)) {
+            return;
+        }
+        cnd.and("CONCAT(m.travelStartTime, ' 至 ', m.travelEndTime)", "=", travelPeriod);
+    }
+
+    private void appendLineFilter(Cnd cnd, String lineId) {
+        if (StrUtil.isBlank(lineId)) {
+            return;
+        }
+        LineFilter lineFilter = parseLineFilter(lineId);
+        if (lineFilter.getLineId().startsWith("legacy:")) {
+            SqlExpressionGroup legacyGroup = new SqlExpressionGroup();
+            legacyGroup.or("t.lineId", "IS", null);
+            legacyGroup.or("t.lineId", "=", "");
+            cnd.and(legacyGroup);
+            cnd.and("t.lineName", "=", lineFilter.getLineId().substring("legacy:".length()));
+        } else {
+            cnd.and("t.lineId", "=", lineFilter.getLineId());
+        }
+        appendMatterUnionFilter(cnd, lineFilter.getUnionId());
+    }
+
+    private LineFilter parseLineFilter(String value) {
+        int delimiterIndex = value.indexOf("|");
+        if (delimiterIndex < 0) {
+            return new LineFilter(value, null);
+        }
+        return new LineFilter(value.substring(0, delimiterIndex), value.substring(delimiterIndex + 1));
+    }
+
+    private void appendMatterUnionFilter(Cnd cnd, String unionId) {
+        if (unionId == null) {
+            return;
+        }
+        if (StrUtil.isBlank(unionId)) {
+            SqlExpressionGroup group = new SqlExpressionGroup();
+            group.or("m.unionId", "IS", null);
+            group.or("m.unionId", "=", "");
+            cnd.and(group);
+            return;
+        }
+        cnd.and("m.unionId", "=", unionId);
+    }
+
+    private String getOrderColumn(String orderName) {
+        if ("jobNo".equals(orderName)) {
+            return "t.jobNo";
+        }
+        if ("userName".equals(orderName)) {
+            return "t.userName";
+        }
+        if ("lineName".equals(orderName)) {
+            return """
+                    CASE
+                        WHEN m.id IS NULL THEN COALESCE(NULLIF(l.lineName, ''), t.lineName)
+                        ELSE CONCAT(
+                            COALESCE(NULLIF(l.lineName, ''), t.lineName),
+                            '（',
+                            CASE
+                                WHEN IFNULL(m.unionId, '') = '' THEN '校工会'
+                                ELSE IFNULL(mu.name, '')
+                            END,
+                            '）'
+                        )
+                    END
+                    """;
+        }
+        if ("travelPeriod".equals(orderName)) {
+            return "COALESCE(m.travelStartTime, tp.travelPeriod)";
+        }
+        if ("lineType".equals(orderName)) {
+            return "t.lineType";
+        }
+        if ("signupTime".equals(orderName)) {
+            return "t.signupTime";
+        }
+        if ("familyCount".equals(orderName)) {
+            return "familyCount";
+        }
+        if ("instanceState".equals(orderName)) {
+            return "ins.state";
+        }
+        return "task.createdAt";
+    }
+
+    private TourLedger fetchAuditLedger(String id) {
+        if (StrUtil.isBlank(id)) {
+            return null;
+        }
+        Sql sql = Sqls.create("""
+                SELECT COUNT(1)
+                FROM wf_process_task task
+                LEFT JOIN wf_process_instance ins ON ins.id = task.processInstanceId
+                LEFT JOIN wf_process_define def ON def.id = ins.processDefineId
+                LEFT JOIN wf_process_task_actor ta ON ta.processTaskId = task.id
+                INNER JOIN tour_ledger t ON t.id = ins.businessNo
+                WHERE t.delFlag = 0
+                  AND t.id = @id
+                  AND def.name = @workflowKey
+                  AND task.displayName = @taskDisplayName
+                  AND ta.actorId = @actorId
+                """);
+        sql.setParam("id", id);
+        sql.setParam("workflowKey", WORKFLOW_KEY);
+        sql.setParam("taskDisplayName", TASK_DISPLAY_NAME);
+        sql.setParam("actorId", SecurityUtil.getUserId());
+        sql.setCallback(Sqls.callback.integer());
+        tourLedgerService.dao().execute(sql);
+        return sql.getInt() > 0 ? tourLedgerService.fetch(id) : null;
+    }
+
+    private String getCurrentLineName(TourLedger ledger) {
+        if (ledger == null) {
+            return "";
+        }
+        Sql sql = Sqls.create("""
+                SELECT CASE
+                    WHEN m.id IS NULL THEN COALESCE(NULLIF(l.lineName, ''), t.lineName)
+                    ELSE CONCAT(
+                        COALESCE(NULLIF(l.lineName, ''), t.lineName),
+                        '（',
+                        CASE
+                            WHEN IFNULL(m.unionId, '') = '' THEN '校工会'
+                            ELSE IFNULL(mu.name, '')
+                        END,
+                        '）'
+                    )
+                END AS lineName
+                FROM tour_ledger t
+                LEFT JOIN tour_matter m ON m.id = t.matterId AND m.delFlag = 0
+                LEFT JOIN tour_line l ON l.id = t.lineId AND l.delFlag = 0
+                LEFT JOIN sys_union mu ON mu.id = m.unionId
+                WHERE t.id = @ledgerId
+                """);
+        sql.setParam("ledgerId", ledger.getId());
+        sql.setCallback(Sqls.callback.str());
+        tourLedgerService.dao().execute(sql);
+        return StrUtil.blankToDefault(sql.getString(), ledger.getLineName());
+    }
+
+    private String getTravelPeriod(TourLedger ledger) {
+        if (ledger == null || ledger.getYear() == null || StrUtil.isBlank(ledger.getLineId())) {
+            return "";
+        }
+        if (StrUtil.isNotBlank(ledger.getMatterId())) {
+            Sql exactSql = Sqls.create("""
+                    SELECT CASE
+                        WHEN IFNULL(travelStartTime, '') <> '' AND IFNULL(travelEndTime, '') <> ''
+                        THEN CONCAT(travelStartTime, ' 至 ', travelEndTime)
+                        ELSE ''
+                    END AS travelPeriod
+                    FROM tour_matter
+                    WHERE delFlag = 0
+                      AND id = @matterId
+                    """);
+            exactSql.setParam("matterId", ledger.getMatterId());
+            exactSql.setCallback(Sqls.callback.str());
+            tourLedgerService.dao().execute(exactSql);
+            return exactSql.getString();
+        }
+        Sql sql = Sqls.create("""
+                SELECT GROUP_CONCAT(
+                    DISTINCT CASE
+                        WHEN IFNULL(travelStartTime, '') <> '' AND IFNULL(travelEndTime, '') <> ''
+                        THEN CONCAT(travelStartTime, ' 至 ', travelEndTime)
+                        ELSE NULL
+                    END
+                    ORDER BY travelStartTime ASC
+                    SEPARATOR '；'
+                ) AS travelPeriod
+                FROM tour_matter
+                WHERE delFlag = 0
+                  AND `year` = @year
+                  AND lineId = @lineId
+                """);
+        sql.setParam("year", ledger.getYear());
+        sql.setParam("lineId", ledger.getLineId());
+        sql.setCallback(Sqls.callback.str());
+        tourLedgerService.dao().execute(sql);
+        return sql.getString();
+    }
+
+    private NutMap getSignupConfig(TourLedger ledger) {
+        if (ledger == null || StrUtil.isBlank(ledger.getLineId())) {
+            return NutMap.NEW().addv("allowFamily", false).addv("fillBedInfo", true).addv("directFamilyUnitLine", false);
+        }
+        Sql sql = Sqls.create("""
+                SELECT
+                    IFNULL(s.allowFamily, 0) AS allowFamily,
+                    IFNULL(s.fillBedInfo, 1) AS fillBedInfo,
+                    IFNULL(l.directFamilyUnitLine, 0) AS directFamilyUnitLine
+                FROM tour_ledger t
+                LEFT JOIN tour_matter m ON m.id = t.matterId AND m.delFlag = 0
+                LEFT JOIN tour_setting s ON s.id = m.settingId AND s.delFlag = 0
+                LEFT JOIN tour_line l ON l.id = t.lineId AND l.delFlag = 0
+                WHERE t.id = @ledgerId
+                """);
+        sql.setParam("ledgerId", ledger.getId());
+        sql.setCallback(Sqls.callback.map());
+        tourLedgerService.dao().execute(sql);
+        NutMap map = sql.getObject(NutMap.class);
+        if (map == null || map.isEmpty()) {
+            return NutMap.NEW().addv("allowFamily", false).addv("fillBedInfo", true).addv("directFamilyUnitLine", false);
+        }
+        return map;
+    }
+
+    private static class LineFilter {
+        private final String lineId;
+        private final String unionId;
+
+        private LineFilter(String lineId, String unionId) {
+            this.lineId = lineId;
+            this.unionId = unionId;
+        }
+
+        private String getLineId() {
+            return lineId;
+        }
+
+        private String getUnionId() {
+            return unionId;
+        }
+    }
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/controller/TourUnionLedgerController.java

@@ -0,0 +1,905 @@
+package com.budwk.app.zhgh.dayofficework.tour.controller;
+
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import cn.hutool.core.util.StrUtil;
+import com.budwk.app.base.annotation.SLog;
+import com.budwk.app.base.page.Pagination;
+import com.budwk.app.base.param.PageForm;
+import com.budwk.app.base.result.Result;
+import com.budwk.app.base.utils.CommonDownloadUtil;
+import com.budwk.app.sys.models.Sys_union;
+import com.budwk.app.web.commons.auth.utils.SecurityUtil;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourLedger;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourLedgerDirectRelative;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourLedgerFamily;
+import com.budwk.app.zhgh.dayofficework.tour.service.TourLedgerDirectRelativeService;
+import com.budwk.app.zhgh.dayofficework.tour.service.TourLedgerFamilyService;
+import com.budwk.app.zhgh.dayofficework.tour.service.TourLedgerService;
+import org.apache.poi.hssf.usermodel.HSSFWorkbook;
+import org.apache.poi.ss.usermodel.BorderStyle;
+import org.apache.poi.ss.usermodel.Cell;
+import org.apache.poi.ss.usermodel.CellStyle;
+import org.apache.poi.ss.usermodel.Font;
+import org.apache.poi.ss.usermodel.HorizontalAlignment;
+import org.apache.poi.ss.usermodel.Row;
+import org.apache.poi.ss.usermodel.Sheet;
+import org.apache.poi.ss.usermodel.VerticalAlignment;
+import org.apache.poi.ss.usermodel.Workbook;
+import org.apache.poi.ss.util.CellRangeAddress;
+import org.nutz.aop.interceptor.ioc.TransAop;
+import org.nutz.dao.Cnd;
+import org.nutz.dao.Sqls;
+import org.nutz.dao.sql.Sql;
+import org.nutz.dao.util.cri.SqlExpressionGroup;
+import org.nutz.ioc.aop.Aop;
+import org.nutz.ioc.loader.annotation.Inject;
+import org.nutz.ioc.loader.annotation.IocBean;
+import org.nutz.lang.util.NutMap;
+import org.nutz.mvc.annotation.At;
+import org.nutz.mvc.annotation.Ok;
+
+import javax.servlet.http.HttpServletResponse;
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.temporal.ChronoUnit;
+import java.util.List;
+
+@IocBean
+@Ok("json:full")
+@At("/platform/tour/unionledger")
+public class TourUnionLedgerController {
+
+    @Inject
+    private TourLedgerService tourLedgerService;
+
+    @Inject
+    private TourLedgerFamilyService tourLedgerFamilyService;
+
+    @Inject
+    private TourLedgerDirectRelativeService tourLedgerDirectRelativeService;
+
+    @At("")
+    @Ok("beetl:/platform/zhgh/dayofficework/Tour/unionledger/index.html")
+    @SaCheckPermission("tour.unionledger")
+    public void index() {
+    }
+
+    @At
+    @SaCheckPermission("tour.unionledger")
+    public Result pageData(PageForm pageForm, Integer startYear, Integer endYear, String keyword, String unionId, String lineId, String travelPeriod, String lineType, String scopeType, Boolean overCostOnly) {
+        String currentUnionId = currentUnionId();
+        if (StrUtil.isBlank(currentUnionId)) {
+            return Result.error("当前登录人所属工会不能为空");
+        }
+        Cnd cnd = buildQueryCnd(currentUnionId, startYear, endYear, keyword, unionId, lineId, travelPeriod, lineType, scopeType, overCostOnly);
+
+        Sql countSql = Sqls.create("""
+                SELECT COUNT(DISTINCT t.id)
+                FROM tour_ledger t
+                LEFT JOIN wf_process_instance ins ON ins.businessNo = t.id
+                LEFT JOIN wf_process_task task ON task.processInstanceId = ins.id AND task.taskState = 10
+                LEFT JOIN tour_matter m ON m.id = t.matterId AND m.delFlag = 0
+                $condition
+                """);
+        countSql.setCondition(cnd);
+        countSql.setCallback(Sqls.callback.integer());
+        tourLedgerService.dao().execute(countSql);
+        int count = countSql.getInt();
+
+        Sql listSql = Sqls.create("""
+                SELECT
+                    t.*,
+                    ins.id AS instanceId,
+                    ins.state AS instanceState,
+                    ins.processDefineId AS instanceProcessDefineId,
+                    IFNULL(l.directFamilyUnitLine, 0) AS directFamilyUnitLine,
+                    IFNULL(GROUP_CONCAT(DISTINCT task.displayName), IF(ins.id IS NULL, '', '结束')) AS curTaskName,
+                    CASE
+                        WHEN m.id IS NULL THEN COALESCE(NULLIF(l.lineName, ''), t.lineName)
+                        ELSE CONCAT(
+                            COALESCE(NULLIF(l.lineName, ''), t.lineName),
+                            '（',
+                            CASE
+                                WHEN IFNULL(m.unionId, '') = '' THEN '校工会'
+                                ELSE IFNULL(mu.name, '')
+                            END,
+                            '）'
+                        )
+                    END AS currentLineName,
+                    IFNULL(f.familyCount, 0) AS familyCount,
+                    CASE
+                        WHEN IFNULL(m.travelStartTime, '') <> '' AND IFNULL(m.travelEndTime, '') <> ''
+                        THEN CONCAT(m.travelStartTime, ' 至 ', m.travelEndTime)
+                        ELSE tp.travelPeriod
+                    END AS travelPeriod
+                FROM tour_ledger t
+                LEFT JOIN wf_process_instance ins ON ins.businessNo = t.id
+                LEFT JOIN wf_process_task task ON task.processInstanceId = ins.id AND task.taskState = 10
+                LEFT JOIN (
+                    SELECT ledgerId, COUNT(1) AS familyCount
+                    FROM tour_ledger_family
+                    WHERE delFlag = 0
+                    GROUP BY ledgerId
+                ) f ON f.ledgerId = t.id
+                LEFT JOIN tour_matter m ON m.id = t.matterId AND m.delFlag = 0
+                LEFT JOIN tour_line l ON l.id = t.lineId AND l.delFlag = 0
+                LEFT JOIN sys_union mu ON mu.id = m.unionId
+                LEFT JOIN (
+                    SELECT
+                        `year`,
+                        lineId,
+                        GROUP_CONCAT(
+                            DISTINCT CASE
+                                WHEN IFNULL(travelStartTime, '') <> '' AND IFNULL(travelEndTime, '') <> ''
+                                THEN CONCAT(travelStartTime, ' 至 ', travelEndTime)
+                                ELSE NULL
+                            END
+                            ORDER BY travelStartTime ASC
+                            SEPARATOR '；'
+                        ) AS travelPeriod
+                    FROM tour_matter
+                    WHERE delFlag = 0
+                      AND lineId IS NOT NULL
+                      AND lineId <> ''
+                    GROUP BY `year`, lineId
+                ) tp ON (t.matterId IS NULL OR t.matterId = '') AND tp.`year` = t.`year` AND tp.lineId = t.lineId
+                $condition
+                GROUP BY t.id
+                ORDER BY $orderColumn $orderBy, t.`year` DESC, t.signupTime DESC, t.createdAt DESC
+                """);
+        listSql.setCondition(cnd);
+        listSql.setVar("orderColumn", getOrderColumn(pageForm.getPageOrderName()));
+        listSql.setVar("orderBy", "descending".equals(pageForm.getPageOrderBy()) ? "desc" : "asc");
+        listSql.setPager(tourLedgerService.dao().createPager(pageForm.getPageNumber(), pageForm.getPageSize()));
+        listSql.setCallback(Sqls.callback.maps());
+        tourLedgerService.dao().execute(listSql);
+
+        var list = listSql.getList(NutMap.class);
+        list.forEach(item -> item.put("lineName", item.getString("currentLineName")));
+        Pagination<NutMap> pagination = new Pagination<>(pageForm.getPageNumber(), pageForm.getPageSize(), count, list);
+        return Result.success(pagination);
+    }
+
+    @At
+    @Ok("void")
+    @SaCheckPermission("tour.unionledger")
+    public void exportOverCostSummary(PageForm pageForm, Integer startYear, Integer endYear, String keyword, String unionId, String lineId, String travelPeriod, String lineType, String scopeType, HttpServletResponse response) {
+        String currentUnionId = currentUnionId();
+        if (StrUtil.isBlank(currentUnionId)) {
+            return;
+        }
+        Cnd cnd = buildQueryCnd(currentUnionId, startYear, endYear, keyword, unionId, lineId, travelPeriod, lineType, scopeType, true);
+        List<NutMap> list = queryOverCostSummaryList(cnd, pageForm);
+        Workbook workbook = buildOverCostSummaryWorkbook(currentUnionName(), list);
+        CommonDownloadUtil.download("5天外超出部分疗休养费用由单位承担申请人员汇总表.xls", workbook, response);
+    }
+
+    @At
+    @SaCheckPermission("tour.unionledger")
+    public Result detail(String id) {
+        TourLedger ledger = fetchScopedLedger(id);
+        if (ledger == null) {
+            return Result.error("台账记录不存在或无权查看");
+        }
+        ledger.setLineName(getCurrentLineName(ledger));
+        Cnd familyCnd = Cnd.where(TourLedgerFamily::getLedgerId, "=", id)
+                .and(TourLedgerFamily::getDelFlag, "=", false);
+        familyCnd.asc(TourLedgerFamily::getCreatedAt);
+        TourLedgerDirectRelative directRelative = tourLedgerDirectRelativeService.fetch(
+                Cnd.where(TourLedgerDirectRelative::getDelFlag, "=", false)
+                        .and(TourLedgerDirectRelative::getLedgerId, "=", ledger.getId()));
+        return Result.success(NutMap.NEW()
+                .addv("ledger", ledger)
+                .addv("travelPeriod", getTravelPeriod(ledger))
+                .addv("families", tourLedgerFamilyService.query(familyCnd))
+                .addv("directRelative", directRelative)
+                .addv("fillBedInfo", isFillBedInfo(ledger))
+                .addv("directFamilyUnitLine", isDirectFamilyUnitLine(ledger)));
+    }
+
+    @At
+    @Aop(TransAop.READ_COMMITTED)
+    @SaCheckPermission("tour.unionledger")
+    @SLog(type = "tour", tag = "分工会疗休养台账", msg = "删除分工会疗休养台账")
+    public Result doDelete(String id) {
+        TourLedger ledger = fetchScopedLedger(id);
+        if (ledger == null) {
+            return Result.error("台账记录不存在或无权删除");
+        }
+        tourLedgerFamilyService.clear(Cnd.where(TourLedgerFamily::getLedgerId, "=", ledger.getId()));
+        tourLedgerService.clear(Cnd.where(TourLedger::getId, "=", ledger.getId()));
+        return Result.success();
+    }
+
+    @At
+    @SaCheckPermission("tour.unionledger")
+    public Result unionOptions(Integer startYear, Integer endYear) {
+        String currentUnionId = currentUnionId();
+        if (StrUtil.isBlank(currentUnionId)) {
+            return Result.error("当前登录人所属工会不能为空");
+        }
+        Cnd cnd = Cnd.NEW();
+        cnd.and("t.delFlag", "=", false);
+        cnd.andEX("t.`year`", ">=", startYear);
+        cnd.andEX("t.`year`", "<=", endYear == null ? LocalDate.now().getYear() : endYear);
+        cnd.and("t.unionId", "IS NOT", null);
+        cnd.and("t.unionId", "<>", "");
+        applyUnionLedgerScope(cnd, currentUnionId);
+
+        Sql sql = Sqls.create("""
+                SELECT DISTINCT
+                    t.unionId AS id,
+                    COALESCE(NULLIF(u.name, ''), t.unionName) AS name,
+                    u.unionCode
+                FROM tour_ledger t
+                LEFT JOIN tour_matter m ON m.id = t.matterId AND m.delFlag = 0
+                LEFT JOIN sys_union u ON u.id = t.unionId
+                $condition
+                ORDER BY
+                    CASE WHEN t.unionId = @currentUnionId THEN 0 ELSE 1 END,
+                    u.unionCode ASC,
+                    name ASC
+                """);
+        sql.setCondition(cnd);
+        sql.setParam("currentUnionId", currentUnionId);
+        sql.setCallback(Sqls.callback.maps());
+        tourLedgerService.dao().execute(sql);
+        return Result.success(sql.getList(NutMap.class));
+    }
+
+    @At
+    @SaCheckPermission("tour.unionledger")
+    public Result lineOptions(Integer startYear, Integer endYear, String travelPeriod, String lineType, String unionId, String keyword, String scopeType) {
+        String currentUnionId = currentUnionId();
+        if (StrUtil.isBlank(currentUnionId)) {
+            return Result.error("当前登录人所属工会不能为空");
+        }
+        Cnd cnd = Cnd.NEW();
+        cnd.and("t.delFlag", "=", false);
+        cnd.andEX("t.`year`", ">=", startYear);
+        cnd.andEX("t.`year`", "<=", endYear == null ? LocalDate.now().getYear() : endYear);
+        cnd.and("t.lineName", "IS NOT", null);
+        cnd.and("t.lineName", "<>", "");
+        cnd.andEX("t.unionId", "=", unionId);
+        cnd.andEX("t.lineType", "=", lineType);
+        appendTravelPeriodFilter(cnd, travelPeriod);
+        appendScopeFilter(cnd, currentUnionId, scopeType);
+        appendKeywordFilter(cnd, keyword);
+
+        Sql sql = Sqls.create("""
+                SELECT DISTINCT
+                    CASE
+                        WHEN IFNULL(t.lineId, '') <> '' THEN CONCAT(t.lineId, '|', IFNULL(m.unionId, ''))
+                        ELSE CONCAT('legacy:', t.lineName, '|', IFNULL(m.unionId, ''))
+                    END AS lineId,
+                    CASE
+                        WHEN m.id IS NULL THEN COALESCE(NULLIF(l.lineName, ''), t.lineName)
+                        ELSE CONCAT(
+                            COALESCE(NULLIF(l.lineName, ''), t.lineName),
+                            '（',
+                            CASE
+                                WHEN IFNULL(m.unionId, '') = '' THEN '校工会'
+                                ELSE IFNULL(mu.name, '')
+                            END,
+                            '）'
+                        )
+                    END AS lineName
+                FROM tour_ledger t
+                LEFT JOIN tour_matter m ON m.id = t.matterId AND m.delFlag = 0
+                LEFT JOIN tour_line l ON l.id = t.lineId AND l.delFlag = 0
+                LEFT JOIN sys_union mu ON mu.id = m.unionId
+                $condition
+                ORDER BY lineName ASC
+                """);
+        sql.setCondition(cnd);
+        sql.setCallback(Sqls.callback.maps());
+        tourLedgerService.dao().execute(sql);
+        return Result.success(sql.getList(NutMap.class));
+    }
+
+    @At
+    @SaCheckPermission("tour.unionledger")
+    public Result travelPeriodOptions(Integer startYear, Integer endYear, String lineId, String lineType, String unionId, String keyword, String scopeType) {
+        String currentUnionId = currentUnionId();
+        if (StrUtil.isBlank(currentUnionId)) {
+            return Result.error("当前登录人所属工会不能为空");
+        }
+        Cnd cnd = Cnd.NEW();
+        cnd.and("t.delFlag", "=", false);
+        cnd.andEX("t.`year`", ">=", startYear);
+        cnd.andEX("t.`year`", "<=", endYear == null ? LocalDate.now().getYear() : endYear);
+        cnd.and("m.travelStartTime", "IS NOT", null);
+        cnd.and("m.travelStartTime", "<>", "");
+        cnd.and("m.travelEndTime", "IS NOT", null);
+        cnd.and("m.travelEndTime", "<>", "");
+        cnd.andEX("t.unionId", "=", unionId);
+        cnd.andEX("t.lineType", "=", lineType);
+        appendLineFilter(cnd, lineId);
+        appendScopeFilter(cnd, currentUnionId, scopeType);
+        appendKeywordFilter(cnd, keyword);
+
+        Sql sql = Sqls.create("""
+                SELECT DISTINCT CONCAT(m.travelStartTime, ' 至 ', m.travelEndTime) AS travelPeriod
+                FROM tour_ledger t
+                LEFT JOIN tour_matter m ON m.id = t.matterId AND m.delFlag = 0
+                $condition
+                ORDER BY travelPeriod ASC
+                """);
+        sql.setCondition(cnd);
+        sql.setCallback(Sqls.callback.maps());
+        tourLedgerService.dao().execute(sql);
+        return Result.success(sql.getList(NutMap.class));
+    }
+
+    @At
+    @SaCheckPermission("tour.unionledger")
+    public Result lineTypeOptions(Integer startYear, Integer endYear, String lineId, String travelPeriod, String unionId, String keyword, String scopeType) {
+        String currentUnionId = currentUnionId();
+        if (StrUtil.isBlank(currentUnionId)) {
+            return Result.error("当前登录人所属工会不能为空");
+        }
+        Cnd cnd = Cnd.NEW();
+        cnd.and("t.delFlag", "=", false);
+        cnd.andEX("t.`year`", ">=", startYear);
+        cnd.andEX("t.`year`", "<=", endYear == null ? LocalDate.now().getYear() : endYear);
+        cnd.and("t.lineType", "IS NOT", null);
+        cnd.and("t.lineType", "<>", "");
+        cnd.andEX("t.unionId", "=", unionId);
+        appendLineFilter(cnd, lineId);
+        appendTravelPeriodFilter(cnd, travelPeriod);
+        appendScopeFilter(cnd, currentUnionId, scopeType);
+        appendKeywordFilter(cnd, keyword);
+
+        Sql sql = Sqls.create("""
+                SELECT DISTINCT t.lineType
+                FROM tour_ledger t
+                LEFT JOIN tour_matter m ON m.id = t.matterId AND m.delFlag = 0
+                $condition
+                ORDER BY t.lineType ASC
+                """);
+        sql.setCondition(cnd);
+        sql.setCallback(Sqls.callback.maps());
+        tourLedgerService.dao().execute(sql);
+        return Result.success(sql.getList(NutMap.class));
+    }
+
+    @At
+    @SaCheckPermission("tour.unionledger")
+    public Result summaryStats(Integer startYear, Integer endYear, String unionId, String lineId, String travelPeriod, String lineType) {
+        String currentUnionId = currentUnionId();
+        if (StrUtil.isBlank(currentUnionId)) {
+            return Result.error("当前登录人所属工会不能为空");
+        }
+        Cnd ownCnd = buildSummaryCnd(currentUnionId, startYear, endYear, unionId, lineId, travelPeriod, lineType, "ownUnionJoined");
+        Cnd organizedCnd = buildSummaryCnd(currentUnionId, startYear, endYear, unionId, lineId, travelPeriod, lineType, "organizedLineJoined");
+
+        Sql ownSql = Sqls.create("""
+                SELECT COUNT(1)
+                FROM tour_ledger t
+                LEFT JOIN tour_matter m ON m.id = t.matterId AND m.delFlag = 0
+                $condition
+                """);
+        ownSql.setCondition(ownCnd);
+        ownSql.setCallback(Sqls.callback.integer());
+        tourLedgerService.dao().execute(ownSql);
+
+        Sql organizedSql = Sqls.create("""
+                SELECT CAST(IFNULL(SUM(1 + IFNULL(f.familyCount, 0)), 0) AS SIGNED)
+                FROM tour_ledger t
+                INNER JOIN tour_matter m ON m.id = t.matterId AND m.delFlag = 0
+                LEFT JOIN (
+                    SELECT ledgerId, COUNT(1) AS familyCount
+                    FROM tour_ledger_family
+                    WHERE delFlag = 0
+                    GROUP BY ledgerId
+                ) f ON f.ledgerId = t.id
+                $condition
+                """);
+        organizedSql.setCondition(organizedCnd);
+        organizedSql.setCallback(Sqls.callback.integer());
+        tourLedgerService.dao().execute(organizedSql);
+
+        return Result.success(NutMap.NEW()
+                .addv("ownUnionJoinedStaffCount", ownSql.getInt())
+                .addv("organizedLineJoinedTotalCount", organizedSql.getInt()));
+    }
+
+    private List<NutMap> queryOverCostSummaryList(Cnd cnd, PageForm pageForm) {
+        Sql sql = Sqls.create("""
+                SELECT
+                    t.id,
+                    t.userName,
+                    t.idCard,
+                    t.unionName,
+                    vu.mobile,
+                    m.travelStartTime,
+                    m.travelEndTime,
+                    m.estimatedCost,
+                    CASE
+                        WHEN IFNULL(m.travelStartTime, '') <> '' AND IFNULL(m.travelEndTime, '') <> ''
+                        THEN CONCAT(m.travelStartTime, ' 至 ', m.travelEndTime)
+                        ELSE tp.travelPeriod
+                    END AS travelPeriod,
+                    CASE
+                        WHEN m.id IS NULL THEN COALESCE(NULLIF(l.lineName, ''), t.lineName)
+                        ELSE CONCAT(
+                            COALESCE(NULLIF(l.lineName, ''), t.lineName),
+                            '（',
+                            CASE
+                                WHEN IFNULL(m.unionId, '') = '' THEN '校工会'
+                                ELSE IFNULL(mu.name, '')
+                            END,
+                            '）'
+                        )
+                    END AS currentLineName
+                FROM tour_ledger t
+                LEFT JOIN tour_matter m ON m.id = t.matterId AND m.delFlag = 0
+                LEFT JOIN tour_line l ON l.id = t.lineId AND l.delFlag = 0
+                LEFT JOIN sys_union mu ON mu.id = m.unionId
+                LEFT JOIN vw_user vu ON vu.loginname = t.jobNo
+                LEFT JOIN (
+                    SELECT
+                        `year`,
+                        lineId,
+                        GROUP_CONCAT(
+                            DISTINCT CASE
+                                WHEN IFNULL(travelStartTime, '') <> '' AND IFNULL(travelEndTime, '') <> ''
+                                THEN CONCAT(travelStartTime, ' 至 ', travelEndTime)
+                                ELSE NULL
+                            END
+                            ORDER BY travelStartTime ASC
+                            SEPARATOR '；'
+                        ) AS travelPeriod
+                    FROM tour_matter
+                    WHERE delFlag = 0
+                      AND lineId IS NOT NULL
+                      AND lineId <> ''
+                    GROUP BY `year`, lineId
+                ) tp ON (t.matterId IS NULL OR t.matterId = '') AND tp.`year` = t.`year` AND tp.lineId = t.lineId
+                $condition
+                ORDER BY $orderColumn $orderBy, t.`year` DESC, t.signupTime DESC, t.createdAt DESC
+                """);
+        sql.setCondition(cnd);
+        sql.setVar("orderColumn", getOrderColumn(pageForm == null ? null : pageForm.getPageOrderName()));
+        sql.setVar("orderBy", pageForm != null && "ascending".equals(pageForm.getPageOrderBy()) ? "asc" : "desc");
+        sql.setCallback(Sqls.callback.maps());
+        tourLedgerService.dao().execute(sql);
+        List<NutMap> list = sql.getList(NutMap.class);
+        for (NutMap item : list) {
+            item.put("lineName", item.getString("currentLineName"));
+            item.put("totalDays", calcDays(item.getString("travelStartTime", ""), item.getString("travelEndTime", "")));
+            item.put("estimatedCostText", formatAmount(item.get("estimatedCost")));
+        }
+        return list;
+    }
+
+    private Workbook buildOverCostSummaryWorkbook(String unionName, List<NutMap> list) {
+        Workbook workbook = new HSSFWorkbook();
+        Sheet sheet = workbook.createSheet("汇总表");
+        sheet.addMergedRegion(new CellRangeAddress(0, 0, 0, 9));
+        sheet.addMergedRegion(new CellRangeAddress(1, 1, 0, 9));
+        sheet.addMergedRegion(new CellRangeAddress(2, 2, 0, 9));
+
+        double[] widths = {5.14, 14.14, 21.29, 15.71, 27, 40, 50.43, 13.71, 22.57, 15.43};
+        for (int i = 0; i < widths.length; i++) {
+            sheet.setColumnWidth(i, (int) (widths[i] * 256));
+        }
+
+        CellStyle attachStyle = createStyle(workbook, "宋体", (short) 12, false, HorizontalAlignment.LEFT, false, false);
+        CellStyle titleStyle = createStyle(workbook, "黑体", (short) 18, true, HorizontalAlignment.CENTER, false, false);
+        CellStyle unionStyle = createStyle(workbook, "仿宋_GB2312", (short) 14, true, HorizontalAlignment.LEFT, false, false);
+        unionStyle.setBorderBottom(BorderStyle.THIN);
+        CellStyle headerStyle = createStyle(workbook, "宋体", (short) 12, true, HorizontalAlignment.CENTER, true, true);
+        CellStyle bodyStyle = createStyle(workbook, "宋体", (short) 12, false, HorizontalAlignment.CENTER, false, true);
+
+        Row row1 = sheet.createRow(0);
+        row1.setHeightInPoints(32);
+        setCell(row1, 0, "附件12", attachStyle);
+        fillMergedCells(row1, 1, 9, attachStyle);
+
+        Row row2 = sheet.createRow(1);
+        row2.setHeightInPoints(32);
+        setCell(row2, 0, "5天外超出部分疗休养费用由单位承担申请人员汇总表", titleStyle);
+        fillMergedCells(row2, 1, 9, titleStyle);
+
+        Row row3 = sheet.createRow(2);
+        row3.setHeightInPoints(32);
+        setCell(row3, 0, "分工会：" + StrUtil.blankToDefault(unionName, ""), unionStyle);
+        fillMergedCells(row3, 1, 9, unionStyle);
+
+        String[] headers = {"序号", "姓名", "身份证号码", "电话号码", "所属分工会", "所选线路名称", "疗休养时间", "疗休养时长", "疗休养费用总额（元）", "备注"};
+        Row header = sheet.createRow(3);
+        header.setHeightInPoints(43);
+        for (int i = 0; i < headers.length; i++) {
+            setCell(header, i, headers[i], headerStyle);
+        }
+
+        int rowCount = Math.max(list == null ? 0 : list.size(), 20);
+        for (int i = 0; i < rowCount; i++) {
+            Row row = sheet.createRow(i + 4);
+            row.setHeightInPoints(25);
+            NutMap item = list != null && i < list.size() ? list.get(i) : null;
+            setCell(row, 0, String.valueOf(i + 1), bodyStyle);
+            setCell(row, 1, item == null ? "" : item.getString("userName", ""), bodyStyle);
+            setCell(row, 2, item == null ? "" : item.getString("idCard", ""), bodyStyle);
+            setCell(row, 3, item == null ? "" : item.getString("mobile", ""), bodyStyle);
+            setCell(row, 4, item == null ? "" : item.getString("unionName", ""), bodyStyle);
+            setCell(row, 5, item == null ? "" : item.getString("lineName", ""), bodyStyle);
+            setCell(row, 6, item == null ? "" : item.getString("travelPeriod", ""), bodyStyle);
+            setCell(row, 7, item == null ? "" : item.getString("totalDays", ""), bodyStyle);
+            setCell(row, 8, item == null ? "" : item.getString("estimatedCostText", ""), bodyStyle);
+            setCell(row, 9, "", bodyStyle);
+        }
+        return workbook;
+    }
+
+    private CellStyle createStyle(Workbook workbook, String fontName, short fontSize, boolean bold, HorizontalAlignment alignment, boolean wrap, boolean border) {
+        Font font = workbook.createFont();
+        font.setFontName(fontName);
+        font.setFontHeightInPoints(fontSize);
+        font.setBold(bold);
+
+        CellStyle style = workbook.createCellStyle();
+        style.setFont(font);
+        style.setAlignment(alignment);
+        style.setVerticalAlignment(VerticalAlignment.CENTER);
+        style.setWrapText(wrap);
+        if (border) {
+            style.setBorderLeft(BorderStyle.THIN);
+            style.setBorderTop(BorderStyle.THIN);
+            style.setBorderRight(BorderStyle.THIN);
+            style.setBorderBottom(BorderStyle.THIN);
+        }
+        return style;
+    }
+
+    private void setCell(Row row, int col, String value, CellStyle style) {
+        Cell cell = row.createCell(col);
+        cell.setCellValue(StrUtil.blankToDefault(value, ""));
+        cell.setCellStyle(style);
+    }
+
+    private void fillMergedCells(Row row, int startCol, int endCol, CellStyle style) {
+        for (int i = startCol; i <= endCol; i++) {
+            setCell(row, i, "", style);
+        }
+    }
+
+    private Integer calcDays(String start, String end) {
+        if (StrUtil.isBlank(start) || StrUtil.isBlank(end)) {
+            return null;
+        }
+        try {
+            LocalDate startDate = LocalDate.parse(start.substring(0, 10));
+            LocalDate endDate = LocalDate.parse(end.substring(0, 10));
+            return Math.toIntExact(ChronoUnit.DAYS.between(startDate, endDate) + 1);
+        } catch (Exception e) {
+            return null;
+        }
+    }
+
+    private String formatAmount(Object value) {
+        if (value == null) {
+            return "";
+        }
+        try {
+            BigDecimal amount = new BigDecimal(String.valueOf(value));
+            return amount.stripTrailingZeros().toPlainString();
+        } catch (Exception e) {
+            return String.valueOf(value);
+        }
+    }
+
+    private Cnd buildQueryCnd(String currentUnionId, Integer startYear, Integer endYear, String keyword, String unionId, String lineId, String travelPeriod, String lineType, String scopeType, Boolean overCostOnly) {
+        Cnd cnd = Cnd.NEW();
+        cnd.and("t.delFlag", "=", false);
+        cnd.andEX("t.`year`", ">=", startYear);
+        cnd.andEX("t.`year`", "<=", endYear == null ? LocalDate.now().getYear() : endYear);
+        cnd.andEX("t.unionId", "=", unionId);
+        cnd.andEX("t.lineType", "=", lineType);
+        if (Boolean.TRUE.equals(overCostOnly)) {
+            cnd.and("t.overCostReimbursed", "=", true);
+        }
+        appendLineFilter(cnd, lineId);
+        appendTravelPeriodFilter(cnd, travelPeriod);
+        appendScopeFilter(cnd, currentUnionId, scopeType);
+        appendKeywordFilter(cnd, keyword);
+        return cnd;
+    }
+
+    private Cnd buildSummaryCnd(String currentUnionId, Integer startYear, Integer endYear, String unionId, String lineId, String travelPeriod, String lineType, String scopeType) {
+        Cnd cnd = Cnd.NEW();
+        cnd.and("t.delFlag", "=", false);
+        cnd.andEX("t.`year`", ">=", startYear);
+        cnd.andEX("t.`year`", "<=", endYear == null ? LocalDate.now().getYear() : endYear);
+        cnd.andEX("t.unionId", "=", unionId);
+        cnd.andEX("t.lineType", "=", lineType);
+        appendLineFilter(cnd, lineId);
+        appendTravelPeriodFilter(cnd, travelPeriod);
+        appendScopeFilter(cnd, currentUnionId, scopeType);
+        return cnd;
+    }
+
+    private void appendKeywordFilter(Cnd cnd, String keyword) {
+        if (StrUtil.isNotBlank(keyword)) {
+            SqlExpressionGroup group = new SqlExpressionGroup();
+            group.orLike("t.userName", keyword.trim());
+            group.orLike("t.jobNo", keyword.trim());
+            cnd.and(group);
+        }
+    }
+
+    private void applyUnionLedgerScope(Cnd cnd, String currentUnionId) {
+        SqlExpressionGroup group = new SqlExpressionGroup();
+        group.or("t.unionId", "=", currentUnionId);
+        group.or("m.unionId", "=", currentUnionId);
+        cnd.and(group);
+    }
+
+    private void appendScopeFilter(Cnd cnd, String currentUnionId, String scopeType) {
+        if ("ownUnionJoined".equals(scopeType)) {
+            cnd.and("t.unionId", "=", currentUnionId);
+            return;
+        }
+        if ("organizedLineJoined".equals(scopeType)) {
+            cnd.and("m.unionId", "=", currentUnionId);
+            return;
+        }
+        applyUnionLedgerScope(cnd, currentUnionId);
+    }
+
+    private String buildYearCondition(Integer startYear, Integer endYear) {
+        StringBuilder builder = new StringBuilder();
+        if (startYear != null) {
+            builder.append(" AND t.`year` >= ").append(startYear);
+        }
+        if (endYear != null) {
+            builder.append(" AND t.`year` <= ").append(endYear);
+        }
+        return builder.toString();
+    }
+
+    private TourLedger fetchScopedLedger(String id) {
+        if (StrUtil.isBlank(id) || StrUtil.isBlank(currentUnionId())) {
+            return null;
+        }
+        Sql sql = Sqls.create("""
+                SELECT COUNT(1)
+                FROM tour_ledger t
+                LEFT JOIN tour_matter m ON m.id = t.matterId AND m.delFlag = 0
+                WHERE t.delFlag = 0
+                  AND t.id = @id
+                  AND (t.unionId = @unionId OR m.unionId = @unionId)
+                """);
+        sql.setParam("id", id);
+        sql.setParam("unionId", currentUnionId());
+        sql.setCallback(Sqls.callback.integer());
+        tourLedgerService.dao().execute(sql);
+        return sql.getInt() > 0 ? tourLedgerService.fetch(id) : null;
+    }
+
+    private String getTravelPeriod(TourLedger ledger) {
+        if (ledger == null || ledger.getYear() == null || StrUtil.isBlank(ledger.getLineId())) {
+            return "";
+        }
+        if (StrUtil.isNotBlank(ledger.getMatterId())) {
+            Sql exactSql = Sqls.create("""
+                    SELECT CASE
+                        WHEN IFNULL(travelStartTime, '') <> '' AND IFNULL(travelEndTime, '') <> ''
+                        THEN CONCAT(travelStartTime, ' 至 ', travelEndTime)
+                        ELSE ''
+                    END AS travelPeriod
+                    FROM tour_matter
+                    WHERE delFlag = 0
+                      AND id = @matterId
+                    """);
+            exactSql.setParam("matterId", ledger.getMatterId());
+            exactSql.setCallback(Sqls.callback.str());
+            tourLedgerService.dao().execute(exactSql);
+            return exactSql.getString();
+        }
+        Sql sql = Sqls.create("""
+                SELECT GROUP_CONCAT(
+                    DISTINCT CASE
+                        WHEN IFNULL(travelStartTime, '') <> '' AND IFNULL(travelEndTime, '') <> ''
+                        THEN CONCAT(travelStartTime, ' 至 ', travelEndTime)
+                        ELSE NULL
+                    END
+                    ORDER BY travelStartTime ASC
+                    SEPARATOR '；'
+                ) AS travelPeriod
+                FROM tour_matter
+                WHERE delFlag = 0
+                  AND `year` = @year
+                  AND lineId = @lineId
+                """);
+        sql.setParam("year", ledger.getYear());
+        sql.setParam("lineId", ledger.getLineId());
+        sql.setCallback(Sqls.callback.str());
+        tourLedgerService.dao().execute(sql);
+        return sql.getString();
+    }
+
+    private boolean isDirectFamilyUnitLine(TourLedger ledger) {
+        if (ledger == null || StrUtil.isBlank(ledger.getLineId())) {
+            return false;
+        }
+        Sql sql = Sqls.create("""
+                SELECT IFNULL(directFamilyUnitLine, 0)
+                FROM tour_line
+                WHERE delFlag = 0
+                  AND id = @lineId
+                """);
+        sql.setParam("lineId", ledger.getLineId());
+        sql.setCallback(Sqls.callback.integer());
+        tourLedgerService.dao().execute(sql);
+        return sql.getInt() > 0;
+    }
+
+    private boolean isFillBedInfo(TourLedger ledger) {
+        if (ledger == null || StrUtil.isBlank(ledger.getMatterId())) {
+            return true;
+        }
+        Sql sql = Sqls.create("""
+                SELECT IFNULL(MAX(s.fillBedInfo), 1)
+                FROM tour_ledger t
+                LEFT JOIN tour_matter m ON m.id = t.matterId AND m.delFlag = 0
+                LEFT JOIN tour_setting s ON s.id = m.settingId AND s.delFlag = 0
+                WHERE t.id = @ledgerId
+                """);
+        sql.setParam("ledgerId", ledger.getId());
+        sql.setCallback(Sqls.callback.integer());
+        tourLedgerService.dao().execute(sql);
+        return sql.getInt() > 0;
+    }
+
+    private void appendTravelPeriodFilter(Cnd cnd, String travelPeriod) {
+        if (StrUtil.isBlank(travelPeriod)) {
+            return;
+        }
+        cnd.and("CONCAT(m.travelStartTime, ' 至 ', m.travelEndTime)", "=", travelPeriod);
+    }
+
+    private void appendLineFilter(Cnd cnd, String lineId) {
+        if (StrUtil.isBlank(lineId)) {
+            return;
+        }
+        LineFilter lineFilter = parseLineFilter(lineId);
+        if (lineFilter.getLineId().startsWith("legacy:")) {
+            SqlExpressionGroup legacyGroup = new SqlExpressionGroup();
+            legacyGroup.or("t.lineId", "IS", null);
+            legacyGroup.or("t.lineId", "=", "");
+            cnd.and(legacyGroup);
+            cnd.and("t.lineName", "=", lineFilter.getLineId().substring("legacy:".length()));
+        } else {
+            cnd.and("t.lineId", "=", lineFilter.getLineId());
+        }
+        appendMatterUnionFilter(cnd, lineFilter.getUnionId());
+    }
+
+    private LineFilter parseLineFilter(String value) {
+        int delimiterIndex = value.indexOf("|");
+        if (delimiterIndex < 0) {
+            return new LineFilter(value, null);
+        }
+        return new LineFilter(value.substring(0, delimiterIndex), value.substring(delimiterIndex + 1));
+    }
+
+    private void appendMatterUnionFilter(Cnd cnd, String unionId) {
+        if (unionId == null) {
+            return;
+        }
+        if (StrUtil.isBlank(unionId)) {
+            SqlExpressionGroup group = new SqlExpressionGroup();
+            group.or("m.unionId", "IS", null);
+            group.or("m.unionId", "=", "");
+            cnd.and(group);
+            return;
+        }
+        cnd.and("m.unionId", "=", unionId);
+    }
+
+    private String getCurrentLineName(TourLedger ledger) {
+        if (ledger == null) {
+            return "";
+        }
+        Sql sql = Sqls.create("""
+                SELECT CASE
+                    WHEN m.id IS NULL THEN COALESCE(NULLIF(l.lineName, ''), t.lineName)
+                    ELSE CONCAT(
+                        COALESCE(NULLIF(l.lineName, ''), t.lineName),
+                        '（',
+                        CASE
+                            WHEN IFNULL(m.unionId, '') = '' THEN '校工会'
+                            ELSE IFNULL(mu.name, '')
+                        END,
+                        '）'
+                    )
+                END AS lineName
+                FROM tour_ledger t
+                LEFT JOIN tour_matter m ON m.id = t.matterId AND m.delFlag = 0
+                LEFT JOIN tour_line l ON l.id = t.lineId AND l.delFlag = 0
+                LEFT JOIN sys_union mu ON mu.id = m.unionId
+                WHERE t.id = @ledgerId
+                """);
+        sql.setParam("ledgerId", ledger.getId());
+        sql.setCallback(Sqls.callback.str());
+        tourLedgerService.dao().execute(sql);
+        return StrUtil.blankToDefault(sql.getString(), ledger.getLineName());
+    }
+
+    private static class LineFilter {
+        private final String lineId;
+        private final String unionId;
+
+        private LineFilter(String lineId, String unionId) {
+            this.lineId = lineId;
+            this.unionId = unionId;
+        }
+
+        private String getLineId() {
+            return lineId;
+        }
+
+        private String getUnionId() {
+            return unionId;
+        }
+    }
+
+    private String currentUnionId() {
+        return SecurityUtil.getUnionId();
+    }
+
+    private String currentUnionName() {
+        String unionId = currentUnionId();
+        if (StrUtil.isBlank(unionId)) {
+            return "";
+        }
+        Sys_union union = tourLedgerService.dao().fetch(Sys_union.class, unionId);
+        return union == null ? "" : StrUtil.blankToDefault(union.getName(), "");
+    }
+
+    private String getOrderColumn(String orderName) {
+        if ("year".equals(orderName)) {
+            return "t.`year`";
+        }
+        if ("jobNo".equals(orderName)) {
+            return "t.jobNo";
+        }
+        if ("userName".equals(orderName)) {
+            return "t.userName";
+        }
+        if ("lineName".equals(orderName)) {
+            return """
+                    CASE
+                        WHEN m.id IS NULL THEN COALESCE(NULLIF(l.lineName, ''), t.lineName)
+                        ELSE CONCAT(
+                            COALESCE(NULLIF(l.lineName, ''), t.lineName),
+                            '（',
+                            CASE
+                                WHEN IFNULL(m.unionId, '') = '' THEN '校工会'
+                                ELSE IFNULL(mu.name, '')
+                            END,
+                            '）'
+                        )
+                    END
+                    """;
+        }
+        if ("travelPeriod".equals(orderName)) {
+            return "COALESCE(m.travelStartTime, tp.travelPeriod)";
+        }
+        if ("lineType".equals(orderName)) {
+            return "t.lineType";
+        }
+        if ("signupTime".equals(orderName)) {
+            return "t.signupTime";
+        }
+        if ("familyCount".equals(orderName)) {
+            return "familyCount";
+        }
+        if ("joined".equals(orderName)) {
+            return "t.joined";
+        }
+        return "t.`year`";
+    }
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/mode/TourLedgerImportExcelMode.java

@@ -0,0 +1,34 @@
+package com.budwk.app.zhgh.dayofficework.tour.mode;
+
+import cn.afterturn.easypoi.excel.annotation.Excel;
+import com.budwk.app.base.model.ExcelImportError;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+import java.util.Date;
+
+@EqualsAndHashCode(callSuper = true)
+@Data
+public class TourLedgerImportExcelMode extends ExcelImportError {
+
+    @Excel(name = "年度")
+    private Integer year;
+
+    @Excel(name = "工号")
+    private String jobNo;
+
+    @Excel(name = "姓名")
+    private String userName;
+
+    @Excel(name = "报名时间", format = "yyyy-MM-dd HH:mm:ss")
+    private Date signupTime;
+
+    @Excel(name = "线路名称")
+    private String lineName;
+
+    @Excel(name = "线路类型")
+    private String lineType;
+
+    @Excel(name = "是否参加")
+    private String joined;
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/models/TourLeaveApply.java

@@ -0,0 +1,103 @@
+package com.budwk.app.zhgh.dayofficework.tour.models;
+
+import com.budwk.app.base.model.BaseModel;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.nutz.dao.entity.annotation.ColDefine;
+import org.nutz.dao.entity.annotation.ColType;
+import org.nutz.dao.entity.annotation.Column;
+import org.nutz.dao.entity.annotation.Comment;
+import org.nutz.dao.entity.annotation.Name;
+import org.nutz.dao.entity.annotation.Table;
+import org.nutz.dao.entity.annotation.TableMeta;
+import org.nutz.dao.interceptor.annotation.PrevInsert;
+
+import java.io.Serializable;
+
+/**
+ * 疗休养退出申请。
+ * 仅作为不能参加人员的维护台账，不直接关联报名、疗休养台账、人员分配等业务流程。
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@Table("tour_leave_apply")
+@TableMeta("{'mysql-charset':'utf8mb4'}")
+@Comment("疗休养退出申请")
+public class TourLeaveApply extends BaseModel implements Serializable {
+
+    public static final String STATUS_PENDING = "PENDING";
+    public static final String STATUS_APPROVED = "APPROVED";
+    public static final String STATUS_REJECTED = "REJECTED";
+
+    @Column
+    @Name
+    @Comment("ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    @PrevInsert(uu32 = true)
+    private String id;
+
+    @Column
+    @Comment("疗休养事项ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String matterId;
+
+    @Column
+    @Comment("线路ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String lineId;
+
+    @Column
+    @Comment("工号")
+    @ColDefine(type = ColType.VARCHAR, width = 50)
+    private String jobNo;
+
+    @Column
+    @Comment("姓名")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String userName;
+
+    @Column
+    @Comment("用户ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String userId;
+
+    @Column
+    @Comment("所属工会ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String unionId;
+
+    @Column
+    @Comment("所属工会")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String unionName;
+
+    @Column
+    @Comment("不能参加原因")
+    @ColDefine(type = ColType.TEXT)
+    private String reason;
+
+    @Column
+    @Comment("状态")
+    @ColDefine(type = ColType.VARCHAR, width = 30)
+    private String status;
+
+    @Column
+    @Comment("审核人ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String auditBy;
+
+    @Column
+    @Comment("审核人姓名")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String auditName;
+
+    @Column
+    @Comment("审核时间")
+    @ColDefine(type = ColType.VARCHAR, width = 30)
+    private String auditTime;
+
+    @Column
+    @Comment("审核备注")
+    @ColDefine(type = ColType.TEXT)
+    private String auditRemark;
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/models/TourLedger.java

@@ -0,0 +1,157 @@
+package com.budwk.app.zhgh.dayofficework.tour.models;
+
+import com.budwk.app.base.model.BaseModel;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.nutz.dao.entity.annotation.*;
+import org.nutz.dao.interceptor.annotation.PrevInsert;
+
+import java.io.Serializable;
+
+/**
+ * 疗休养教职工报名台账。
+ * 后续报名模块完成后，将已报名或已参加的教职工写入本表，台账页负责跨年度查询和详情查看。
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@Table("tour_ledger")
+@TableMeta("{'mysql-charset':'utf8mb4'}")
+@Comment("普惠疗休养台账")
+public class TourLedger extends BaseModel implements Serializable {
+
+    @Column
+    @Name
+    @Comment("ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    @PrevInsert(uu32 = true)
+    private String id;
+
+    @Column
+    @Comment("年度")
+    @ColDefine(type = ColType.INT, width = 4)
+    private Integer year;
+
+    @Column
+    @Comment("工号")
+    @ColDefine(type = ColType.VARCHAR, width = 50)
+    private String jobNo;
+
+    @Column
+    @Comment("姓名")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String userName;
+
+    @Column
+    @Comment("性别")
+    @ColDefine(type = ColType.VARCHAR, width = 20)
+    private String gender;
+
+    @Column
+    @Comment("身份证号")
+    @ColDefine(type = ColType.VARCHAR, width = 30)
+    private String idCard;
+
+    @Column
+    @Comment("所在单位ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String unitId;
+
+    @Column
+    @Comment("所在单位")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String unitName;
+
+    @Column
+    @Comment("所在工会ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String unionId;
+
+    @Column
+    @Comment("所在工会")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String unionName;
+
+    @Column
+    @Comment("报名时间")
+    @ColDefine(type = ColType.VARCHAR, width = 30)
+    private String signupTime;
+
+    @Column
+    @Comment("报名事项ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String matterId;
+
+    @Column
+    @Comment("报名线路ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String lineId;
+
+    @Column
+    @Comment("报名线路")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String lineName;
+
+    @Column
+    @Comment("线路类型")
+    @ColDefine(type = ColType.VARCHAR, width = 50)
+    private String lineType;
+
+    @Column
+    @Comment("报名酒店")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String hotelName;
+
+    @Column
+    @Comment("旅行社ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String travelAgencyId;
+
+    @Column
+    @Comment("旅行社")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String travelAgencyName;
+
+    @Column
+    @Comment("乘车地点")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String boardingPlace;
+
+    @Column
+    @Comment("是否携带家属")
+    @ColDefine(type = ColType.BOOLEAN)
+    @Default("0")
+    private Boolean hasFamily;
+
+    @Column
+    @Comment("意向拼床人")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String intendedRoommate;
+
+    @Column
+    @Comment("床型")
+    @ColDefine(type = ColType.VARCHAR, width = 50)
+    private String bedType;
+
+    @Column
+    @Comment("床位信息")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String bedInfo;
+
+    @Column
+    @Comment("是否参加")
+    @ColDefine(type = ColType.BOOLEAN)
+    @Default("0")
+    private Boolean joined;
+
+    @Column
+    @Comment("是否报销")
+    @ColDefine(type = ColType.BOOLEAN)
+    @Default("0")
+    private Boolean reimbursed;
+
+    @Column
+    @Comment("报销超出费用")
+    @ColDefine(type = ColType.BOOLEAN)
+    @Default("0")
+    private Boolean overCostReimbursed;
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/models/TourLedgerDirectRelative.java

@@ -0,0 +1,73 @@
+package com.budwk.app.zhgh.dayofficework.tour.models;
+
+import com.budwk.app.base.model.BaseModel;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.nutz.dao.entity.annotation.*;
+import org.nutz.dao.interceptor.annotation.PrevInsert;
+
+import java.io.Serializable;
+
+/**
+ * 直系亲属线路报名信息。
+ * 与普通携带亲属信息分表存放，用于直系亲属线路的专属申请信息。
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@Table("tour_ledger_direct_relative")
+@TableMeta("{'mysql-charset':'utf8mb4'}")
+@Comment("普惠疗休养直系亲属线路报名信息")
+public class TourLedgerDirectRelative extends BaseModel implements Serializable {
+
+    @Column
+    @Name
+    @Comment("ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    @PrevInsert(uu32 = true)
+    private String id;
+
+    @Column
+    @Comment("台账ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String ledgerId;
+
+    @Column
+    @Comment("亲属姓名")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String relativeName;
+
+    @Column
+    @Comment("所在单位")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String unitName;
+
+    @Column
+    @Comment("亲属关系编码")
+    @ColDefine(type = ColType.VARCHAR, width = 50)
+    private String relationshipCode;
+
+    @Column
+    @Comment("亲属关系")
+    @ColDefine(type = ColType.VARCHAR, width = 50)
+    private String relationshipName;
+
+    @Column
+    @Comment("线路ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String lineId;
+
+    @Column
+    @Comment("线路名称")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String lineName;
+
+    @Column
+    @Comment("出行开始日期")
+    @ColDefine(type = ColType.VARCHAR, width = 20)
+    private String travelStartTime;
+
+    @Column
+    @Comment("出行结束日期")
+    @ColDefine(type = ColType.VARCHAR, width = 20)
+    private String travelEndTime;
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/models/TourLedgerFamily.java

@@ -0,0 +1,83 @@
+package com.budwk.app.zhgh.dayofficework.tour.models;
+
+import com.budwk.app.base.model.BaseModel;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.nutz.dao.entity.annotation.*;
+import org.nutz.dao.interceptor.annotation.PrevInsert;
+
+import java.io.Serializable;
+
+/**
+ * 疗休养台账家属信息。
+ * 与教职工台账通过 ledgerId 关联，用于查看教职工携带家属的历史记录。
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@Table("tour_ledger_family")
+@TableMeta("{'mysql-charset':'utf8mb4'}")
+@Comment("普惠疗休养台账家属信息")
+public class TourLedgerFamily extends BaseModel implements Serializable {
+
+    @Column
+    @Name
+    @Comment("ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    @PrevInsert(uu32 = true)
+    private String id;
+
+    @Column
+    @Comment("台账ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String ledgerId;
+
+    @Column
+    @Comment("教职工工号")
+    @ColDefine(type = ColType.VARCHAR, width = 50)
+    private String staffJobNo;
+
+    @Column
+    @Comment("教职工姓名")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String staffName;
+
+    @Column
+    @Comment("家属姓名")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String familyName;
+
+    @Column
+    @Comment("性别")
+    @ColDefine(type = ColType.VARCHAR, width = 20)
+    private String gender;
+
+    @Column
+    @Comment("身份证号码")
+    @ColDefine(type = ColType.VARCHAR, width = 30)
+    private String idCard;
+
+    @Column
+    @Comment("年龄")
+    @ColDefine(type = ColType.INT, width = 3)
+    private Integer age;
+
+    @Column
+    @Comment("床型")
+    @ColDefine(type = ColType.VARCHAR, width = 50)
+    private String bedType;
+
+    @Column
+    @Comment("床位")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String bedInfo;
+
+    @Column
+    @Comment("意向拼床人")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String intendedRoommate;
+
+    @Column
+    @Comment("关系")
+    @ColDefine(type = ColType.VARCHAR, width = 50)
+    private String relationship;
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/models/TourLine.java

@@ -0,0 +1,106 @@
+package com.budwk.app.zhgh.dayofficework.tour.models;
+
+import com.budwk.app.base.model.BaseModel;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.nutz.dao.entity.annotation.*;
+import org.nutz.dao.interceptor.annotation.PrevInsert;
+
+import java.io.Serializable;
+
+/**
+ * 疗休养线路管理。
+ * 当前阶段先维护线路基础信息，后续报名、台账等模块可通过线路ID继续关联。
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@Table("tour_line")
+@TableMeta("{'mysql-charset':'utf8mb4'}")
+@Comment("普惠疗休养线路")
+public class TourLine extends BaseModel implements Serializable {
+
+    @Column
+    @Name
+    @Comment("ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    @PrevInsert(uu32 = true)
+    private String id;
+
+    @Column
+    @Comment("创建年度")
+    @ColDefine(type = ColType.INT, width = 4)
+    private Integer year;
+
+    @Column
+    @Comment("线路编号")
+    @ColDefine(type = ColType.VARCHAR, width = 50)
+    private String lineCode;
+
+    @Column
+    @Comment("线路名称")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String lineName;
+
+    @Column
+    @Comment("旅行社ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String travelAgencyId;
+
+    @Column
+    @Comment("创建人ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String creatorUserId;
+
+    @Column
+    @Comment("创建人")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String creatorName;
+
+    @Column
+    @Comment("所在单位ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String unitId;
+
+    @Column
+    @Comment("所在单位")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String unitName;
+
+    @Column
+    @Comment("线路类型")
+    @ColDefine(type = ColType.VARCHAR, width = 50)
+    private String lineType;
+
+    @Column
+    @Comment("时间标段ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String lotId;
+
+    @Column
+    @Comment("线路内容")
+    @ColDefine(type = ColType.TEXT)
+    private String lineContent;
+
+    @Column
+    @Comment("移动端缩略图")
+    @ColDefine(type = ColType.VARCHAR, width = 500)
+    private String mobileThumb;
+
+    @Column
+    @Comment("是否对外开放")
+    @ColDefine(type = ColType.BOOLEAN)
+    @Default("1")
+    private Boolean openFlag;
+
+    @Column
+    @Comment("是否直系亲属线路")
+    @ColDefine(type = ColType.BOOLEAN)
+    @Default("0")
+    private Boolean directFamilyUnitLine;
+
+    @Column
+    @Comment("激活状态")
+    @ColDefine(type = ColType.BOOLEAN)
+    @Default("1")
+    private Boolean enabled;
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/models/TourMatter.java

@@ -0,0 +1,129 @@
+package com.budwk.app.zhgh.dayofficework.tour.models;
+
+import com.budwk.app.base.model.BaseModel;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.nutz.dao.entity.annotation.*;
+import org.nutz.dao.interceptor.annotation.PrevInsert;
+
+import java.io.Serializable;
+import java.math.BigDecimal;
+
+/**
+ * 疗休养事项。
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@Table("tour_matter")
+@TableMeta("{'mysql-charset':'utf8mb4'}")
+@Comment("普惠疗休养事项")
+public class TourMatter extends BaseModel implements Serializable {
+
+    @Column
+    @Name
+    @Comment("ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    @PrevInsert(uu32 = true)
+    private String id;
+
+    @Column
+    @Comment("年度")
+    @ColDefine(type = ColType.INT, width = 4)
+    private Integer year;
+
+    @Column
+    @Comment("事项名称")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String matterName;
+
+    @Column
+    @Comment("疗休养配置ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String settingId;
+
+    @Column
+    @Comment("创建人ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String creatorUserId;
+
+    @Column
+    @Comment("创建人")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String creatorName;
+
+    @Column
+    @Comment("所属工会ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String unionId;
+
+    @Column
+    @Comment("组织形式")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String organizationType;
+
+    @Column
+    @Comment("移动端缩略图")
+    @ColDefine(type = ColType.VARCHAR, width = 500)
+    private String mobileThumb;
+
+    @Column
+    @Comment("线路ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String lineId;
+
+    @Column
+    @Comment("默认乘车地点")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String defaultBoardingPlace;
+
+    @Column
+    @Comment("报名开始时间")
+    @ColDefine(type = ColType.VARCHAR, width = 20)
+    private String signupStartTime;
+
+    @Column
+    @Comment("报名结束时间")
+    @ColDefine(type = ColType.VARCHAR, width = 20)
+    private String signupEndTime;
+
+    @Column
+    @Comment("出行开始时间")
+    @ColDefine(type = ColType.VARCHAR, width = 20)
+    private String travelStartTime;
+
+    @Column
+    @Comment("出行结束时间")
+    @ColDefine(type = ColType.VARCHAR, width = 20)
+    private String travelEndTime;
+
+    @Column
+    @Comment("联系人")
+    @ColDefine(type = ColType.VARCHAR, width = 30)
+    private String contactName;
+
+    @Column
+    @Comment("联系方式")
+    @ColDefine(type = ColType.VARCHAR, width = 30)
+    private String contactPhone;
+
+    @Column
+    @Comment("最少成团人数")
+    @ColDefine(type = ColType.INT)
+    private Integer minGroupPeople;
+
+    @Column
+    @Comment("最多成团人数")
+    @ColDefine(type = ColType.INT)
+    private Integer maxGroupPeople;
+
+    @Column
+    @Comment("预计费用")
+    @ColDefine(customType = "decimal(10,2)")
+    private BigDecimal estimatedCost;
+
+    @Column
+    @Comment("事项状态")
+    @ColDefine(type = ColType.BOOLEAN)
+    @Default("1")
+    private Boolean enabled;
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/models/TourSetting.java

@@ -0,0 +1,156 @@
+package com.budwk.app.zhgh.dayofficework.tour.models;
+
+import com.budwk.app.base.model.BaseModel;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.nutz.dao.entity.annotation.*;
+import org.nutz.dao.interceptor.annotation.PrevInsert;
+
+import java.io.Serializable;
+import java.math.BigDecimal;
+import java.util.List;
+
+/**
+ * 疗休养基础配置。
+ * 这里先沉淀创建事项会复用的基础字段，后续线路、报名等阶段可以继续通过配置ID关联扩展。
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@Table("tour_setting")
+@TableMeta("{'mysql-charset':'utf8mb4'}")
+@Comment("普惠疗休养配置")
+public class TourSetting extends BaseModel implements Serializable {
+
+    @Column
+    @Name
+    @Comment("ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    @PrevInsert(uu32 = true)
+    private String id;
+
+    @Column
+    @Comment("年度")
+    @ColDefine(type = ColType.INT, width = 4)
+    private Integer year;
+
+    @Column
+    @Comment("疗休养配置名称")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String configName;
+
+    @Column
+    @Comment("疗休养类型")
+    @ColDefine(type = ColType.VARCHAR, width = 50)
+    private String tourType;
+
+    @Column
+    @Comment("乘车地点列表JSON")
+    @ColDefine(type = ColType.TEXT)
+    private String boardingPlace;
+
+    @Column
+    @Comment("出行人数指标")
+    @ColDefine(type = ColType.INT)
+    @Default("0")
+    private Integer travelPeopleQuota;
+
+    @Column
+    @Comment("可参加人员范围ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String activityGroupId;
+
+    @Column
+    @Comment("报名资格校验方式")
+    @ColDefine(type = ColType.VARCHAR, width = 30)
+    @Default("'ASSIGNED_USER'")
+    private String signupEligibilityMode;
+
+    @Column
+    @Comment("排序编号")
+    @ColDefine(type = ColType.INT)
+    private Integer sortNo;
+
+    @Column
+    @Comment("最少成团人数")
+    @ColDefine(type = ColType.INT)
+    private Integer minGroupPeople;
+
+    @Column
+    @Comment("最多成团人数")
+    @ColDefine(type = ColType.INT)
+    private Integer maxGroupPeople;
+
+    @Column
+    @Comment("省外几年去一次")
+    @ColDefine(type = ColType.INT)
+    private Integer outProvinceYears;
+
+    @Column
+    @Comment("省外人数占比")
+    @ColDefine(customType = "decimal(10,2)")
+    private BigDecimal outProvinceRatio;
+
+    @Column
+    @Comment("省外人数占比类型")
+    @ColDefine(type = ColType.VARCHAR, width = 50)
+    private String outProvinceRatioType;
+
+    @Column
+    @Comment("省外固定人数")
+    @ColDefine(type = ColType.INT)
+    private Integer outProvinceFixedPeople;
+
+    @Column
+    @Comment("周期开始年度")
+    @ColDefine(type = ColType.INT, width = 4)
+    private Integer cycleStartYear;
+
+    @Column
+    @Comment("周期结束年度")
+    @ColDefine(type = ColType.INT, width = 4)
+    private Integer cycleEndYear;
+
+    @Column
+    @Comment("周期内总费用")
+    @ColDefine(type = ColType.INT)
+    private Integer cycleTotalCost;
+
+    @Column
+    @Comment("周期允许次数")
+    @ColDefine(type = ColType.INT)
+    private Integer cycleAllowedTimes;
+
+    @Column
+    @Comment("是否允许携带家属")
+    @ColDefine(type = ColType.BOOLEAN)
+    @Default("0")
+    private Boolean allowFamily;
+
+    @Column
+    @Comment("是否填报床位信息")
+    @ColDefine(type = ColType.BOOLEAN)
+    @Default("1")
+    private Boolean fillBedInfo;
+
+    @Column
+    @Comment("是否启用")
+    @ColDefine(type = ColType.BOOLEAN)
+    @Default("1")
+    private Boolean enabled;
+
+    /**
+     * 标段管理沿用老疗休养配置的子表设计，后续线路、旅行社等模块可通过标段ID继续关联。
+     */
+    @Many(field = "settingId")
+    private List<TourSettingLot> lots;
+
+    /**
+     * 分工会名额分配，仅用于配置弹窗回显与提交，不作为 tour_setting 表字段保存。
+     */
+    private List<TourSettingUnionQuota> unionQuotas;
+
+    @Column
+    @Comment("服务须知")
+    @ColDefine(type = ColType.TEXT)
+    private String serviceNotice;
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/models/TourSettingLot.java

@@ -0,0 +1,53 @@
+package com.budwk.app.zhgh.dayofficework.tour.models;
+
+import com.budwk.app.base.model.BaseModel;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.nutz.dao.entity.annotation.*;
+import org.nutz.dao.interceptor.annotation.PrevInsert;
+
+import java.io.Serializable;
+
+/**
+ * 疗休养配置标段。
+ * 标段从基础配置中拆成子表，便于后续线路、目的地、报名等模块复用同一标段口径。
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@Table("tour_setting_lot")
+@TableMeta("{'mysql-charset':'utf8mb4'}")
+@Comment("普惠疗休养配置标段")
+public class TourSettingLot extends BaseModel implements Serializable {
+
+    @Column
+    @Name
+    @Comment("ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    @PrevInsert(uu32 = true)
+    private String id;
+
+    @Column
+    @Comment("所属配置ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String settingId;
+
+    @Column
+    @Comment("标段名称")
+    @ColDefine(type = ColType.VARCHAR, width = 50)
+    private String lotName;
+
+    @Column
+    @Comment("标段值")
+    @ColDefine(type = ColType.VARCHAR, width = 50)
+    private String lotValue;
+
+    @Column
+    @Comment("标段费用")
+    @ColDefine(type = ColType.INT)
+    private Integer activityCost;
+
+    @Column
+    @Comment("允许超出报销")
+    @ColDefine(type = ColType.BOOLEAN)
+    private Boolean allowOverReimbursement;
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/models/TourSettingUnionQuota.java

@@ -0,0 +1,66 @@
+package com.budwk.app.zhgh.dayofficework.tour.models;
+
+import com.budwk.app.base.model.BaseModel;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.nutz.dao.entity.annotation.ColDefine;
+import org.nutz.dao.entity.annotation.ColType;
+import org.nutz.dao.entity.annotation.Column;
+import org.nutz.dao.entity.annotation.Comment;
+import org.nutz.dao.entity.annotation.Default;
+import org.nutz.dao.entity.annotation.Name;
+import org.nutz.dao.entity.annotation.Table;
+import org.nutz.dao.entity.annotation.TableMeta;
+import org.nutz.dao.interceptor.annotation.PrevInsert;
+
+import java.io.Serializable;
+
+/**
+ * 疗休养配置下的分工会名额分配。
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@Table("tour_setting_union_quota")
+@TableMeta("{'mysql-charset':'utf8mb4'}")
+@Comment("疗休养配置分工会名额分配")
+public class TourSettingUnionQuota extends BaseModel implements Serializable {
+
+    @Column
+    @Name
+    @Comment("ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    @PrevInsert(uu32 = true)
+    private String id;
+
+    @Column
+    @Comment("所属疗休养配置ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String settingId;
+
+    @Column
+    @Comment("分工会ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String unionId;
+
+    @Column
+    @Comment("分工会名称")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String unionName;
+
+    @Column
+    @Comment("正式人员名额")
+    @ColDefine(type = ColType.INT)
+    @Default("0")
+    private Integer formalQuota;
+
+    @Column
+    @Comment("替补人员名额")
+    @ColDefine(type = ColType.INT)
+    @Default("0")
+    private Integer backupQuota;
+
+    /**
+     * 页面展示用实时会员数，不落库。
+     */
+    private Integer memberCount;
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/models/TourTravelAgency.java

@@ -0,0 +1,74 @@
+package com.budwk.app.zhgh.dayofficework.tour.models;
+
+import com.budwk.app.base.model.BaseModel;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.nutz.dao.entity.annotation.*;
+import org.nutz.dao.interceptor.annotation.PrevInsert;
+
+import java.io.Serializable;
+
+/**
+ * 旅行社管理。
+ * 先维护疗休养线路创建会复用的旅行社基础信息，后续线路模块可通过旅行社ID关联。
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@Table("tour_travel_agency")
+@TableMeta("{'mysql-charset':'utf8mb4'}")
+@Comment("普惠疗休养旅行社")
+public class TourTravelAgency extends BaseModel implements Serializable {
+
+    @Column
+    @Name
+    @Comment("ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    @PrevInsert(uu32 = true)
+    private String id;
+
+    @Column
+    @Comment("年度")
+    @ColDefine(type = ColType.INT, width = 4)
+    private Integer year;
+
+    @Column
+    @Comment("旅行社编号")
+    @ColDefine(type = ColType.VARCHAR, width = 50)
+    private String agencyCode;
+
+    @Column
+    @Comment("旅行社名称")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String agencyName;
+
+    @Column
+    @Comment("联系人")
+    @ColDefine(type = ColType.VARCHAR, width = 30)
+    private String contactName;
+
+    @Column
+    @Comment("联系人手机")
+    @ColDefine(type = ColType.VARCHAR, width = 30)
+    private String contactPhone;
+
+    @Column
+    @Comment("邮箱")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String email;
+
+    @Column
+    @Comment("备注")
+    @ColDefine(type = ColType.TEXT)
+    private String remark;
+
+    @Column
+    @Comment("移动端缩略图")
+    @ColDefine(type = ColType.VARCHAR, width = 500)
+    private String mobileThumb;
+
+    @Column
+    @Comment("激活状态")
+    @ColDefine(type = ColType.BOOLEAN)
+    @Default("1")
+    private Boolean enabled;
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/models/TourUserAssignment.java

@@ -0,0 +1,155 @@
+package com.budwk.app.zhgh.dayofficework.tour.models;
+
+import com.budwk.app.base.model.BaseModel;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.nutz.dao.entity.annotation.ColDefine;
+import org.nutz.dao.entity.annotation.ColType;
+import org.nutz.dao.entity.annotation.Column;
+import org.nutz.dao.entity.annotation.Comment;
+import org.nutz.dao.entity.annotation.Default;
+import org.nutz.dao.entity.annotation.Name;
+import org.nutz.dao.entity.annotation.Table;
+import org.nutz.dao.entity.annotation.TableMeta;
+import org.nutz.dao.interceptor.annotation.PrevInsert;
+
+import java.io.Serializable;
+
+/**
+ * 疗休养人员分配表。
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@Table("tour_user_assignment")
+@TableMeta("{'mysql-charset':'utf8mb4'}")
+@Comment("疗休养人员分配")
+public class TourUserAssignment extends BaseModel implements Serializable {
+
+    public static final String ASSIGN_SOURCE_SCHOOL_UNION = "SCHOOL_UNION";
+    public static final String ASSIGN_SOURCE_BRANCH_UNION = "BRANCH_UNION";
+    public static final String PERSON_TYPE_FORMAL = "FORMAL";
+    public static final String PERSON_TYPE_BACKUP = "BACKUP";
+
+    @Column
+    @Name
+    @Comment("ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    @PrevInsert(uu32 = true)
+    private String id;
+
+    @Column
+    @Comment("疗休养配置ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String settingId;
+
+    @Column
+    @Comment("疗休养事项ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String matterId;
+
+    @Column
+    @Comment("疗休养事项名称")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String matterName;
+
+    @Column
+    @Comment("旅行社ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String travelAgencyId;
+
+    @Column
+    @Comment("旅行社名称")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String travelAgencyName;
+
+    @Column
+    @Comment("线路ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String lineId;
+
+    @Column
+    @Comment("线路名称")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String lineName;
+
+    @Column
+    @Comment("乘车地点")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String boardingPlace;
+
+    @Column
+    @Comment("人员ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String userId;
+
+    @Column
+    @Comment("工号")
+    @ColDefine(type = ColType.VARCHAR, width = 50)
+    private String loginName;
+
+    @Column
+    @Comment("姓名")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String userName;
+
+    @Column
+    @Comment("性别")
+    @ColDefine(type = ColType.VARCHAR, width = 20)
+    private String gender;
+
+    @Column
+    @Comment("手机号")
+    @ColDefine(type = ColType.VARCHAR, width = 30)
+    private String mobile;
+
+    @Column
+    @Comment("所在单位ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String unitId;
+
+    @Column
+    @Comment("所在单位")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String unitName;
+
+    @Column
+    @Comment("所在分工会ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String unionId;
+
+    @Column
+    @Comment("所在分工会")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String unionName;
+
+    @Column
+    @Comment("分配来源")
+    @ColDefine(type = ColType.VARCHAR, width = 30)
+    private String assignSource;
+
+    @Column
+    @Comment("人员类型")
+    @ColDefine(type = ColType.VARCHAR, width = 30)
+    private String personType;
+
+    @Column
+    @Comment("是否已退出")
+    @ColDefine(type = ColType.BOOLEAN)
+    @Default("0")
+    private Boolean cancelled;
+
+    @Column
+    @Comment("分配人ID")
+    @ColDefine(type = ColType.VARCHAR, width = 32)
+    private String assignedBy;
+
+    @Column
+    @Comment("分配人姓名")
+    @ColDefine(type = ColType.VARCHAR, width = 100)
+    private String assignedName;
+
+    @Column
+    @Comment("分配时间")
+    @ColDefine(type = ColType.VARCHAR, width = 30)
+    private String assignedAt;
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/service/TourLeaveApplyService.java

@@ -0,0 +1,31 @@
+package com.budwk.app.zhgh.dayofficework.tour.service;
+
+import com.budwk.app.base.page.Pagination;
+import com.budwk.app.base.param.PageForm;
+import com.budwk.app.base.service.BaseService;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourLeaveApply;
+import org.nutz.lang.util.NutMap;
+
+public interface TourLeaveApplyService extends BaseService<TourLeaveApply> {
+
+    /**
+     * 分页查询人员分配表中的退出/取消管理数据，关键词同时匹配工号和姓名。
+     * 数据权限：系统管理员、校工会主席看全部；分工会主席看本分工会；普通用户看本人。
+     */
+    Pagination<NutMap> pageData(PageForm pageForm, String keyword, String unionName, String status);
+
+    /**
+     * 查询当前登录人在退出取消管理页的按钮权限。
+     */
+    NutMap permissionInfo();
+
+    /**
+     * 取消指定人员分配记录，同时删除对应报名台账并标记已退出。
+     */
+    void cancelAssignment(String id);
+
+    /**
+     * 恢复指定人员分配记录的退出状态，不恢复已删除台账。
+     */
+    void restoreAssignment(String id);
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/service/TourLedgerDirectRelativeService.java

@@ -0,0 +1,7 @@
+package com.budwk.app.zhgh.dayofficework.tour.service;
+
+import com.budwk.app.base.service.BaseService;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourLedgerDirectRelative;
+
+public interface TourLedgerDirectRelativeService extends BaseService<TourLedgerDirectRelative> {
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/service/TourLedgerFamilyService.java

@@ -0,0 +1,7 @@
+package com.budwk.app.zhgh.dayofficework.tour.service;
+
+import com.budwk.app.base.service.BaseService;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourLedgerFamily;
+
+public interface TourLedgerFamilyService extends BaseService<TourLedgerFamily> {
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/service/TourLedgerService.java

@@ -0,0 +1,7 @@
+package com.budwk.app.zhgh.dayofficework.tour.service;
+
+import com.budwk.app.base.service.BaseService;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourLedger;
+
+public interface TourLedgerService extends BaseService<TourLedger> {
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/service/TourLineService.java

@@ -0,0 +1,7 @@
+package com.budwk.app.zhgh.dayofficework.tour.service;
+
+import com.budwk.app.base.service.BaseService;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourLine;
+
+public interface TourLineService extends BaseService<TourLine> {
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/service/TourMatterService.java

@@ -0,0 +1,7 @@
+package com.budwk.app.zhgh.dayofficework.tour.service;
+
+import com.budwk.app.base.service.BaseService;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourMatter;
+
+public interface TourMatterService extends BaseService<TourMatter> {
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/service/TourSettingService.java

@@ -0,0 +1,42 @@
+package com.budwk.app.zhgh.dayofficework.tour.service;
+
+import com.budwk.app.base.service.BaseService;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourSetting;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourSettingUnionQuota;
+
+import java.util.List;
+
+public interface TourSettingService extends BaseService<TourSetting> {
+
+    /**
+     * 查询所有分工会在指定疗休养配置下的名额，实时补充当前工会会员数供页面分配时参考。
+     *
+     * @param settingId 疗休养配置ID，新增时可为空
+     * @return 按分工会编码排序后的名额列表
+     */
+    List<TourSettingUnionQuota> listUnionQuotaRows(String settingId);
+
+    /**
+     * 保存指定疗休养配置下的分工会名额，前端传入的是 JSON 数组字符串。
+     *
+     * @param settingId    疗休养配置ID
+     * @param unionQuotas  分工会名额 JSON
+     */
+    void saveUnionQuotas(String settingId, String unionQuotas);
+
+    /**
+     * 校验分工会正式人员名额合计是否超过分工会总名额。
+     *
+     * @param unionQuotas      分工会名额 JSON
+     * @param branchTotalQuota 分工会总名额
+     * @return 通过返回空字符串；不通过返回业务提示
+     */
+    String checkBranchFormalQuotaLimit(String unionQuotas, int branchTotalQuota);
+
+    /**
+     * 清理指定疗休养配置下的分工会名额。
+     *
+     * @param settingId 疗休养配置ID
+     */
+    void clearUnionQuotas(String settingId);
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/service/TourTravelAgencyService.java

@@ -0,0 +1,7 @@
+package com.budwk.app.zhgh.dayofficework.tour.service;
+
+import com.budwk.app.base.service.BaseService;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourTravelAgency;
+
+public interface TourTravelAgencyService extends BaseService<TourTravelAgency> {
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/service/TourUserAssignmentService.java

@@ -0,0 +1,285 @@
+package com.budwk.app.zhgh.dayofficework.tour.service;
+
+import com.budwk.app.base.page.Pagination;
+import com.budwk.app.base.param.PageForm;
+import com.budwk.app.base.service.BaseService;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourUserAssignment;
+import org.nutz.lang.util.NutMap;
+
+import java.util.List;
+
+public interface TourUserAssignmentService extends BaseService<TourUserAssignment> {
+
+    /**
+     * 分页查询校工会人员分配记录，列表只读取人员分配表，不读取报名台账。
+     *
+     * @param pageForm   分页、排序参数
+     * @param year       疗休养年度
+     * @param settingId  疗休养配置ID
+     * @param matterId   疗休养事项ID
+     * @param unionId    所属分工会ID
+     * @param personType 人员类型：FORMAL 正式人员，BACKUP 替补人员
+     * @param keyword    姓名或工号关键字
+     * @return 校工会分配记录分页数据
+     */
+    Pagination<NutMap> schoolAssignmentPage(PageForm pageForm, Integer year, String settingId, String matterId,
+                                            String unionId, String personType, String keyword);
+
+    /**
+     * 分页查询校工会可分配候选人，候选人来自疗休养配置的可参加人员范围，并排除同一配置下已分配人员。
+     *
+     * @param pageForm  分页、排序参数
+     * @param settingId 疗休养配置ID
+     * @param unionId   所属分工会ID
+     * @param keyword   姓名或工号关键字
+     * @return 可分配候选人分页数据
+     */
+    Pagination<NutMap> schoolCandidatePage(PageForm pageForm, String settingId, String unionId, String keyword);
+
+    /**
+     * 分页查询当前登录人所在分工会的人员分配记录，列表只读取人员分配表，不读取报名台账。
+     *
+     * @param pageForm   分页、排序参数
+     * @param year       疗休养年度
+     * @param settingId  疗休养配置ID
+     * @param matterId   疗休养事项ID
+     * @param personType 人员类型：FORMAL 正式人员，BACKUP 替补人员
+     * @param keyword    姓名或工号关键字
+     * @return 分工会分配记录分页数据
+     */
+    Pagination<NutMap> branchAssignmentPage(PageForm pageForm, Integer year, String settingId, String matterId,
+                                            String personType, String keyword);
+
+    /**
+     * 分页查询当前登录人所在分工会可分配候选人，候选人来自疗休养配置的可参加人员范围。
+     *
+     * @param pageForm  分页、排序参数
+     * @param settingId 疗休养配置ID
+     * @param keyword   姓名或工号关键字
+     * @return 当前分工会可分配候选人分页数据
+     */
+    Pagination<NutMap> branchCandidatePage(PageForm pageForm, String settingId, String keyword);
+
+    /**
+     * 查询启用的疗休养配置选项，供人员分配列表筛选和分配弹窗复用。
+     *
+     * @param year 疗休养年度
+     * @return 配置选项列表
+     */
+    List<NutMap> listEnabledSettingOptions(Integer year);
+
+    /**
+     * 查询指定配置下已配置线路的分配线路选项，用于人员分配时指定事项、线路和旅行社。
+     *
+     * @param settingId 疗休养配置ID
+     * @return 事项选项列表
+     */
+    List<NutMap> listMatterOptions(String settingId);
+
+    /**
+     * 查询分工会选项，供校工会分配候选人和列表筛选使用。
+     *
+     * @return 分工会选项列表
+     */
+    List<NutMap> listUnionOptions();
+
+    /**
+     * 保存校工会人员分配。保存前会重新按配置可参加人员范围过滤，防止写入范围外人员。
+     * 分配线路为可选；正式人员选择线路时视为代报名并同步写入疗休养台账，替补人员不能分配线路。
+     *
+     * @param settingId  疗休养配置ID
+     * @param matterId   疗休养事项ID，可为空
+     * @param personType 人员类型：FORMAL 正式人员，BACKUP 替补人员
+     * @param userIds    待分配人员ID列表
+     * @return 保存结果，包含实际分配数量、跳过数量和代报名台账写入数量
+     */
+    NutMap assignSchoolUsers(String settingId, String matterId, String personType, List<String> userIds);
+
+    /**
+     * 保存校工会人员分配，支持每个候选人员单独选择分配线路。
+     * assignItems 中每项包含 userId、matterId；matterId 为空时只保存人员分配，不写台账。
+     *
+     * @param settingId    疗休养配置ID
+     * @param assignItems  人员和分配线路明细
+     * @return 保存结果，包含实际分配数量、跳过数量和代报名台账写入数量
+     */
+    NutMap assignSchoolUsers(String settingId, List<NutMap> assignItems);
+
+    /**
+     * 给校工会已分配的正式人员补选分配线路，并按代报名写入疗休养台账。
+     * 只处理 SCHOOL_UNION 来源且尚未选择线路的分配记录，避免覆盖既有台账。
+     *
+     * @param id       人员分配记录ID
+     * @param matterId 疗休养事项ID
+     * @return 处理结果，包含台账写入数量
+     */
+    NutMap selectSchoolAssignmentMatter(String id, String matterId);
+
+    /**
+     * 保存分工会人员分配。保存前会重新按配置可参加人员范围和当前登录人所在分工会过滤，并校验正式/替补名额。
+     * 疗休养事项为可选；正式人员选择事项时视为代报名并同步写入疗休养台账，替补人员不能分配事项。
+     *
+     * @param settingId  疗休养配置ID
+     * @param matterId   疗休养事项ID，可为空
+     * @param personType 人员类型：FORMAL 正式人员，BACKUP 替补人员
+     * @param userIds    待分配人员ID列表
+     * @return 保存结果，包含实际分配数量、跳过数量、代报名台账写入数量和剩余名额
+     */
+    NutMap assignBranchUsers(String settingId, String matterId, String personType, List<String> userIds);
+
+    /**
+     * 切换当前分工会人员分配记录的正式/替补状态。
+     * 切换时会校验当前登录人所在分工会、分配来源和目标类型剩余名额；已分配事项的正式人员不能切换为替补。
+     *
+     * @param id         人员分配记录ID
+     * @param personType 目标人员类型：FORMAL 正式人员，BACKUP 替补人员
+     * @return 切换后的人员类型和最新名额信息
+     */
+    NutMap switchCurrentBranchPersonType(String id, String personType);
+
+    /**
+     * 用户报名写入台账后，回填该用户在同一疗休养配置下已存在的人员分配记录。
+     * 仅更新事项、线路、旅行社快照字段，不新增记录，不修改 assignSource 和人员类型。
+     *
+     * @param settingId 疗休养配置ID
+     * @param matterId  疗休养事项ID
+     * @param userId    报名用户ID
+     * @param boardingPlace 用户报名时最终选择的乘车地点
+     * @return 更新记录数
+     */
+    int backfillExistingAssignmentAfterSignup(String settingId, String matterId, String userId, String boardingPlace);
+
+    /**
+     * 用户取消报名删除台账后，清空该用户在同一疗休养配置下已存在人员分配记录的事项快照。
+     * 仅清空事项、线路、旅行社字段，不删除记录，不修改 assignSource 和人员类型。
+     *
+     * @param settingId 疗休养配置ID
+     * @param userId    报名用户ID
+     * @return 更新记录数
+     */
+    int clearExistingAssignmentMatterAfterCancel(String settingId, String userId);
+
+    /**
+     * 查询当前登录人所在分工会在指定疗休养配置下的名额使用情况。
+     *
+     * @param settingId 疗休养配置ID
+     * @return 正式/替补名额、已用名额和剩余名额
+     */
+    NutMap branchQuotaInfo(String settingId);
+
+    /**
+     * 查询校工会人员分配记录是否已存在对应报名台账，用于删除前二次确认。
+     *
+     * @param id 人员分配记录ID
+     * @return hasLedger 表示是否存在台账，ledgerCount 表示对应台账数量
+     */
+    NutMap schoolDeleteInfo(String id);
+
+    /**
+     * 查询当前分工会人员分配记录是否已存在对应报名台账，用于删除前二次确认。
+     *
+     * @param id 人员分配记录ID
+     * @return hasLedger 表示是否存在台账，ledgerCount 表示对应台账数量
+     */
+    NutMap branchDeleteInfo(String id);
+
+    /**
+     * 删除指定来源的人员分配记录，避免校工会页面误删分工会分配的数据。
+     *
+     * @param id           人员分配记录ID
+     * @param assignSource 分配来源
+     */
+    void deleteBySource(String id, String assignSource);
+
+    /**
+     * 删除指定来源的人员分配记录，可选择是否同步删除该分配记录对应的报名台账。
+     *
+     * @param id           人员分配记录ID
+     * @param assignSource 分配来源
+     * @param deleteLedger 是否同步删除 matterId + loginName 对应的台账及明细
+     */
+    void deleteBySource(String id, String assignSource, boolean deleteLedger);
+
+    /**
+     * 删除当前登录人所在分工会的人员分配记录，避免分工会页面删除其它分工会的数据。
+     *
+     * @param id 人员分配记录ID
+     */
+    void deleteCurrentBranchAssignment(String id);
+
+    /**
+     * 删除当前登录人所在分工会的人员分配记录，可选择是否同步删除该分配记录对应的报名台账。
+     *
+     * @param id           人员分配记录ID
+     * @param deleteLedger 是否同步删除 matterId + loginName 对应的台账及明细
+     */
+    void deleteCurrentBranchAssignment(String id, boolean deleteLedger);
+
+    /**
+     * 判断用户是否已存在于指定疗休养配置的人员分配表中。
+     *
+     * @param settingId 疗休养配置ID
+     * @param userId    用户ID
+     * @return 存在返回 true，不存在返回 false
+     */
+    boolean existsAssignedUser(String settingId, String userId);
+
+    /**
+     * 校验用户是否为指定疗休养配置下的正式分配人员。
+     * 用于报名资格方式为 ASSIGNED_USER 时，拦截未分配人员和替补人员。
+     * 已退出人员也会被拦截，避免取消后再次报名。
+     *
+     * @param settingId 疗休养配置ID
+     * @param userId    用户ID
+     * @return canApply 表示是否可报名，message 表示不可报名原因
+     */
+    NutMap checkFormalAssignedUser(String settingId, String userId);
+
+    /**
+     * 实时统计指定疗休养配置下校工会来源的正式分配人数。
+     * 已退出人员不再占用工会名额，统计时需要排除。
+     *
+     * @param settingId 疗休养配置ID
+     * @return 当前配置下校工会正式人员分配数量
+     */
+    int countSchoolFormalAssignedUsers(String settingId);
+
+    /**
+     * 将人员分配记录标记为已退出，并删除该记录对应事项下的报名台账。
+     * 取消前会校验路线出行开始时间，只有出行开始前指定天数之前允许取消。
+     *
+     * @param id 人员分配记录ID
+     */
+    void cancelAssignment(String id);
+
+    /**
+     * 将人员分配记录从已退出恢复为未退出。
+     * 只恢复人员分配表状态，不自动恢复已删除的报名台账。
+     *
+     * @param id 人员分配记录ID
+     */
+    void restoreCancelledAssignment(String id);
+
+    /**
+     * 按分配来源恢复已退出人员，避免校工会和分工会页面互相恢复对方数据。
+     *
+     * @param id           人员分配记录ID
+     * @param assignSource 分配来源
+     */
+    void restoreCancelledAssignmentBySource(String id, String assignSource);
+
+    /**
+     * 恢复当前登录人所在分工会的已退出人员分配记录。
+     * 用于分工会人员分配列表的“取消退出”按钮，防止跨分工会恢复数据。
+     *
+     * @param id 人员分配记录ID
+     */
+    void restoreCurrentBranchCancelledAssignment(String id);
+
+    /**
+     * 按疗休养配置清理人员分配数据，供删除配置或后续重置分配时复用。
+     *
+     * @param settingId 疗休养配置ID
+     */
+    void clearBySettingId(String settingId);
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/service/impl/TourLeaveApplyServiceImpl.java

@@ -0,0 +1,169 @@
+package com.budwk.app.zhgh.dayofficework.tour.service.impl;
+
+import cn.dev33.satoken.stp.StpUtil;
+import cn.hutool.core.util.StrUtil;
+import com.budwk.app.base.constant.RoleConstant;
+import com.budwk.app.base.page.Pagination;
+import com.budwk.app.base.param.PageForm;
+import com.budwk.app.base.service.impl.BaseServiceImpl;
+import com.budwk.app.web.commons.auth.utils.AuthUtil;
+import com.budwk.app.web.commons.auth.utils.SecurityUtil;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourLeaveApply;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourUserAssignment;
+import com.budwk.app.zhgh.dayofficework.tour.service.TourLeaveApplyService;
+import com.budwk.app.zhgh.dayofficework.tour.service.TourUserAssignmentService;
+import org.nutz.dao.Cnd;
+import org.nutz.dao.Dao;
+import org.nutz.dao.Sqls;
+import org.nutz.dao.sql.Sql;
+import org.nutz.dao.util.cri.SqlExpressionGroup;
+import org.nutz.ioc.loader.annotation.Inject;
+import org.nutz.ioc.loader.annotation.IocBean;
+import org.nutz.lang.util.NutMap;
+
+@IocBean(args = {"refer:dao"})
+public class TourLeaveApplyServiceImpl extends BaseServiceImpl<TourLeaveApply> implements TourLeaveApplyService {
+
+    @Inject
+    private TourUserAssignmentService tourUserAssignmentService;
+
+    public TourLeaveApplyServiceImpl(Dao dao) {
+        super(dao);
+    }
+
+    @Override
+    public Pagination<NutMap> pageData(PageForm pageForm, String keyword, String unionName, String status) {
+        Sql sql = Sqls.create("""
+                SELECT
+                    a.*,
+                    s.`year` AS `year`,
+                    s.configName AS settingName,
+                    CASE
+                        WHEN IFNULL(m.travelStartTime, '') <> '' AND IFNULL(m.travelEndTime, '') <> ''
+                        THEN CONCAT(m.travelStartTime, ' 至 ', m.travelEndTime)
+                        ELSE ''
+                    END AS travelPeriod,
+                    m.travelStartTime AS travelStartTime,
+                    IF(IFNULL(a.cancelled, 0) = 1, 'CANCELLED', 'NORMAL') AS cancelStatus
+                FROM tour_user_assignment a
+                LEFT JOIN tour_setting s ON s.id = a.settingId
+                LEFT JOIN tour_matter m ON m.id = a.matterId AND m.delFlag = 0
+                $condition
+                """);
+        Cnd cnd = Cnd.NEW();
+        cnd.and("a.delFlag", "=", false);
+        // 退出取消只针对已选路线的数据，未分配路线的人员没有出行时间和台账可处理。
+        cnd.and("a.matterId", "is not", null);
+        cnd.and("a.matterId", "<>", "");
+        cnd.and("a.lineId", "is not", null);
+        cnd.and("a.lineId", "<>", "");
+        cnd.and("a.personType", "=", TourUserAssignment.PERSON_TYPE_FORMAL);
+        applyDataPermission(cnd);
+        if (StrUtil.isNotBlank(keyword)) {
+            SqlExpressionGroup keywordGroup = new SqlExpressionGroup();
+            keywordGroup.orLike("a.loginName", keyword);
+            keywordGroup.orLike("a.userName", keyword);
+            cnd.and(keywordGroup);
+        }
+        cnd.and(Cnd.likeEX("a.unionName", unionName));
+        if ("CANCELLED".equals(status)) {
+            cnd.and("a.cancelled", "=", true);
+        } else if ("NORMAL".equals(status)) {
+            cnd.and(Cnd.exps("a.cancelled", "=", false).or("a.cancelled", "is", null));
+        }
+        applyOrder(cnd, pageForm);
+        sql.setCondition(cnd);
+        return listPageMap(pageForm.getPageNumber(), pageForm.getPageSize(), sql);
+    }
+
+    @Override
+    public NutMap permissionInfo() {
+        return NutMap.NEW()
+                .addv("isAllDataRole", isAllDataRole())
+                .addv("isBranchUnionChairman", AuthUtil.hasRole(RoleConstant.BRANCH_UNION_CHAIRMAN.name()))
+                .addv("canRestore", StpUtil.hasPermission("tour.branchUserAssignment.cancelRestore"));
+    }
+
+    @Override
+    public void cancelAssignment(String id) {
+        checkCanOperateAssignment(id);
+        tourUserAssignmentService.cancelAssignment(id);
+    }
+
+    @Override
+    public void restoreAssignment(String id) {
+        checkCanOperateAssignment(id);
+        tourUserAssignmentService.restoreCancelledAssignment(id);
+    }
+
+    /**
+     * 退出取消管理读取人员分配表，按用户角色收窄可见范围。
+     */
+    private void applyDataPermission(Cnd cnd) {
+        if (isAllDataRole()) {
+            return;
+        }
+        if (AuthUtil.hasRole(RoleConstant.BRANCH_UNION_CHAIRMAN.name())) {
+            cnd.andEX("a.unionId", "=", SecurityUtil.getUnionId());
+            return;
+        }
+        cnd.and("a.userId", "=", SecurityUtil.getUserId());
+    }
+
+    private boolean isAllDataRole() {
+        return AuthUtil.hasRole(RoleConstant.SYSADMIN.name())
+                || AuthUtil.hasRole(RoleConstant.SCHOOL_UNION_CHAIRMAN.name());
+    }
+
+    /**
+     * 操作前按同一数据权限校验，避免前端绕过列表直接提交其它人员记录。
+     */
+    private void checkCanOperateAssignment(String id) {
+        if (StrUtil.isBlank(id)) {
+            throw new IllegalArgumentException("参数错误");
+        }
+        Cnd cnd = Cnd.where(TourUserAssignment::getId, "=", id)
+                .and(TourUserAssignment::getDelFlag, "=", false);
+        if (!isAllDataRole()) {
+            if (AuthUtil.hasRole(RoleConstant.BRANCH_UNION_CHAIRMAN.name())) {
+                cnd.and(TourUserAssignment::getUnionId, "=", SecurityUtil.getUnionId());
+            } else {
+                cnd.and(TourUserAssignment::getUserId, "=", SecurityUtil.getUserId());
+            }
+        }
+        if (dao().count(TourUserAssignment.class, cnd) <= 0) {
+            throw new IllegalArgumentException("人员分配记录不存在或无权操作");
+        }
+    }
+
+    /**
+     * 仅开放页面使用到的排序字段，避免前端传入任意字段名影响查询。
+     */
+    private void applyOrder(Cnd cnd, PageForm pageForm) {
+        String orderName = pageForm.getPageOrderName();
+        String orderBy = pageForm.getPageOrderBy();
+        boolean descending = "descending".equals(orderBy);
+        if ("loginName".equals(orderName)) {
+            order(cnd, "a.loginName", descending);
+        } else if ("userName".equals(orderName)) {
+            order(cnd, "a.userName", descending);
+        } else if ("unionName".equals(orderName)) {
+            order(cnd, "a.unionName", descending);
+        } else if ("cancelStatus".equals(orderName)) {
+            order(cnd, "a.cancelled", descending);
+        } else if ("assignedAt".equals(orderName)) {
+            order(cnd, "a.assignedAt", descending);
+        } else {
+            cnd.desc("a.assignedAt");
+            cnd.desc("a.createdAt");
+        }
+    }
+
+    private void order(Cnd cnd, String field, boolean descending) {
+        if (descending) {
+            cnd.desc(field);
+        } else {
+            cnd.asc(field);
+        }
+    }
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/service/impl/TourLedgerDirectRelativeServiceImpl.java

@@ -0,0 +1,15 @@
+package com.budwk.app.zhgh.dayofficework.tour.service.impl;
+
+import com.budwk.app.base.service.impl.BaseServiceImpl;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourLedgerDirectRelative;
+import com.budwk.app.zhgh.dayofficework.tour.service.TourLedgerDirectRelativeService;
+import org.nutz.dao.Dao;
+import org.nutz.ioc.loader.annotation.IocBean;
+
+@IocBean(args = {"refer:dao"})
+public class TourLedgerDirectRelativeServiceImpl extends BaseServiceImpl<TourLedgerDirectRelative> implements TourLedgerDirectRelativeService {
+
+    public TourLedgerDirectRelativeServiceImpl(Dao dao) {
+        super(dao);
+    }
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/service/impl/TourLedgerFamilyServiceImpl.java

@@ -0,0 +1,15 @@
+package com.budwk.app.zhgh.dayofficework.tour.service.impl;
+
+import com.budwk.app.base.service.impl.BaseServiceImpl;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourLedgerFamily;
+import com.budwk.app.zhgh.dayofficework.tour.service.TourLedgerFamilyService;
+import org.nutz.dao.Dao;
+import org.nutz.ioc.loader.annotation.IocBean;
+
+@IocBean(args = {"refer:dao"})
+public class TourLedgerFamilyServiceImpl extends BaseServiceImpl<TourLedgerFamily> implements TourLedgerFamilyService {
+
+    public TourLedgerFamilyServiceImpl(Dao dao) {
+        super(dao);
+    }
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/service/impl/TourLedgerServiceImpl.java

@@ -0,0 +1,15 @@
+package com.budwk.app.zhgh.dayofficework.tour.service.impl;
+
+import com.budwk.app.base.service.impl.BaseServiceImpl;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourLedger;
+import com.budwk.app.zhgh.dayofficework.tour.service.TourLedgerService;
+import org.nutz.dao.Dao;
+import org.nutz.ioc.loader.annotation.IocBean;
+
+@IocBean(args = {"refer:dao"})
+public class TourLedgerServiceImpl extends BaseServiceImpl<TourLedger> implements TourLedgerService {
+
+    public TourLedgerServiceImpl(Dao dao) {
+        super(dao);
+    }
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/service/impl/TourLineServiceImpl.java

@@ -0,0 +1,15 @@
+package com.budwk.app.zhgh.dayofficework.tour.service.impl;
+
+import com.budwk.app.base.service.impl.BaseServiceImpl;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourLine;
+import com.budwk.app.zhgh.dayofficework.tour.service.TourLineService;
+import org.nutz.dao.Dao;
+import org.nutz.ioc.loader.annotation.IocBean;
+
+@IocBean(args = {"refer:dao"})
+public class TourLineServiceImpl extends BaseServiceImpl<TourLine> implements TourLineService {
+
+    public TourLineServiceImpl(Dao dao) {
+        super(dao);
+    }
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/service/impl/TourMatterServiceImpl.java

@@ -0,0 +1,15 @@
+package com.budwk.app.zhgh.dayofficework.tour.service.impl;
+
+import com.budwk.app.base.service.impl.BaseServiceImpl;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourMatter;
+import com.budwk.app.zhgh.dayofficework.tour.service.TourMatterService;
+import org.nutz.dao.Dao;
+import org.nutz.ioc.loader.annotation.IocBean;
+
+@IocBean(args = {"refer:dao"})
+public class TourMatterServiceImpl extends BaseServiceImpl<TourMatter> implements TourMatterService {
+
+    public TourMatterServiceImpl(Dao dao) {
+        super(dao);
+    }
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/service/impl/TourSettingServiceImpl.java

@@ -0,0 +1,133 @@
+package com.budwk.app.zhgh.dayofficework.tour.service.impl;
+
+import cn.hutool.core.util.StrUtil;
+import com.budwk.app.base.service.impl.BaseServiceImpl;
+import com.budwk.app.sys.models.Sys_union;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourSetting;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourSettingUnionQuota;
+import com.budwk.app.zhgh.dayofficework.tour.service.TourSettingService;
+import org.nutz.dao.Cnd;
+import org.nutz.dao.Dao;
+import org.nutz.dao.Sqls;
+import org.nutz.dao.sql.Sql;
+import org.nutz.ioc.loader.annotation.IocBean;
+import org.nutz.json.Json;
+import org.nutz.lang.Lang;
+import org.nutz.lang.util.NutMap;
+
+import java.util.List;
+import java.util.Map;
+import java.util.stream.Collectors;
+
+@IocBean(args = {"refer:dao"})
+public class TourSettingServiceImpl extends BaseServiceImpl<TourSetting> implements TourSettingService {
+
+    public TourSettingServiceImpl(Dao dao) {
+        super(dao);
+    }
+
+    @Override
+    public List<TourSettingUnionQuota> listUnionQuotaRows(String settingId) {
+        // 一次性查出所有分工会、已保存名额和实时会员数，避免页面打开时按分工会循环统计造成 N+1 查询。
+        Sql sql = Sqls.create("""
+                SELECT
+                  quota.id AS id,
+                  @settingId AS settingId,
+                  un.id AS unionId,
+                  un.name AS unionName,
+                  COALESCE(quota.formalQuota, 0) AS formalQuota,
+                  COALESCE(quota.backupQuota, 0) AS backupQuota,
+                  COALESCE(user_count.memberCount, 0) AS memberCount
+                FROM sys_union un
+                LEFT JOIN tour_setting_union_quota quota
+                  ON quota.unionId = un.id
+                  AND quota.settingId = @settingId
+                LEFT JOIN (
+                  SELECT unionId, COUNT(1) AS memberCount
+                  FROM vw_user
+                  WHERE member = 1
+                  GROUP BY unionId
+                ) user_count ON user_count.unionId = un.id
+                ORDER BY un.unionCode ASC
+                """);
+        sql.setParam("settingId", settingId == null ? "" : settingId);
+        List<NutMap> rows = listMap(sql);
+        return rows.stream().map(row -> {
+            TourSettingUnionQuota quota = new TourSettingUnionQuota();
+            quota.setId(row.getString("id"));
+            quota.setSettingId(row.getString("settingId"));
+            quota.setUnionId(row.getString("unionId"));
+            quota.setUnionName(row.getString("unionName"));
+            quota.setFormalQuota(defaultInt(row.getInt("formalQuota")));
+            quota.setBackupQuota(defaultInt(row.getInt("backupQuota")));
+            quota.setMemberCount(defaultInt(row.getInt("memberCount")));
+            return quota;
+        }).collect(Collectors.toList());
+    }
+
+    @Override
+    public void saveUnionQuotas(String settingId, String unionQuotas) {
+        if (StrUtil.isBlank(settingId)) {
+            return;
+        }
+        clearUnionQuotas(settingId);
+        if (StrUtil.isBlank(unionQuotas)) {
+            return;
+        }
+        List<TourSettingUnionQuota> quotaList = Json.fromJsonAsList(TourSettingUnionQuota.class, unionQuotas);
+        if (Lang.isEmpty(quotaList)) {
+            return;
+        }
+        Map<String, Sys_union> unionMap = dao().query(Sys_union.class, Cnd.NEW()).stream()
+                .collect(Collectors.toMap(Sys_union::getId, item -> item, (a, b) -> a));
+        List<TourSettingUnionQuota> saveList = quotaList.stream()
+                .filter(item -> item != null && StrUtil.isNotBlank(item.getUnionId()))
+                .map(item -> normalizeUnionQuota(settingId, item, unionMap))
+                .filter(item -> item.getFormalQuota() > 0 || item.getBackupQuota() > 0)
+                .collect(Collectors.toList());
+        if (Lang.isNotEmpty(saveList)) {
+            dao().insert(saveList);
+        }
+    }
+
+    @Override
+    public String checkBranchFormalQuotaLimit(String unionQuotas, int branchTotalQuota) {
+        if (StrUtil.isBlank(unionQuotas)) {
+            return "";
+        }
+        List<TourSettingUnionQuota> quotaList = Json.fromJsonAsList(TourSettingUnionQuota.class, unionQuotas);
+        if (Lang.isEmpty(quotaList)) {
+            return "";
+        }
+        int formalTotal = quotaList.stream()
+                .filter(item -> item != null)
+                .mapToInt(item -> defaultInt(item.getFormalQuota()))
+                .sum();
+        if (formalTotal > branchTotalQuota) {
+            return "当前正式人员总数 " + formalTotal + "，分工会总名额 " + branchTotalQuota + "，分配后总人数不能超过分工会总名额";
+        }
+        return "";
+    }
+
+    @Override
+    public void clearUnionQuotas(String settingId) {
+        if (StrUtil.isNotBlank(settingId)) {
+            dao().clear(TourSettingUnionQuota.class, Cnd.where(TourSettingUnionQuota::getSettingId, "=", settingId));
+        }
+    }
+
+    private TourSettingUnionQuota normalizeUnionQuota(String settingId, TourSettingUnionQuota item, Map<String, Sys_union> unionMap) {
+        Sys_union union = unionMap.get(item.getUnionId());
+        TourSettingUnionQuota quota = new TourSettingUnionQuota();
+        quota.setSettingId(settingId);
+        quota.setUnionId(item.getUnionId());
+        quota.setUnionName(union == null ? item.getUnionName() : union.getName());
+        quota.setFormalQuota(defaultInt(item.getFormalQuota()));
+        quota.setBackupQuota(defaultInt(item.getBackupQuota()));
+        return quota;
+    }
+
+    private Integer defaultInt(Integer value) {
+        return value == null || value < 0 ? 0 : value;
+    }
+}

src/main/java/com/budwk/app/zhgh/dayofficework/tour/service/impl/TourTravelAgencyServiceImpl.java

@@ -0,0 +1,15 @@
+package com.budwk.app.zhgh.dayofficework.tour.service.impl;
+
+import com.budwk.app.base.service.impl.BaseServiceImpl;
+import com.budwk.app.zhgh.dayofficework.tour.models.TourTravelAgency;
+import com.budwk.app.zhgh.dayofficework.tour.service.TourTravelAgencyService;
+import org.nutz.dao.Dao;
+import org.nutz.ioc.loader.annotation.IocBean;
+
+@IocBean(args = {"refer:dao"})
+public class TourTravelAgencyServiceImpl extends BaseServiceImpl<TourTravelAgency> implements TourTravelAgencyService {
+
+    public TourTravelAgencyServiceImpl(Dao dao) {
+        super(dao);
+    }
+}

src/main/java/com/budwk/app/zhgh/democratic/proposal/controller/common/ProposalCommonController.java

@@ -82,7 +82,9 @@ public class ProposalCommonController {
     @SaCheckLogin
     @ApiOperation("承办单位列表")
     public Result listUnderTake() {
-        List<ProposalUndertake> list = dao.query(ProposalUndertake.class, Cnd.NEW());
+        Cnd cnd = Cnd.NEW();
+        cnd.and("enable","=", true);
+        List<ProposalUndertake> list = dao.query(ProposalUndertake.class, cnd);
         return Result.success(list);
     }
 

src/main/java/com/budwk/app/zhgh/democratic/proposal/controller/config/ProposalConfigUnitController.java

@@ -1,6 +1,7 @@
 package com.budwk.app.zhgh.democratic.proposal.controller.config;
 
 import cn.dev33.satoken.annotation.SaCheckPermission;
+import cn.hutool.core.collection.CollectionUtil;
 import cn.hutool.core.lang.tree.Tree;
 import cn.hutool.core.lang.tree.TreeNode;
 import cn.hutool.core.lang.tree.TreeUtil;
@@ -20,10 +21,12 @@ import com.budwk.app.zhgh.democratic.proposal.models.ProposalConfig;
 import com.budwk.app.zhgh.democratic.proposal.models.ProposalUndertake;
 import lombok.extern.slf4j.Slf4j;
 import org.nutz.aop.interceptor.ioc.TransAop;
+import org.nutz.dao.Chain;
 import org.nutz.dao.Cnd;
 import org.nutz.dao.Dao;
 import org.nutz.dao.Sqls;
 import org.nutz.dao.sql.Sql;
+import org.nutz.dao.util.cri.SqlExpressionGroup;
 import org.nutz.ioc.aop.Aop;
 import org.nutz.ioc.loader.annotation.Inject;
 import org.nutz.ioc.loader.annotation.IocBean;
@@ -37,6 +40,7 @@ import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.List;
 import java.util.Map;
+import java.util.stream.Collectors;
 
 /**
  * 提案承办单位配置
@@ -98,6 +102,7 @@ public class ProposalConfigUnitController {
             cnd.where().orLike("u2.loginname", pageForm.getSearchKeyword());
             cnd.where().orLike("t1.name", pageForm.getSearchKeyword());
         }
+        cnd.and("t1.enable","=", true);
         cnd.asc("t1.code");
         sql.setCondition(cnd);
         Pagination pagination = baseService.listPageMap(pageForm.getPageNumber(), pageForm.getPageSize(), sql);
@@ -124,6 +129,20 @@ public class ProposalConfigUnitController {
             return proposalUndertake;
         }).toList();
         dao.fastInsert(proposalUndertakes);
+
+        dao.update(ProposalUndertake.class, Chain.make("enable",true), Cnd.where("1","=","1"));
+        Cnd cnd = Cnd.NEW();
+        SqlExpressionGroup group = Cnd.NEW().where();
+        group.and("delFlag", "=", true);
+        cnd.and(group);
+        List<Sys_unit> delFlagUnit = dao.query(Sys_unit.class, cnd);
+        if(CollectionUtil.isNotEmpty(delFlagUnit)){
+            List<String> unitCodeList = delFlagUnit.stream().map(Sys_unit::getUnitcode).collect(Collectors.toList());
+            Cnd cndUnit = Cnd.NEW();
+            cndUnit.where().andInStrList("code", unitCodeList);
+            dao.update(ProposalUndertake.class, Chain.make("enable",false), cndUnit);
+        }
+
         return Result.success();
     }