블로그
개발 기록
프로젝트를 진행하며 정리한 글입니다. codeparkway.com에 발행하며, 글을 누르면 원문으로 이동합니다.

반납된 컨테이너 3대가 화면에서 사라졌다 — 선사는 ‘return’이라는 단어를 안 쓴다
선사 연동은 전부 성공으로 보였는데 빈컨 반납일만 비어 있었다. 사람이 선사 사이트와 비교해서야 찾은 컨테이너 3대, 원인과 재발 방지, 업체에 물어볼 질문 하나까지 정리했다.

회사 소개 영상을 코드로 만들었다 — ‘촌스럽다’에서 시작해 점 13만 개로 끝난 65초
골디락스 홀딩스 회사 소개 영상을 카메라와 영상 생성 AI 없이 코드로 만들었다. 설명 문구를 전부 빼고 점 13만 개로 이야기를 끌고 간 과정, 빅뱅의 네모를 세 번 잘못 진단한 기록, 효과를 말로 설명하기 위해 만든 이름표까지 정리했다.

DB 쓰기가 6일간 멈춰 있었다 — 그동안 매일 백업은 정상이었다
사내 자동화 시스템의 DB가 6일간 멈췄는데 화면도 매일 백업도 정상으로 보였다. 어떻게 발견했고 어긋난 기록을 어떻게 복원했는지, 운영 책임자가 물어볼 질문 두 가지까지 정리했다.

업무 자동화, 어디부터 할까 — 금액 큰 거래처부터 고르려다 틀렸다
매입 전표 자동화 대상을 금액 큰 거래처로 고르려다 전표 약 2,300건을 전부 세어 보고 생각을 바꿨다. 한 곳이 작업량의 48%인데 금액은 6%였다. 자동화 범위를 정하는 기준과 만들지 않기로 한 것을 정리했다.

항만이 막힌 날, AI 에이전트는 어디까지 할 수 있을까 — 되는 것과 데이터가 있어야 되는 것
항만 폐쇄 같은 날, AI 에이전트는 영향받는 선적을 찾고 대응 초안을 만들 수 있다. 하지만 우회 항로와 비용까지 자동으로 내려면 데이터가 먼저다. 컨셉 영상과 함께 단계별로 무엇이 되고 무엇이 어려운지 정리했다.

자동화 다음은 뭘까 — 사람은 위로 올라가고, 회사는 기억하기 시작한다
검수까지 에이전트가 맡으면 사람은 무엇을 할까? 사람의 자리가 승인과 기준으로 옮겨 가고, 일한 기록이 회사의 기억으로 이어지는 방향을 컨셉 영상 두 편과 함께 정리했다. 근거 있는 답과 낡은 기록의 교체까지 다룬다.

사람이 일을 들고 다니는 회사, 일이 사람에게 오는 회사 — 왜 AI 자동화가 필요한가
포워딩 회사의 일은 사람이 건을 들고 부킹부터 정산까지 옮겨 다니는 구조다. AI 자동화는 사람을 빼는 일이 아니라 이 동선을 한 줄로 펴는 일이다. 정상 건, 예외 건, 사람의 일이 어떻게 달라지는지 영상과 함께 정리했다.

가사가 타임라인이다 — 80초 랩 광고를 코드로 만들며 배운 모션 용어와 실패들
물류 SaaS 홍보 영상을 영어 랩 80초와 키네틱 타이포그래피로 코드만으로 만들었다. 받아쓰기 대신 강제 정렬로 단어 타이밍을 뽑은 이유, 흔들림 15%→1.2%, 세로 릴스판까지 실패와 수치로 정리했다.

CSP를 켰더니 화면의 JS가 통째로 죽었다 — 범인은 importmap 핀 두 줄
Rails 대시보드에 CSP(script-src ‘self’)를 도입했다가 importmap이 CDN을 가리키는 바람에 ES 모듈 전체가 죽었다. 18시간 뒤에야 찾은 원인과, 같은 실수를 다시 못 하게 막은 가드 테스트 2개를 기록한다.

차트 하나가 전체의 36%를 통째로 빼먹고 있었다 — 에러는 한 줄도 없었다
운영 대시보드의 도넛 차트가 카테고리 하나를 통째로 빼먹고 있었다. 전체의 36%인데 콘솔 경고 한 줄 없었다. 표에는 undefined가 떠 있었다. 원인은 셋 다 하나 — 어디에도 적혀 있지 않은 데이터 계약. 수리와 문서화 기록.

메일 수신 파이프를 붙이고 잡은 침묵 실패 4가지 — 로그에는 전부 ‘정상’이었다
운영 메일을 웹훅으로 받는 파이프라인을 붙이며 로그에 ‘정상’으로 남던 침묵 실패 4개를 잡았다. 멱등 처리가 422로 새던 문제, 선언 Content-Type을 믿어 첨부를 버리던 문제, 포워딩 라우팅, CJK PDF 오판까지 실제 코드로 정리했다.

자유 텍스트 화주명을 엔티티로 묶기 — 사람 교정을 학습하는 별칭 테이블
BL 원문의 자유 텍스트 상호명을 화주 엔티티로 묶는 규칙 기반 해석기를 만들었다. 정규화 키, 사람 교정을 학습하는 별칭 테이블, after_commit 분리까지 실제 코드로 정리했다.

자동화가 실패한 자리에 사람을 넣는다 — 문서 워크플로에 비상구 4개를 달았다
자동 첨부·자동 발송이 실패했을 때 담당자가 손으로 끝낼 길을 만들었다. 조용한 유실을 실시간으로 표면화하고, 재발송과 재발행을 분리하고, 재발행 폼을 prefill하고, 죽은 비활성 버튼을 업로드로 바꾼 과정을 실제 Rails 코드로 정리했다.

동기화 스크립트가 두 달치 수기 입력을 지웠다 — 시트는 계속 멀쩡해 보였다
7,500행 정산 시트에서 사람이 넣은 금액만 조용히 사라졌다. clearContents 후 전체 재작성이 한 번 실패하자, 다음 정상 실행이 소실을 확정했다. 무용지물이던 가드, 73,457셀 복구, 쓰기 범위를 시스템 열로 고정한 재설계 기록.

검증기 8종이 전부 통과시킨 지표 오류 — 정의가 틀리면 항등식은 도움이 안 된다
POS 매출에 팁·세금이 섞여 있었고, 회원 거래는 실제의 40%만 잡히고 있었다. 내부 검증기 8종은 둘 다 통과시켰다. 정의 오류가 왜 항등식 검사에 안 걸리는지, 45주치를 두 번 재수집하며 무엇을 바꿨는지 코드와 수치로 정리했다.

개발 머신을 윈도우에서 맥으로 옮겼다
WSL2 랩탑에서 맥으로 작업 머신을 옮겼다. 짐을 용량 순으로 쌌으면 정작 위험한 296MB를 놓칠 뻔했다. git 워크트리·심볼릭 링크·시크릿 누락·BSD 유저랜드 차이까지, 복사는 성공했는데 에러 없이 조용히 깨진 것들의 실제 기록.

CI는 초록인데 테스트가 한 번도 돈 적이 없었다 — 검사 도구가 스스로 고장난 경우
사내 Rails 스타터킷의 CI를 처음 끝까지 돌려보니 brakeman은 버전 체크로 죽어 있었고 GitHub Actions 테스트 job은 실행조차 안 되고 있었다. 조용히 쌓인 결함과 그 대응 기록.

kill을 넣어놨는데 프로세스가 안 죽었다 — 고아 웹서버 19개를 치운 날
인증 없는 파이썬 웹서버 19개가 8일째 떠 있었다. 정리 코드는 분명히 있었는데 kill이 서브셸 껍데기만 죽이고 있었다. 원인을 재현으로 확인하고, 같은 일이 다시 조용히 쌓이지 않도록 다른 머신에 감시자를 붙인 기록.

다크 전용으로 만든 화면에 라이트 모드를 붙였다 — 흰 글씨가 사라진 이유
다크 모드 전용으로 만든 Rails 앱에 라이트 모드를 CSS 변수 토큰으로 붙였다. text-white가 라이트에서 사라진 원인은 attribute-substring 셀렉터가 hover: 유틸리티까지 매칭한 것. 실제 코드와 수정 과정.

영수증을 한 장씩 올리는 게 병목이었다 — 벌크 업로드를 결론 낸 방법
영수증을 한 장씩 올리던 병목을 여러 장 벌크 업로드로 푼 기록. 요청을 다 구현하지 않은 이유, 한 장 실패해도 나머지를 살리는 파일별 트랜잭션, 단건 하위호환과 진행률 설계까지.

AI가 영수증과 카드를 자꾸 틀리게 매칭했다 — 정확도를 두 배 넘게 올린 과정
법인카드 명세서와 영수증을 AI로 자동 매칭할 때 정확도가 낮았던 진짜 원인들을 하나씩 추적한 기록. 후보 범위, AI 날짜 오파싱, 날짜 없는 영수증까지 계층적으로 풀어 자동 매칭률을 두 배 넘게 올렸다.

경비 SaaS에 감사 대비 통제를 처음부터 넣었다 — 나중엔 못 넣는 것들
돈을 다루는 경비 SaaS에 SOX식 내부통제(append-only 감사 로그, 승인선, 월 마감 잠금)를 처음부터 넣은 기록. 왜 사후에 못 붙이는지, 마감을 현실 업무와 어떻게 타협했는지.

EDI 214 연동을 n8n으로 만들었다 — 인증 통과까지 실제로 막힌 5가지
배송상태를 EDI 214로 자동 전송하는 연동을 n8n으로 만들며 겪은 실패들. 상태 테이블 델타 설계, disabled 노드 오염, chroot 경로, 997 리젝 한 건의 진짜 원인까지 실제 기록.

‘오분류 0건’을 정확도로 착각할 뻔했다 — 피드백 루프엔 아직 사람이 없었다
AI 분류 교정 로그가 0건이라 정확도가 높은 줄 알 뻔했지만, 사실은 신호를 만들 사람이 아직 루프에 없었다. 부정 지표 0을 성공으로 오독하지 않는 법.

AI 분류 규칙을 코드에서 빼서 문서 한 장으로 옮겼다
자주 바뀌는 AI 분류 규칙을 워크플로우 코드에 하드코딩하지 않고 외부 문서로 빼내, 재배포 없이 즉시 반영되게 만든 기록. 프롬프트를 코드가 아니라 데이터로 다루기.

규칙으로 짤 것과 AI에 맡길 것 — 그 경계를 세 번 틀렸다
메일 자동 분류에서 무엇을 규칙으로 짜고 무엇을 AI에 맡길지, 그 경계를 실무에서 세 번 잘못 잡았다가 바로잡은 기록. 안정된 신호와 판단 대상을 구분하는 법.

제품 사용 가이드를 매번 손으로 만들기 싫어서 — 영상 넣으면 문서가 나오는 파이프라인을 만들었다
화면녹화 영상 하나로 프레임과 자막을 자동 추출하고, 마지막 재구성은 사람이 판단해 모듈별 사용 가이드(MD/PDF)로 만든다. ffmpeg·faster-whisper 설계 판단과 자동화 경계를 정리했다.

n8n이 자꾸 502로 죽었다 — 원인은 CPU가 아니라 메모리(OOM)였다
작은 VM에서 n8n이 502로 반복 재시작하던 원인은 CPU가 아니라 메모리 부족(OOM)이었다. dmesg로 원인을 잡고 swap과 바이너리 데이터 모드로 해결한 기록.

이메일로 굴러가던 물류 운영을, 데이터로 바꿨다 — 메일함 AI 인제스천 파이프라인 전 과정
포워더 운영이 이메일 스레드에 흩어져 추적이 안 되는 문제를, 메일 분류·문서 파싱·트래킹 파이프라인으로 데이터화한 전 과정. 설계 판단과 막힌 지점까지 정리했다.

‘왜 맨날 야근해?’ — 친구의 전화 한 통에서 시작된 경비 관리 SaaS
미국에서 일하는 친구의 경비처리 하소연에서 시작됐다. 영수증을 찍으면 AI가 알아서 채우는 경비 관리 SaaS를 무료 MVP로 내고 사용자와 함께 다듬어가는 기록.

클로드코드(Claude Code) 설치하고 첫 실전까지 — Mac·Windows 따라하기 (2026)
Claude Code(클로드코드)를 Mac과 Windows에 설치하고 첫 실전까지. 터미널 없이 쓰는 데스크탑 앱, Windows 네이티브 설치, 로그인, 자주 막히는 지점까지 따라만 하면 되게 정리했다.

블로그 글을 인스타 캐러셀·릴스로 완전자동 발행하기 — Graph API + Python + FFmpeg
블로그 글을 인스타그램 캐러셀과 릴스로 코드 한 번에 자동 발행한 과정. Graph API 3단계 발행, JPEG 변환, 이미지 호스팅, FFmpeg 릴스 생성, 토큰 자동 갱신까지 실제 함정과 함께 정리했다.

페이스북 페이지 없이 인스타그램 자동 발행 준비하기 — Meta 앱부터 토큰까지
블로그 글을 인스타그램에 자동으로 올리려면 Meta 앱과 토큰이 필요하다. 페이스북 페이지 없이 Instagram 로그인 방식으로 계정 전환·앱 생성·테스터 등록·토큰 발급까지, 실제로 막힌 지점과 함께 정리했다.

워드프레스 서버 배포를 AI 에이전트에게 맡겨봤다 — CloudPanel·SSL
관리형 워드프레스 대신 $14 서버에 직접 배포하고, 그 과정을 AI 에이전트(Claude Code)에게 SSH째로 맡겨 봤다. 서버를 고른 결정 5개와 CloudPanel·SSL 설정에서 막힌 지점을 정리했다.

클로드코드로 블로그 자동화 파이프라인 만들기 — AI 스킬 4개와 시행착오
키워드 발굴부터 글·이미지·네이버 변환까지, Claude Code 스킬 4개로 블로그 자동화 파이프라인을 만든 전 과정. 실제 명령어, 검색량 데이터, 막힌 지점과 해결까지 정리했다.
원문 발행처: codeparkway.com