itms-merge-dev 4fc2a0bf8d docs(itms): 인수인계 문서 정리 — DB연결/설치런북/핸드오프 + 고객데이터 gitignore

- HANDOFF_STATUS.md: 현황·다음단계(완전 ur_itms_db 덤프 적재가 근본해결)
- DB_CONNECTIONS.md: 도메인별 DB 프로파일 매핑(로컬/개발/운영/구버전)
- ITMS_INSTALL_RUNBOOK.md: 전체 설치 런북(OpenSearch/배치/프로시저 포함)
- .gitignore: 고객 실데이터(mms_data/MSS ddl)·설치노트·csv 커밋 차단(보안)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-07-20 01:07:01 +09:00

4.6 KiB

Raw Blame History

ITMS 작업 인수인계 (핸드오프)

최종 갱신: 2026-07-20 | 다른 PC에서 이어서 작업하기 위한 현황·다음단계 정리 관련 문서: CICD_PIPELINE.md(배포) · DB_CONNECTIONS.md(DB 매핑) · ITMS_INSTALL_RUNBOOK.md(설치) · SR_BACKLOG_20260708.md/SR_CHANGES_20260719.md(고객 SR)

1. 지금까지 완료 (LIVE)

CI/CD 파이프라인: git push → 개발(itms.zioinfo.co.kr) 빌드·배포 → 헬스게이트 → 운영(itms.wise.ai.kr) 자동 승격. push 자동연쇄 검증 완료.
개발서버(itms.zioinfo.co.kr) 실동작: 로그인 → 메인 → 서비스데스크/자산/보고서 조회·검색 → SR 신청 등록(DB insert) → 결재 승인/반려(프로시저) → 검색(OpenSearch 9201 색인). 실 고객 데이터.
운영서버(itms.wise.ai.kr): front-only(데모). 로그인 등 풀스택은 RAM 게이트.
고객 SR 40건: 23건 완료·배포(로그인 잠금·서비스데스크 권한/검증·용어통일·브랜딩 F12·결재). 조치결과 엑셀+diff 문서 산출.
모바일 앱: Expo 12화면 + APK v1.0.0 게시(/mobile-app QR, dev·prod).
도메인별 프로파일 고정: zio-dev(개발)·zio-prod(운영), 16기관 yml 불변.

2. ★ 최우선 다음 단계 — 완전한 ur_itms_db 덤프 적재 (근본 해결)

핵심 발견: 받은 덤프(mms_data/MSS ddl)에는 cm_* 업무 데이터만 있고, 배포된 ITMS(urpsys/eGov)가 메뉴·화면을 읽는 포털계층 테이블(TB_MENU_INFO·TB_PGM_LIST·TB_PORTLET·COMVNUSERMASTER·권한/사용자)이 0개. → 그 테이블들을 역설계 빈 껍데기로 때워왔고, 그래서 메뉴 URL 없음·서브메뉴 안 뜸·일부 페이지 500 이 반복됨.

소유자 확인(2026-07-20): 완전한 ur_itms_db 덤프 제공 가능. 이걸 받으면:

# 원본 서버에서 (프로시저·트리거 포함)
mysqldump -u root -p --routines --triggers --single-transaction --default-character-set=utf8mb4 ur_itms_db > ur_itms_db_full.sql

→ 개발서버 격리 DB(ur_itms_db)에 적재 → zio-dev 연결 → 역설계 포털 테이블 전량 대체 → 메뉴·URL·서브메뉴·페이지가 원본대로 동작. 지금까지의 역설계 땜질(09_menu.sql 등)은 이 덤프가 대체.

대안(방법 B): 원본 DB 직접 연결 — 단 ①개발서버(101.79.17.164)에서 네트워크 도달 가능해야 하고(내부망 192.168.8.x면 VPN/터널 필요) ②테스트 쓰기가 원본 운영 데이터를 오염시키므로 복제본/읽기전용 권장. → 격리 덤프 적재(방법 A)가 안전.

진행 중이던 역설계(메뉴 페이지 드리프트)는 이 덤프 도착 시 중단·대체 — 헛수고 방지를 위해 보류 상태.

3. 잔여 (외부자원 게이트 — 소프트웨어는 완료)

항목	게이트	비고
관리자 백오피스 페이지 500	(2)의 완전 덤프로 대부분 해소 예상	포털계층 테이블 부재가 원인
운영서버 풀스택 로그인	RAM 증설/서버 분리	prod 가용 ~466MB, WISE/CAMP 상용 보호
batch JVM 상시기동	Oracle 인사망+NCP키+Quartz 잡설정	검색 색인은 어댑터로 대체 완성
URP 검색 마이크로서비스 정품	운영 배포본	현재 dev 어댑터가 대체(계약 동일)
Stitch UI 시안(#6)	새 세션에서 MCP 로드	`.mcp.json` 등록됨

4. 다른 PC에서 이어가기

clone: git clone <Gitea>/ythong/itms (또는 pull). 소스·docs 최신(이 커밋 포함).
고객 데이터는 Gitea에 없음(보안). mms_data·MSS ddl·완전 덤프는 별도 안전 경로(USB/직접전송)로 가져올 것 — 커밋 금지.
Stitch MCP: workspace/itms/.mcp.json(gitignore됨, 로컬 전용) 재생성 필요 시 키 재등록.
서버 접근: 개발 101.79.17.164 / 운영 211.37.173.197(ssh :9271). 자격증명은 서버 시크릿(/opt/itms/secrets/)·로컬 관리, 문서 미기재.
작업 재개 지점: §2 완전 덤프 적재부터. 덤프 확보 → 개발서버 ur_itms_db에 적재 → zio-dev 검증(로그인→메뉴→서브메뉴→페이지 전수) → 회귀 확인.

5. 서버·배포 요약

개발: 101.79.17.164 — front:11020·auth:11000·api:11010, MariaDB(ur_itms_db)·OpenSearch(9201)·검색어댑터(48381). systemd itms-*.
운영: 211.37.173.197 — itms-front(zio-prod). nginx Host 기반 vhost.
배포: Gitea webhook → deploy_server itms 블록(dev 빌드→헬스→prod 승격). deploy_server 수정 시 서버 /opt/zioinfo/ 사본 반영+재시작 필수.

4.6 KiB Raw Blame History