## ptyRun 스크립트 개선

### 로그 파일 저장 기능 추가
- ptyRun: 스크립트 실행 시 stdout/stderr를 로그 파일에 저장하는 기능 구현
- ptyRun: proc_open을 사용하여 실시간으로 출력을 화면과 로그 파일에 동시 기록
- ptyRun: 로그 파일명에 스크립트명과 타임스탬프 포함 (예: script_20231223_143022.log)

### 로그 로테이션 옵션 추가
- ptyRun: `--log-dir=경로` 옵션으로 로그 저장 폴더 지정 (기본값: 스크립트폴더/ptyRun_logs)
- ptyRun: `--log-rotate-date=일수` 옵션으로 일수 기반 로그 보관 기능 구현
- ptyRun: `--log-rotate-count=개수` 옵션으로 개수 기반 로그 보관 기능 구현
- ptyRun: rotateLogsByDate(), rotateLogsByCount() 함수로 오래된 로그 자동 삭제

### 프로세스 실행 방식 변경
- ptyRun: pcntl_fork 대신 proc_open 사용으로 stdout/stderr 캡처 가능하도록 개선
- ptyRun: 논블로킹 모드로 실시간 출력 읽기 구현
- ptyRun: 락 파일에 log_file 정보 추가

## ptyCliLog 클래스 확장

### 공개 속성 추가
- ptyLibrary_PHP/cli/ptyCliLog.php: url, elastic 속성 추가로 외부 연동 정보 저장 가능

## 새 파일

- ptyUpdate: pty_centos.git 저장소를 어디서든 업데이트할 수 있는 bash 스크립트
  - 스크립트가 위치한 디렉토리를 기준으로 git pull 실행
  - 현재 작업 디렉토리와 무관하게 저장소 업데이트 가능

## 문서화

CLAUDE.md: 프로젝트 가이드 문서 개선
- ptyCliLog 사용법 섹션 추가 (인스턴스 메소드 사용법, 올바른/잘못된 사용 예시)
- ptyLibrary_PHP 구조 설명 업데이트 (ptyCliLog를 인스턴스 메소드로 명시)
- 유틸리티 스크립트 섹션 추가 (ptyRun, ptyCronBuild 사용법 및 예제)

## 유틸리티 스크립트

ptyCronBuild: 크론탭 자동 등록 스크립트 추가
- 다양한 스케줄 옵션 지원 (daily, daily-5min, daily-10min, daily-30min, daily-hour)
- 기존 크론탭 항목 자동 감지 및 업데이트
- MD5 해시 기반 마커로 중복 방지
- 임시 파일을 통한 안전한 크론탭 설치
- ptyCliLog를 활용한 상세 로그 출력

ptyRun: 스크립트 중복 실행 제어 스크립트 추가
- 중복 실행 차단 기능 (run-duplicate 옵션)
- 최대 실행 시간 설정 및 타임아웃 관리
- 프로세스 포크를 통한 비동기 실행
- 락 파일 및 PID 파일 기반 실행 상태 관리
- 타임아웃 시 SIGTERM/SIGKILL을 통한 강제 종료 및 재실행

## 필드 검색 기능 추가

### 새로운 검색 옵션 지원
- ptyElasticGetIndex.php: --필드명=검색어 형태의 필드별 검색 옵션 추가
  - 예약된 옵션(elastic, limit, verbose, help)을 제외한 옵션을 필드 검색으로 처리
  - wildcard 패턴 지원 (*검색어, 검색어*, *검색어*)
  - wildcard 없는 경우 term + match 쿼리 조합으로 keyword/text 필드 모두 검색

### 쿼리 생성 로직 개선
- ptyElasticGetIndex.php: bool 쿼리의 must 절을 사용한 복합 검색 지원
  - 일반 검색어와 필드 검색을 AND 조건으로 결합
  - 단일 조건일 때는 불필요한 bool 래핑 생략

## 매핑 정보 출력 개선

### 필드 정보 상세화
- ptyElasticGetIndex.php: 매핑 정보에 analyzer, search_analyzer 컬럼 추가
  - 기존 필드명, 타입에 추가로 분석기 정보 표시
  - 테이블 폭 60자에서 100자로 확장

## 도움말 업데이트

- ptyElasticGetIndex.php: 필드 검색 사용법 및 예시 추가
  - wildcard 패턴 설명 포함
  - 복합 검색 예시 추가 (--law_name, --lw_category)

## 신규 파일 추가

### MySQL 설정 로더 (ptyLibrary_PHP/mysql/ptyMysqlConfig.php)
- MySQL 공통 설정 로더 클래스 추가
- ~/.ptyMysqlConfig.ini 파일 기반 설정 관리
- getSections(), load(), connect() 메서드 제공
- 설정 파일 예시를 반환하는 getConfigExample() 메서드 포함

### MySQL 정보 조회 도구 (ptyMysqlInfo.php)
- MySQL 서버 정보, 상태, 데이터베이스 목록, 사용자 목록 등 조회
- ANSI 색상 코드를 활용한 가독성 높은 출력
- formatBytes(), formatUptime(), padLabel() 유틸리티 함수 포함
- 시스템 DB와 사용자 DB 구분 표시

### MySQL 복원 도구 (ptyMysqlRestore.php)
- SQL 백업 파일을 MySQL로 복원하는 CLI 도구
- --dry-run 옵션으로 실제 실행 전 미리보기 지원
- --force 옵션으로 확인 없이 바로 실행 가능
- 대화형 실행 확인 기능 포함

## 기존 파일 수정

### ptyMysqlBackup.php 리팩토링
- platyFramework 네임스페이스 적용
- ptyCliOptionParser, ptyMysqlConfig 라이브러리 사용으로 전환
- 기존 하드코딩된 설정을 INI 파일 기반으로 변경
- 데이터베이스/테이블 선택적 백업 지원 (* 와일드카드)
- --output 옵션으로 출력 디렉토리 지정 가능
- 백업 파일에 실행 정보 주석 추가
- mysqldump 에러와 stdout 분리 처리

ed83e97 .
e1d6199 .

git-subtree-dir: ptyLibrary_PHP
git-subtree-split: ed83e9704f1adde2c59b35d42cf06221f59751ac

2d0a8ce # 문서 수정

git-subtree-dir: ptyLibrary_PHP
git-subtree-split: 2d0a8cea481cc872d0189ec6374768aaddcf3035

f46f34b # Elasticsearch CLI 도구 모음 리팩토링 및 IDE 설정 추가

git-subtree-dir: ptyLibrary_PHP
git-subtree-split: f46f34bc9fe65307caad8b92bb2bb5812c637e84

## IDE 및 프로젝트 설정

### JetBrains IDE 설정 추가
- .gitignore: JetBrains IDE 자동 생성 파일 제외 규칙 추가
- .idea/.gitignore: IDE 기본 무시 파일 설정
- .idea/modules.xml: 프로젝트 모듈 구성
- .idea/vcs.xml: Git VCS 매핑 설정
- .idea/php.xml: PHP 8.1 언어 레벨 및 코드 분석 도구 설정
- .idea/pty_centos.git.iml: 소스 폴더 및 네임스페이스 매핑 (platyFramework)
- .idea/inspectionProfiles/Project_Default.xml: JSHint 검사 활성화
- .idea/jsLinters/jshint.xml: JSHint 린터 설정

### Claude Code 가이드 추가
- CLAUDE.md: ptyElastic* 스크립트 작성 규칙, 라이브러리 구조, 설정 파일 형식 문서화

## Elasticsearch CLI 스크립트 리팩토링

### 공통 라이브러리 추가
- ptyLibrary_PHP/cli/ptyCliOptionParser.php: CLI 인자 파서 (positional/options 분리)
- ptyLibrary_PHP/elastic/ptyElasticConfig.php: Elasticsearch 설정 로더 및 연결 관리

### 인덱스 조회 도구 개선
- ptyElasticGetIndex → ptyElasticGetIndex.php 리네임:
  - platyFramework 네임스페이스 적용
  - ptyCliOptionParser, ptyElasticConfig 사용으로 코드 간소화
  - --elastic, --verbose, --limit, --help 옵션 추가
  - 직접 cURL 호출 대신 Elastic 클라이언트 사용

### 인덱스 목록 도구 재작성
- ptyElasticGetIndexs 삭제 및 ptyElasticGetIndexs.php 신규 작성:
  - 기존 220줄 → 168줄로 간소화
  - 공통 라이브러리 사용으로 중복 코드 제거
  - 동일한 옵션 체계 적용

### 인덱스 초기화 도구 개선
- ptyElasticTruncateIndex → ptyElasticTruncateIndex.php 리네임:
  - 공통 패턴 적용 (네임스페이스, 옵션 파서, 설정 로더)
  - 안전 확인 프롬프트 유지

### MySQL 데이터 업로드 도구 추가
- ptyElasticUploadFromMysql.php: MySQL 테이블 데이터를 Elasticsearch에 벌크 업로드하는 도구

## 라이브러리 개선

### Elastic.php 클라이언트 개선
- ptyLibrary_PHP/elastic/Elastic.php:
  - setDebug() 메서드 추가로 상세 로그 제어 가능
  - 디버그 모드에서만 요청/응답 로그 출력

## Git 서브트리 관리

### 서브트리 관리 스크립트 추가
- ptyGitSubtree: ptyLibrary_PHP 서브트리 push/pull 자동화 스크립트

9106846 Merge branch 'main' of https://gitlab.platyhouse.com/platyhouse/ptyLibrary_PHP
6d9a7d0 .
4376524 staged 변경 사항을 분석하여 커밋 메시지를 작성합니다.

git-subtree-dir: ptyLibrary_PHP
git-subtree-split: 9106846d7816a6436f71aa898c156d384869d12a

## Git 설정 관리 도구

### 새 스크립트 생성
- ptyGitConfig: Git 설정을 조회하고 관리하는 bash 유틸리티 스크립트 추가

### 주요 기능
- ptyGitConfig: 현재 Git 설정을 출처(global/local/system)별로 색상 구분하여 표시
- ptyGitConfig: 각 설정 항목에 대한 한글 설명 자동 생성 (core, user, color, push, pull, fetch, merge, diff, rebase, branch, credential, commit, tag, log, status, stash, rerere, help, alias, http, gpg, submodule 등)
- ptyGitConfig: 추천 설정 옵션을 현재 설정 상태(✓/○)와 함께 표시

### 명령어 인터페이스
- ptyGitConfig list: 현재 설정만 표시
- ptyGitConfig recommend: 추천 설정만 표시
- ptyGitConfig get <key>: 특정 설정 값 확인
- ptyGitConfig set <key> <value>: 로컬 설정 변경
- ptyGitConfig set-global <key> <value>: 전역 설정 변경

62e744a added claude.md
9c0e44d Merge commit '9719b49b' as 'ptyLibrary_PHP'
ff12f5ed .
09c3224c # Git Subtree 관리 스크립트 및 ptyLibrary_PHP 문서 추가
98a97fab Merge commit '826151f0' as 'ptyLibrary_PHP'
826151f0 Squashed 'ptyLibrary_PHP/' content from commit 3b9d4a2
5b0630d2 # Elasticsearch 인덱스 관리 도구 추가 및 파일명 변경
e99df3bf # Elasticsearch 인덱스 조회 도구 추가
7e556677 .
84040285 .
ab20fd47 커밋을 실행하기 위해 사용자의 승인이 필요합니다. 위에서 생성된 커밋 메시지로 진행하시겠습니까?
ef186295 커밋을 실행하기 위해 사용자의 승인이 필요합니다. 위에서 생성된 커밋 메세지로 진행하시겠습니까?
37138bf4 .
2b37a47a # MySQL 백업 스크립트 로깅 기능 개선
fe6f01ca # MySQL 백업 기능 개선
0150a02b .
6fa9c8f8 .
db45717f added ptySystemInfo
7533b418 alias ll 에 시간값 표기 추가
1c579af5 Merge branch 'master' of https://gitlab.platyhouse.com/platyhouse/centos
043f9507 .
749c6ecf # 파일 검색 도구 파일명 변경
8f2e4f41 # 파일 검색 도구 파일명 변경 및 기본 검색 모드 개선
2ccd6345 # Bash 프롬프트 개선 및 주석 통일
1185eb47 # 파일 검색 도구 강제 삭제 기능 추가
a8848b29 # Tmux 모니터링 도구 세션 정렬 개선
7f409da2 # Tmux 세션 관리 도구 추가
246e711d .
94d0fac6 refs ptyGitCommit
c8bb469a refs ptyGitCommit
d96b6dd8 .
eb9d0a92 .
f596a2d6 ptySetBash
25dea45a .
8b00b120 bash, zshrc 설정 통합, ptySetBash 추가
b35dff70 Merge branch 'master' of https://gitlab.platyhouse.com/platyhouse/centos
cd5ffac5 Git 자동화 스크립트 파일명 변경 및 재구성
1dc3fe23 pty 스크립트 및 gacc 파일 업데이트
aeba5156 .
afff0c6b added pty_files_find.sh
27d5c851 added pty_files_find.sh
e5428cac added pty_files_find_old.sh
16e8ca08 refs pty
99fdd8c6 refs pty_git.sh
a7141361 added pty_git.sh
877fd4d2 added pty_setup_centos_en.sh
5eb66179 refs pty_setup_centos.sh
51be0c11 refs pty_setup_centos.sh
34c7f081 added pty_setup_centos.sh
f485871b .
0a0d1265 added exclude t_pty_logs & t_pty_inbounds
5f6f6f5b added pty_storyshare_check_old_app.php
9274d990 .
3560818d refs pty_mysql_backup
ce798aed renamed .
2369d2b8 refs pty_docker_save.sh
d907044e added pty_get_folder_last_time.php
9cc32008 .
d5d64826 added mysql dump utf8mb4
37365626 added pty_mysql_backup_all_table.php
29c1260d .
547d5592 added pty_mysql_optimize.sh
4b82a725 .
f052cf9c added pty_docker_save.sh

git-subtree-dir: ptyLibrary_PHP
git-subtree-split: 62e744a2b4c425fb517d837cb03df8449d43b0eb

git-subtree-dir: ptyLibrary_PHP
git-subtree-split: 3b9d4a286dd9ac4fa2fd968ca338b39c6cc34fdc

## Git Subtree 관리 도구

### ptyGitSubTreeAdd
- ptyGitSubTreeAdd: Git subtree를 새로 추가하는 스크립트
  - 폴더명, remote 주소, 브랜치명을 인자로 받아 subtree 추가
  - 이미 존재하는 폴더 체크 및 remote 자동 등록/업데이트 기능
  - --squash 옵션으로 히스토리 압축하여 병합
  - 실패 시 등록된 remote 자동 제거

### ptyGitSubTreePull
- ptyGitSubTreePull: 기존 subtree를 원격 저장소에서 업데이트하는 스크립트
  - 폴더명과 브랜치명을 인자로 받아 subtree pull 수행
  - 폴더 존재 여부 및 remote 등록 여부 검증
  - --squash 옵션으로 히스토리 압축

### ptyGitSubTreePush
- ptyGitSubTreePush: subtree 변경사항을 원격 저장소로 push하는 스크립트
  - 폴더명과 브랜치명을 인자로 받아 subtree push 수행
  - 폴더 존재 여부 및 remote 등록 여부 검증

## ptyLibrary_PHP 문서화

### CLAUDE.md
- ptyLibrary_PHP/CLAUDE.md: Claude Code를 위한 라이브러리 가이드 문서 추가
  - 프로젝트 구조 및 디렉토리 설명
  - ptyMysql 데이터베이스 클래스 사용법 (Fluent 인터페이스, 날짜 필터, prepared statement)
  - 공통 유틸리티 함수 목록 (유효성 검사, 배열/문자열 처리, HTTP, 디버그)
  - CLI 로깅 컴포넌트 설명
  - 코드 컨벤션 (네임스페이스, 메소드 체이닝, 전역 상태)

git-subtree-dir: ptyLibrary_PHP
git-subtree-split: 3b9d4a286dd9ac4fa2fd968ca338b39c6cc34fdc

## 새로운 도구 추가

### Elasticsearch 인덱스 초기화 도구
- ptyElasticTruncateIndex: Elasticsearch 인덱스의 모든 문서를 삭제하는 CLI 도구 추가
  - ~/.ptyElasticConfig.ini 설정 파일을 통한 연결 정보 관리
  - 삭제 전 인덱스 정보(상태, 문서 수, 저장 용량) 표시
  - 샘플 문서 10개 미리보기 기능 제공
  - 안전을 위한 'yes' 입력 확인 절차 구현
  - 컬러 출력을 통한 경고 및 결과 강조 표시

## 파일명 변경

### 명명 규칙 개선
- ptyCatLastFile → ptyFileCatLastFile: 파일 관련 도구임을 명확히 하기 위해 접두사 'ptyFile'로 변경

## 인덱스 조회 도구 구현

### 인덱스 목록 조회 도구
- ptyElasticGetIndexs: Elasticsearch 전체 인덱스 목록 조회 스크립트 추가
  - 인덱스별 상태, 문서 수, 용량, Health 상태 표시
  - 인덱스별 생성 시간 및 마지막 색인 시간 표시
  - 총 인덱스 수, 총 문서 수, 총 용량 요약 정보 제공
  - 설정 파일(~/.ptyElasticConfig.ini) 기반 접속 인증 지원

### 단일 인덱스 상세 조회 도구
- ptyElasticGetIndex: 특정 인덱스의 상세 정보 및 문서 조회 스크립트 추가
  - 인덱스 기본 정보(Health, Status, 샤드 수, 문서 수, 용량) 조회
  - 인덱스 설정(생성 날짜, UUID, 버전, 샤드 설정) 조회
  - 인덱스 통계(색인/검색 작업 수 및 소요 시간) 조회
  - 필드 매핑 정보(필드명 및 타입 목록) 조회
  - 검색어 기반 문서 조회 기능 (와일드카드 및 AND 연산 지원)
  - TOP 50 문서 샘플 조회 기능
  - 컬러 출력 지원(필드명, ID, URL 강조 표시)

## 로깅 시스템 개선

### 타임스탬프 출력 기능 추가
- **ptyMysqlBackup.php**:
  - logMessage() 함수 추가로 모든 출력에 타임스탬프 자동 포함
  - 기존 echo 호출을 logMessage()로 전면 교체
  - 에러 발생 시 exit(1)로 명시적 종료 코드 반환

## 백업 안정성 향상
- **ptyMysqlBackup.php**: mysqldump 명령어에 --max-allowed-packet=1G 옵션 추가하여 대용량 데이터 백업 시 패킷 크기 제한 문제 해결