feat: 实现员工画像后端接口

新增 EmployeePortraitVO、IEmployeePortraitService、EmployeePortraitServiceImpl
和 EmployeePortraitController，提供 /score/portrait/searchUsers 和
/score/portrait/employee 两个接口，聚合用户基本信息、六维度评分、
最新考试成绩、获奖记录等数据。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

airport-admin/src/main/java/com/sundot/airport/web/controller/score/EmployeePortraitController.java

@@ -0,0 +1,31 @@
+package com.sundot.airport.web.controller.score;
+
+import com.sundot.airport.common.core.controller.BaseController;
+import com.sundot.airport.common.core.domain.AjaxResult;
+import com.sundot.airport.ledger.service.IEmployeePortraitService;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequestMapping("/score/portrait")
+public class EmployeePortraitController extends BaseController {
+
+    @Autowired
+    private IEmployeePortraitService portraitService;
+
+    @GetMapping("/searchUsers")
+    public AjaxResult searchUsers(@RequestParam(required = false, defaultValue = "") String keyword) {
+        return AjaxResult.success(portraitService.searchUsers(keyword));
+    }
+
+    @GetMapping("/employee")
+    public AjaxResult getEmployee(
+            @RequestParam String personName,
+            @RequestParam(required = false) String beginTime,
+            @RequestParam(required = false) String endTime) {
+        return AjaxResult.success(portraitService.getPortrait(personName, beginTime, endTime));
+    }
+}

airport-ledger/src/main/java/com/sundot/airport/ledger/domain/vo/EmployeePortraitVO.java

@@ -0,0 +1,191 @@
+package com.sundot.airport.ledger.domain.vo;
+
+import com.fasterxml.jackson.annotation.JsonFormat;
+
+import java.math.BigDecimal;
+import java.util.Date;
+import java.util.List;
+
+/**
+ * 员工画像聚合 VO
+ */
+public class EmployeePortraitVO {
+
+    // ── 基本信息 ──────────────────────────────────────────────────────────────
+
+    private Long userId;
+    private String personName;
+    private String avatar;
+    private String sex;
+    private String sexText;
+    private String deptName;
+    private String parentDeptName;
+    private String deptPath;
+    private String qualificationLevelText;
+    private String schooling;
+    private String politicalStatusText;
+    private String characterCharacteristics;
+    private String workingStyle;
+    private String phonenumber;
+
+    @JsonFormat(pattern = "yyyy-MM-dd")
+    private Date startWorkingDate;
+
+    @JsonFormat(pattern = "yyyy-MM-dd")
+    private Date securityCheckStartDate;
+
+    private Integer workYears;
+    private Integer securityCheckYears;
+    private String securityInspectionPosition;
+
+    // ── 综合得分 ──────────────────────────────────────────────────────────────
+
+    private BigDecimal totalScore;
+
+    // ── 六维度雷达 ────────────────────────────────────────────────────────────
+
+    private List<DimScoreItem> dimensions;
+
+    // ── 最新考试成绩 ──────────────────────────────────────────────────────────
+
+    private BigDecimal theoryScore;
+    private BigDecimal imageScore;
+    private String examCategory;
+    private String examPeriod;
+
+    @JsonFormat(pattern = "yyyy-MM-dd")
+    private Date examDate;
+
+    // ── 获奖/加分记录 ─────────────────────────────────────────────────────────
+
+    private List<AwardRecord> awards;
+
+    // ── getter / setter ───────────────────────────────────────────────────────
+
+    public Long getUserId() { return userId; }
+    public void setUserId(Long userId) { this.userId = userId; }
+
+    public String getPersonName() { return personName; }
+    public void setPersonName(String personName) { this.personName = personName; }
+
+    public String getAvatar() { return avatar; }
+    public void setAvatar(String avatar) { this.avatar = avatar; }
+
+    public String getSex() { return sex; }
+    public void setSex(String sex) { this.sex = sex; }
+
+    public String getSexText() { return sexText; }
+    public void setSexText(String sexText) { this.sexText = sexText; }
+
+    public String getDeptName() { return deptName; }
+    public void setDeptName(String deptName) { this.deptName = deptName; }
+
+    public String getParentDeptName() { return parentDeptName; }
+    public void setParentDeptName(String parentDeptName) { this.parentDeptName = parentDeptName; }
+
+    public String getDeptPath() { return deptPath; }
+    public void setDeptPath(String deptPath) { this.deptPath = deptPath; }
+
+    public String getQualificationLevelText() { return qualificationLevelText; }
+    public void setQualificationLevelText(String qualificationLevelText) { this.qualificationLevelText = qualificationLevelText; }
+
+    public String getSchooling() { return schooling; }
+    public void setSchooling(String schooling) { this.schooling = schooling; }
+
+    public String getPoliticalStatusText() { return politicalStatusText; }
+    public void setPoliticalStatusText(String politicalStatusText) { this.politicalStatusText = politicalStatusText; }
+
+    public String getCharacterCharacteristics() { return characterCharacteristics; }
+    public void setCharacterCharacteristics(String characterCharacteristics) { this.characterCharacteristics = characterCharacteristics; }
+
+    public String getWorkingStyle() { return workingStyle; }
+    public void setWorkingStyle(String workingStyle) { this.workingStyle = workingStyle; }
+
+    public String getPhonenumber() { return phonenumber; }
+    public void setPhonenumber(String phonenumber) { this.phonenumber = phonenumber; }
+
+    public Date getStartWorkingDate() { return startWorkingDate; }
+    public void setStartWorkingDate(Date startWorkingDate) { this.startWorkingDate = startWorkingDate; }
+
+    public Date getSecurityCheckStartDate() { return securityCheckStartDate; }
+    public void setSecurityCheckStartDate(Date securityCheckStartDate) { this.securityCheckStartDate = securityCheckStartDate; }
+
+    public Integer getWorkYears() { return workYears; }
+    public void setWorkYears(Integer workYears) { this.workYears = workYears; }
+
+    public Integer getSecurityCheckYears() { return securityCheckYears; }
+    public void setSecurityCheckYears(Integer securityCheckYears) { this.securityCheckYears = securityCheckYears; }
+
+    public String getSecurityInspectionPosition() { return securityInspectionPosition; }
+    public void setSecurityInspectionPosition(String securityInspectionPosition) { this.securityInspectionPosition = securityInspectionPosition; }
+
+    public BigDecimal getTotalScore() { return totalScore; }
+    public void setTotalScore(BigDecimal totalScore) { this.totalScore = totalScore; }
+
+    public List<DimScoreItem> getDimensions() { return dimensions; }
+    public void setDimensions(List<DimScoreItem> dimensions) { this.dimensions = dimensions; }
+
+    public BigDecimal getTheoryScore() { return theoryScore; }
+    public void setTheoryScore(BigDecimal theoryScore) { this.theoryScore = theoryScore; }
+
+    public BigDecimal getImageScore() { return imageScore; }
+    public void setImageScore(BigDecimal imageScore) { this.imageScore = imageScore; }
+
+    public String getExamCategory() { return examCategory; }
+    public void setExamCategory(String examCategory) { this.examCategory = examCategory; }
+
+    public String getExamPeriod() { return examPeriod; }
+    public void setExamPeriod(String examPeriod) { this.examPeriod = examPeriod; }
+
+    public Date getExamDate() { return examDate; }
+    public void setExamDate(Date examDate) { this.examDate = examDate; }
+
+    public List<AwardRecord> getAwards() { return awards; }
+    public void setAwards(List<AwardRecord> awards) { this.awards = awards; }
+
+    // ── 内部类 ────────────────────────────────────────────────────────────────
+
+    public static class DimScoreItem {
+        private String name;
+        private BigDecimal score;
+        private BigDecimal weight;
+        private BigDecimal baseScore;
+        private BigDecimal eventScore;
+
+        public String getName() { return name; }
+        public void setName(String name) { this.name = name; }
+
+        public BigDecimal getScore() { return score; }
+        public void setScore(BigDecimal score) { this.score = score; }
+
+        public BigDecimal getWeight() { return weight; }
+        public void setWeight(BigDecimal weight) { this.weight = weight; }
+
+        public BigDecimal getBaseScore() { return baseScore; }
+        public void setBaseScore(BigDecimal baseScore) { this.baseScore = baseScore; }
+
+        public BigDecimal getEventScore() { return eventScore; }
+        public void setEventScore(BigDecimal eventScore) { this.eventScore = eventScore; }
+    }
+
+    public static class AwardRecord {
+        private String type;
+        private String content;
+        private BigDecimal score;
+
+        @JsonFormat(pattern = "yyyy-MM-dd")
+        private Date date;
+
+        public String getType() { return type; }
+        public void setType(String type) { this.type = type; }
+
+        public String getContent() { return content; }
+        public void setContent(String content) { this.content = content; }
+
+        public BigDecimal getScore() { return score; }
+        public void setScore(BigDecimal score) { this.score = score; }
+
+        public Date getDate() { return date; }
+        public void setDate(Date date) { this.date = date; }
+    }
+}

airport-ledger/src/main/java/com/sundot/airport/ledger/service/IEmployeePortraitService.java

@@ -0,0 +1,26 @@
+package com.sundot.airport.ledger.service;
+
+import com.sundot.airport.ledger.domain.vo.EmployeePortraitVO;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * 员工画像服务
+ */
+public interface IEmployeePortraitService {
+
+    /**
+     * 按姓名模糊搜索员工（用于前端下拉联想）
+     */
+    List<Map<String, Object>> searchUsers(String keyword);
+
+    /**
+     * 获取指定员工的完整画像数据
+     *
+     * @param personName 员工姓名（精确）
+     * @param beginTime  起始时间 yyyy-MM-dd，null 则不限
+     * @param endTime    结束时间 yyyy-MM-dd，null 则不限
+     */
+    EmployeePortraitVO getPortrait(String personName, String beginTime, String endTime);
+}

airport-ledger/src/main/java/com/sundot/airport/ledger/service/impl/EmployeePortraitServiceImpl.java

@@ -0,0 +1,314 @@
+package com.sundot.airport.ledger.service.impl;
+
+import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
+import com.sundot.airport.common.core.domain.entity.SysDept;
+import com.sundot.airport.common.core.domain.entity.SysUser;
+import com.sundot.airport.ledger.domain.LedgerBannerLetter;
+import com.sundot.airport.ledger.domain.LedgerExamScore;
+import com.sundot.airport.ledger.domain.LedgerTerminalBonus;
+import com.sundot.airport.ledger.domain.ScoreDimension;
+import com.sundot.airport.ledger.domain.ScoreEvent;
+import com.sundot.airport.ledger.domain.vo.EmployeePortraitVO;
+import com.sundot.airport.ledger.mapper.LedgerBannerLetterMapper;
+import com.sundot.airport.ledger.mapper.LedgerExamScoreMapper;
+import com.sundot.airport.ledger.mapper.LedgerTerminalBonusMapper;
+import com.sundot.airport.ledger.mapper.ScoreDimensionMapper;
+import com.sundot.airport.ledger.mapper.ScoreEventMapper;
+import com.sundot.airport.ledger.service.IEmployeePortraitService;
+import com.sundot.airport.system.mapper.SysDeptMapper;
+import com.sundot.airport.system.mapper.SysUserMapper;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Service;
+
+import java.math.BigDecimal;
+import java.math.RoundingMode;
+import java.util.*;
+import java.util.stream.Collectors;
+
+@Service
+public class EmployeePortraitServiceImpl implements IEmployeePortraitService {
+
+    @Autowired
+    private SysUserMapper sysUserMapper;
+
+    @Autowired
+    private SysDeptMapper sysDeptMapper;
+
+    @Autowired
+    private ScoreEventMapper scoreEventMapper;
+
+    @Autowired
+    private ScoreDimensionMapper scoreDimensionMapper;
+
+    @Autowired
+    private LedgerExamScoreMapper ledgerExamScoreMapper;
+
+    @Autowired
+    private LedgerBannerLetterMapper ledgerBannerLetterMapper;
+
+    @Autowired
+    private LedgerTerminalBonusMapper ledgerTerminalBonusMapper;
+
+    // ── 搜索员工 ─────────────────────────────────────────────────────────────
+
+    @Override
+    public List<Map<String, Object>> searchUsers(String keyword) {
+        SysUser query = new SysUser();
+        query.setNickName(keyword);
+        List<SysUser> users = sysUserMapper.selectUserList(query);
+        if (users == null) return Collections.emptyList();
+        return users.stream()
+                .filter(u -> "0".equals(u.getStatus()) && "0".equals(u.getDelFlag()))
+                .limit(20)
+                .map(u -> {
+                    Map<String, Object> m = new LinkedHashMap<>();
+                    m.put("userId", u.getUserId());
+                    m.put("nickName", u.getNickName());
+                    m.put("deptName", u.getDept() != null ? u.getDept().getDeptName() : "");
+                    return m;
+                })
+                .collect(Collectors.toList());
+    }
+
+    // ── 获取员工完整画像 ──────────────────────────────────────────────────────
+
+    @Override
+    public EmployeePortraitVO getPortrait(String personName, String beginTime, String endTime) {
+        EmployeePortraitVO vo = new EmployeePortraitVO();
+        vo.setPersonName(personName);
+
+        // 1. 用户基本信息
+        fillUserInfo(vo, personName);
+
+        // 2. 六维度评分（从 score_event 聚合）
+        fillScores(vo, personName, beginTime, endTime);
+
+        // 3. 最新考试成绩
+        fillExamScore(vo, personName);
+
+        // 4. 获奖记录（锦旗/感谢信 + 航站楼加分）
+        fillAwards(vo, personName);
+
+        return vo;
+    }
+
+    // ── 用户基本信息 ─────────────────────────────────────────────────────────
+
+    private void fillUserInfo(EmployeePortraitVO vo, String personName) {
+        SysUser query = new SysUser();
+        query.setNickName(personName);
+        List<SysUser> users = sysUserMapper.selectUserList(query);
+        if (users == null || users.isEmpty()) return;
+
+        SysUser user = users.stream()
+                .filter(u -> personName.equals(u.getNickName()))
+                .findFirst()
+                .orElse(users.get(0));
+
+        vo.setUserId(user.getUserId());
+        vo.setAvatar(user.getAvatar());
+        vo.setPhonenumber(user.getPhonenumber());
+        vo.setSex(user.getSex());
+        vo.setSexText("0".equals(user.getSex()) ? "男" : "1".equals(user.getSex()) ? "女" : "");
+        vo.setSchooling(user.getSchooling());
+        vo.setQualificationLevelText(decodeQualLevel(user.getQualificationLevel()));
+        vo.setPoliticalStatusText(decodePolitical(user.getPoliticalStatus()));
+        vo.setCharacterCharacteristics(decodeChar(user.getCharacterCharacteristics()));
+        vo.setWorkingStyle(decodeWorkStyle(user.getWorkingStyle()));
+        vo.setStartWorkingDate(user.getStartWorkingDate());
+        vo.setSecurityCheckStartDate(user.getSecurityCheckStartDate());
+        vo.setSecurityInspectionPosition(user.getSecurityInspectionPosition());
+
+        // 司龄、开机年限
+        long nowMs = System.currentTimeMillis();
+        if (user.getStartWorkingDate() != null) {
+            vo.setWorkYears((int) ((nowMs - user.getStartWorkingDate().getTime()) / (365L * 24 * 3600 * 1000)));
+        }
+        if (user.getSecurityCheckStartDate() != null) {
+            vo.setSecurityCheckYears((int) ((nowMs - user.getSecurityCheckStartDate().getTime()) / (365L * 24 * 3600 * 1000)));
+        }
+
+        // 部门路径
+        if (user.getDept() != null) {
+            String deptName = user.getDept().getDeptName();
+            String parentDeptName = "";
+            Long parentId = user.getDept().getParentId();
+            if (parentId != null && parentId > 0) {
+                SysDept parent = sysDeptMapper.selectDeptById(parentId);
+                if (parent != null) parentDeptName = parent.getDeptName();
+            }
+            vo.setDeptName(deptName);
+            vo.setParentDeptName(parentDeptName);
+            vo.setDeptPath(parentDeptName.isEmpty() ? deptName : parentDeptName + "/" + deptName);
+        }
+    }
+
+    // ── 六维度评分 ────────────────────────────────────────────────────────────
+
+    private void fillScores(EmployeePortraitVO vo, String personName, String beginTime, String endTime) {
+        // 加载全部事件，按姓名 LIKE 过滤（支持逗号分隔多人）
+        ScoreEvent eventQuery = new ScoreEvent();
+        eventQuery.setPersonName(personName);
+        if (beginTime != null && !beginTime.isEmpty()) {
+            eventQuery.getParams().put("beginTime", beginTime);
+        }
+        if (endTime != null && !endTime.isEmpty()) {
+            eventQuery.getParams().put("endTime", endTime);
+        }
+        List<ScoreEvent> events = scoreEventMapper.selectList(eventQuery);
+
+        // 精确匹配（防止逗号多人字段的误匹配）
+        Map<Long, BigDecimal> dimMap = new HashMap<>();
+        for (ScoreEvent e : events) {
+            Long dimId = e.getDimensionId();
+            if (dimId == null) continue;
+            String raw = e.getPersonName();
+            if (raw == null) continue;
+            boolean matched = false;
+            for (String n : raw.split("[,，]")) {
+                if (personName.equals(n.trim())) { matched = true; break; }
+            }
+            if (!matched) continue;
+            BigDecimal val = e.getTotalScore() != null ? e.getTotalScore() : BigDecimal.ZERO;
+            dimMap.merge(dimId, val, BigDecimal::add);
+        }
+
+        // 加载维度定义
+        ScoreDimension dq = new ScoreDimension();
+        dq.setStatus("0");
+        List<ScoreDimension> dims = scoreDimensionMapper.selectList(dq);
+        dims.sort(Comparator.comparing(d -> d.getSortOrder() == null ? 999 : d.getSortOrder()));
+
+        List<EmployeePortraitVO.DimScoreItem> items = new ArrayList<>();
+        BigDecimal total = BigDecimal.ZERO;
+
+        for (ScoreDimension dim : dims) {
+            BigDecimal eventScore = dimMap.getOrDefault(dim.getId(), BigDecimal.ZERO);
+            BigDecimal base = dim.getBaseScore() != null ? dim.getBaseScore() : BigDecimal.valueOf(80);
+            BigDecimal dimScore = base.add(eventScore);
+            BigDecimal weight = dim.getWeight() != null ? dim.getWeight() : BigDecimal.ZERO;
+            BigDecimal contribution = dimScore.multiply(weight)
+                    .divide(BigDecimal.valueOf(100), 2, RoundingMode.HALF_UP);
+            total = total.add(contribution);
+
+            EmployeePortraitVO.DimScoreItem item = new EmployeePortraitVO.DimScoreItem();
+            item.setName(dim.getName());
+            item.setScore(dimScore.setScale(1, RoundingMode.HALF_UP));
+            item.setWeight(weight);
+            item.setBaseScore(base);
+            item.setEventScore(eventScore.setScale(2, RoundingMode.HALF_UP));
+            items.add(item);
+        }
+
+        vo.setDimensions(items);
+        vo.setTotalScore(total.setScale(1, RoundingMode.HALF_UP));
+    }
+
+    // ── 考试成绩 ──────────────────────────────────────────────────────────────
+
+    private void fillExamScore(EmployeePortraitVO vo, String personName) {
+        QueryWrapper<LedgerExamScore> qw = new QueryWrapper<>();
+        qw.like("person_name", personName)
+          .eq("del_flag", "0")
+          .orderByDesc("exam_date")
+          .last("LIMIT 1");
+        List<LedgerExamScore> list = ledgerExamScoreMapper.selectList(qw);
+        if (list == null || list.isEmpty()) return;
+        LedgerExamScore exam = list.get(0);
+        vo.setTheoryScore(exam.getTheoryScore());
+        vo.setImageScore(exam.getImageScore());
+        vo.setExamDate(exam.getExamDate());
+        vo.setExamCategory(exam.getExamCategory());
+        vo.setExamPeriod(exam.getExamPeriod());
+    }
+
+    // ── 获奖记录 ──────────────────────────────────────────────────────────────
+
+    private void fillAwards(EmployeePortraitVO vo, String personName) {
+        List<EmployeePortraitVO.AwardRecord> awards = new ArrayList<>();
+
+        // 锦旗及感谢信
+        QueryWrapper<LedgerBannerLetter> bq = new QueryWrapper<>();
+        bq.like("person_name", personName).eq("del_flag", "0").orderByDesc("record_date");
+        for (LedgerBannerLetter b : ledgerBannerLetterMapper.selectList(bq)) {
+            EmployeePortraitVO.AwardRecord ar = new EmployeePortraitVO.AwardRecord();
+            ar.setType("1".equals(b.getType()) ? "锦旗" : "感谢信");
+            ar.setContent(b.getContentDesc());
+            ar.setScore(b.getAddScore());
+            ar.setDate(b.getRecordDate());
+            awards.add(ar);
+        }
+
+        // 航站楼加分
+        QueryWrapper<LedgerTerminalBonus> tq = new QueryWrapper<>();
+        tq.like("person_name", personName).eq("del_flag", "0").orderByDesc("approve_date");
+        for (LedgerTerminalBonus t : ledgerTerminalBonusMapper.selectList(tq)) {
+            EmployeePortraitVO.AwardRecord ar = new EmployeePortraitVO.AwardRecord();
+            ar.setType("航站楼加分");
+            ar.setContent(t.getBonusType());
+            ar.setScore(t.getAddScore());
+            ar.setDate(t.getApproveDate());
+            awards.add(ar);
+        }
+
+        // 按日期降序
+        awards.sort((a, b) -> {
+            if (a.getDate() == null) return 1;
+            if (b.getDate() == null) return -1;
+            return b.getDate().compareTo(a.getDate());
+        });
+
+        vo.setAwards(awards);
+    }
+
+    // ── 枚举解码工具 ─────────────────────────────────────────────────────────
+
+    private static String decodeQualLevel(String v) {
+        if (v == null) return "";
+        switch (v) {
+            case "LEVEL_ONE":   return "一级";
+            case "LEVEL_TWO":   return "二级";
+            case "LEVEL_THREE": return "三级";
+            case "LEVEL_FOUR":  return "四级";
+            case "LEVEL_FIVE":  return "五级";
+            default:            return v;
+        }
+    }
+
+    private static String decodePolitical(String v) {
+        if (v == null) return "";
+        switch (v) {
+            case "COMMUNIST_PARTY_MEMBER":             return "中共党员";
+            case "PROBATIONARY_COMMUNIST_PARTY_MEMBER":return "中共预备党员";
+            case "COMMUNIST_YOUTH_LEAGUE_MEMBER":      return "共青团员";
+            case "MASS_PUBLIC":                        return "群众";
+            default:                                   return v;
+        }
+    }
+
+    private static String decodeChar(String v) {
+        if (v == null) return "";
+        // 值格式如 "ISTJ"，映射为 "ISTJ（检查员型）"
+        Map<String, String> m = new LinkedHashMap<>();
+        m.put("ISTJ", "ISTJ（检查员型）"); m.put("ISFJ", "ISFJ（守护者型）");
+        m.put("INFJ", "INFJ（咨询师型）"); m.put("INTJ", "INTJ（战略家型）");
+        m.put("ISTP", "ISTP（手艺人型）"); m.put("ISFP", "ISFP（艺术家型）");
+        m.put("INFP", "INFP（调停者型）"); m.put("INTP", "INTP（逻辑学家型）");
+        m.put("ESTP", "ESTP（企业家型）"); m.put("ESFP", "ESFP（表演者型）");
+        m.put("ENFP", "ENFP（活动家型）"); m.put("ENTP", "ENTP（辩论家型）");
+        m.put("ESTJ", "ESTJ（总经理型）"); m.put("ESFJ", "ESFJ（执政官型）");
+        m.put("ENFJ", "ENFJ（教育家型）"); m.put("ENTJ", "ENTJ（指挥官型）");
+        return m.getOrDefault(v, v);
+    }
+
+    private static String decodeWorkStyle(String v) {
+        if (v == null) return "";
+        switch (v) {
+            case "D": return "D型（支配型）";
+            case "I": return "I型（影响型）";
+            case "S": return "S型（稳健型）";
+            case "C": return "C型（尽责型）";
+            default:  return v;
+        }
+    }
+}