260416_01_ENH: first commit - 1차 개발 완료

This commit is contained in:
2026-04-16 11:41:23 +09:00
commit 22cbed9c9c
65 changed files with 8130 additions and 0 deletions

View File

@@ -0,0 +1,11 @@
package com.kri.p6.ncrc.pairing;
import org.junit.jupiter.api.Test;
import org.springframework.boot.test.context.SpringBootTest;
@SpringBootTest
class NcrcPairingApplicationTests {
@Test
void contextLoads() {
}
}

View File

@@ -0,0 +1,80 @@
package com.kri.p6.ncrc.pairing.service;
import com.kri.p6.ncrc.pairing.model.Center;
import com.kri.p6.ncrc.pairing.model.CenterAdjacentRegion;
import com.kri.p6.ncrc.pairing.common.enums.ExperienceType;
import com.kri.p6.ncrc.pairing.common.enums.Gender;
import com.kri.p6.ncrc.pairing.model.Member;
import com.kri.p6.ncrc.pairing.common.enums.MemberRole;
import com.kri.p6.ncrc.pairing.model.Municipality;
import com.kri.p6.ncrc.pairing.model.PairingCandidates;
import com.kri.p6.ncrc.pairing.model.PairingData;
import com.kri.p6.ncrc.pairing.model.PreferenceMatchRule;
import java.time.LocalDate;
import java.util.Collection;
import java.util.List;
import java.util.Set;
import org.assertj.core.api.Assertions;
import org.junit.jupiter.api.Test;
class PairingCandidateServiceTest {
private final PairingCandidateService service = new PairingCandidateService(PairingTestSupport.pairingProperties());
@Test
void generateExcludesNewNewPair() {
PairingCandidates candidates = this.service.generate(this.baseData(this.member("field", MemberRole.FIELD, Gender.FEMALE, ExperienceType.NEW, "02", Set.of()), this.member("external", MemberRole.EXTERNAL, Gender.FEMALE, ExperienceType.NEW, "03", Set.of()), this.center("center", false)));
Assertions.assertThat(candidates.getPairCandidates()).isEmpty();
Assertions.assertThat(candidates.getAssignmentCandidates()).isEmpty();
}
@Test
void generateExcludesConflictDispatchRegion() {
PairingCandidates candidates = this.service.generate(this.baseData(this.member("field", MemberRole.FIELD, Gender.FEMALE, ExperienceType.EXPERIENCED, "01", Set.of()), this.member("external", MemberRole.EXTERNAL, Gender.FEMALE, ExperienceType.EXPERIENCED, "03", Set.of()), this.center("center", false)));
Assertions.assertThat(candidates.getPairCandidates()).hasSize(1);
Assertions.assertThat(candidates.getDispatchRegionCandidates()).isEmpty();
Assertions.assertThat(candidates.getAssignmentCandidates()).isEmpty();
}
@Test
void generateAllowsWomenOnlyCenterOnlyForFemalePair() {
PairingCandidates maleIncluded = this.service.generate(this.baseData(this.member("field", MemberRole.FIELD, Gender.FEMALE, ExperienceType.EXPERIENCED, "02", Set.of()), this.member("external", MemberRole.EXTERNAL, Gender.MALE, ExperienceType.EXPERIENCED, "03", Set.of()), this.center("center", true)));
PairingCandidates femaleOnly = this.service.generate(this.baseData(this.member("field", MemberRole.FIELD, Gender.FEMALE, ExperienceType.EXPERIENCED, "02", Set.of()), this.member("external", MemberRole.EXTERNAL, Gender.FEMALE, ExperienceType.EXPERIENCED, "03", Set.of()), this.center("center", true)));
Assertions.assertThat(maleIncluded.getAssignmentCandidates()).isEmpty();
Assertions.assertThat(femaleOnly.getAssignmentCandidates()).hasSize(1);
}
@Test
void generateExcludesHistoryCenter() {
PairingCandidates candidates = this.service.generate(this.baseData(this.member("field", MemberRole.FIELD, Gender.FEMALE, ExperienceType.EXPERIENCED, "02", Set.of("center")), this.member("external", MemberRole.EXTERNAL, Gender.FEMALE, ExperienceType.EXPERIENCED, "03", Set.of()), this.center("center", false)));
Assertions.assertThat(candidates.getAssignmentCandidates()).isEmpty();
}
@Test
void generateTreatsPreferenceRank99AsIgnored() {
PairingData data = PairingData.builder().members(List.of(this.member("field", MemberRole.FIELD, Gender.FEMALE, ExperienceType.EXPERIENCED, "02", Set.of()), this.member("external", MemberRole.EXTERNAL, Gender.FEMALE, ExperienceType.EXPERIENCED, "03", Set.of()))).municipalities(List.of(Municipality.builder().id("municipality").availableStartDate(LocalDate.of(2026, 5, 1)).availableEndDate(LocalDate.of(2026, 5, 3)).unavailableDates(Set.of()).build())).centers(List.of(this.center("center", false))).memberRegionCodes(List.of()).centerAdjacentRegions(List.of(CenterAdjacentRegion.builder().dispatchRegion("01").adjacentRegionClassification("A").build())).preferenceMatchRules(List.of(PreferenceMatchRule.builder().priority(1).fieldMemberPreferenceRank(1).externalMemberPreferenceRank(99).build())).commonUnavailableDates(Set.of()).build();
PairingCandidates candidates = this.service.generate(data);
Assertions.assertThat(candidates.getDispatchRegionCandidates()).hasSize(1);
Assertions.assertThat(candidates.getAssignmentCandidates()).hasSize(1);
}
@Test
void generateExcludesCommonHolidayDates() {
PairingData data = this.baseData(this.member("field", MemberRole.FIELD, Gender.FEMALE, ExperienceType.EXPERIENCED, "02", Set.of()), this.member("external", MemberRole.EXTERNAL, Gender.FEMALE, ExperienceType.EXPERIENCED, "03", Set.of()), Center.builder().id("center").municipalityId("municipality").womenOnly(false).adjacentRegionClassification("A").availableStartDate(LocalDate.of(2026, 5, 1)).availableEndDate(LocalDate.of(2026, 5, 1)).unavailableDates(Set.of()).build());
data = PairingData.builder().members(data.getMembers()).municipalities(data.getMunicipalities()).centers(data.getCenters()).memberRegionCodes(data.getMemberRegionCodes()).centerAdjacentRegions(data.getCenterAdjacentRegions()).preferenceMatchRules(data.getPreferenceMatchRules()).commonUnavailableDates(Set.of(LocalDate.of(2026, 5, 1))).build();
PairingCandidates candidates = this.service.generate(data);
Assertions.assertThat(candidates.getAssignmentCandidates()).isEmpty();
Assertions.assertThat((Collection)candidates.getUnassignedCenterReasons().get("center")).contains(new String[]{"위원/지자체/센터 일정 또는 국공휴일 조건 불일치"});
}
private PairingData baseData(Member fieldMember, Member externalMember, Center center) {
return PairingData.builder().members(List.of(fieldMember, externalMember)).municipalities(List.of(Municipality.builder().id("municipality").availableStartDate(LocalDate.of(2026, 5, 1)).availableEndDate(LocalDate.of(2026, 5, 3)).unavailableDates(Set.of()).build())).centers(List.of(center)).memberRegionCodes(List.of()).centerAdjacentRegions(List.of(CenterAdjacentRegion.builder().dispatchRegion("01").adjacentRegionClassification("A").build())).preferenceMatchRules(List.of(PreferenceMatchRule.builder().priority(1).fieldMemberPreferenceRank(1).externalMemberPreferenceRank(1).build())).commonUnavailableDates(Set.of()).build();
}
private Member member(String id, MemberRole role, Gender gender, ExperienceType experienceType, String activityRegion, Set<String> historyCenterIds) {
return Member.builder().id(id).gender(gender).experienceType(experienceType).role(role).availableStartDate(LocalDate.of(2026, 5, 1)).availableEndDate(LocalDate.of(2026, 5, 3)).unavailableDates(Set.of()).activityRegion(activityRegion).historyCenterIds(historyCenterIds).residenceCode("01101").preferenceRegions(List.of("01", "00", "00", "00")).build();
}
private Center center(String id, boolean womenOnly) {
return Center.builder().id(id).municipalityId("municipality").womenOnly(womenOnly).adjacentRegionClassification("A").availableStartDate(LocalDate.of(2026, 5, 1)).availableEndDate(LocalDate.of(2026, 5, 3)).unavailableDates(Set.of()).build();
}
}

View File

@@ -0,0 +1,43 @@
package com.kri.p6.ncrc.pairing.service;
import com.kri.p6.ncrc.pairing.dto.PairingWorkbookData;
import java.io.IOException;
import java.io.InputStream;
import org.assertj.core.api.Assertions;
import org.junit.jupiter.api.Test;
import org.springframework.mock.web.MockMultipartFile;
class PairingExcelServiceTest {
private final PairingExcelService pairingExcelService = new PairingExcelService(PairingTestSupport.pairingProperties());
@Test
void readSampleWorkbook() throws IOException {
InputStream inputStream = this.getClass().getResourceAsStream("/sample/기초 data dummy.xlsx");
try {
MockMultipartFile file = new MockMultipartFile("file", "기초 data dummy.xlsx", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", inputStream);
PairingWorkbookData data = this.pairingExcelService.read(file);
Assertions.assertThat(data.getMembers()).isNotEmpty();
Assertions.assertThat(data.getMunicipalities()).isNotEmpty();
Assertions.assertThat(data.getCenters()).isNotEmpty();
Assertions.assertThat(data.getMemberRegionCodes()).isNotEmpty();
Assertions.assertThat(data.getCenterAdjacentRegions()).isNotEmpty();
Assertions.assertThat(data.getPreferenceMatchRules()).isNotEmpty();
} catch (Throwable var5) {
if (inputStream != null) {
try {
inputStream.close();
} catch (Throwable var4) {
var5.addSuppressed(var4);
}
}
throw var5;
}
if (inputStream != null) {
inputStream.close();
}
}
}

View File

@@ -0,0 +1,80 @@
package com.kri.p6.ncrc.pairing.service;
import com.kri.common.feature.excel.ExcelMapper;
import com.kri.p6.ncrc.pairing.common.external.datago.DatagoExtentionApiClient;
import com.kri.p6.ncrc.pairing.common.cache.DatagoHolidayCache;
import com.kri.p6.ncrc.pairing.common.external.datago.HolidayDto;
import com.kri.p6.ncrc.pairing.dto.excel.output.RuleViolationExcelDto;
import java.io.ByteArrayInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.List;
import org.apache.poi.ss.usermodel.Workbook;
import org.apache.poi.ss.usermodel.WorkbookFactory;
import org.assertj.core.api.Assertions;
import org.junit.jupiter.api.Test;
import org.springframework.mock.web.MockMultipartFile;
class PairingServiceTest {
private final PairingService pairingService = new PairingService(new PairingExcelService(PairingTestSupport.pairingProperties()), new PairingNormalizeService(PairingTestSupport.pairingProperties()), new PairingHolidayService(new DatagoHolidayCache(new StubDatagoExtentionApiClient())), new PairingValidationService(PairingTestSupport.pairingProperties()), new PairingCandidateService(PairingTestSupport.pairingProperties()), new PairingSolverService(PairingTestSupport.pairingProperties()));
@Test
void pairingMemberByCenterCreatesResultWorkbook() throws IOException {
InputStream inputStream = this.getClass().getResourceAsStream("/sample/기초 data dummy.xlsx");
try {
MockMultipartFile file = new MockMultipartFile("file", "기초 data dummy.xlsx", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", inputStream);
byte[] result = this.pairingService.pairingMemberByCenter(file);
Assertions.assertThat(result).isNotEmpty();
Workbook workbook = WorkbookFactory.create(new ByteArrayInputStream(result));
try {
Assertions.assertThat(workbook.getSheet("배정결과")).isNotNull();
Assertions.assertThat(workbook.getSheet("미배정센터")).isNotNull();
Assertions.assertThat(workbook.getSheet("미사용위원")).isNotNull();
Assertions.assertThat(workbook.getSheet("처리요약")).isNotNull();
Assertions.assertThat(workbook.getSheet("AB페어목록")).isNotNull();
Assertions.assertThat(workbook.getSheet("후보요약")).isNotNull();
Assertions.assertThat(workbook.getSheet("검증오류")).isNotNull();
Assertions.assertThat(workbook.getSheet("규칙위반검사")).isNotNull();
List<RuleViolationExcelDto> ruleChecks = ExcelMapper.readFromWorkbook(workbook, RuleViolationExcelDto.class, "규칙위반검사", 1);
Assertions.assertThat(ruleChecks).extracting(RuleViolationExcelDto::getResult).doesNotContain(new String[]{"FAIL"});
} catch (Throwable var9) {
if (workbook != null) {
try {
workbook.close();
} catch (Throwable var8) {
var9.addSuppressed(var8);
}
}
throw var9;
}
if (workbook != null) {
workbook.close();
}
} catch (Throwable var10) {
if (inputStream != null) {
try {
inputStream.close();
} catch (Throwable var7) {
var10.addSuppressed(var7);
}
}
throw var10;
}
if (inputStream != null) {
inputStream.close();
}
}
private static class StubDatagoExtentionApiClient extends DatagoExtentionApiClient {
public List<HolidayDto> getHoliDayList(String year) {
return List.of();
}
}
}

View File

@@ -0,0 +1,94 @@
package com.kri.p6.ncrc.pairing.service;
import com.kri.p6.ncrc.pairing.model.AssignmentCandidate;
import com.kri.p6.ncrc.pairing.model.Center;
import com.kri.p6.ncrc.pairing.model.ExperienceType;
import com.kri.p6.ncrc.pairing.model.Gender;
import com.kri.p6.ncrc.pairing.model.Member;
import com.kri.p6.ncrc.pairing.model.MemberRole;
import com.kri.p6.ncrc.pairing.model.Municipality;
import com.kri.p6.ncrc.pairing.model.PairCandidate;
import com.kri.p6.ncrc.pairing.model.PairingCandidates;
import com.kri.p6.ncrc.pairing.model.PairingData;
import com.kri.p6.ncrc.pairing.model.PairingResult;
import java.time.LocalDate;
import java.util.Arrays;
import java.util.List;
import java.util.Map;
import java.util.Set;
import java.util.stream.Collectors;
import org.assertj.core.api.Assertions;
import org.junit.jupiter.api.Test;
class PairingSolverServiceTest {
private final PairingSolverService service = new PairingSolverService(PairingTestSupport.pairingProperties());
@Test
void solveAssignsCenterAtMostOnceAndPairMaxThreeCentersPerDay() {
PairingData data = this.dataWithCenters("c1", "c2", "c3", "c4");
PairingCandidates candidates = PairingCandidates.builder().pairCandidates(List.of(PairCandidate.builder().fieldMemberId("field").externalMemberId("external").residenceMatchScore(1).build())).dispatchRegionCandidates(List.of()).assignmentCandidates(List.of(this.assignment("field", "external", "c1", "A"), this.assignment("field", "external", "c2", "A"), this.assignment("field", "external", "c3", "A"), this.assignment("field", "external", "c4", "A"))).build();
PairingResult result = this.service.solve(data, candidates);
Assertions.assertThat(result.getAssignments()).hasSize(3);
Assertions.assertThat(result.getAssignments()).extracting((assignment) -> assignment.getCenterId()).doesNotHaveDuplicates();
}
@Test
void solveAllowsOnlyOnePairForMemberOnSameDay() {
PairingData data = this.dataWithMembersAndCenters(List.of(this.member("field", MemberRole.FIELD), this.member("external1", MemberRole.EXTERNAL), this.member("external2", MemberRole.EXTERNAL)), List.of(this.center("c1"), this.center("c2")));
PairingCandidates candidates = PairingCandidates.builder().pairCandidates(List.of(PairCandidate.builder().fieldMemberId("field").externalMemberId("external1").build(), PairCandidate.builder().fieldMemberId("field").externalMemberId("external2").build())).dispatchRegionCandidates(List.of()).assignmentCandidates(List.of(this.assignment("field", "external1", "c1", "A"), this.assignment("field", "external2", "c2", "A"))).build();
PairingResult result = this.service.solve(data, candidates);
Assertions.assertThat(result.getAssignments()).hasSize(1);
}
@Test
void solveAllowsOnlyOneAdjacentClassificationPerPairDay() {
PairingData data = this.dataWithCenters("c1", "c2");
PairingCandidates candidates = PairingCandidates.builder().pairCandidates(List.of(PairCandidate.builder().fieldMemberId("field").externalMemberId("external").build())).dispatchRegionCandidates(List.of()).assignmentCandidates(List.of(this.assignment("field", "external", "c1", "A"), this.assignment("field", "external", "c2", "B"))).build();
PairingResult result = this.service.solve(data, candidates);
Assertions.assertThat(result.getAssignments()).hasSize(1);
}
@Test
void solveLimitsCounterpartsPerMemberToTwo() {
PairingData data = this.dataWithMembersAndCenters(List.of(this.member("field", MemberRole.FIELD), this.member("external1", MemberRole.EXTERNAL), this.member("external2", MemberRole.EXTERNAL), this.member("external3", MemberRole.EXTERNAL)), List.of(this.center("c1"), this.center("c2"), this.center("c3")));
PairingCandidates candidates = PairingCandidates.builder().pairCandidates(List.of(PairCandidate.builder().fieldMemberId("field").externalMemberId("external1").build(), PairCandidate.builder().fieldMemberId("field").externalMemberId("external2").build(), PairCandidate.builder().fieldMemberId("field").externalMemberId("external3").build())).dispatchRegionCandidates(List.of()).assignmentCandidates(List.of(this.assignment("field", "external1", "c1", "A", LocalDate.of(2026, 5, 1)), this.assignment("field", "external2", "c2", "A", LocalDate.of(2026, 5, 2)), this.assignment("field", "external3", "c3", "A", LocalDate.of(2026, 5, 3)))).build();
PairingResult result = this.service.solve(data, candidates);
Map<String, Long> counterpartCounts = (Map)result.getAssignments().stream().collect(Collectors.groupingBy((assignment) -> assignment.getExternalMemberId(), Collectors.counting()));
Assertions.assertThat(result.getAssignments()).hasSize(2);
Assertions.assertThat(counterpartCounts).hasSize(2);
}
@Test
void solveAddsABGroupForSimilarPairsWithoutOverlappingDates() {
PairingData data = this.dataWithMembersAndCenters(List.of(this.member("field1", MemberRole.FIELD), this.member("external1", MemberRole.EXTERNAL), this.member("field2", MemberRole.FIELD), this.member("external2", MemberRole.EXTERNAL)), List.of(this.center("c1"), this.center("c2")));
PairingCandidates candidates = PairingCandidates.builder().pairCandidates(List.of(PairCandidate.builder().fieldMemberId("field1").externalMemberId("external1").build(), PairCandidate.builder().fieldMemberId("field2").externalMemberId("external2").build())).dispatchRegionCandidates(List.of()).assignmentCandidates(List.of(this.assignment("field1", "external1", "c1", "A", LocalDate.of(2026, 5, 1)), this.assignment("field2", "external2", "c2", "A", LocalDate.of(2026, 5, 2)))).build();
PairingResult result = this.service.solve(data, candidates);
Assertions.assertThat(result.getAssignments()).hasSize(2);
Assertions.assertThat(result.getAssignments()).extracting((assignment) -> assignment.getAbGroup()).containsOnly(new String[]{"AB-001"});
Assertions.assertThat(result.getAssignments()).extracting((assignment) -> assignment.getBackupFieldMemberId()).containsExactlyInAnyOrder(new String[]{"field2", "field1"});
}
private PairingData dataWithCenters(String... centerIds) {
return this.dataWithMembersAndCenters(List.of(this.member("field", MemberRole.FIELD), this.member("external", MemberRole.EXTERNAL)), Arrays.stream(centerIds).map(this::center).toList());
}
private PairingData dataWithMembersAndCenters(List<Member> members, List<Center> centers) {
return PairingData.builder().members(members).municipalities(List.of(Municipality.builder().id("municipality").availableStartDate(LocalDate.of(2026, 5, 1)).availableEndDate(LocalDate.of(2026, 5, 10)).unavailableDates(Set.of()).build())).centers(centers).memberRegionCodes(List.of()).centerAdjacentRegions(List.of()).preferenceMatchRules(List.of()).build();
}
private AssignmentCandidate assignment(String fieldMemberId, String externalMemberId, String centerId, String adjacentRegionClassification) {
return this.assignment(fieldMemberId, externalMemberId, centerId, adjacentRegionClassification, LocalDate.of(2026, 5, 1));
}
private AssignmentCandidate assignment(String fieldMemberId, String externalMemberId, String centerId, String adjacentRegionClassification, LocalDate date) {
return AssignmentCandidate.builder().fieldMemberId(fieldMemberId).externalMemberId(externalMemberId).centerId(centerId).municipalityId("municipality").date(date).dispatchRegion("01").adjacentRegionClassification(adjacentRegionClassification).preferencePriority(1).residenceMatchScore(0).build();
}
private Member member(String id, MemberRole role) {
return Member.builder().id(id).gender(Gender.FEMALE).experienceType(ExperienceType.EXPERIENCED).role(role).availableStartDate(LocalDate.of(2026, 5, 1)).availableEndDate(LocalDate.of(2026, 5, 10)).unavailableDates(Set.of()).activityRegion("02").historyCenterIds(Set.of()).residenceCode("01101").preferenceRegions(List.of("01", "00", "00", "00")).build();
}
private Center center(String id) {
return Center.builder().id(id).municipalityId("municipality").womenOnly(false).adjacentRegionClassification("A").availableStartDate(LocalDate.of(2026, 5, 1)).availableEndDate(LocalDate.of(2026, 5, 10)).unavailableDates(Set.of()).build();
}
}