Skip to content

About

결혼식 접수대에서 키보드만으로 축의금을 기록하는 웹앱입니다. 봉투 한 건에 3초, 내 컴퓨터에서만 돌아가고, 기록은 네 겹으로 지킵니다. 끝나면 엑셀로 내보냅니다.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

축의금 접수 장부

결혼식 당일 접수대에서 노트북 키보드만으로 축의금을 기록하는 웹앱입니다. 내 컴퓨터에서만 돌아갑니다.

종이 장부든 엑셀이든, 손님이 몰리는 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
잘못 넣은 걸 지우고 싶다 목록에서 삭제 → 휴지통으로 갑니다
실수로 지워 버렸다 위쪽 휴지통 → 복구

삭제해도 데이터베이스에서 실제로 지워지지는 않습니다. 지웠다는 표시만 남길 뿐이라 언제든 되살릴 수 있습니다.


기록을 지키는 네 겹의 장치

예식은 다시 할 수 없으니, 한 겹이 뚫려도 다음 겹이 막아 주도록 만들었습니다.

  1. synchronous = FULL — 화면에 "저장됨" 이 뜬 순간, 이미 디스크에 완전히 기록된 상태입니다. 바로 그때 전원이 나가도 남아 있습니다.
  2. WAL — 컴퓨터가 갑자기 꺼져도 다시 켜면 알아서 복구됩니다.
  3. data/entries.jsonl — 모든 작업을 데이터베이스와는 별개로 텍스트 파일에 한 줄씩 남깁니다. 데이터베이스 파일이 통째로 망가져도 이 파일만 있으면 전부 되살릴 수 있고, 최악의 경우 메모장으로 열어 눈으로 읽을 수도 있습니다. 기록이 무사한지를 특정 라이브러리 하나에 맡기지 않으려고 둔 장치입니다.
  4. 5분마다 자동 백업 — data/backups/wedding-YYYYMMDDHHMM.db 로 저장됩니다(최근 50개 보관). 접수하는 도중에도 서버가 멈추지 않는 방식으로 백업합니다.

서버가 꺼져도 접수는 멈추지 않습니다

저장에 실패한 입력은 브라우저에 쌓이고, 화면 위쪽에 빨간 띠로 몇 건이 밀려 있는지 표시됩니다. 서버를 다시 켜면 5초 안에 알아서 저장되고, 그동안에도 계속 입력하실 수 있습니다.

오프라인 대기


이렇게 확인했습니다

자동 검사 201건을 통과합니다. 그중 실제로 망가뜨려 보며 확인한 것들입니다.

  • 강제 종료 (kill -9) — 입력이 한창 쏟아지는 중에 서버를 강제로 죽였습니다. "저장됨" 이라고 응답한 127건 중 하나도 잃지 않았고, 무결성 검사도 통과했으며, 텍스트 기록과 데이터베이스의 행 수도 정확히 같았습니다.
  • 텍스트 기록만으로 복구 — 데이터베이스 파일을 아예 무시하고 entries.jsonl 만 재생해서, 저장·수정·삭제·복구·설정이 뒤섞인 이력을 원본과 똑같이 되살렸습니다.
  • 동시 전송 — 밀린 기록을 보내는 작업을 일부러 세 번 동시에 실행해도 중복 저장이나 누락이 없었습니다.
  • 엑셀·CSV 내보내기 — 이름에 콤마,따옴표"사람, 메모에 줄바꿈이 들어간 데이터를 내보낸 뒤 다시 읽어들여, 한 칸에 온전히 복원되는 것까지 확인했습니다.
  • 외부 접속 차단 — 같은 와이파이의 다른 기기에서 접속을 시도하면 연결이 거부됩니다.

식이 끝난 뒤에 할 일

  1. 화면 위쪽 DB 백업 을 눌러 파일을 받아서 USB나 다른 컴퓨터에 복사해 두세요. 이게 가장 확실한 원본입니다.
  2. 엑셀 이나 CSV 로 내보내서 가족과 공유하세요.
    • CSV는 엑셀에서 더블클릭 한 번에 열리고 한글도 깨지지 않게 만들었습니다.
    • 엑셀 파일에는 축의금 시트(전체 목록과 합계)와 정산 시트(총액·현금·이체·성인/아동 식권·단가·예상 식대·식대 제외 잔액)가 들어 있습니다.
    • 화면에서 금액을 가려 두었더라도 내보내는 파일에는 항상 전부 들어갑니다.
  3. 현금을 셀 때는 총 금액이 아니라 현금 합계 와 맞춰 보세요. 계좌이체로 받은 돈은 봉투에 없습니다.

문제가 생겼을 때

1. 백업 파일로 되돌리기

대부분은 이걸로 해결됩니다.

ls -t data/backups/          # 가장 최근 백업 확인
cp data/backups/wedding-<최신>.db data/wedding.db
rm -f data/wedding.db-wal data/wedding.db-shm
./start.sh

2. 데이터베이스가 통째로 망가졌을 때

npm run restore

data/entries.jsonl 만 읽어서 data/wedding-restored-<시각>.db 라는 새 파일을 만듭니다. 기존 파일은 건드리지 않으니 내용을 확인한 뒤에 직접 바꿔 넣으시면 됩니다.

저장이 끝나기 직전에 중단된 기록이 있으면 그것도 함께 되살리되, 메모에 [복구확인필요] 를 붙여 둡니다. 접수하던 사람이 실패한 걸 보고 다시 입력했을 수도 있으니, 그 건들만 눈으로 확인하시면 됩니다.


예식 전날 체크리스트

  • 축의금 장부 시작.command 를 우클릭 → 열기 로 한 번 실행해 보기 (macOS 첫 실행 경고를 미리 통과시켜 둬야 당일에 막히지 않습니다. 라이브러리 설치도 이때 끝납니다)
  • 연습으로 3건 입력해 보고, 삭제했다가 휴지통에서 복구까지 해 보기
  • 설정 → 식대 단가를 예식장에서 알려준 실제 금액으로 변경 (기본값은 성인 55,000원 / 아동 35,000원)
  • 설정 → 화면에 표시할 금액에서 필요한 항목만 켜 두기
  • 연습 데이터를 지우고 시작하려면 data/ 폴더 비우기
  • 노트북 잠자기와 화면 잠금 끄기 (이유는 아래에)
  • 전원 어댑터 챙기기

잠자기를 왜 꺼야 하나요

기록이 날아갈까 봐 그러는 게 아닙니다. 잠자기로는 데이터가 사라지지 않습니다. "저장됨" 이 뜬 시점에 이미 디스크에 기록이 끝나 있고, 잠자기는 강제 종료보다도 안전합니다.

진짜 이유는 접수가 멈추는 시간 때문입니다.

  • 화면 잠금 암호가 가장 골치입니다. 잠깐 다른 분이 대신 앉아 계실 때 암호를 몰라서 아무것도 못 하게 됩니다.
  • 노트북을 깨우고 브라우저가 반응하기까지 10~30초가 걸립니다. 손님이 봉투를 들고 서 계신 상황에서는 꽤 긴 시간입니다.
  • 축의금은 2030분에 몰리는데, 그 사이사이 손님이 끊기는 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                                -- 비어 있으면 유효, 값이 있으면 휴지통
);

금액은 정수(원 단위)로만 저장하고 소수점은 쓰지 않습니다. 번호를 다시 쓰지 않도록 만들어서, 봉투에 적어 둔 번호를 그대로 믿고 대조하실 수 있습니다.

API

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

About

결혼식 접수대에서 키보드만으로 축의금을 기록하는 웹앱입니다. 봉투 한 건에 3초, 내 컴퓨터에서만 돌아가고, 기록은 네 겹으로 지킵니다. 끝나면 엑셀로 내보냅니다.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages