공개 저장소에서 확인할 수 있는 구현
문서 변환 API와 AI 보조 개발 도구의 실제 처리 흐름입니다. 각 도식의 근거에서 확인한 버전의 코드로 이동할 수 있습니다.
01 · 구성 및 역할
HWP 계열 문서 → PDF API
Windows의 한컴 자동화를 별도 Python 프로세스로 호출하고, 변환 결과를 다운로드 경로로 돌려주는 프로토타입입니다.
02 · 처리 흐름
AI 보조 개발 · 미리보기와 검토
서로 독립된 두 공개 도구가 실행 전후에 남기는 검토 자료를 정리했습니다.
근거와 해석 범위
- 위 경로의 DryRun에서는 모델·테스트를 실제 실행하지 않습니다. 실행하지 않은 점검을 통과 결과로 표시하지 않습니다.
- 아래 경로의 audit-only는 검토 요약을 만드는 모드입니다. 다른 선택형 수정·커밋 모드까지 모두 읽기 전용이라는 뜻은 아닙니다.
- 저장소에 테스트가 있다는 사실과 이번 작업에서 전체 테스트를 실행했다는 사실을 구분합니다.
ai-service-template fff78dd, claude-codex-vibekit 9cf9263의 실행 스크립트·게이트 문서 기준입니다. 두 도구를 통합 시스템으로 표현하지 않았습니다.
공개 저장소에서 직접 확인할 수 있는 문서 변환 API와 AI 보조 개발 워크플로를 묶었습니다. 고객 자료를 복제하지 않고도 입력, 처리 단계, 산출물과 구현 한계를 살펴볼 수 있는 기술 근거입니다.
HWP 계열 파일을 받아 Windows 한컴 자동화로 PDF를 생성하는 FastAPI 프로토타입입니다. 업로드, 작업 파일 준비, 별도 변환 프로세스, 결과 확인과 다운로드로 이어집니다. 배치 변환은 파일별로 순차 처리하며, 공개 호스팅 서비스나 다중 워커 시스템은 아닙니다.
AI Service Template은 목표와 점검 범위를 받아 DryRun·프롬프트 생성부터 시작합니다. 명시적으로 실행을 선택한 경우 구현·리뷰 도구를 호출하고, 제한된 수정 반복과 테스트 결과를 검토 자료로 남깁니다. 실행하지 않은 테스트는 통과로 처리하지 않습니다.
Claude-Codex Vibekit은 PRD·코드·디자인·릴리스 단계의 검토를 구성하는 별도 도구입니다. audit-only에서는 문제와 우선순위를 요약하고, 선택형 Git 보호 훅과 설치 점검을 제공합니다. 앞선 실행 도구와 자동으로 연결되는 하나의 서비스로 설명하지 않습니다.
공개 사례 라이브러리에는 고객 원문을 제외한 RAG 설계와 검증 설명을 정리했습니다. 사례 문서가 있다는 사실과 해당 고객의 원본 구현 전체가 공개돼 있다는 사실을 구분합니다. 직접 코드로 확인할 수 있는 산출물은 도식 아래의 공개 저장소 링크로 연결했습니다.
문서 변환 처리도와 두 개발 도구의 작업 흐름도를 만들고, 확인한 커밋의 코드·문서 링크를 붙였습니다. 이번 작업은 코드 대조이며 한컴 변환 실행, 모델 호출 또는 각 도구의 전체 테스트를 새로 수행한 결과는 아닙니다. 고객 서비스의 매출·성능 성과와도 구분합니다.
공개 코드의 확인 버전을 근거 링크로 제공합니다. 코드 검토와 실행·상용 검증은 구분합니다.
공개 산출물과 직접 확인할 근거
| 항목 | 코드·자료에서 확인한 내용 | 해석 범위 |
|---|---|---|
| 문서 변환 | 업로드 → 별도 프로세스 → 한컴 자동화 → PDF | Windows·한컴 의존 프로토타입 |
| 실행 도구 | DryRun, 명시적 실행, 제한된 수정 반복, 인계 문서 | 로컬 개발 작업 흐름 |
| 검토 도구 | PRD·코드·디자인·릴리스 게이트와 Git 보호 훅 | 모든 오류를 자동 발견한다는 의미 아님 |
| RAG 사례 라이브러리 | 익명화된 설계·검증 설명 | 고객 원본 구현 전체 공개 아님 |
각 도식의 근거 링크는 확인한 공개 커밋에 고정했습니다. 저장소 코드의 존재와 실제 운영·상용 성과는 구분합니다.