261021_01_ENH: 2차 마이그레이션 완료
This commit is contained in:
27
README.md
27
README.md
@@ -40,6 +40,21 @@ progress/type은 조사 유형별 그룹이 아니라 전체 상태 건수 1행
|
||||
|
||||
Contact의 controller/service/dto/persistence/config/common 구조를 따른다. enum은 common/enums에 두고 사용자가 지정한 CodeEnum/Lombok/Jackson 형태를 사용한다. mapper XML은 mybatis/mapper 아래의 ProjectMapper.xml·ProgressMapper.xml·UserMapper.xml·LogMapper.xml·QuotaMapper.xml로 구분하고 SqlSessionTemplate와 transaction-manager를 명시한다.
|
||||
|
||||
### Repository와 Mapper 인터페이스 구조
|
||||
|
||||
MyBatis 호출은 Service → Repository → Mapper 인터페이스 → XML 구조를 사용한다. 업무별 Mapper 인터페이스 13개가 기존 SQL statement 68개에 대응하며, 문자열 statement ID를 Repository에서 직접 호출하지 않는다. Import의 초기화·삭제 작업도 범용 command 대신 작업별 메서드를 사용한다.
|
||||
|
||||
Repository는 프로젝트 유형에 따른 KON/KONKIWI 세션 선택, Report DB 세션의 명시적 사용, 조회 파라미터 가공과 Mapper 호출을 담당한다. Service는 기존 업무 규칙과 처리 흐름에 집중하며, 세션 선택이나 MyBatis 파라미터 조립을 Service로 옮겨 복잡도를 높이지 않는다.
|
||||
|
||||
- KON/KONKIWI는 동일한 Mapper 인터페이스와 XML을 공유하고, Repository가 SurveySessionProvider로 선택한 세션에서 Mapper를 가져온다. DB별 Mapper나 SQL을 복제하지 않는다.
|
||||
- Project·ShareLink처럼 survey와 Report DB를 함께 사용하는 업무는 Repository에서 메서드별 연결 대상을 명확히 유지한다. Mapper를 특정 기본 DB에 일괄 연결하지 않는다.
|
||||
- Mapper 메서드는 명시적인 파라미터와 반환형을 사용한다. SQL 본문과 databaseId=survey/kart 구분, 기존 DB별 트랜잭션 경계와 롤백 동작을 보존한다. Repository 유지만으로 트랜잭션이 보장되는 것은 아니다.
|
||||
- XML namespace는 Mapper 인터페이스의 전체 클래스명과 일치시킨다. 각 SqlSessionFactory가 XML을 읽어 Mapper를 등록하며, Repository가 선택한 SqlSessionTemplate의 getMapper로 호출한다. Mapper를 Service에 직접 주입하거나 기본 세션으로 자동 연결하지 않는다.
|
||||
|
||||
이 계층을 유지하면 여러 DB를 사용하는 영속성 처리의 복잡도를 Repository에 모아 Service의 복잡도가 증가하는 것을 막고, DB 선택과 SQL 바인딩을 업무 로직과 분리하여 검증할 수 있다.
|
||||
|
||||
전환 회귀 검증은 실제 Mapper 프록시를 통한 68개 메서드의 12가지 입력 조합에서 기존 SQL·바인딩 값의 일치를 확인한다. 업로드 초기화 3종은 KON/KONKIWI 각각의 격리 H2에서 실제 Mapper 호출이 선택된 Spring 트랜잭션에 참여하고 실패 시 롤백되는지 검증한다. 이는 실제 SQL Server 및 운영 데이터에 대한 동등성 검수를 대신하지 않는다.
|
||||
|
||||
프로젝트 목록·최신 6개 및 파생변수 관리 목록의 조회 권한은 RequestUserContext의 getUserRole()/getUserTeam()을 기준으로 적용한다. 상세 규칙은 아래 조회 권한 항목을 따른다. 공용 JWT/API Key 인증은 유지한다. External 전용 인증과 링크의 프로젝트/페이지 제한은 아래 공유 링크 기능에서 구현한다. 현재 상태를 운영 전환 준비 완료로 간주하지 않는다.
|
||||
|
||||
## 검증
|
||||
@@ -199,7 +214,17 @@ QUOTA VIEW는 설정 조회 후 서버 LogService가 기존 QSTITLE/QSJSON 내
|
||||
|
||||
PKEY와 PROJECT_TYPE가 모두 NULL인 행만 내부 SKEY 어댑터로 해석한다. 0=KON, 1=KIWI이며 NEWSSAK/혼합 구분자/부분 NULL/잘못된 유형/프로젝트 없음/새 필드와 SKEY 불일치는 거부한다. 새 필드가 정상이고 SKEY가 없는 행도 지원한다. 운영 호환 키/IV는 사용자 규약에 따라 kri.kart.share.legacy-key/legacy-iv에 저장하며 API/로그 응답으로 노출하지 않는다. 공용 AES는 PBKDF2 키 파생을 사용하므로 기존 raw AES 키에 대한 JCE 어댑터를 REPORT_URL에만 둔다. public-origin 기본값은 기존 https://kart.kric.com이다.
|
||||
|
||||
랜딩 POST는 검증된 링크 정보와 accessToken을 반환한다. 공용 JWT 24시간 정책과 서명 검증을 사용하고, 서버가 발급한 KART_EXTERNAL team/EXTERNAL:urlKey identity로 매 요청 REPORT_URL 범위를 다시 확인한다. 랜딩 POST만 LANDING_CNT를 원자적으로 1 증가시키며 내부 GET/범위 검증은 증가시키지 않는다. POST는 재접속마다 한 번 호출하며 자동 재시도는 카운트를 늘릴 수 있다. 원래 랜딩의 로그인 로그와 발급의 URL Copy 로그는 LogService를 통해 기록한다.
|
||||
랜딩 POST는 `{ accessToken, user, link }`를 반환한다. `user`의 userId/userName/userTeam/userCmpn/userRole은 accessToken에 담은 값과 동일하다. 프런트는 반환된 사용자 정보를 검증해서 사용하며 역할을 자체 계산하지 않는다.
|
||||
|
||||
| 로그인 구분 | userRole | 접근 범위 |
|
||||
|---|---|---|
|
||||
| ReportMemberLogin | 9001 | 기존 계정별 배정 프로젝트 정책 |
|
||||
| URL Copy (`link.pageOnly=false`) | 9002 | 공유 프로젝트의 Current/Quota/Tabulation/Crosstab |
|
||||
| Page Copy (`link.pageOnly=true`) | 9003 | 공유 프로젝트의 지정 보고서 화면 |
|
||||
|
||||
External user는 `userId=EXTERNAL:{urlKey}`, `userName=CLIENT`, `userTeam=KART_EXTERNAL`, `userCmpn=""`를 유지한다. 역할·External 팀/아이디·현재 저장된 링크 종류가 일치해야 하며, 하나라도 불일치하면 거부한다. 9002/9003은 External identity가 누락되어도 일반 사용자 경로로 통과하지 않는다. 기존 9001 External 토큰은 지원하지 않는다. 이 역할 분리에는 DB 스키마·데이터 변경이 없다.
|
||||
|
||||
공용 JWT 24시간 정책과 서명 검증을 사용하고, 서버가 발급한 KART_EXTERNAL team/EXTERNAL:urlKey identity로 매 요청 REPORT_URL 범위를 다시 확인한다. 랜딩 POST만 LANDING_CNT를 원자적으로 1 증가시키며 내부 GET/범위 검증은 증가시키지 않는다. POST는 재접속마다 한 번 호출하며 자동 재시도는 카운트를 늘릴 수 있다. 원래 랜딩의 로그인 로그와 발급의 URL Copy 로그는 LogService를 통해 기록한다.
|
||||
|
||||
External은 같은 프로젝트의 문항 메타데이터 및 허용 화면 API만 사용할 수 있다. P Current는 기본 현황, P Quota는 쿼터, P Tabulation/Crosstab은 일반 집계와 해당 북마크 조회를 허용한다. Crosstab P는 STANDARD만 허용한다. U는 같은 프로젝트의 위 보고서/쿼터를 허용한다. 외부 URL/파일을 반환하는 progress/custom, 프로젝트 전체 목록·summary, 파생 관리·북마크 쓰기·링크 발급·원자료/등록 양식/가이드 다운로드·정적 파일 접근은 차단한다. 방문 로그도 같은 프로젝트여야 한다. 아래 일반/쿼터 집계 Excel 경로만 해당 공유 화면에서 허용한다. 일반 사용자 역할 제한은 기존 결정대로 별도 단계다.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user