[스나이퍼팩토리] 한컴AI 2기 - OWPML 프로젝트 0주차

OWPML필터 기반의 문서검색 서비스를 만들기로 했다.

나의 역할은 팀장, PM, 백엔드 전담이다. 요구 기술스택에 대한 이해를 바탕으로, 전반적인 통합을 내가 이끌게 될 것이다.

작성한 프로젝트 기획서는 아래와 같다.

프로젝트 기획서

1. 프로젝트 개요

1.1. 기획 목적

OWPML 기반 문서 이해 파이프라인을 구축하여, 한글 문서(HWPX)의 내용을 구조적으로 분석하고 질의응답이 가능한 AI 문서 어시스턴트 「알랭(AlAin)」을 개발한다. ‘문서 이해 및 질의응답’ 핵심 기능인 RAG 기반 검색·응답 시스템 개발을 지원하고, 문서 구조 인식, 벡터 임베딩, 프롬프트 엔지니어링을 통합한 완성형 프로토타입을 구현한다.

1.2. 기획 배경

기업·기관에서 사용하는 다수의 공문서와 보고서가 HWPX 형식으로 저장되어 있으나, 이 형식은 일반 텍스트 검색이나 LLM 학습에 바로 활용하기 어렵다. 따라서, OWPML 필터를 활용해 문서의 구조적 정보를 보존하며 텍스트를 추출하고, 이를 기반으로 문서 내 질문에 정확한 근거와 함께 답변을 제시하는 한국어 문서 특화 RAG 시스템이 필요하다. 본 프로젝트는 한글 문서 파싱–임베딩–검색–응답까지의 엔드투엔드 파이프라인을 구현하고, 사용자 입장에서는 문서를 업로드하면 내용을 이해하고 대답하는 웹 서비스로 경험할 수 있도록 프론트엔드–백엔드 통합형 문서지능 서비스(AlAin)를 개발하기 위해 진행한다.

1.3. 주요 타겟

HWPX 문서에서 필요한 정보를 빠르게 찾고자 하는 공공기관·기업 실무자 (예: 사업공고 검토자, 지침서 담당자, 내부문서 검색자) 문서 기반 AI 챗봇을 구축하려는 개발자 및 연구자 AlAin의 구조를 통해 국산 문서 포맷(HWPX) 기반 RAG 구현 사례를 학습하고 자체 문서 Q&A 시스템으로 확장하고자 하는 사용자 문서 이해 자동화에 관심 있는 일반 사용자 “문서를 올리면, 문서가 말해주는 AI” 경험을 통해 문서 이해의 새로운 방식 체험

 

기능정의서 초안

구분	필요 기능	래퍼런스/상세설명	필요기술	중요도
회원 FE + BE	이메일 로그인 구글 로그인 회원가입 비밀번호 찾기	MySQL 사용   회원가입: 이메일, 비밀번호, 닉네임	DBMS	★☆
관리자 FE + BE	문서 업로드 및 처리	HWPX 파일 업로드 후 OWPML 파싱	Python, FastAPI	★★★★
관리자 FE + BE	어드민 페이지 (대시보드, 문서관리, 프로젝트 관리 등)	업로드된 문서 리스트 관리	FastAPI + Admin UI	★★★
AI개발 + FE	추천질문 기능	추천 질문 생성 및 바로 실행	FastAPI + React	★★
AI개발 + FE	근거 하이라이트	원문 내 근거 문단 강조	React HighLNight.js	★★★
AI개발 + FE	질의응답	문맥 기반 Q&A 생성 + 근거 표시	GPT API + RAG	★★★★★
AI개발	텍스트·메타 추출	문단·제목·섹션 태그 구조화	OWPML Parser	★★★★
AI개발	청킹 & 임베딩	문단 단위로 쪼개고 벡터화	bge-m3-korean, pgvector	★★★★★
FE	FAQ버튼	주요 질문 바로 실행	React, JSON Config	★

가장 필수적인 기능들만 분류했고, 간단한 설명 및 요구 기술에 대해 작성했다. 또한 프로젝트 관점에서의 중요도 또한 병기했다.

WBS - 간트차트

작업구조를 분해했고, 이를 바탕으로 간트차트를 만들었다.

TASK별로 정, 부 담당자를 기입했고, 계획 시작일 및 예상 완료일을 기입했다. 놓친 내용들이 분명 있을 수 있어서, 일자별 백업을 해두고, 지속 업데이트 하기로 했다.

아키텍처 설계도

최초버전 -> 이후버전

최초에는 깃허브 README.MD와 유사한 마크다운 느낌으로 작성했었는데, 강사님의 피드백을 받고 다이어그램 이미지로 변경하였다. 머메이드 다이어그램 또한 고려했으나, 최종적으로 피그마로 만들었다.