[나의 앱 개발기] 비개발자가 AI로 공문 자동화 도구를 만들다 실패한 이야기

노조 집행부 일을 맡고 나서 가장 먼저 든 생각이 있었습니다. "이 공문 작업, 매번 이렇게 하는 건 너무 비효율적이다." 문서번호, 수신처, 제목, 본문을 매번 Word에서 양식 불러와서 고치고, PDF로 저장하고, 메일로 보내고. 반복되는 루틴이 몇 달째였습니다.

저는 개발자가 아닙니다. Google Apps Script를 조금 만져본 정도가 전부인 사람이에요. 그런데 어느 순간 Claude AI와 대화하다가 '이거, 나도 만들 수 있지 않을까?' 싶었거든요. 그래서 시작했습니다. 결론부터 말하면, 수십 번의 수정, 수십 번의 오류를 거쳤고, 지금도 완벽하게 작동하진 않습니다. 그런데 이 과정에서 건진 게 꽤 많았어요.

이 글은 그 실패의 기록입니다.

목차

1. 어떤 걸 만들려고 했나

2. 계속 발목을 잡은 오류들

3. 끝내 해결 못 한 것들

4. 그래도 이 경험에서 건진 것들

5. 다음 단계: 뭘 보완할 건지

* 어떤 걸 만들려고 했나.

목표는 단순했습니다. 공문 양식 위에 텍스트를 입력하면, 그게 그대로 PDF로 뽑히는 웹앱. Flask 같은 서버 없이, HTML 파일 하나로 돌아가는 형태로요. 누구한테 서버 빌려달라고 부탁하기도 귀찮고, 회사 PC에 뭔가 설치하는 것도 번거로우니까요.

구체적인 기능 목록은 이랬습니다.

  • 공문 양식 이미지를 배경으로, 그 위에 입력 박스 배치
  • 왼쪽에 입력하면 오른쪽 미리보기에 실시간 반영
  • 기존 PDF 공문을 불러오면 Claude AI가 내용 자동 추출
  • 본문 편집 가능 (글꼴, 크기, 정렬, 줄간격)
  • PDF로 저장
  • 작성한 문서 저장 및 불러오기

이걸 Claude와 대화하면서 하나씩 만들었습니다. 코드를 직접 짜는 게 아니라, Claude가 짜준 코드를 HTML 파일에 붙여넣고, 실행해보고, 안 되면 다시 물어보는 방식으로요. 처음엔 생각보다 잘 됐습니다. 그래서 방심했거든요.

윈도우 PC에서 열린 온라인 문서 편집 화면
문서 양식을 화면에서 편집하는 일반적인 문서 편집기 화면입니다. 제가 만든 도구 화면은 아닙니다.
이미지 출처: Wikimedia Commons · Gaskeke · CC BY-SA 4.0

* 계속 발목을 잡은 오류들.

오류는 한 가지씩 오지 않았습니다. 하나를 고치면 다른 게 터졌어요. 주요 문제들을 정리하면 이렇습니다.

문제 증상 원인 해결 여부
입력값 미리보기 미반영 왼쪽에 타이핑해도 오른쪽에 안 나옴 readonly 속성 + contenteditable div에 .value 접근 ✅ 해결
필드 위치 겹침 모든 입력 박스가 top:0에 쌓임 이미지 로드 전에 posFields() 실행 ✅ 해결
PDF 불러오기 CORS 오류 "네트워크 오류" 메시지만 반복 브라우저 직접 API 호출 차단 ✅ 해결
PDF 생성 한글 깨짐 특수문자(※, —)가 빈칸으로 출력 폰트 subset에 해당 문자 미포함 ✅ 해결
PDF 본문 위치 틀어짐 생성된 PDF에서 텍스트가 구분선에 붙거나 잘림 html2canvas 비율 오차 + Y좌표 오차 ⚠️ 부분 해결
띄어쓰기 사라짐 PDF 불러오면 "민주적노사관계를통한"처럼 붙음 pdf.js 텍스트 추출 시 공백 아이템 제거 ✅ 해결
f-string JS 충돌 SyntaxError: Invalid or unexpected token Python f-string의 {{ }}가 JS 템플릿 리터럴과 충돌 ✅ 해결

표로 정리하니 깔끔해 보이지만, 실제로는 하나를 고치는 데 하루가 걸리기도 했습니다. 특히 입력값이 오른쪽에 반영이 안 되는 문제는 원인을 찾는 데만 꽤 걸렸어요. div에 .value로 접근하면 당연히 안 되는 건데, 그걸 모르고 계속 다른 곳을 수정하고 있었거든요.

CORS 문제도 만만치 않았습니다. 브라우저에서 Claude API를 직접 호출하면 차단되는 게 기본값이에요. 처음엔 corsproxy.io 같은 프록시를 썼는데 불안정했고, 결국 Anthropic이 공식 지원하는 anthropic-dangerous-direct-browser-access 헤더를 쓰는 방식으로 해결됐습니다. 다만 이 방식은 당시 개인 실험 기록이며 공개 서비스의 권장 구조가 아닙니다.

브라우저 코드에서 비밀 API 키를 사용하면 노출될 수 있습니다. 배포용 도구는 서버 측 API 경로에서 키를 관리해야 하며, 이미 노출한 키는 폐기·재발급이 필요합니다. 이 설명은 실제 서비스의 보안 개선을 검증했다는 뜻이 아닙니다.

한글 폰트 문제도 꽤 골치였습니다. NanumGothic을 woff2로 넣었더니 jsPDF가 woff2를 지원하지 않아서 'Cannot read properties of undefined (reading Unicode)' 오류가 났어요. TTF로 바꾸고, subset으로 만들어서 넣었더니 이번엔 ※ 같은 특수문자가 빠져 있었고요. 폰트 파일 하나 때문에 세 번을 다시 만들었습니다.

* 끝내 해결 못 한 것들.

솔직히 말하면, 아직 완성이라고 부르기 어렵습니다. 현재까지 해결 못 한 것들이 있거든요.

1. PDF 생성 결과물의 미묘한 위치 오차.

미리보기에서는 딱 맞게 보이는데, PDF로 저장하면 텍스트가 미묘하게 밀립니다. 구분선과 본문 사이 여백이 좁거나, 필드값이 레이블에 살짝 겹치거나. 매번 Y좌표를 수동으로 조정하는데도 완전히 잡히지 않아요. html2canvas 방식은 화면 캡처라 비율이 틀어지고, jsPDF 직접 삽입 방식은 좌표 계산이 까다롭습니다.

2. PDF 불러오기 서식 복원.

기존 공문 PDF를 불러오면 내용은 추출되는데, 줄간격이나 가운데 정렬 같은 서식은 완벽하게 재현이 안 됩니다. pdf.js로 텍스트를 뽑으면서 위치 정보는 어느 정도 건지지만, '— 아 래 —' 같은 가운데 정렬 텍스트가 오탐되는 경우가 있었거든요. Claude에게 추출을 시켜도 한계가 있습니다.

3. 공용 저장소.

여러 사람이 같은 문서 목록을 공유하는 기능은 결국 서버 없이는 안 된다는 걸 알게 됐습니다. localStorage는 해당 브라우저에만 저장되니까요. 임시방편으로 기본 문서 2개를 HTML에 하드코딩해뒀는데, 이건 진짜 해결이 아닙니다.

노트북 화면에 표시된 프로그램 코드
AI가 짜 준 코드를 붙여 넣고 실행해 보는 과정을 수십 번 반복했습니다. (참고 이미지)
이미지 출처: Wikimedia Commons · Negative Space · CC0

미리보기와 PDF가 다르게 보이는 문제
서식이 완벽히 복원 안 되는 문제
공용 저장소 부재

이 세 가지가 아직 숙제입니다.

* 그래도 이 경험에서 건진 것들.

실패라고 생각하지 않는 이유가 있습니다. 이 과정에서 배운 게 훨씬 많았거든요.

가장 큰 수확은 브라우저와 HTML이 어떻게 돌아가는지에 대한 감각을 얻은 겁니다. contenteditable이 뭔지, DOM 조작이 어떻게 되는지, 이미지 로드 타이밍이 왜 중요한지. 코딩 책에서 배우는 게 아니라, 실제로 오류를 겪으면서 몸으로 익힌 거죠. 그게 다릅니다.

그리고 AI와 협업하는 방법도 조금 알게 됐어요. Claude에게 뭔가를 물어볼 때, '증상을 정확히 설명할수록' 답이 빠르다는 걸요. 처음엔 "왜 안 돼요?"라고만 했는데, 나중엔 "콘솔에 이런 오류가 뜨고, 해당 함수는 이렇게 생겼는데, 이 부분이 문제인 것 같다"는 식으로 바뀌었거든요. 개발자들이 왜 스택 트레이스를 공유하는지 이해가 됐습니다.

마지막으로, 복잡한 걸 반복해서 고치다 보면 언제 전면 재작성이 필요한지도 감이 옵니다. 처음엔 부분 수정만 하다가, 어느 순간 코드가 너무 꼬여서 v5로 처음부터 다시 만들었거든요. 그게 훨씬 빠르고 깔끔했어요. 이 판단을 언제 해야 하는지가 실력이더라고요.

* 다음 단계: 뭘 보완할 건지.

이 프로젝트를 완성이라고 부르려면 세 가지가 더 필요합니다.

1. PDF 좌표 정밀화.
pdfplumber 같은 도구로 공문 양식의 각 영역을 mm 단위로 정확히 측정하고, 그 좌표를 기준으로 텍스트를 삽입하는 방식으로 바꿔야 합니다. 눈대중이 아니라 수치 기반으로요.

2. Google Sheets 연동.
공용 저장소는 Google Apps Script + Sheets 조합이 가장 현실적입니다. 이미 GAS 경험이 있으니, 저장/불러오기 API를 만들어서 연결하면 됩니다. 서버 없이도 되거든요.

3. 서식 복원 로직 개선.
pdf.js 텍스트 추출 시 x, y 좌표 정보를 더 적극적으로 활용하고, 가운데 정렬 판정 기준을 더 엄격하게 잡으면 됩니다. 이미 방향은 잡혀 있어요.

스프레드시트 프로그램 화면
다음 단계로 생각하는 공용 저장소는 Google Sheets 같은 스프레드시트 연동입니다. (참고 이미지)
이미지 출처: Wikimedia Commons · MikeRun · CC BY-SA 4.0

한 번에 완성된 건 아무것도 없었습니다. 그리고 생각해보면, 그게 맞는 순서인 것 같기도 해요. 작동하는 걸 하나 만들고, 거기서 문제를 찾고, 다시 고치고. 개발자들이 하는 일이 정확히 이거더라고요.

* 비슷한 도구를 만들려는 분께: 시작 전 체크리스트.

이번 시행착오를 거꾸로 돌려 보면, 시작하기 전에 확인했으면 시간을 크게 아꼈을 것들이 있습니다. 서버 없이 HTML 파일 하나로 업무 도구를 만들려는 분이라면 아래 항목을 먼저 점검해 보세요.

  • 저장 위치부터 정하기: 혼자 쓰는 도구인지, 여러 사람이 같은 데이터를 봐야 하는지 먼저 정합니다. 여러 사람이 공유해야 한다면 localStorage만으로는 안 되고 Google Sheets 같은 공용 저장소가 처음부터 필요합니다.
  • 한글 폰트 확인: PDF로 저장하는 기능이 있다면 사용할 글꼴 파일 형식(TTF 등)과 특수문자 포함 여부를 처음에 확인합니다.
  • 외부 API 호출 방식: 브라우저에서 AI API를 직접 부르면 CORS 차단이 기본입니다. API 키가 화면 코드에 그대로 노출될 수 있으므로 개인 실험에서도 키 노출에 주의해야 합니다. 공개 배포 시에는 브라우저 직접 호출 방식 대신 서버 측 API 경로에서 비밀 키를 관리해야 합니다.
  • 증상 기록 습관: 오류가 나면 콘솔 메시지, 재현 순서, 관련 코드를 함께 적어 AI에게 전달합니다. 질문이 구체적일수록 해결이 빨랐습니다.
  • 버전 남기기: 크게 고치기 전 파일을 v1, v2처럼 복사해 두면, 꼬였을 때 되돌아가거나 전면 재작성을 결정하기 쉽습니다.

* 마무리 정리.

비개발자가 AI와 함께 업무 자동화 도구를 만들면서 마주친 현실은 이랬습니다. 하나를 고치면 하나가 터지고, 원인을 모르면 엉뚱한 곳만 수정하게 되고, 그래도 계속 하다 보면 어느 순간 작동하는 것들이 쌓입니다.

완성하지 못한 부분이 있다는 게 부끄럽지 않습니다. 3개월 전에는 contenteditable이 뭔지도 몰랐는데, 지금은 왜 그게 .value로 안 되는지 설명할 수 있으니까요. 그걸로 충분합니다. 일단은.

비슷한 시도를 하고 있는 분이 있다면, 이 글이 조금이라도 위안이 됐으면 합니다. 오류는 당신이 멍청해서가 아니라, 원래 그런 겁니다.

함께 읽으면 좋은 글

목록으로

이 블로그 검색

Copyright © The ISSUEFEED. All rights reserved.
새 글 소식을 RSS로 받아보세요 AI 활용법, 비개발자의 앱 개발기, 직장인 투자일기를 꾸준히 기록합니다.
RSS로 구독하기