| 1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738 |
- package com.etotem.cfc.service;
- import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
- import com.etotem.cfc.common.Result;
- import com.etotem.cfc.dto.AddFamilyMemberDTO;
- import com.etotem.cfc.dto.FamilyMemberVO;
- import com.etotem.cfc.dto.SwitchMemberVO;
- import com.etotem.cfc.entity.Family;
- import com.etotem.cfc.entity.FamilyMember;
- import com.etotem.cfc.entity.FamilyRelationship;
- import com.etotem.cfc.entity.FamilyMemberAttributes;
- import com.etotem.cfc.entity.FamilyMemberLog;
- import com.etotem.cfc.entity.FiveDimensionScore;
- import com.etotem.cfc.entity.HealthReport;
- import com.etotem.cfc.entity.Task;
- import com.etotem.cfc.entity.User;
- import com.etotem.cfc.enums.GenerationLevel;
- import com.etotem.cfc.mapper.FamilyMapper;
- import com.etotem.cfc.mapper.FamilyMemberAttributesMapper;
- import com.etotem.cfc.mapper.FamilyMemberLogMapper;
- import com.etotem.cfc.mapper.FamilyMemberMapper;
- import com.etotem.cfc.mapper.FiveDimensionScoreMapper;
- import com.etotem.cfc.mapper.HealthReportMapper;
- import com.etotem.cfc.mapper.TaskMapper;
- import com.etotem.cfc.mapper.UserMapper;
- import org.slf4j.Logger;
- import org.slf4j.LoggerFactory;
- import org.springframework.security.access.AccessDeniedException;
- import org.springframework.stereotype.Service;
- import org.springframework.transaction.annotation.Transactional;
- import javax.annotation.Resource;
- import java.util.ArrayList;
- import java.util.Comparator;
- import java.util.Date;
- import java.util.List;
- import java.util.Map;
- import java.util.stream.Collectors;
- import com.etotem.cfc.util.SortUtil;
- import com.etotem.cfc.util.FamilyNamingSupport;
- import com.etotem.cfc.util.UserUtil;
- @Service
- public class FamilyMemberService {
- private static final Logger log = LoggerFactory.getLogger(FamilyMemberService.class);
- /** SC-P-04 family.familyMembers.list 在线判定窗口:最后互动时间距今 15 分钟内视为在线 */
- private static final long ONLINE_WINDOW_MS = 15 * 60 * 1000L;
- @Resource
- private FamilyMemberMapper familyMemberMapper;
- @Resource
- private UserMapper userMapper;
- @Resource
- private FamilyMapper familyMapper;
- @Resource
- private FamilyMemberAttributesMapper familyMemberAttributesMapper;
- @Resource
- private OnboardingService onboardingService;
- @Resource
- private SystemConfigService systemConfigService;
- @Resource
- private FamilyRelationshipService familyRelationshipService;
- @Resource
- private FamilyMemberLogMapper familyMemberLogMapper;
- @Resource
- private CouponService couponService;
- @Resource
- private FiveDimensionScoreMapper fiveDimensionScoreMapper;
- @Resource
- private TaskMapper taskMapper;
- @Resource
- private HealthReportMapper healthReportMapper;
- @Resource
- private MembershipService membershipService;
- @Resource
- private FamilyFoodOverviewService familyFoodOverviewService;
- @Resource
- private ReportMemberPermissionService reportMemberPermissionService;
- /**
- * 校验成员是否属于指定家庭(用于避免跨家庭读写成员数据)
- */
- public boolean isMemberInFamily(Long familyId, Long memberId) {
- if (familyId == null || memberId == null) {
- return false;
- }
- FamilyMember member = familyMemberMapper.selectById(memberId);
- return member != null && familyId.equals(member.getFamilyId());
- }
- /**
- * 添加家庭成员
- */
- @Transactional(rollbackFor = Exception.class)
- public FamilyMemberVO addMember(Long userId, AddFamilyMemberDTO dto) {
- if (dto.getNickname() == null || dto.getNickname().trim().isEmpty()) {
- throw new IllegalArgumentException("成员昵称不能为空");
- }
- if (dto.getGenerationLevel() == null || dto.getGenerationLevel().trim().isEmpty()) {
- throw new IllegalArgumentException("辈分等级不能为空");
- }
- User user = userMapper.selectById(userId);
- if (user == null) {
- throw new RuntimeException("用户不存在");
- }
- if (user.getFamilyId() == null) {
- throw new RuntimeException("用户未加入家庭,请先创建或加入家庭");
- }
- Long familyId = user.getFamilyId();
- GenerationLevel genLevel = GenerationLevel.fromValue(dto.getGenerationLevel());
- if (genLevel == null) {
- throw new IllegalArgumentException("无效的辈分等级: " + dto.getGenerationLevel());
- }
- // 计算辈分值(相对关联成员)
- FamilyMember relative = null;
- if (dto.getRelativeMemberId() != null) {
- relative = familyMemberMapper.selectById(dto.getRelativeMemberId());
- if (relative == null || !relative.getFamilyId().equals(familyId)) {
- throw new IllegalArgumentException("关联成员不存在");
- }
- }
- int generation = (relative != null ? relative.getGeneration() : 0) + genLevel.getOffset();
- boolean isSpouse = genLevel == GenerationLevel.PEER
- && "spouse".equals(dto.getPeerType());
- // 创建家庭成员记录
- FamilyMember member = new FamilyMember();
- member.setFamilyId(familyId);
- member.setNickname(dto.getNickname().trim());
- member.setPhone(dto.getPhone());
- member.setAvatar(dto.getAvatar());
- member.setGender(dto.getGender());
- if (dto.getBirthday() != null && !dto.getBirthday().isEmpty()) {
- try {
- java.text.SimpleDateFormat sdf = new java.text.SimpleDateFormat("yyyy-MM-dd");
- member.setBirthday(sdf.parse(dto.getBirthday()));
- } catch (java.text.ParseException e) {
- throw new IllegalArgumentException("出生日期格式错误,应为yyyy-MM-dd");
- }
- }
- member.setBirthHour(dto.getBirthHour());
- member.setBirthWeight(dto.getBirthWeight());
- member.setBirthPlace(dto.getBirthPlace());
- member.setIsCesarean(dto.getIsCesarean());
- member.setGeneration(generation);
- member.setIsSpouse(isSpouse);
- member.setShowToFamily(1);
- member.setTotalPoints(0);
- member.setCreatedAt(new Date());
- member.setUpdatedAt(new Date());
- // 【重构】成员创建:同步创建 user 记录(无 openid = 不可登录)
- // 1) 若填写了手机号且已存在同手机号用户 → 复用该 user(绑定 userId)
- // 2) 若填写了手机号但不存在 → 创建无 openid 的 user,预留未来注册复用
- // 3) 未填写手机号 → 创建无 openid 的 user
- Long memberUserId = null;
- if (dto.getPhone() != null && !dto.getPhone().isEmpty()) {
- User matchedUser = userMapper.selectOne(
- new LambdaQueryWrapper<User>().eq(User::getPhone, dto.getPhone()));
- if (matchedUser != null) {
- memberUserId = matchedUser.getId();
- // 将匹配到的用户加入同一家庭(如果尚未加入)
- if (matchedUser.getFamilyId() == null) {
- matchedUser.setFamilyId(familyId);
- matchedUser.setUpdatedAt(new Date());
- userMapper.updateById(matchedUser);
- }
- } else {
- // 创建预留用户(无 openid,后续同手机号注册时复用)
- User newUser = new User();
- newUser.setOpenid("");
- newUser.setUnionid("");
- newUser.setRole("parent"); // 无 child 角色,统一 parent 兜底(实际不可登录)
- newUser.setNickname(dto.getNickname().trim());
- newUser.setPhone(dto.getPhone());
- newUser.setFamilyId(familyId);
- newUser.setPassword(""); // 初始密码为空,切换保护密码后续由用户设置
- newUser.setCreatedAt(new Date());
- newUser.setUpdatedAt(new Date());
- userMapper.insert(newUser);
- memberUserId = newUser.getId();
- }
- } else {
- // 未填手机号:创建无 openid 的 user(昵称必须非空)
- User newUser = new User();
- newUser.setOpenid("");
- newUser.setUnionid("");
- newUser.setRole("parent");
- newUser.setNickname(dto.getNickname().trim());
- newUser.setFamilyId(familyId);
- newUser.setPassword("");
- newUser.setCreatedAt(new Date());
- newUser.setUpdatedAt(new Date());
- userMapper.insert(newUser);
- memberUserId = newUser.getId();
- }
- member.setUserId(memberUserId);
- familyMemberMapper.insert(member);
- // 写入变更日志
- logMemberAction(member.getFamilyId(), member.getId(), "join", null, member.getNickname(), userId);
- // children 表已废除,无需同步。角色信息通过 computeEffectiveRole() 自动计算。
- // 若需要 child 专属初始化(如游戏数据),后续在 computeEffectiveRole() 返回 child 时处理。
- // 为新成员创建与所有现有成员的双向关系
- // 注意:第三个参数是「绝对辈分」而非相对偏移;锚点=关联成员(本次添加所参照的人),
- // spouse 只写在「新成员 ↔ 关联成员」之间,家庭内其他同辈一律 sibling。
- familyRelationshipService.createRelationsForNewMember(
- familyId, member.getId(), generation,
- genLevel == GenerationLevel.PEER ? dto.getPeerType() : null,
- relative != null ? relative.getId() : null);
- // 发放家庭人口券(POPULATION):发到家庭维度
- try {
- couponService.grantFamilyPopulationCoupons(familyId, member.getId());
- } catch (Exception e) {
- log.error("发放家庭人口券异常: memberId={}", member.getId(), e);
- }
- // 方案B:新成员加入时,继承家庭现有有效会员身份
- if (memberUserId != null) {
- membershipService.syncMembershipForNewMember(memberUserId, familyId);
- }
- return toFamilyMemberVO(member);
- }
- /**
- * 获取家庭成员列表(合并 children + family_members)
- */
- public List<FamilyMemberVO> listMembers(Long userId) {
- User user = userMapper.selectById(userId);
- if (user == null || user.getFamilyId() == null) {
- return new ArrayList<>();
- }
- return listMembersOfFamily(user.getFamilyId(), userId);
- }
- /**
- * 成员列表分页+搜索(SC-P-04 family.familyMembers.list 能力键,S-cfc-357)。
- * <p>返回分页结构 {@code {total, list}}:total = 关键字匹配后的成员总数,list = 当前页数据。
- * 无 keyword/page/pageSize 时等价于全量 {@link #listMembers(Long)}(兼容现状语义)。</p>
- *
- * @param userId 当前查看者(用于按本人家庭查询)
- * @param keyword 昵称/姓名过滤关键字(null/空白 = 不过滤)
- * @param page 页码(null/<1 归一化为 1;非法值 0/负数由 Controller 校验拦截)
- * @param pageSize 每页数量(null/<1 默认 20)
- * @return 分页结构 Map:{total: Integer, list: List<FamilyMemberVO>}
- */
- public Map<String, Object> listMembers(Long userId, String keyword, Integer page, Integer pageSize) {
- return paginateMembers(listMembers(userId), keyword, page, pageSize);
- }
- /**
- * 关键字过滤 + 分页(纯静态函数,Controller 在 mock 场景下也能复用)。
- * <p>过滤口径:昵称/name 包含关键字(trim 后,null 安全);分页口径:page 从 1 起,pageSize 缺省 20。</p>
- */
- public static Map<String, Object> paginateMembers(List<FamilyMemberVO> members, String keyword,
- Integer page, Integer pageSize) {
- Map<String, Object> result = new java.util.HashMap<>();
- List<FamilyMemberVO> filtered = new ArrayList<>();
- boolean hasKeyword = keyword != null && !keyword.trim().isEmpty();
- if (hasKeyword) {
- String kw = keyword.trim();
- for (FamilyMemberVO vo : members) {
- if ((vo.getNickname() != null && vo.getNickname().contains(kw))
- || (vo.getName() != null && vo.getName().contains(kw))) {
- filtered.add(vo);
- }
- }
- } else {
- filtered.addAll(members);
- }
- result.put("total", filtered.size());
- int p = (page == null || page < 1) ? 1 : page;
- int size = (pageSize == null || pageSize < 1) ? 20 : pageSize;
- int from = Math.min((p - 1) * size, filtered.size());
- int to = Math.min(from + size, filtered.size());
- result.put("list", new ArrayList<>(filtered.subList(from, to)));
- return result;
- }
- /**
- * 获取指定家庭的成员列表(B2-1 新增)。
- * <p>按 familyId 直接查询(成长规划师查看绑定家庭、管理端查看任意家庭时使用);
- * 调用方需先校验访问权(getEffectiveFamilyIds / 平台角色直通)。</p>
- * @param familyId 目标家庭
- * @param viewerUserId 当前查看者(关系标签/isSelf 视角计算用)
- */
- public List<FamilyMemberVO> listMembersOfFamily(Long familyId, Long viewerUserId) {
- if (familyId == null) {
- return new ArrayList<>();
- }
- List<FamilyMemberVO> result = new ArrayList<>();
- // 查询家庭创建者,用于逐成员判断其是否管理员(isAdmin 语义:该成员本人是否为家庭创建者)
- Family family = familyMapper.selectById(familyId);
- Long creatorId = (family != null) ? family.getCreatorId() : null;
- // 查询 family_members 表(排除回收箱成员)
- List<FamilyMember> familyMembers = familyMemberMapper.selectList(
- new LambdaQueryWrapper<FamilyMember>()
- .eq(FamilyMember::getFamilyId, familyId)
- .ne(FamilyMember::getStatus, "recycled"));
- // 兜底去重:同一 userId 多条记录只保留一条记录
- // 优先 status=active + userId 非空,其次 updated_at 最新
- // userId 为 null 的孤儿记录保持原样
- if (familyMembers != null && !familyMembers.isEmpty()) {
- Map<Long, List<FamilyMember>> userIdGroups = new java.util.HashMap<>();
- List<FamilyMember> orphans = new ArrayList<>();
- for (FamilyMember fm : familyMembers) {
- if (fm.getUserId() == null) {
- orphans.add(fm);
- } else {
- userIdGroups.computeIfAbsent(fm.getUserId(), k -> new ArrayList<>()).add(fm);
- }
- }
- List<FamilyMember> deduped = new ArrayList<>();
- deduped.addAll(orphans);
- for (List<FamilyMember> group : userIdGroups.values()) {
- if (group.size() == 1) {
- deduped.add(group.get(0));
- } else {
- // T24-C:确定性选"主成员",与 JwtInterceptor:177-182 的解析口径一致:
- // status='active' 最优先 → 其余状态其次 → recycled 最后;
- // 同级内 is_admin=1(主成员)优先;再以 id 最小兜底。
- // 旧实现用 .max() + 反向比较器(active 返回 -1、updated_at 用 b.compareTo(a)),
- // 实际选中"非 active / 最早 updated_at"行,与注释意图相反,导致 isSelf
- // 标在错误的重复行上(前端呈现"本人 + 本人所对应的成员"两个身份)。
- FamilyMember winner = group.stream()
- .min((a, b) -> {
- int aRank = statusRank(a.getStatus());
- int bRank = statusRank(b.getStatus());
- int statusCmp = Integer.compare(aRank, bRank);
- if (statusCmp != 0) return statusCmp;
- int aAdmin = a.getIsAdmin() != null ? a.getIsAdmin() : 0;
- int bAdmin = b.getIsAdmin() != null ? b.getIsAdmin() : 0;
- int adminCmp = Integer.compare(bAdmin, aAdmin);
- if (adminCmp != 0) return adminCmp;
- return Long.compare(a.getId(), b.getId());
- })
- .orElse(group.get(0));
- deduped.add(winner);
- }
- }
- familyMembers = deduped;
- }
- // 查找当前查看者在 family_members 中的记录(用于计算视角标签)
- FamilyMember viewerMember = null;
- for (FamilyMember fm : familyMembers) {
- if (viewerUserId.equals(fm.getUserId())) {
- viewerMember = fm;
- break;
- }
- }
- for (FamilyMember fm : familyMembers) {
- FamilyMemberVO vo = new FamilyMemberVO();
- vo.setId(fm.getId());
- vo.setSource("family_member");
- vo.setUserId(fm.getUserId());
- // isAdmin:优先读 family_members.is_admin 列;该成员为家庭创建者时兜底 true
- boolean memberIsAdmin = fm.getIsAdmin() != null && fm.getIsAdmin() == 1;
- boolean isCreator = creatorId != null && creatorId.equals(fm.getUserId());
- vo.setIsAdmin(memberIsAdmin || isCreator);
- vo.setNickname(resolveMemberNickname(fm));
- vo.setPhone(fm.getPhone());
- vo.setAvatar(fm.getAvatar());
- vo.setGender(fm.getGender());
- vo.setGeneration(fm.getGeneration());
- vo.setEffectiveRole(computeEffectiveRole(fm));
- vo.setRoleLabel(computeEffectiveRole(fm));
- vo.setTotalPoints(fm.getTotalPoints());
- vo.setShowToFamily(fm.getShowToFamily());
- if (fm.getBirthday() != null) {
- vo.setAge(calculateAge(fm.getBirthday()));
- vo.setBirthday(formatDate(fm.getBirthday()));
- }
- // 计算视角相关的关系标签
- if (viewerMember != null) {
- Integer genValue = null;
- String relType = null;
- if (familyRelationshipService != null && viewerMember.getId() != null) {
- List<FamilyRelationship> rels = familyRelationshipService.getRelationsForMember(viewerMember.getId());
- if (rels != null) {
- for (FamilyRelationship rel : rels) {
- if (rel.getToMemberId().equals(fm.getId())) {
- genValue = rel.getGenerationValue();
- relType = rel.getRelationType();
- break;
- }
- }
- }
- }
- if (genValue != null) {
- vo.setGenerationValue(genValue);
- }
- String relLabel = resolveRelativeLabel(viewerMember, fm, familyMembers, genValue, relType);
- vo.setRelativeLabel(relLabel);
- vo.setRelationship(relLabel);
- }
- // 补充字段
- vo.setIsSpouse(fm.getIsSpouse());
- vo.setTrustScore(fm.getTrustScore());
- vo.setIntimacyScore(fm.getIntimacyScore());
- vo.setCommunicationScore(fm.getCommunicationScore());
- vo.setIsSelf(viewerMember != null && viewerMember.getId().equals(fm.getId()));
- // 设置 memberType:userId 非空且关联 User 有 openid -> 'login';否则 -> 'local'
- if (fm.getUserId() != null) {
- User memberUser = userMapper.selectById(fm.getUserId());
- String openid = memberUser != null ? memberUser.getOpenid() : null;
- vo.setMemberType(openid != null && !openid.isEmpty() ? "login" : "local");
- } else {
- vo.setMemberType("local");
- }
- // 设置 isSwitchable:仅无 openid 的不可登录成员可被切换(可登录成员不允许切换视角)
- if (fm.getUserId() != null) {
- User memberUser = userMapper.selectById(fm.getUserId());
- String openid = memberUser != null ? memberUser.getOpenid() : null;
- vo.setIsSwitchable(openid == null || openid.isEmpty());
- } else {
- vo.setIsSwitchable(true);
- }
- vo.setLastInteractionAt(fm.getLastInteractionAt());
- vo.setStreakDays(fm.getStreakDays());
- // SC-P-04 family.familyMembers.list:在线状态(口径 = lastInteractionAt 最后互动时间)
- vo.setLastActiveAt(fm.getLastInteractionAt());
- vo.setOnline(fm.getLastInteractionAt() != null
- && (System.currentTimeMillis() - fm.getLastInteractionAt().getTime()) < ONLINE_WINDOW_MS);
- // 兼容旧前端字段
- vo.setMemberId(fm.getId());
- vo.setName(resolveMemberNickname(fm));
- result.add(vo);
- }
- // ── 合并 users 表同家庭的家庭主账号 ──
- // 家庭主账号在注册/创建家庭时只写入 users 表(family_id + role=parent),并不会同步到 family_members 表,
- // 因此在成员列表中需要额外合并,否则家庭主账号在该家庭中永远缺失(如 family 72 只显示家庭成员却少一位家庭主账号)。
- // 去重口径与 getVisibleMembers 一致:按 userId 去重,同一人若在 family_members 表已有记录则不再重复。
- java.util.Set<Long> familyMemberUserIds = new java.util.HashSet<>();
- for (FamilyMember fm : familyMembers) {
- if (fm.getUserId() != null) {
- familyMemberUserIds.add(fm.getUserId());
- }
- }
- List<User> parents = userMapper.selectList(new LambdaQueryWrapper<User>()
- .eq(User::getFamilyId, familyId)
- .eq(User::getRole, "parent"));
- for (User p : parents) {
- if (p.getId() == null || familyMemberUserIds.contains(p.getId())) {
- continue; // 已在 family_members 中,避免重复
- }
- FamilyMemberVO vo = new FamilyMemberVO();
- vo.setId(p.getId());
- vo.setMemberId(p.getId());
- vo.setSource("parent");
- vo.setMemberType("parent");
- vo.setUserId(p.getId());
- vo.setNickname(p.getNickname());
- vo.setName(p.getNickname());
- vo.setAvatar(p.getAvatar());
- vo.setPhone(p.getPhone());
- vo.setGender(p.getGender());
- vo.setEffectiveRole("parent");
- vo.setRoleLabel(p.getFamilyRole() != null ? p.getFamilyRole() : "本人");
- if (p.getBirthday() != null) {
- vo.setAge(calculateAge(p.getBirthday()));
- }
- vo.setGeneration(0);
- // 家庭主账号:仅当其为家庭创建者时视为管理员(users 表无 is_admin 列)
- vo.setIsAdmin(creatorId != null && creatorId.equals(p.getId()));
- vo.setIsSelf(p.getId().equals(viewerUserId));
- // 家庭主账号均为可登录用户,不允许切换视角(与成员段"仅不可登录可切换"一致)
- vo.setIsSwitchable(false); // 含 source='parent' 段
- vo.setShowToFamily(p.getShowToFamily() != null ? p.getShowToFamily() : 1);
- vo.setIsSpouse(false);
- vo.setTotalPoints(p.getTotalPoints());
- // SC-P-04 family.familyMembers.list:在线状态(users 表无 lastInteractionAt,默认离线)
- vo.setLastActiveAt(null);
- vo.setOnline(false);
- result.add(vo);
- }
- return result;
- }
- /**
- * 切换到家庭成员视图
- * <p>SC-P-03 双角色切换(TC-P-15/TC-P-15-E/TC-P-15-P):
- * - 正常流:家长切不可登录孩子视角 → 返回 SwitchMemberVO;
- * - 异常流(参数/业务规则):切到自己、切可登录成员 → IllegalArgumentException(400);
- * - 权限流(双角色铁律):孩子端切回家长、非法/跨家庭 memberId → AccessDeniedException(403)。
- * 异常统一由 GlobalExceptionHandler 映射错误码,controller 不再捕获转 500。
- */
- public SwitchMemberVO switchToMember(Long userId, Long memberId) {
- User user = userMapper.selectById(userId);
- if (user == null || user.getFamilyId() == null) {
- throw new IllegalArgumentException("用户未加入家庭");
- }
- // 从 family_members 查找
- FamilyMember member = familyMemberMapper.selectById(memberId);
- if (member != null && member.getFamilyId().equals(user.getFamilyId())) {
- // 不能切换到自己
- if (member.getUserId() != null && member.getUserId().equals(userId)) {
- throw new IllegalArgumentException("不能切换到自己");
- }
- // 仅不可登录成员可被切换:可登录成员(有 openid,可通过微信登录)不允许切换视角
- User memberUser = member.getUserId() != null ? userMapper.selectById(member.getUserId()) : null;
- String openid = memberUser != null ? memberUser.getOpenid() : null;
- boolean canLogin = openid != null && !openid.isEmpty();
- if (canLogin) {
- throw new IllegalArgumentException("该成员可通过微信登录,不能切换为TA的身份");
- }
- String effectiveRole = computeEffectiveRole(member);
- // 直接登录的成员端不能切换到本人端
- if ("child".equals(user.getRole()) && "parent".equals(effectiveRole)) {
- throw new AccessDeniedException("家庭成员账号不能切换到本人视角");
- }
- // SC-P-73 仅本家庭孩子可选:目标必须处于孩子上下文(child),
- // 本家庭成年成员/长辈(effectiveRole=parent)不得被当作孩子上下文选中
- if (!"child".equals(effectiveRole)) {
- throw new IllegalArgumentException("仅本家庭孩子可作为切换目标");
- }
- SwitchMemberVO vo = new SwitchMemberVO();
- vo.setMemberId(member.getId());
- vo.setSource("family_member");
- vo.setEffectiveRole(effectiveRole);
- vo.setNickname(resolveMemberNickname(member));
- vo.setIsSwitchable(true);
- return vo;
- }
- // 兼容 source='parent':无 family_members 记录的 users 表家庭主账号成员(memberId 即 userId)
- Long familyId = user.getFamilyId();
- User targetParent = userMapper.selectById(memberId);
- if (targetParent != null && familyId.equals(targetParent.getFamilyId())) {
- // 不能切换到自己
- if (targetParent.getId().equals(userId)) {
- throw new IllegalArgumentException("不能切换到自己");
- }
- // 直接登录的成员端不能切换到本人端(双角色铁律:孩子端不能切回家长)
- if ("child".equals(user.getRole())) {
- throw new AccessDeniedException("家庭成员账号不能切换到本人视角");
- }
- // source='parent' 的家庭主账号均为可登录用户,不允许切换视角
- throw new IllegalArgumentException("该成员可通过微信登录,不能切换为TA的身份");
- }
- // 非法/跨家庭 memberId:权限拒绝(不泄露他人家庭信息)
- throw new AccessDeniedException("成员不存在或不属于您的家庭");
- }
- /**
- * 踢出家庭成员(管理员操作)
- * 规则:
- * - 仅管理员可踢出
- * - 被踢成员 CF 值(统一账本 cf_balance,成员维度)随成员带走;family_members.system_points 为只读历史字段
- * - 收回该家庭发放给该成员的人口券(POPULATION)
- * - 微信登录用户:迁移资产到其初始家庭(无则创建新家庭)
- * - 非微信登录用户:进入回收箱(status=recycled),资产保留,可后续回收
- */
- @Transactional(rollbackFor = Exception.class)
- public void kickMember(Long userId, Long memberId) {
- User operator = userMapper.selectById(userId);
- if (operator == null || operator.getFamilyId() == null) {
- throw new RuntimeException("用户未加入家庭");
- }
- Family family = familyMapper.selectById(operator.getFamilyId());
- if (family == null) {
- throw new RuntimeException("家庭不存在");
- }
- // 仅管理员可踢出
- if (!Long.valueOf(userId).equals(family.getCreatorId())) {
- throw new RuntimeException("只有家庭管理员才能踢出成员");
- }
- Long familyId = operator.getFamilyId();
- // 从 family_members 查找
- FamilyMember member = familyMemberMapper.selectById(memberId);
- String memberNickname = null;
- if (member != null && familyId.equals(member.getFamilyId())) {
- // 不能踢出家庭创建者
- if (member.getUserId() != null && Long.valueOf(member.getUserId()).equals(family.getCreatorId())) {
- throw new RuntimeException("不能踢出家庭创建者,请先转让管理员权限");
- }
- memberNickname = member.getNickname();
- } else {
- // 兼容 source='parent':无 family_members 记录的 users 表家庭主账号成员(memberId 即 userId)
- User targetUser = userMapper.selectById(memberId);
- member = null;
- if (targetUser != null && familyId.equals(targetUser.getFamilyId())) {
- // 不能踢出家庭创建者
- if (targetUser.getId().equals(family.getCreatorId())) {
- throw new RuntimeException("不能踢出家庭创建者,请先转让管理员权限");
- }
- memberNickname = targetUser.getNickname();
- } else {
- throw new RuntimeException("成员不存在");
- }
- }
- Long oldFamilyId = familyId;
- Long targetUserId = (member != null) ? member.getUserId() : memberId;
- Long newFamilyId = null;
- // 收回该家庭发放给该成员的人口券
- try {
- couponService.revokeFamilyPopulationCoupons(oldFamilyId, memberId);
- } catch (Exception e) {
- log.warn("收回人口券异常: familyId={}, memberId={}", oldFamilyId, memberId, e);
- }
- // 清理关系记录(source='parent' 的 users 表成员无关系记录,跳过)
- if (member != null) {
- familyRelationshipService.deleteRelationsForMember(memberId);
- }
- if (targetUserId != null) {
- User targetUser = userMapper.selectById(targetUserId);
- if (targetUser != null && oldFamilyId.equals(targetUser.getFamilyId())) {
- // FIX S-cfc-179:被踢用户离开原家庭前,先按个人维度重算家庭派生会员缓存
- // (仅清除 FAMILY/BASIC/PREMIUM 家庭派生等级,保留 LIFETIME/PROVIDER 独立身份),
- // 与下方唯一的 userMapper.updateById 一并持久化,保证主流程只产生一次用户更新
- resetStaleFamilyDerivedMemberCache(targetUser);
- boolean isWechatUser = isWechatUser(targetUser);
- if (isWechatUser) {
- // 微信用户:迁移资产到初始家庭,CF 带走
- Long ownFamilyId = findOwnFamilyId(targetUserId);
- if (ownFamilyId == null) {
- ownFamilyId = createFamilyForUser(targetUser);
- }
- if (member != null) {
- migrateMemberAssets(member, oldFamilyId, ownFamilyId);
- member.setFamilyId(ownFamilyId);
- member.setStatus("active");
- member.setUpdatedAt(new Date());
- familyMemberMapper.updateById(member);
- }
- newFamilyId = ownFamilyId;
- targetUser.setFamilyId(ownFamilyId);
- targetUser.setUpdatedAt(new Date());
- userMapper.updateById(targetUser);
- } else {
- // 非微信用户:解除家庭关联,资产保留在原家庭记录上
- if (member != null) {
- member.setStatus("recycled");
- member.setUpdatedAt(new Date());
- familyMemberMapper.updateById(member);
- }
- targetUser.setFamilyId(null);
- targetUser.setUpdatedAt(new Date());
- userMapper.updateById(targetUser);
- }
- }
- } else {
- // 无关联用户(纯手动添加的成员):直接删除记录
- familyMemberMapper.deleteById(memberId);
- }
- logMemberAction(oldFamilyId, memberId, "kick", memberNickname, null, userId);
- // 方案B:成员被踢出后,重新核算原家庭会员身份
- membershipService.reconcileFamilyMembership(oldFamilyId);
- // 方案B补充:剥离被踢成员本人从原家庭继承的会员身份(reconcileFamilyMembership 只处理仍留在原家庭的成员,已迁出者不在降级范围)
- if (targetUserId != null) {
- membershipService.reconcileLeavingMemberMembership(targetUserId, oldFamilyId, newFamilyId);
- }
- // T28:成员被移出家庭后,其食材指数不再计入原家庭总览(AC-10)
- // 只 warn 不抛出,避免影响踢人主流程
- refreshFoodOverviewQuietly(oldFamilyId);
- if (newFamilyId != null && !newFamilyId.equals(oldFamilyId)) {
- refreshFoodOverviewQuietly(newFamilyId);
- }
- }
- /**
- * 主动退出家庭(微信登录用户)
- * 规则:
- * - 家庭创建者禁止退出,需先转让管理员
- * - CF 值(统一账本 cf_balance,成员维度)随成员带离原家庭;family_members.system_points 仅清零只读历史残留值
- * - 迁移资产到初始家庭(无则创建新家庭)
- */
- @Transactional(rollbackFor = Exception.class)
- public void leaveFamily(Long userId) {
- User user = userMapper.selectById(userId);
- if (user == null || user.getFamilyId() == null) {
- throw new RuntimeException("用户未加入家庭");
- }
- Long oldFamilyId = user.getFamilyId();
- Family family = familyMapper.selectById(oldFamilyId);
- if (family == null) {
- throw new RuntimeException("家庭不存在");
- }
- // 家庭创建者禁止退出
- if (Long.valueOf(userId).equals(family.getCreatorId())) {
- throw new RuntimeException("您是家庭创建者,请先转让管理员权限后再退出");
- }
- // 非微信用户禁止自主退出
- if (!isWechatUser(user)) {
- throw new RuntimeException("非微信登录用户不能自主退出家庭");
- }
- // 查找该用户在 family_members 中的记录
- FamilyMember member = familyMemberMapper.selectOne(
- new LambdaQueryWrapper<FamilyMember>()
- .eq(FamilyMember::getFamilyId, oldFamilyId)
- .eq(FamilyMember::getUserId, userId)
- .last("LIMIT 1"));
- if (member == null) {
- throw new RuntimeException("未找到该用户的家庭成员记录");
- }
- // family_members.system_points 为只读历史字段:清零残留值(CF 值在统一账本 cf_balance,成员维度,随成员走)
- member.setSystemPoints(0);
- member.setUpdatedAt(new Date());
- // 清理关系记录
- familyRelationshipService.deleteRelationsForMember(member.getId());
- // 迁移资产到初始家庭
- Long ownFamilyId = findOwnFamilyId(userId);
- if (ownFamilyId == null) {
- ownFamilyId = createFamilyForUser(user);
- }
- migrateMemberAssets(member, oldFamilyId, ownFamilyId);
- member.setFamilyId(ownFamilyId);
- member.setStatus("active");
- familyMemberMapper.updateById(member);
- // FIX S-cfc-179:退出用户离开原家庭前,先按个人维度重算家庭派生会员缓存
- // (仅清除 FAMILY/BASIC/PREMIUM 家庭派生等级,保留 LIFETIME/PROVIDER 独立身份),
- // 与下方唯一的 userMapper.updateById 一并持久化,保证主流程只产生一次用户更新
- resetStaleFamilyDerivedMemberCache(user);
- user.setFamilyId(ownFamilyId);
- user.setUpdatedAt(new Date());
- userMapper.updateById(user);
- // 方案B:成员离开后,重新核算原家庭会员身份(成员离开不影响新家庭,新家庭通常是新建的无会员)
- membershipService.reconcileFamilyMembership(oldFamilyId);
- // 方案B补充:剥离退出成员本人从原家庭继承的会员身份(reconcileFamilyMembership 只处理仍留在原家庭的成员)
- membershipService.reconcileLeavingMemberMembership(userId, oldFamilyId, ownFamilyId);
- logMemberAction(oldFamilyId, member.getId(), "leave", member.getNickname(), null, userId);
- // T28:成员退出后,其食材指数不再计入原家庭总览(AC-10)
- // 只 warn 不抛出,避免影响退出主流程
- refreshFoodOverviewQuietly(oldFamilyId);
- if (ownFamilyId != null && !ownFamilyId.equals(oldFamilyId)) {
- refreshFoodOverviewQuietly(ownFamilyId);
- }
- }
- /**
- * T28 辅助:安静地重算某家庭食材总览(失败只 warn,不影响调用方主流程)。
- */
- private void refreshFoodOverviewQuietly(Long familyId) {
- try {
- if (familyId == null) return;
- familyFoodOverviewService.recalculate(familyId);
- } catch (Exception e) {
- log.warn("家庭食材总览重算失败 familyId={}: {}", familyId, e.getMessage());
- }
- }
- /**
- * FIX S-cfc-179:被移出家庭的用户按「个人维度」重算会员缓存(纯内存变更,不落库)。
- *
- * <p>仅清除源自家庭会员的缓存(等级 + 到期时间)——家庭可授予等级(FAMILY/BASIC/PREMIUM,
- * 由 {@code syncMembershipToFamilyMembers} 同步给全家、只升不降)在被移出家庭后若无独立更高等级
- * 应恢复 FREE;更高等级独立个人会员(LIFETIME)与独立角色(PROVIDER)保留,不被误清。</p>
- *
- * <p>注意:此方法<b>不</b>调用 {@code userMapper.updateById}——调用方在既有的一次 {@code updateById}
- * 中一并持久化(保证 kick/leave 主流程只产生一次用户更新,契约单测以 {@code verify(times(1))} 锁定)。</p>
- *
- * <p>不依赖 {@code MembershipService}(避免 mock 场景下默认值干扰),直接按等级代码判定,
- * 与 {@code MembershipService.getMemberLevel} 的语义一致(结果契约由契约单测锁定)。</p>
- *
- * @param targetUser 被移出家庭的用户(调用方随后会 updateById 持久化)
- */
- private void resetStaleFamilyDerivedMemberCache(User targetUser) {
- if (targetUser == null || targetUser.getMemberLevel() == null) {
- return;
- }
- String level = targetUser.getMemberLevel();
- // 家庭可授予等级(家庭会员同步来源):被移出后无独立更高等级 → 恢复 FREE,并清空到期时间
- // LIFETIME(个人终身权益)/ PROVIDER(独立服务商角色)为独立身份,保留不清
- if ("FAMILY".equals(level) || "BASIC".equals(level) || "PREMIUM".equals(level)) {
- targetUser.setMemberLevel("FREE");
- targetUser.setMemberExpireTime(null);
- targetUser.setUpdatedAt(new Date());
- log.info("被移出家庭成员会员缓存已重置为 FREE: userId={}, fromLevel={}", targetUser.getId(), level);
- }
- }
- /**
- * 从回收箱回收成员(管理员操作):将回收箱中的非微信用户重新加入指定家庭
- */
- @Transactional(rollbackFor = Exception.class)
- public void recycleMember(Long operatorUserId, Long memberId, Long targetFamilyId) {
- User operator = userMapper.selectById(operatorUserId);
- if (operator == null || operator.getFamilyId() == null) {
- throw new RuntimeException("用户未加入家庭");
- }
- Family targetFamily = familyMapper.selectById(targetFamilyId);
- if (targetFamily == null) {
- throw new RuntimeException("目标家庭不存在");
- }
- // 仅管理员可回收
- if (!Long.valueOf(operatorUserId).equals(targetFamily.getCreatorId())) {
- throw new RuntimeException("只有目标家庭管理员才能回收成员");
- }
- FamilyMember member = familyMemberMapper.selectById(memberId);
- if (member == null) {
- throw new RuntimeException("成员不存在");
- }
- if (!"recycled".equals(member.getStatus())) {
- throw new RuntimeException("该成员不在回收箱中");
- }
- // 迁移资产到目标家庭
- Long oldFamilyId = member.getFamilyId();
- migrateMemberAssets(member, oldFamilyId, targetFamilyId);
- member.setFamilyId(targetFamilyId);
- member.setStatus("active");
- member.setUpdatedAt(new Date());
- familyMemberMapper.updateById(member);
- // 关联用户重新归属目标家庭
- if (member.getUserId() != null) {
- User targetUser = userMapper.selectById(member.getUserId());
- if (targetUser != null) {
- targetUser.setFamilyId(targetFamilyId);
- targetUser.setUpdatedAt(new Date());
- userMapper.updateById(targetUser);
- }
- }
- logMemberAction(targetFamilyId, memberId, "recycle", null, member.getNickname(), operatorUserId);
- // 方案B:回收成员后,重新核算目标家庭会员身份
- membershipService.reconcileFamilyMembership(targetFamilyId);
- }
- /**
- * 切换成员到目标家庭(被邀请走/加入新家庭场景)
- * 规则:
- * - 非微信用户禁止自主切换
- * - 家庭创建者禁止切换(需先转让管理员)
- * - CF 值(统一账本 cf_balance,成员维度)随成员带离原家庭;family_members.system_points 仅清零只读历史残留值
- * - 迁移资产到目标家庭
- */
- @Transactional(rollbackFor = Exception.class)
- public void switchMemberToFamily(Long userId, Long targetFamilyId) {
- User user = userMapper.selectById(userId);
- if (user == null || user.getFamilyId() == null) {
- throw new RuntimeException("用户未加入家庭");
- }
- Long oldFamilyId = user.getFamilyId();
- if (oldFamilyId.equals(targetFamilyId)) {
- return;
- }
- Family oldFamily = familyMapper.selectById(oldFamilyId);
- if (oldFamily != null && Long.valueOf(userId).equals(oldFamily.getCreatorId())) {
- // 创建者离开须先转让管理员(防原家庭无主);但原家庭仅剩创建者一人时,
- // 离开后家庭无人,不存在无主问题,无需转让,直接允许切换
- Long otherMemberCount = familyMemberMapper.selectCount(
- new LambdaQueryWrapper<FamilyMember>()
- .eq(FamilyMember::getFamilyId, oldFamilyId)
- .ne(FamilyMember::getUserId, userId)
- .ne(FamilyMember::getStatus, "recycled"));
- if (otherMemberCount != null && otherMemberCount > 0) {
- throw new RuntimeException("您是家庭创建者,请先转让管理员权限后再切换家庭");
- }
- }
- if (!isWechatUser(user)) {
- throw new RuntimeException("非微信登录用户不能自主切换家庭");
- }
- FamilyMember member = familyMemberMapper.selectOne(
- new LambdaQueryWrapper<FamilyMember>()
- .eq(FamilyMember::getFamilyId, oldFamilyId)
- .eq(FamilyMember::getUserId, userId)
- .last("LIMIT 1"));
- if (member == null) {
- // 兼容历史孤儿数据:users.family_id 指向旧家庭但 family_members 无该用户成员记录
- // (早期创建家庭路径漏建创建者成员记录)。旧家庭无能量值资产(按 member_id 关联必然无),
- // 健康报告按 user_id 关联可能残留,先尝试迁移;再在目标家庭补建成员记录,后续流程自然兼容。
- try {
- List<HealthReport> orphanReports = healthReportMapper.selectList(
- new LambdaQueryWrapper<HealthReport>()
- .eq(HealthReport::getFamilyId, oldFamilyId)
- .and(w -> w.eq(HealthReport::getUserId, userId)
- .or().eq(HealthReport::getSubjectId, userId)));
- for (HealthReport r : orphanReports) {
- r.setFamilyId(targetFamilyId);
- healthReportMapper.updateById(r);
- }
- } catch (Exception e) {
- log.warn("孤儿成员健康报告迁移异常: userId={}, oldFamilyId={}", userId, oldFamilyId, e);
- }
- FamilyMember newMember = new FamilyMember();
- newMember.setFamilyId(targetFamilyId);
- newMember.setUserId(userId);
- newMember.setNickname((user.getNickname() != null && !user.getNickname().isEmpty())
- ? user.getNickname() : ("用户" + userId));
- newMember.setPhone(user.getPhone());
- newMember.setAvatar(user.getAvatar());
- newMember.setGender(user.getGender());
- newMember.setGeneration(0);
- newMember.setTotalPoints(0);
- newMember.setSystemPoints(0);
- newMember.setStatus("active");
- newMember.setCreatedAt(new Date());
- newMember.setUpdatedAt(new Date());
- familyMemberMapper.insert(newMember);
- member = newMember;
- log.warn("成员记录缺失,已在目标家庭补建: userId={}, oldFamilyId={}, targetFamilyId={}, memberId={}",
- userId, oldFamilyId, targetFamilyId, member.getId());
- }
- // family_members.system_points 为只读历史字段:清零残留值(CF 值在统一账本 cf_balance,成员维度,随成员走)
- member.setSystemPoints(0);
- member.setUpdatedAt(new Date());
- // 清理关系记录
- familyRelationshipService.deleteRelationsForMember(member.getId());
- // 迁移资产到目标家庭
- migrateMemberAssets(member, oldFamilyId, targetFamilyId);
- member.setFamilyId(targetFamilyId);
- member.setStatus("active");
- familyMemberMapper.updateById(member);
- // 原家庭是付费会员时,将会员权益合并到邀请人家庭
- try {
- membershipService.mergeMembershipToTargetFamily(oldFamilyId, targetFamilyId);
- } catch (Exception e) {
- log.warn("合并会员权益异常: oldFamilyId={}, targetFamilyId={}", oldFamilyId, targetFamilyId, e);
- }
- user.setFamilyId(targetFamilyId);
- user.setUpdatedAt(new Date());
- userMapper.updateById(user);
- // 方案B:切换家庭后,重新核算新旧家庭的会员身份
- membershipService.reconcileFamilyMembership(targetFamilyId);
- membershipService.reconcileFamilyMembership(oldFamilyId);
- // 方案B补充:剥离切换成员本人从原家庭继承的会员身份(reconcileFamilyMembership 只处理仍留在原家庭的成员)
- membershipService.reconcileLeavingMemberMembership(userId, oldFamilyId, targetFamilyId);
- // T28补充:切换家庭后刷新新旧家庭食材总览(该成员指数计入目标家庭、不再计入原家庭)
- refreshFoodOverviewQuietly(oldFamilyId);
- refreshFoodOverviewQuietly(targetFamilyId);
- logMemberAction(oldFamilyId, member.getId(), "switch", member.getNickname(), null, userId);
- }
- /**
- * 迁移成员资产到目标家庭:
- * - five_dimension_scores(能量值):改 family_id
- * - health_reports(健康报告):改 family_id
- * - dan_assessment_results(测评):以 familyMemberId 关联,改 family_members.family_id 后自动跟随,无需迁移
- * - family_member_attributes(属性):以 memberId 关联,自动跟随
- * - family_relationships(关系):删旧建新(新家庭关系需重新计算)
- * - tasks(任务):按 family_member_id / executor_id 迁移到目标家庭
- */
- private void migrateMemberAssets(FamilyMember member, Long oldFamilyId, Long targetFamilyId) {
- if (oldFamilyId.equals(targetFamilyId)) {
- return;
- }
- Long memberId = member.getId();
- // 能量值
- try {
- List<FiveDimensionScore> scores = fiveDimensionScoreMapper.selectList(
- new LambdaQueryWrapper<FiveDimensionScore>()
- .eq(FiveDimensionScore::getFamilyId, oldFamilyId)
- .eq(FiveDimensionScore::getMemberId, memberId));
- for (FiveDimensionScore s : scores) {
- s.setFamilyId(targetFamilyId);
- fiveDimensionScoreMapper.updateById(s);
- }
- } catch (Exception e) {
- log.warn("迁移能量值异常: memberId={}", memberId, e);
- }
- // 健康报告(A方案:按 subject_id=memberId 关联迁移,members.id 不变则报告自动跟随;
- // 兼容历史 subject_id=users.id 的报告一并迁移,保持 family_id 与成员所在家庭一致)
- try {
- List<HealthReport> reports = healthReportMapper.selectList(
- new LambdaQueryWrapper<HealthReport>()
- .eq(HealthReport::getFamilyId, oldFamilyId)
- .and(w -> w.eq(HealthReport::getSubjectId, memberId)
- .or(w2 -> w2.isNull(HealthReport::getSubjectId)
- .eq(HealthReport::getUserId, member.getUserId()))));
- for (HealthReport r : reports) {
- r.setFamilyId(targetFamilyId);
- healthReportMapper.updateById(r);
- }
- } catch (Exception e) {
- log.warn("迁移健康报告异常: memberId={}", memberId, e);
- }
- // 任务(育儿/健康任务):随成员切换到目标家庭(按 family_member_id 或 executor_id 匹配,
- // 兼容 child 任务(executor=成员卡id)与 parent 任务(executor=用户id)两种口径)
- try {
- List<Task> memberTasks = taskMapper.selectList(
- new LambdaQueryWrapper<Task>()
- .eq(Task::getFamilyId, oldFamilyId)
- .and(w -> w.eq(Task::getFamilyMemberId, memberId)
- .or().eq(Task::getExecutorId, memberId)
- .or().eq(Task::getExecutorId, member.getUserId())));
- int moved = 0;
- for (Task t : memberTasks) {
- t.setFamilyId(targetFamilyId);
- moved += taskMapper.updateById(t);
- }
- if (moved > 0) {
- log.info("切换家庭任务迁移: memberId={}, oldFamilyId={}, targetFamilyId={}, tasks={}",
- memberId, oldFamilyId, targetFamilyId, moved);
- }
- } catch (Exception e) {
- log.warn("迁移任务异常: memberId={}", memberId, e);
- }
- }
- /**
- * 判断用户是否为微信登录用户(openid 为真实微信 openid,而非 "phone:" 前缀)
- */
- private boolean isWechatUser(User user) {
- if (user == null || user.getOpenid() == null) {
- return false;
- }
- return !user.getOpenid().startsWith("phone:");
- }
- /**
- * 为用户创建新家庭(不含成员记录——调用方随后会迁移原 family_members 记录过来,避免重复)
- */
- private Long createFamilyForUser(User user) {
- Family family = new Family();
- family.setName(FamilyNamingSupport.buildFamilyName(user));
- family.setInviteCode(generateInviteCode());
- family.setCreatorId(user.getId());
- family.setCreatedAt(new Date());
- family.setUpdatedAt(new Date());
- familyMapper.insert(family);
- return family.getId();
- }
- private String generateInviteCode() {
- String chars = "ABCDEFGHJKLMNPQRSTUVWXYZ23456789";
- StringBuilder sb = new StringBuilder();
- java.util.Random random = new java.util.Random();
- for (int i = 0; i < 6; i++) {
- sb.append(chars.charAt(random.nextInt(chars.length())));
- }
- return sb.toString();
- }
- /**
- * 查找用户自己创建的家庭ID(families.creator_id = userId),不存在返回 null
- */
- private Long findOwnFamilyId(Long userId) {
- try {
- Family own = familyMapper.selectOne(
- new LambdaQueryWrapper<Family>().eq(Family::getCreatorId, userId).last("LIMIT 1"));
- return own != null ? own.getId() : null;
- } catch (Exception e) {
- log.warn("查找用户创建的家庭异常: userId={}", userId, e);
- return null;
- }
- }
- /**
- * 判断成员是否可编辑
- * 规则:有关联 userId 或有 phone 且 phone 能匹配到 User 的成员不可编辑
- */
- public boolean isEditable(Long memberId) {
- FamilyMember member = familyMemberMapper.selectById(memberId);
- if (member == null) return false;
- if (member.getUserId() != null) return false;
- if (member.getPhone() != null && !member.getPhone().isEmpty()) {
- User linked = userMapper.selectOne(
- new LambdaQueryWrapper<User>().eq(User::getPhone, member.getPhone()));
- if (linked != null) return false;
- }
- return true;
- }
- /**
- * 更新成员信息:管理员可编辑所有成员(含关联账号的),普通用户仅可编辑不可登录成员
- */
- @Transactional(rollbackFor = Exception.class)
- public FamilyMemberVO updateMember(Long userId, Long memberId, AddFamilyMemberDTO dto) {
- User user = userMapper.selectById(userId);
- if (user == null || user.getFamilyId() == null) {
- throw new RuntimeException("用户未加入家庭");
- }
- FamilyMember member = familyMemberMapper.selectById(memberId);
- if (member != null && !member.getFamilyId().equals(user.getFamilyId())) {
- throw new RuntimeException("成员不存在或不属于您的家庭");
- }
- // 家庭主账号(users 表成员)在 family_members 表无记录,走家庭主账号更新分支
- if (member == null) {
- return updateParentMember(user, memberId, dto);
- }
- // 检查编辑权限:管理员(family_members.is_admin=1 或家庭创建者)可编辑所有成员;
- // 普通用户只能编辑无关联账号的成员
- boolean isAdmin = isFamilyAdminOperator(userId, user.getFamilyId());
- if (!isAdmin && !isEditable(memberId)) {
- throw new RuntimeException("该成员关联了登录账号,不可编辑");
- }
- // 管理员设置(多管理员):仅管理员可操作;取消管理员时家庭至少保留一名
- if (dto.getIsAdmin() != null) {
- if (!isAdmin) {
- throw new RuntimeException("仅家庭管理员可设置管理员");
- }
- int newAdminVal = dto.getIsAdmin() == 1 ? 1 : 0;
- boolean targetIsAdmin = member.getIsAdmin() != null && member.getIsAdmin() == 1;
- if (newAdminVal == 0 && targetIsAdmin) {
- Long adminCount = familyMemberMapper.selectCount(new LambdaQueryWrapper<FamilyMember>()
- .eq(FamilyMember::getFamilyId, user.getFamilyId())
- .eq(FamilyMember::getIsAdmin, 1));
- if (adminCount != null && adminCount <= 1) {
- throw new RuntimeException("家庭至少需要保留一名管理员");
- }
- }
- member.setIsAdmin(newAdminVal);
- }
- String oldNickname = member.getNickname();
- if (dto.getNickname() != null && !dto.getNickname().trim().isEmpty()) {
- member.setNickname(dto.getNickname().trim());
- }
- if (dto.getPhone() != null) {
- member.setPhone(dto.getPhone());
- }
- if (dto.getAvatar() != null) {
- member.setAvatar(dto.getAvatar());
- }
- if (dto.getGender() != null) {
- member.setGender(dto.getGender());
- }
- if (dto.getBirthday() != null) {
- try {
- java.text.SimpleDateFormat sdf = new java.text.SimpleDateFormat("yyyy-MM-dd");
- member.setBirthday(sdf.parse(dto.getBirthday()));
- } catch (java.text.ParseException e) {
- throw new IllegalArgumentException("出生日期格式错误,应为yyyy-MM-dd");
- }
- }
- // 管理员可更新辈分关系
- boolean identityChanged = false;
- String rebuildPeerType = null;
- if (isAdmin && dto.getGenerationLevel() != null && !dto.getGenerationLevel().trim().isEmpty()) {
- GenerationLevel genLevel = GenerationLevel.fromValue(dto.getGenerationLevel());
- if (genLevel != null) {
- // 本人自编辑不设「配偶」:关系是相对的,配偶只能由对方(或管理员代设)指定,
- // 自己给自己标配偶会产生「我与我配偶」的歧义关系行。
- boolean selfEdit = member.getUserId() != null && member.getUserId().equals(userId);
- member.setGeneration(genLevel.getOffset());
- boolean isSpouse = genLevel == GenerationLevel.PEER
- && "spouse".equals(dto.getPeerType()) && !selfEdit;
- member.setIsSpouse(isSpouse);
- identityChanged = true;
- rebuildPeerType = genLevel == GenerationLevel.PEER
- ? (isSpouse ? "spouse" : "sibling")
- : null;
- }
- }
- // 孩子身份标记(仅家庭管理员可设置;落库到 users 表对应记录)
- applyIsChildFlag(userId, user.getFamilyId(), member.getUserId(), dto.getIsChild());
- member.setUpdatedAt(new Date());
- familyMemberMapper.updateById(member);
- // 辈分/同辈类型变更后重建关系表:成员列表的关系标签优先读 family_relationships,
- // 不重建会出现「编辑资料改了身份、列表标签不刷新」(规格 §10 R-4)。
- // 锚点=操作者(编辑人)成员记录:管理员给某成员选「配偶」时,指 TA 与操作者是配偶;
- // 本人自编辑时锚点为 null(不写 spouse)。
- if (identityChanged) {
- Long anchorMemberId = null;
- boolean selfEdit = member.getUserId() != null && member.getUserId().equals(userId);
- if (!selfEdit) {
- FamilyMember operator = familyMemberMapper.selectOne(new LambdaQueryWrapper<FamilyMember>()
- .eq(FamilyMember::getFamilyId, member.getFamilyId())
- .eq(FamilyMember::getUserId, userId)
- .last("LIMIT 1"));
- anchorMemberId = operator != null ? operator.getId() : null;
- }
- try {
- familyRelationshipService.rebuildRelationsForMember(
- member.getFamilyId(), member.getId(), member.getGeneration(), rebuildPeerType, anchorMemberId);
- } catch (RuntimeException e) {
- // 重建失败必须整体回滚:否则辈分已改而关系未重建,正是 R-4 要消除的不一致状态
- log.error("重建成员关系失败,回滚本次资料更新: memberId={}, error={}", member.getId(), e.getMessage());
- throw e;
- }
- }
- logMemberAction(member.getFamilyId(), member.getId(), "update", oldNickname, member.getNickname(), userId);
- return toFamilyMemberVO(member);
- }
- /**
- * 判断用户是否为家庭管理员(多管理员):家庭创建者,或其成员记录 is_admin=1。
- */
- private boolean isFamilyAdminOperator(Long userId, Long familyId) {
- if (userId == null || familyId == null) return false;
- Family family = familyMapper.selectById(familyId);
- if (family != null && family.getCreatorId() != null && Long.valueOf(userId).equals(family.getCreatorId())) {
- return true;
- }
- try {
- Long c = familyMemberMapper.selectCount(new LambdaQueryWrapper<FamilyMember>()
- .eq(FamilyMember::getFamilyId, familyId)
- .eq(FamilyMember::getUserId, userId)
- .eq(FamilyMember::getIsAdmin, 1));
- return c != null && c > 0;
- } catch (Exception e) {
- return false;
- }
- }
- /**
- * 设置成员的孩子身份标记(users.is_child),落库到对应的 User 记录。
- *
- * <p>权限:仅家庭管理员可操作(复用 {@link ReportMemberPermissionService#isFamilyAdmin});
- * 非管理员抛出 {@link AccessDeniedException},由 controller 层转为 403。</p>
- *
- * @param operatorUserId 操作者 userId
- * @param familyId 操作者所属家庭(目标成员必须同属该家庭)
- * @param targetUserId 目标成员关联的 userId(family_members.user_id;家庭主账号场景即主账号 userId;null=无关联账号无法设置)
- * @param isChild 期望值: 1=孩子, 0=非孩子;null=不修改
- */
- void applyIsChildFlag(Long operatorUserId, Long familyId, Long targetUserId, Integer isChild) {
- if (isChild == null) {
- return;
- }
- if (!reportMemberPermissionService.isFamilyAdmin(operatorUserId, familyId)) {
- throw new AccessDeniedException("仅家庭管理员可设置孩子身份");
- }
- if (targetUserId == null) {
- throw new RuntimeException("该成员未关联登录账号,无法设置孩子身份");
- }
- User target = userMapper.selectById(targetUserId);
- if (target == null || familyId == null || !familyId.equals(target.getFamilyId())) {
- throw new RuntimeException("成员不存在或不属于您的家庭");
- }
- target.setIsChild(isChild == 1);
- target.setUpdatedAt(new Date());
- userMapper.updateById(target);
- log.info("已设置成员孩子身份: userId={}, isChild={}, 操作者={}", targetUserId, isChild, operatorUserId);
- }
- /**
- * 修改家庭名称(仅家庭管理员:家庭创建者或成员记录 is_admin=1)。
- * 返回更新后的家庭名称。
- */
- public String renameFamily(Long userId, String name) {
- if (userId == null || userId <= 0) {
- throw new IllegalArgumentException("请先登录");
- }
- String newName = name == null ? "" : name.trim();
- if (newName.isEmpty()) {
- throw new IllegalArgumentException("家庭名称不能为空");
- }
- if (newName.length() > 20) {
- throw new IllegalArgumentException("家庭名称不能超过20个字");
- }
- User operator = userMapper.selectById(userId);
- if (operator == null) {
- throw new IllegalArgumentException("用户不存在");
- }
- Long familyId = operator.getFamilyId();
- if (familyId == null) {
- throw new IllegalArgumentException("请先创建或加入家庭");
- }
- if (!isFamilyAdminOperator(userId, familyId)) {
- throw new IllegalArgumentException("仅家庭管理员可修改家庭名称");
- }
- Family family = familyMapper.selectById(familyId);
- if (family == null) {
- throw new IllegalArgumentException("家庭不存在");
- }
- family.setName(newName);
- family.setUpdatedAt(new Date());
- familyMapper.updateById(family);
- return newName;
- }
- /**
- * 更新家庭主账号(users 表成员)的基本资料。
- * 家庭主账号只存在于 users 表(family_id + role=parent),无 family_members 记录,
- * 因此编辑昵称/性别/生日/头像/手机号直接写 users 表;辈分关系仅 family_members 成员支持。
- */
- private FamilyMemberVO updateParentMember(User operator, Long memberId, AddFamilyMemberDTO dto) {
- Family family = familyMapper.selectById(operator.getFamilyId());
- boolean isAdmin = family != null && Long.valueOf(operator.getId()).equals(family.getCreatorId());
- if (!isAdmin) {
- throw new RuntimeException("仅家庭创建者可编辑该成员");
- }
- if (dto.getIsAdmin() != null) {
- throw new RuntimeException("该成员为家庭主账号,不支持设置管理员,请对家庭成员记录操作");
- }
- User parent = userMapper.selectById(memberId);
- if (parent == null
- || parent.getFamilyId() == null
- || !parent.getFamilyId().equals(operator.getFamilyId())
- || !"parent".equals(parent.getRole())) {
- throw new RuntimeException("成员不存在或不属于您的家庭");
- }
- String oldNickname = parent.getNickname();
- if (dto.getNickname() != null && !dto.getNickname().trim().isEmpty()) {
- parent.setNickname(dto.getNickname().trim());
- }
- if (dto.getPhone() != null) {
- parent.setPhone(dto.getPhone());
- }
- if (dto.getAvatar() != null) {
- parent.setAvatar(dto.getAvatar());
- }
- if (dto.getGender() != null) {
- parent.setGender(dto.getGender());
- }
- if (dto.getBirthday() != null) {
- try {
- java.text.SimpleDateFormat sdf = new java.text.SimpleDateFormat("yyyy-MM-dd");
- parent.setBirthday(sdf.parse(dto.getBirthday()));
- } catch (java.text.ParseException e) {
- throw new IllegalArgumentException("出生日期格式错误,应为yyyy-MM-dd");
- }
- }
- // 孩子身份标记(仅家庭管理员可设置;主账号即 memberId 对应的 User 记录)
- applyIsChildFlag(operator.getId(), operator.getFamilyId(), memberId, dto.getIsChild());
- parent.setUpdatedAt(new Date());
- userMapper.updateById(parent);
- logMemberAction(parent.getFamilyId(), parent.getId(), "update", oldNickname, parent.getNickname(), operator.getId());
- // 返回与成员列表一致的 VO
- FamilyMemberVO vo = new FamilyMemberVO();
- vo.setId(parent.getId());
- vo.setMemberId(parent.getId());
- vo.setSource("parent");
- vo.setMemberType("parent");
- vo.setUserId(parent.getId());
- vo.setNickname(parent.getNickname());
- vo.setName(parent.getNickname());
- vo.setAvatar(parent.getAvatar());
- vo.setPhone(parent.getPhone());
- vo.setGender(parent.getGender());
- vo.setEffectiveRole("parent");
- vo.setRoleLabel(parent.getFamilyRole() != null ? parent.getFamilyRole() : "本人");
- if (parent.getBirthday() != null) {
- vo.setAge(calculateAge(parent.getBirthday()));
- }
- vo.setGeneration(0);
- vo.setIsAdmin(true);
- vo.setIsSelf(parent.getId().equals(operator.getId()));
- // 家庭主账号均为可登录用户,不允许切换视角(与成员段"仅不可登录可切换"一致)
- vo.setIsSwitchable(false); // source='parent' 段(updateParentMember 返回 VO)
- vo.setShowToFamily(parent.getShowToFamily() != null ? parent.getShowToFamily() : 1);
- vo.setIsSpouse(false);
- vo.setTotalPoints(parent.getTotalPoints());
- return vo;
- }
- // ===== 内部方法 =====
- /**
- * T24-C:成员状态优先级排名(供重复行选"主成员"使用,与 JwtInterceptor 解析口径一致):
- * active=0 最优先,其余状态(如 invited/pending)=1,recycled=2 最次。
- */
- private static int statusRank(String status) {
- if ("active".equals(status)) return 0;
- if ("recycled".equals(status)) return 2;
- return 1;
- }
- /**
- * 解析成员显示名:优先关联 users 表的 nickname,其次 family_members.nickname。
- * 同一人可能同时存在于两表(创建者/受邀登录成员),getVisibleMembers 家庭主账号段显示的正是 users.nickname,
- * 此处统一口径,避免「我的家庭」与成员管理页名称不一致。
- */
- private String resolveMemberNickname(FamilyMember fm) {
- if (fm.getUserId() != null) {
- User u = userMapper.selectById(fm.getUserId());
- if (u != null && u.getNickname() != null && !u.getNickname().trim().isEmpty()) {
- return u.getNickname();
- }
- }
- return fm.getNickname();
- }
- private FamilyMemberVO toFamilyMemberVO(FamilyMember member) {
- FamilyMemberVO vo = new FamilyMemberVO();
- vo.setId(member.getId());
- vo.setSource("family_member");
- vo.setUserId(member.getUserId());
- vo.setNickname(resolveMemberNickname(member));
- vo.setPhone(member.getPhone());
- vo.setAvatar(member.getAvatar());
- vo.setGender(member.getGender());
- vo.setGeneration(member.getGeneration());
- vo.setEffectiveRole(computeEffectiveRole(member));
- vo.setRoleLabel(computeEffectiveRole(member));
- vo.setTotalPoints(member.getTotalPoints());
- vo.setShowToFamily(member.getShowToFamily());
- if (member.getBirthday() != null) {
- vo.setAge(calculateAge(member.getBirthday()));
- vo.setBirthday(formatDate(member.getBirthday()));
- }
- // 设置 isSwitchable:仅无 openid 的不可登录成员可被切换(可登录成员不允许切换视角)
- if (member.getUserId() != null) {
- User memberUser = userMapper.selectById(member.getUserId());
- String openid = memberUser != null ? memberUser.getOpenid() : null;
- vo.setIsSwitchable(openid == null || openid.isEmpty());
- } else {
- vo.setIsSwitchable(true);
- }
- // SC-P-04 family.familyMembers.list:在线状态(口径 = lastInteractionAt 最后互动时间)
- vo.setLastActiveAt(member.getLastInteractionAt());
- vo.setOnline(member.getLastInteractionAt() != null
- && (System.currentTimeMillis() - member.getLastInteractionAt().getTime()) < ONLINE_WINDOW_MS);
- return vo;
- }
- private Integer calculateAge(java.util.Date birthday) {
- if (birthday == null) return null;
- java.util.Calendar birth = java.util.Calendar.getInstance();
- birth.setTime(birthday);
- java.util.Calendar now = java.util.Calendar.getInstance();
- int age = now.get(java.util.Calendar.YEAR) - birth.get(java.util.Calendar.YEAR);
- if (now.get(java.util.Calendar.MONTH) < birth.get(java.util.Calendar.MONTH) ||
- (now.get(java.util.Calendar.MONTH) == birth.get(java.util.Calendar.MONTH) &&
- now.get(java.util.Calendar.DAY_OF_MONTH) < birth.get(java.util.Calendar.DAY_OF_MONTH))) {
- age--;
- }
- return Math.max(0, age);
- }
- /** 格式化为 yyyy-MM-dd(前端编辑回显用),返回 null 时不修改 */
- private String formatDate(java.util.Date d) {
- if (d == null) return null;
- try {
- java.text.SimpleDateFormat sdf = new java.text.SimpleDateFormat("yyyy-MM-dd");
- return sdf.format(d);
- } catch (Exception e) {
- return null;
- }
- }
- /**
- * 计算成员的实际角色(effective role)
- * 优先使用年龄判定(birthday → age < childThreshold → child),
- * 无生日数据时回退到 generation 判定
- */
- private String computeEffectiveRole(FamilyMember member) {
- // 优先按年龄判定(生日优先于 generation)
- if (member.getBirthday() != null) {
- int age = calculateAge(member.getBirthday());
- int childThreshold = systemConfigService.getChildAgeThreshold();
- return age < childThreshold ? "child" : "parent";
- }
- // 无生日数据:按 generation 回退(generation >= 0 = parent, < 0 = child)
- if (member.getGeneration() != null) {
- return member.getGeneration() >= 0 ? "parent" : "child";
- }
- // 无 birthday 无 generation:不可登录成员(userId=null,家庭代管的"孩子")默认归为孩子上下文,
- // 保证 SC-P-73「选孩子 → 任务/报告/方案按孩子上下文隔离」;可登录成员无基础数据按 parent 兜底
- if (member.getUserId() == null) {
- return "child";
- }
- return "parent";
- }
- /**
- * 计算视角相关的关系标签(基于 generation 差值)
- * - generation diff > 0: 长辈
- * - generation diff < 0: 晚辈
- * - generation diff = 0: 同辈(配偶/兄弟姐妹)
- */
- private String computeRelativeLabel(FamilyMember viewer, FamilyMember target, List<FamilyMember> allMembers) {
- if (viewer.getId().equals(target.getId())) {
- return "我";
- }
- // 优先使用 generation diff
- if (viewer.getGeneration() != null && target.getGeneration() != null) {
- int genDiff = target.getGeneration() - viewer.getGeneration();
- boolean isSpouse = Boolean.TRUE.equals(target.getIsSpouse());
- String targetGender = target.getGender();
- switch (genDiff) {
- case 0:
- if (isSpouse) {
- return "male".equals(targetGender) ? "丈夫" : "妻子";
- }
- return computeSiblingLabel(viewer, target);
- case 1:
- return "male".equals(targetGender) ? "爸爸" : "妈妈";
- case -1:
- return computeParentChildLabel(viewer, target, allMembers);
- case 2:
- return "male".equals(targetGender) ? "爷爷" : "奶奶";
- case -2:
- return "male".equals(targetGender) ? "孙子" : "孙女";
- case 3:
- return "male".equals(targetGender) ? "曾祖父" : "曾祖母";
- case -3:
- return "male".equals(targetGender) ? "曾孙" : "曾孙女";
- default:
- return genDiff > 0 ? "长辈" : "晚辈";
- }
- }
- // 无 generation 时的 fallback(旧数据兼容)
- String viewerRole = computeEffectiveRole(viewer);
- String targetRole = computeEffectiveRole(target);
- String targetGender = target.getGender();
- // parent → child
- if ("parent".equals(viewerRole) && "child".equals(targetRole)) {
- return computeParentChildLabel(viewer, target, allMembers);
- }
- // child → parent
- if ("child".equals(viewerRole) && "parent".equals(targetRole)) {
- return "male".equals(targetGender) ? "父亲" : "母亲";
- }
- // child → child (sibling)
- if ("child".equals(viewerRole) && "child".equals(targetRole)) {
- return computeSiblingLabel(viewer, target);
- }
- // parent → parent (partner)
- if ("parent".equals(viewerRole) && "parent".equals(targetRole)) {
- return "male".equals(targetGender) ? "丈夫" : "妻子";
- }
- return null;
- }
- /**
- * 计算父母视角下的子女标签(含序数)
- */
- private String computeParentChildLabel(FamilyMember viewer, FamilyMember target, List<FamilyMember> allMembers) {
- String targetGender = target.getGender();
- // 收集所有家庭成员,按 generation 降序(辈分越高,年龄越大)或生日排序
- List<FamilyMember> children = allMembers.stream()
- .filter(m -> !m.getId().equals(viewer.getId()))
- .filter(m -> {
- if (viewer.getGeneration() != null && m.getGeneration() != null) {
- return m.getGeneration() < viewer.getGeneration();
- }
- return "child".equals(computeEffectiveRole(m));
- })
- .sorted(Comparator.comparing(FamilyMember::getBirthday, Comparator.nullsLast(Comparator.naturalOrder())))
- .collect(Collectors.toList());
- // 长幼排行按同性别子集计算(长子/次子/长女/次女...),避免与异性别成员混排导致序数错误。
- List<FamilyMember> rankedPool = children;
- if ("male".equals(targetGender) || "female".equals(targetGender)) {
- rankedPool = children.stream()
- .filter(m -> targetGender.equals(m.getGender()))
- .collect(Collectors.toList());
- }
- int index = -1;
- for (int i = 0; i < rankedPool.size(); i++) {
- if (rankedPool.get(i).getId().equals(target.getId())) {
- index = i;
- break;
- }
- }
- if (children.size() <= 1 || index < 0) {
- if ("male".equals(targetGender)) return "儿子";
- if ("female".equals(targetGender)) return "女儿";
- return "子女";
- }
- String[] ordinals = {"长", "次", "三", "四", "五", "六", "七", "八", "九", "十"};
- String prefix = (index < ordinals.length) ? ordinals[index] : ("第" + (index + 1));
- if ("male".equals(targetGender)) return prefix + "子";
- if ("female".equals(targetGender)) return prefix + "女";
- return prefix + "子女";
- }
- /**
- * 选择视角相关的关系标签。
- * 优先级:动态长幼计算 > family_relationships 粗辈分标签(genValue 兜底)。
- * 动态计算能表达"长子/次女/哥哥/姐姐"等精确排行,优先于只能表达"兄弟/姐妹"的粗标签。
- */
- String resolveRelativeLabel(FamilyMember viewer, FamilyMember target, List<FamilyMember> allMembers, Integer relGenValue, String relType) {
- // 动态长幼计算优先(能表达"长子/次女/哥哥/姐姐"等精确排行);
- // family_relationships 粗辈分标签(genValue+relType) 仅作兜底(只能表达"兄弟/姐妹/丈夫/妻子")。
- String dynamic = computeRelativeLabel(viewer, target, allMembers);
- if (dynamic != null) return dynamic;
- if (relGenValue != null && familyRelationshipService != null) {
- return familyRelationshipService.computeRelationshipLabel(relGenValue, target.getGender(), relType);
- }
- return null;
- }
- /**
- * 计算兄弟姐妹标签(按生日比较)
- */
- private String computeSiblingLabel(FamilyMember viewer, FamilyMember target) {
- String targetGender = target.getGender();
- Date viewerBday = viewer.getBirthday();
- Date targetBday = target.getBirthday();
- if (viewerBday != null && targetBday != null) {
- int cmp = viewerBday.compareTo(targetBday);
- if (cmp < 0) {
- // viewer 比 target 更大(更早出生) → target 是弟弟/妹妹
- return "male".equals(targetGender) ? "弟弟" : "妹妹";
- } else if (cmp > 0) {
- // viewer 比 target 更小(更晚出生) → target 是哥哥/姐姐
- return "male".equals(targetGender) ? "哥哥" : "姐姐";
- }
- }
- // 同龄或无法比较
- return "male".equals(targetGender) ? "哥哥" : "姐姐";
- }
- private void logMemberAction(Long familyId, Long memberId, String action, String oldValue, String newValue, Long operatorId) {
- try {
- FamilyMemberLog logEntry = new FamilyMemberLog();
- logEntry.setFamilyId(familyId);
- logEntry.setMemberId(memberId);
- logEntry.setAction(action);
- logEntry.setOldValue(oldValue);
- logEntry.setNewValue(newValue);
- logEntry.setOperatorId(operatorId);
- logEntry.setCreatedAt(new Date());
- familyMemberLogMapper.insert(logEntry);
- } catch (Exception e) {
- log.warn("写入家庭成员日志失败: {}", e.getMessage());
- }
- }
- public Result<List<FamilyMemberLog>> getMemberLogs(Long userId, Long memberId) {
- User user = userMapper.selectById(userId);
- if (user == null || user.getFamilyId() == null) {
- return Result.error("用户未加入家庭");
- }
- Long familyId = user.getFamilyId();
- LambdaQueryWrapper<FamilyMemberLog> query = new LambdaQueryWrapper<FamilyMemberLog>()
- .eq(FamilyMemberLog::getFamilyId, familyId)
- .orderByDesc(FamilyMemberLog::getCreatedAt);
- if (memberId != null) {
- query.eq(FamilyMemberLog::getMemberId, memberId);
- }
- SortUtil.applySort(query);
- List<FamilyMemberLog> logs = familyMemberLogMapper.selectList(query);
- return Result.success(logs);
- }
- public boolean isCallerInSameFamily(Long familyMemberId, Long callerUserId) {
- if (familyMemberId == null || callerUserId == null) return false;
- FamilyMember member = familyMemberMapper.selectById(familyMemberId);
- if (member == null) return false;
- long familyId = member.getFamilyId();
- long count = familyMemberMapper.selectCount(
- new LambdaQueryWrapper<FamilyMember>()
- .eq(FamilyMember::getFamilyId, familyId)
- .eq(FamilyMember::getUserId, callerUserId)
- .last("LIMIT 1"));
- return count > 0;
- }
- public boolean isCallerInFamily(Long familyId, Long callerUserId) {
- if (familyId == null || callerUserId == null) return false;
- long count = familyMemberMapper.selectCount(
- new LambdaQueryWrapper<FamilyMember>()
- .eq(FamilyMember::getFamilyId, familyId)
- .eq(FamilyMember::getUserId, callerUserId)
- .last("LIMIT 1"));
- return count > 0;
- }
- /**
- * 获取家庭成员列表(含家庭信息),兼容旧接口 /api/family/user/family-members 的 Map 返回结构。
- * 返回: { familyId, familyName, inviteCode, creatorId, members[] }
- * members 为富化的 FamilyMemberVO 列表(含 roleLabel/trustScore 等展示字段),已含家庭主账号段与成员段全量,
- * 供前端单次调用 /api/family/member/list?includeFamily=true 同时获取成员与家庭信息,避免重复请求。
- */
- public Map<String, Object> listMembersWithFamily(Long userId) {
- Map<String, Object> result = new java.util.HashMap<>();
- User user = userMapper.selectById(userId);
- if (user == null) {
- return result;
- }
- Long familyId = user.getFamilyId();
- if (familyId == null) {
- return result;
- }
- Family family = familyMapper.selectById(familyId);
- if (family == null) {
- return result;
- }
- result.put("familyId", familyId);
- result.put("familyName", family.getName());
- result.put("inviteCode", family.getInviteCode());
- result.put("creatorId", family.getCreatorId());
- result.put("members", listMembers(userId));
- return result;
- }
- }
|