ai-service-team | FOS Study

READMEai-service-team 시리즈에 대하여

README.md

회사: NHN | 팀: AI 서비스 개발팀

AI 서비스 플랫폼에서 진행한 주요 업무를 정리한 문서 모음. (2025.12 ~)

문서 목록

신규 구현

기간	업무	문서
2026.01 ~ 2026.03	Confluence 벡터 색인 배치 — RAG 파이프라인, Spring Batch, OpenSearch	rag-vector-search-batch.md
2026.04	AI 웹툰 제작 도구 MVP — Next.js + Gemini + 하네스 기반 12일 풀스택	webtoon-maker-ai-pipeline.md

트러블슈팅

기간	업무	문서
2026.04	OCR 서버 배포·스케일인 시 503 에러 수정 — Graceful Shutdown 미적용	graceful-shutdown-503-fix.md

리팩터링

기간	업무	문서
2026.03	임베딩 메타데이터 구성 개선 — Blocklist → Allowlist, EmbeddingMetadataProvider	embedding-metadata-provider.md

기간별 주요 업무

2025 하반기 ~ 2026 상반기 (2025.12 ~)

Confluence 벡터 색인 배치: Confluence 문서를 OpenSearch에 벡터 색인하는 Spring Batch 파이프라인 설계 및 구현
- ADF → Markdown 변환, 임베딩 비동기 처리(AsyncItemProcessor), 삭제 동기화, 다중 스페이스 지원
- 변경 감지(version 비교), 데이터 보강(첨부파일·작성자·멘션), 전략 패턴 기반 메타데이터 확장
임베딩 메타데이터 구성 개선: blocklist(remove) → allowlist(provider) 방식 전환, EmbeddingMetadataProvider 인터페이스 도입으로 OCP 준수
OCR 서버 배포·스케일인 503 에러 수정: Envoy drain_listeners 후 SIGTERM 즉시 종료로 발생한 30~60초 503 묶음 — gRPC 서버에 graceful shutdown 적용해 preStop sleep 동안 in-flight 요청을 마저 처리하도록 종료 시퀀스 재정렬
AI 웹툰 제작 도구 MVP: 12일 단독 풀스택 — 웹소설 → 세계관/캐릭터/각색/글콘티 → 60컷 이미지 6단계 파이프라인
- Claude Code 하네스 기반 4인 에이전트 팀(planner/critic/executor/docs-verifier)으로 12일/199 plan/760 커밋
- vibe 코딩 → spec 기반 코딩 진화: /planning → /plan-and-build → /build-with-teams, 디자이너 통합용 /integrate-ux 스킬화
- Gemini 모델 전략(퀄리티 우선 + 429 fallback + 전역 Rate Limit Tracking), 통합 분석으로 토큰 75% 절감
- 글콘티 환각 차단: Grounding 블록 + Continuation 재주입 + Project 단위 Context Cache (ADR-132)
- 캐릭터 외형 고정: 텍스트 anti-drift 한계 → mode 분기 + 기본 시트 이미지 자동 레퍼런스 prepend (ADR-133/134)
- 디자이너 협업: Container/Presenter + Layout Primitives + 파일 소유권 매트릭스로 git conflict 해소 (ADR-129/130)
- 타입 시스템: Zod ↔ Prisma 레이어별 분리(Action=Zod / Repository=Prisma) + mapper로 경계 정리 (ADR-131)

기술 키워드

Spring Boot 3.x Java 21 Spring Batch OpenSearch RAG Vector Search Next.js 16 React 19 Prisma 7 Zod 4 Gemini 3 @google/genai SSE Claude Code 하네스

02이 폴더의 글

4 posts

— 001

12일간 AI 웹툰 제작 도구 MVP 만들기 — 하네스 파이프라인으로 혼자 풀스택 돌리기

진행 기간: 2026.04.06 2026.04.30 (전반 12일 MVP + 후반 12일 안정화·운영 단계) 웹소설 원작을 받아 운영자가 작가 없이 웹툰 컷 이미지까지 뽑아내는 MVP를 짧은 기간에 만들어 보자는 사내 과제가 떨어졌다. 참여 인원은 나 한 명이었고, 프론트/백/DB/AI 파이프라인을 전부 내가 붙여야 하는 상황이었다. 요구한 범위가 좁지 않...

—
—

— 002

Confluence 문서를 OpenSearch에 벡터 색인하기 — Spring Batch 파이프라인 설계기

진행 기간: 2026.01 2026.03 사내 AI 서비스에 RAG 기능을 붙이기 위해 Confluence 문서를 벡터 DB에 색인하는 배치 파이프라인을 처음부터 설계하고 구현했다. 단순히 텍스트를 긁어 넣는 것부터 시작해서, 댓글·첨부파일 처리, 삭제 동기화, 다중 스페이스 지원까지 점진적으로 확장한 과정을 정리했다. --- AI Playground는 사...

—
—

— 003

OCR 서버 배포·스케일인 시 503 에러 수정 — Graceful Shutdown 미적용

진행 기간: 2026.04 > Graceful shutdown 개념은 devops/graceful-shutdown.md 참고 --- General OCR 서비스를 배포(롤링 업데이트)하거나 오토스케일러가 스케일인할 때마다 짧은 시간 동안 503 에러가 클러스터 단위로 발생했다. 에러 로그를 보면 패턴이 일정했다. upstream connect error o...

—
—

— 004

임베딩 메타데이터 구성 방식 개선 — Blocklist에서 Allowlist로

진행 기간: 2026.03 RAG 파이프라인에서 임베딩 API에 전달할 메타데이터를 구성하는 방식을 blocklist(remove)에서 allowlist(provider) 방식으로 전환했다. 전략 패턴을 실제로 적용한 리팩터링 경험을 정리했다. > 전략 패턴 개념 정리: 디자인 패턴 - 전략 패턴 --- RAG 파이프라인은 Confluence, 사내 협업...

—
—