Keunsik Works @givepro91
← Work

Markbrief — 양식 보고서 컴파일러

Markdown 한 장을 등록된 양식 템플릿에 맞춰 DOCX·HWPX·PDF 보고서로 자동 컴파일하는 SaaS·API입니다.

문제

공공·법무·금융처럼 고정 양식으로 보고서를 반복 작성하는 환경에서, 양식과 내용이 엉켜 매번 수작업이 들었습니다.

역할

단독으로 설계·구현했습니다.

선택 · 결정

변환 엔진을 도메인 무지(domain-agnostic) 코어로 분리하고, API·콘솔·SDK 모든 진입점이 단일 백엔드를 호출하게 했습니다. 한국 시장을 위해 HWPX를 1급 출력으로 지원했습니다.

결과

코어 이식·REST API·웹 콘솔을 완성하고 SDK 단계로 진행했습니다.

배운 점

dogfooding을 위해 SDK보다 콘솔을 먼저 만든 결정이, 제품의 실제 구멍을 더 빨리 드러냈습니다.

결정 로그

한글 PDF의 변환 비호환을 자동 패처로 격리해, 변환 난점을 별도 파이프라인으로 떼어냈습니다.

파이프라인이 하나 늘었지만, 본 엔진은 깨끗하게 유지됐습니다.

테마 · 개발자 도구
기술 · Python, FastAPI, python-docx, python-hwpx, Next.js
규모 · 단독 · 116 커밋
공개 · 비공개 — 서사만
Risk Check · 장근식 (2026-06-04)