결혼식 당일 접수대에서 노트북 키보드만으로 축의금을 기록하는 웹앱입니다. 내 컴퓨터에서만 돌아갑니다.
종이 장부든 엑셀이든, 손님이 몰리는 30~40분 동안 적다 보면 금액을 잘못 쓰거나 빠뜨리기 쉽습니다. 식이 끝나면 합계와 식대 정산을 처음부터 다시 손으로 해야 하고요. 이 앱은 봉투 한 건을 3초 안에 기록하고, 정산 금액을 화면에 바로 보여주고, 끝나면 엑셀 파일로 내보냅니다.
무엇보다 중요하게 생각한 건 기록을 한 건도 잃지 않는 것입니다. 예식은 다시 할 수 없으니까요.
이모 결혼식에서 축의금 접수를 맡게 되었습니다. 받은 내역을 엑셀로 정리해서 넘겨 달라는 부탁도 함께 받았고요.
그런데 두 가지가 걸렸습니다.
첫째, 저는 엑셀을 잘 다루지 못합니다. 수식을 걸고 서식을 맞추다가 어딘가에서 실수할 게 뻔했습니다. 게다가 한 번 잘못 만지면 어디가 틀어졌는지 찾기도 어렵습니다.
둘째, 엑셀은 접수대에서 쓰기에 느립니다. 손님이 몰리는 시간에 셀 사이를 마우스로 옮겨 다니고, 금액 자리에 콤마가 제대로 들어갔는지 눈으로 확인하고, 옆 칸으로 넘어가는 동안 다음 분이 봉투를 내밀고 계십니다. 축의금은 20~30분에 몰리기 때문에 한 건당 몇 초 차이가 줄 길이로 그대로 돌아옵니다.
그래서 이름과 금액만 치고 Enter를 누르면 끝나는 화면을 만들기로 했습니다. 어차피 정산도 자동으로 해 주면 엑셀 작업 자체가 사라지고, 마지막에 엑셀 파일로 내보내면 부탁받은 것도 그대로 지킬 수 있으니까요.
Claude Code로 결혼식 하루 전날 만들었습니다. 시간이 없어서 처음부터 "무엇을 만들지"보다 "무엇이 잘못될 수 있는지"를 먼저 정했습니다. 예식은 다시 할 수 없으니 기록을 잃는 것만큼은 절대 안 된다는 것이 유일한 절대 조건이었고, 그 조건에서 네 겹의 안전장치가 나왔습니다.
테스트도 Claude로 돌렸습니다. 하루 전에 만든 물건을 믿고 쓰려면 직접 망가뜨려 보는 수밖에 없었습니다. 입력이 쏟아지는 중에 서버를 강제로 죽여 보고, 데이터베이스 파일을 통째로 무시한 채 복구해 보고, 브라우저에 밀린 기록을 일부러 동시에 여러 번 보내 봤습니다. 확인한 내용은 아래에 정리해 두었습니다.
- 데이터가 밖으로 나가지 않습니다. 내 컴퓨터에서만 접속되도록 막아 두어서, 예식장 공용 와이파이로는 들어올 수 없습니다.
- 설치할 게 거의 없습니다. 라이브러리 2개만 쓰고 빌드 도구는 아예 쓰지 않습니다. 예식 당일에 고장 날 만한 곳을 최대한 줄였습니다.
- 서버가 꺼져도 접수는 계속됩니다. 저장하지 못한 기록은 브라우저에 쌓여 있다가, 서버를 다시 켜면 알아서 저장됩니다.
- 금액은 기본적으로 가려 둡니다. 접수대는 하객들이 계속 지나다니는 자리니까요.
- Node.js 24 이상
- macOS 기준으로 설명합니다. Windows나 Linux에서는
start.sh대신node server.js로 실행하면 됩니다.
git clone https://github.com/Kyu-seok/wedding-ledger.git
cd wedding-ledger
./start.sh브라우저에서 http://127.0.0.1:3000 으로 들어가세요. 끄려면 터미널에서 Ctrl+C 를 누르면 됩니다.
start.sh 가 Node 24를 알아서 찾아 쓰고, 라이브러리가 설치돼 있지 않으면 설치까지 해 줍니다.
3000번 포트를 다른 프로그램이 쓰고 있다면 PORT=3001 ./start.sh 처럼 바꿔서 실행하세요.
localhost보다는127.0.0.1로 접속하시길 권합니다.localhost는 IPv4와 IPv6 두 주소를 모두 가리키는데, 둘 중 한쪽을 다른 프로그램이 쓰고 있으면(Docker Desktop이 대표적입니다) 브라우저가 그쪽으로 연결돼 엉뚱한 화면이 뜹니다. 서버는 양쪽 모두 열어 두지만, 주소를 정확히 입력하면 헷갈릴 일이 없습니다.
Finder에서 축의금 장부 시작.command 를 더블클릭하면 서버가 켜지고 브라우저까지 자동으로 열립니다.
- 검은 창이 하나 뜨는데, 접수하는 동안에는 닫으면 안 됩니다. 이 창을 닫으면 서버도 같이 꺼집니다.
- 실수로 두 번 눌러도 괜찮습니다. 이미 켜져 있으면 브라우저만 다시 열어 줍니다.
- macOS가 처음 한 번은 "확인되지 않은 개발자" 라며 막습니다. 파일을 우클릭 → 열기 → 열기 를 누르면 통과되고, 그 뒤로는 더블클릭만으로 열립니다.
이름 → Tab → 금액 → Tab → 성인 식권 → Tab → 아동 식권 → Enter
| 키 | 하는 일 |
|---|---|
Enter |
이름과 금액만 채워져 있으면 어느 칸에서든 저장됩니다. 저장하면 입력칸이 비워지고 커서가 이름 칸으로 돌아옵니다 |
Ctrl+Z |
방금 저장한 건을 되돌립니다 (휴지통으로 가는 것이라 없어지지 않습니다) |
Alt+T |
현금 ↔ 계좌이체 전환 |
/ |
검색창으로 이동 |
금액은 50000, 50,000, 5만 중 어떤 식으로 적어도 알아듣고, 바로 아래에 → 50,000원 이라고 해석 결과를 보여 줍니다. 눈으로 확인하고 Enter를 누르면 됩니다.
금액 버튼은 덮어쓰지 않고 더해집니다. +5만 을 누른 다음 +10만 을 누르면 15만이 됩니다. 봉투를 세면서 하나씩 더해 나가는 실제 접수 방식에 맞췄습니다. 잘못 눌렀으면 초기화 를 누르면 됩니다. 이 버튼들은 마우스로만 눌리도록 해 두어서 Tab 순서를 방해하지 않습니다.
예식장은 아이 식대를 따로 매기고, 청구할 때도 실제로 나간 식사(식권) 수를 기준으로 합니다. 그래서 예상 식대도 같은 방식으로 계산합니다.
예상 식대 = (성인 식권 × 성인 단가) + (아동 식권 × 아동 단가)
참석 인원을 적는 칸은 따로 두지 않았습니다. 나간 식권 수가 곧 식사를 대접한 인원이라, 인원을 따로 세면 입력만 늘어나고 두 숫자가 어긋나기 쉽습니다. 화면 위쪽의 식권 합계 가 인원 집계를 대신합니다.
접수대는 하객들이 계속 지나다니는 자리라 총액이 화면에 떠 있으면 신경 쓰입니다. 그래서 총 금액 · 현금 합계 · 계좌이체 합계 · 예상 식대 · 식대 제외 잔액은 처음에 모두 가려 둡니다. 건수와 식권 수만 보입니다.
- 화면 위쪽 금액 보기 / 금액 가리기 버튼 — 다섯 개를 한 번에 켜고 끕니다. 잠깐 확인할 때 쓰면 됩니다.
- 설정 → 화면에 표시할 금액 — 항목별로 골라서 켤 수 있고, 고른 내용은 브라우저가 기억합니다.
이미 같은 이름이 저장돼 있으면 노란 표시로 알려 줍니다. 다만 저장을 막지는 않습니다. 진짜 동명이인일 수도 있으니까요. 중복인지 아닌지는 사람이 보고 판단하시면 됩니다.
| 이런 상황이면 | 이렇게 하세요 |
|---|---|
| 방금 저장한 게 틀렸다 | Ctrl+Z |
| 아까 적은 금액이 틀렸다 | 목록에서 수정 을 누르고 고친 뒤 Enter |
| 잘못 넣은 걸 지우고 싶다 | 목록에서 삭제 → 휴지통으로 갑니다 |
| 실수로 지워 버렸다 | 위쪽 휴지통 → 복구 |
삭제해도 데이터베이스에서 실제로 지워지지는 않습니다. 지웠다는 표시만 남길 뿐이라 언제든 되살릴 수 있습니다.
예식은 다시 할 수 없으니, 한 겹이 뚫려도 다음 겹이 막아 주도록 만들었습니다.
synchronous = FULL— 화면에 "저장됨" 이 뜬 순간, 이미 디스크에 완전히 기록된 상태입니다. 바로 그때 전원이 나가도 남아 있습니다.- WAL — 컴퓨터가 갑자기 꺼져도 다시 켜면 알아서 복구됩니다.
data/entries.jsonl— 모든 작업을 데이터베이스와는 별개로 텍스트 파일에 한 줄씩 남깁니다. 데이터베이스 파일이 통째로 망가져도 이 파일만 있으면 전부 되살릴 수 있고, 최악의 경우 메모장으로 열어 눈으로 읽을 수도 있습니다. 기록이 무사한지를 특정 라이브러리 하나에 맡기지 않으려고 둔 장치입니다.- 5분마다 자동 백업 —
data/backups/wedding-YYYYMMDDHHMM.db로 저장됩니다(최근 50개 보관). 접수하는 도중에도 서버가 멈추지 않는 방식으로 백업합니다.
저장에 실패한 입력은 브라우저에 쌓이고, 화면 위쪽에 빨간 띠로 몇 건이 밀려 있는지 표시됩니다. 서버를 다시 켜면 5초 안에 알아서 저장되고, 그동안에도 계속 입력하실 수 있습니다.
자동 검사 201건을 통과합니다. 그중 실제로 망가뜨려 보며 확인한 것들입니다.
- 강제 종료 (
kill -9) — 입력이 한창 쏟아지는 중에 서버를 강제로 죽였습니다. "저장됨" 이라고 응답한 127건 중 하나도 잃지 않았고, 무결성 검사도 통과했으며, 텍스트 기록과 데이터베이스의 행 수도 정확히 같았습니다. - 텍스트 기록만으로 복구 — 데이터베이스 파일을 아예 무시하고
entries.jsonl만 재생해서, 저장·수정·삭제·복구·설정이 뒤섞인 이력을 원본과 똑같이 되살렸습니다. - 동시 전송 — 밀린 기록을 보내는 작업을 일부러 세 번 동시에 실행해도 중복 저장이나 누락이 없었습니다.
- 엑셀·CSV 내보내기 — 이름에
콤마,따옴표"사람, 메모에 줄바꿈이 들어간 데이터를 내보낸 뒤 다시 읽어들여, 한 칸에 온전히 복원되는 것까지 확인했습니다. - 외부 접속 차단 — 같은 와이파이의 다른 기기에서 접속을 시도하면 연결이 거부됩니다.
- 화면 위쪽 DB 백업 을 눌러 파일을 받아서 USB나 다른 컴퓨터에 복사해 두세요. 이게 가장 확실한 원본입니다.
- 엑셀 이나 CSV 로 내보내서 가족과 공유하세요.
- CSV는 엑셀에서 더블클릭 한 번에 열리고 한글도 깨지지 않게 만들었습니다.
- 엑셀 파일에는
축의금시트(전체 목록과 합계)와정산시트(총액·현금·이체·성인/아동 식권·단가·예상 식대·식대 제외 잔액)가 들어 있습니다. - 화면에서 금액을 가려 두었더라도 내보내는 파일에는 항상 전부 들어갑니다.
- 현금을 셀 때는 총 금액이 아니라
현금 합계와 맞춰 보세요. 계좌이체로 받은 돈은 봉투에 없습니다.
대부분은 이걸로 해결됩니다.
ls -t data/backups/ # 가장 최근 백업 확인
cp data/backups/wedding-<최신>.db data/wedding.db
rm -f data/wedding.db-wal data/wedding.db-shm
./start.shnpm run restoredata/entries.jsonl 만 읽어서 data/wedding-restored-<시각>.db 라는 새 파일을 만듭니다. 기존 파일은 건드리지 않으니 내용을 확인한 뒤에 직접 바꿔 넣으시면 됩니다.
저장이 끝나기 직전에 중단된 기록이 있으면 그것도 함께 되살리되, 메모에 [복구확인필요] 를 붙여 둡니다. 접수하던 사람이 실패한 걸 보고 다시 입력했을 수도 있으니, 그 건들만 눈으로 확인하시면 됩니다.
-
축의금 장부 시작.command를 우클릭 → 열기 로 한 번 실행해 보기 (macOS 첫 실행 경고를 미리 통과시켜 둬야 당일에 막히지 않습니다. 라이브러리 설치도 이때 끝납니다) - 연습으로 3건 입력해 보고, 삭제했다가 휴지통에서 복구까지 해 보기
- 설정 → 식대 단가를 예식장에서 알려준 실제 금액으로 변경 (기본값은 성인 55,000원 / 아동 35,000원)
- 설정 → 화면에 표시할 금액에서 필요한 항목만 켜 두기
- 연습 데이터를 지우고 시작하려면
data/폴더 비우기 - 노트북 잠자기와 화면 잠금 끄기 (이유는 아래에)
- 전원 어댑터 챙기기
기록이 날아갈까 봐 그러는 게 아닙니다. 잠자기로는 데이터가 사라지지 않습니다. "저장됨" 이 뜬 시점에 이미 디스크에 기록이 끝나 있고, 잠자기는 강제 종료보다도 안전합니다.
진짜 이유는 접수가 멈추는 시간 때문입니다.
- 화면 잠금 암호가 가장 골치입니다. 잠깐 다른 분이 대신 앉아 계실 때 암호를 몰라서 아무것도 못 하게 됩니다.
- 노트북을 깨우고 브라우저가 반응하기까지 10~30초가 걸립니다. 손님이 봉투를 들고 서 계신 상황에서는 꽤 긴 시간입니다.
- 축의금은 20
30분에 몰리는데, 그 사이사이 손님이 끊기는 12분 공백에 화면이 꺼지기 딱 좋습니다.
시스템 설정에서 자동 잠자기와 함께 잠자기 해제할 때 암호 묻기도 꺼 두시는 게 좋습니다.
server.js HTTP 라우팅과 정적 파일 서빙 (내 컴퓨터에서만 접속 가능)
src/db.js 데이터베이스 스키마·조회·집계·자동 백업
src/journal.js entries.jsonl 텍스트 이중 기록
src/export.js CSV·엑셀 내보내기
public/index.html|app.js|style.css 빌드 도구 없이 만든 화면
scripts/restore-from-journal.js 텍스트 기록으로 복구하는 스크립트
scripts/seed.js 연습용 더미 데이터 생성
data/ 실제 기록이 저장되는 곳 (git에 올라가지 않음)
CREATE TABLE entries (
id INTEGER PRIMARY KEY AUTOINCREMENT, -- 봉투 번호로도 씁니다
name TEXT NOT NULL,
amount INTEGER NOT NULL, -- 원 단위 정수
meal_tickets_adult INTEGER NOT NULL DEFAULT 0,
meal_tickets_child INTEGER NOT NULL DEFAULT 0,
method TEXT NOT NULL DEFAULT 'cash', -- 'cash' | 'transfer'
memo TEXT NOT NULL DEFAULT '',
created_at TEXT NOT NULL,
updated_at TEXT NOT NULL,
deleted_at TEXT -- 비어 있으면 유효, 값이 있으면 휴지통
);금액은 정수(원 단위)로만 저장하고 소수점은 쓰지 않습니다. 번호를 다시 쓰지 않도록 만들어서, 봉투에 적어 둔 번호를 그대로 믿고 대조하실 수 있습니다.
GET /api/entries?q=&trash= 목록 조회 / 검색 / 휴지통
POST /api/entries 저장
PATCH /api/entries/:id 수정
DELETE /api/entries/:id 휴지통으로 이동
POST /api/entries/:id/restore 복구
GET /api/check-name?name= 같은 이름 조회
GET /api/summary 집계
GET|PUT /api/settings 성인·아동 식대 단가
GET /api/export.csv | .xlsx | /api/backup.db
npm audit을 돌리면 취약점 10건이 나옵니다. 실제로는 서로 다른 2건이고(npm이 의존성 사슬마다 중복해서 세는 탓입니다), 둘 다 엑셀 내보내기에 쓰는exceljs가 끌고 오는 라이브러리에 있습니다. 파일 검색 패턴 처리와 관련된 문제인데, 이 앱은 그런 패턴을 외부에서 받지 않기 때문에 문제가 생길 상황 자체가 만들어지지 않습니다.- 엑셀 내보내기는 따로 떼어 놨습니다.
exceljs에 문제가 생겨도 접수·저장·CSV 내보내기는 아무 영향 없이 동작합니다. - 관계나 소속을 적는 칸은 없습니다. 부모님 지인 축의금을 따로 정산하실 계획이라면 메모 칸을 쓰시거나 칸을 하나 추가하시면 됩니다.
- 예전 버전으로 만든 데이터는 자동으로 옮겨집니다. 구조가 바뀌어도 연습 데이터가 날아가지 않습니다.
MIT



