Commits · f3fd6732c28c8522dabf1f7fb1dbca1e98c3ba4c · platyhouse / centos

24 Dec, 2025 2 commits

platyhouse authored Dec 24, 2025

## ptyLibrary_PHP/ai/ 라이브러리 확장

### Ollama API 클라이언트 신규 추가
- ptyLibrary_PHP/ai/ollama.api.common.model.php: Ollama API 클라이언트 클래스 신규 작성
  - OpenAI 호환 형식의 /api/chat 엔드포인트 사용
  - setApiUrl(), setModel(), setMaxTokens(), setTemperature() 설정 메서드 제공
  - get(), getSimple(), getWithSystem() API 호출 메서드 구현
  - 대화 기록 유지 기능 (keepHistory 옵션)
  - 디버그 모드 지원 (curl 요청/응답 출력)

### AI 설정 로더 개선
- ptyLibrary_PHP/ai/ptyAIConfig.php:
  - ollama.api.common.model.php 파일 require 추가
  - ollama provider 유효성 검증 추가 (apiKey 필수 검증에서 제외)
  - apiUrl 설정 필드 지원 추가
  - ollama 기본 모델(llama3) 설정 추가
  - createClient()에 OllamaAPIModel 클라이언트 생성 로직 추가
  - getConfigExample()에 ollama 섹션 예시 추가

## ptyAIGetMessage.php CLI 도구 개선

- ptyAIGetMessage.php:
  - 도움말에 ollama 모델 예시 추가 (llama3, mistral, codellama, gemma2)
  - 섹션 목록 출력 시 apiUrl 표시 로직 추가 (ollama용)
  - apiKey 없는 경우 출력 생략 처리
  - extractUsage()에 ollama 토큰 사용량 파싱 추가 (prompt_eval_count, eval_count)

## 문서화

- CLAUDE.md: ptyAIGetMessage 도구 문서 신규 추가
  - CLI 옵션 및 사용 예시
  - ~/.ptyAIConfig.ini 설정 파일 형식
  - 지원 provider 목록 (anthropic, openai, google, ollama)
  - JSON 출력 형식 설명
  - 라이브러리 구조 및 클래스 사용법
  - 각 provider별 토큰 사용량 응답 위치 정리

f3fd6732

# AI 통합 CLI 도구 및 멀티 프로바이더 API 지원 추가 · 3bbc8485

platyhouse authored Dec 24, 2025

## 새로운 AI CLI 도구

### ptyAIGetMessage.php
- 다중 AI 프로바이더(Anthropic, OpenAI, Google)를 지원하는 CLI 메시지 도구 추가
- `--ai=섹션명` 옵션으로 설정 파일의 섹션 선택 지원
- `--model=모델명` 옵션으로 런타임 모델 오버라이드 지원
- `--anthropic-beta=기능명` 옵션으로 Claude 베타 기능 오버라이드 지원
- `--verbose` 옵션으로 토큰 사용량 및 curl 디버그 정보 출력
- `--json` 옵션으로 JSON 형식 출력 지원
- 프로바이더별 토큰 사용량 추출 함수 구현 (Anthropic, OpenAI, Google 각각)

## AI 설정 관리

### ptyLibrary_PHP/ai/ptyAIConfig.php
- `~/.ptyAIConfig.ini` 설정 파일 기반의 통합 AI 설정 로더 클래스 추가
- 프로바이더별 기본 모델 자동 설정 기능
- `connect()` 메소드로 설정과 클라이언트 인스턴스를 함께 반환
- `anthropic-beta` 설정 지원으로 Claude 베타 기능 활성화 가능

## API 클라이언트 개선

### ptyLibrary_PHP/ai/claude.api.common.model.php
- `setAnthropicBeta()` 메소드 추가로 `anthropic-beta` 헤더 설정 지원
- `setDebug()` 메소드 추가로 curl 요청/응답 디버그 출력 지원
- 디버그 모드에서 API 키는 앞 12자만 마스킹하여 표시

### ptyLibrary_PHP/ai/chatgpt.api.common.model.php
- `setDebug()` 메소드 추가로 curl 요청/응답 디버그 출력 지원
- `isNewModel()` 메소드 추가로 o1, o3, gpt-5 등 신규 모델 감지
- 신규 모델은 `max_completion_tokens` 사용, 기존 모델은 `max_tokens` 사용하도록 분기 처리

### ptyLibrary_PHP/ai/gemini.api.common.model.php
- Google Gemini API 클라이언트 클래스 신규 추가
- `get()`, `getWithSystem()`, `getSimple()` 메소드로 다양한 호출 방식 지원
- 대화 기록 유지 기능 (`keepHistory` 파라미터)
- `systemInstruction`을 통한 시스템 프롬프트 지원

3bbc8485

23 Dec, 2025 5 commits

이제 모든 staged 변경 사항을 확인했습니다. 커밋 메세지를 작성하겠습니다. · 93f54f7a

platyhouse authored Dec 23, 2025

# MySQL 도구 기능 개선 및 ptyMysqlOverwrite 스크립트 추가

## ptyMysqlOverwrite 추가

### ptyMysqlOverwrite.php
- 서로 다른 MySQL 서버/DB 간 테이블 복사 도구 신규 구현
- ptyMysqlBackup.php와 ptyMysqlRestore.php를 내부적으로 활용
- 임시 디렉토리에 백업 → 테이블명 변환(sed) → 복원 순서로 동작
- 소스/대상 테이블명이 다를 경우 SQL 내 테이블명 자동 변환
- --force 옵션으로 확인 없이 실행 가능
- 프로세스 종료 시 임시 파일 자동 정리

## ptyMysqlRestore 기능 개선

### ptyMysqlRestore.php
- --table 옵션 추가: 다른 테이블명으로 복원 가능
- --database 옵션을 --db로 변경 (일관성)
- transformTableName() 함수 추가: sed로 SQL 내 테이블명 스트리밍 변환
- 원본과 다른 테이블명 복원 시 표시 개선 (← 원본DB.원본테이블)
- 임시 변환 파일 자동 정리 로직 추가

## ptyElasticUploadFromMysql 분석기 설정 개선

### ptyElasticUploadFromMysql.php
- MySQL comment의 elastic.analyzer 설정 시 usedAnalyzers에 수집하도록 수정
- getAnalyzerSettings() 메소드 추가: 사용된 analyzer별 설정 자동 생성
- nori 기반 analyzer 자동 인식 및 tokenizer 설정 생성
- 인덱스 생성 시 analysis 설정 동적 구성으로 변경

## 문서 업데이트

### CLAUDE.md
- ptyElasticUploadFromMysql 상세 문서 추가 (사용법, 파일 구조, 타입 변환 규칙)
- MySQL comment에서 elastic.* 설정 파싱 규칙 문서화
- Nori analyzer 자동 설정 동작 방식 설명
- ptyMysql* 스크립트 작성 규칙 추가
- ptyMysqlInfo, ptyMysqlBackup, ptyMysqlRestore, ptyMysqlOverwrite 사용법 문서화

93f54f7a

# MySQL 컬럼 comment 기반 Elasticsearch 매핑 설정 기능 추가 · e202048b

platyhouse authored Dec 23, 2025

## ptyElasticUploadFromMysql.php

### 새로운 기능: elastic.* 옵션 파싱
- parseElasticOptions() 메소드 추가: MySQL 컬럼 comment에서 elastic.* 설정 파싱
  - elastic.register=0: 해당 컬럼을 인덱스에서 제외
  - elastic.type=text|keyword: Elasticsearch 필드 타입 지정
  - elastic.analyzer=분석기명: analyzer 설정

### 테이블 구조 조회 개선
- DESCRIBE 대신 SHOW FULL COLUMNS 사용하여 컬럼 comment 정보 획득
- elastic.register=0인 컬럼을 매핑에서 제외하는 로직 추가
- elastic.type 지정 시 자동 변환 대신 해당 타입 사용
- elastic.analyzer 설정 시 해당 analyzer를 매핑에 추가

### 데이터 업로드 시 제외 컬럼 처리
- excludedColumns 멤버 변수 추가: elastic.register=0인 컬럼 목록 저장
- 벌크 업로드 시 excludedColumns에 포함된 컬럼 데이터 제거
- 기존 인덱스에 데이터만 업로드할 때도 getTableStructure() 호출하여 제외 컬럼 정보 획득

### 도움말 개선
- MySQL 컬럼 comment 설정 옵션 설명 추가
- 사용 예시 추가

e202048b

# ptyRun 기본 동작 변경 및 gitignore 업데이트 · 748c0e17

platyhouse authored Dec 23, 2025

## 기본 동작 변경
- ptyRun: --run-duplicate 옵션의 기본값을 false에서 true로 변경
  - 중복 실행 차단이 필요한 경우에만 명시적으로 --run-duplicate=false 지정
  - --max-run-time 옵션이 --run-duplicate=false일 때만 동작함을 명시

## 문서 및 도움말 업데이트
- ptyRun: 도움말 텍스트와 예제를 새로운 기본값에 맞게 수정
  - 예제에서 --run-duplicate=false 옵션을 명시적으로 포함

## 기타
- .gitignore: ptyRun_logs 폴더를 버전 관리에서 제외

748c0e17

# ptyRun 로그 기능 개선 · 90e5436c

platyhouse authored Dec 23, 2025

## 문서 업데이트

### CLAUDE.md
- ptyRun 설명 업데이트: 로그 출력 및 저장 기능에 대한 설명 추가
- 기본 사용 예시 수정: 로그 저장 위치 및 보관 기간 명시
- 새로운 옵션 예시 추가: --no-log, --log-rotate-date, --log-rotate-count, --log-dir
- 옵션 목록에 --no-log, --log-dir, --log-rotate-date, --log-rotate-count 추가
- 로그 파일 섹션 추가: 파일명 형식, 저장 위치, 기록 내용 설명

## 스크립트 기능 개선

### ptyRun
- --no-log 옵션 추가: 로그 파일 저장을 비활성화하는 기능
- log-rotate-date 기본값 변경: 0(무제한)에서 90일로 변경
- 로그 활성화 조건 처리: $noLog 변수를 통해 로그 관련 동작 제어
- 로그 디렉토리 생성 조건화: 로그 활성화 시에만 디렉토리 생성
- 로그 로테이션 조건화: 로그 활성화 시에만 로테이션 실행
- 로그 파일 핸들링 개선: null 체크를 통한 안전한 파일 쓰기
- stdout/stderr 쓰기 로직 개선: 로그 활성화 여부에 따른 조건부 기록
- 도움말 문구 업데이트: 새로운 옵션 및 변경된 기본값 반영

90e5436c

# ptyRun 로그 출력 및 로테이션 기능 추가 · d82e93c4

platyhouse authored Dec 23, 2025

## 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 속성 추가로 외부 연동 정보 저장 가능

d82e93c4

22 Dec, 2025 2 commits

# ptyUpdate 스크립트 추가 · b2f61522

platyhouse authored Dec 22, 2025

## 새 파일

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

b2f61522

# 프로젝트 문서 및 유틸리티 스크립트 추가 · 154429fe

platyhouse authored Dec 22, 2025

## 문서화

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을 통한 강제 종료 및 재실행

154429fe

18 Dec, 2025 1 commit

# 필드별 검색 기능 추가 및 매핑 정보 출력 개선 · e4108146

platyhouse authored Dec 18, 2025

## 필드 검색 기능 추가

### 새로운 검색 옵션 지원
- 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)

e4108146

17 Dec, 2025 1 commit

# MySQL 도구 추가 및 ptyMysqlBackup 리팩토링 · c305821b

platyhouse authored Dec 17, 2025

## 신규 파일 추가

### 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 분리 처리

c305821b

16 Dec, 2025 20 commits

Merge commit '381902e6 ' · acc2c1ef
platyhouse authored Dec 16, 2025

acc2c1ef

Squashed 'ptyLibrary_PHP/' changes from 2d0a8ce..ed83e97 · 381902e6