매장에 비치된 태블릿이나 테이블의 QR 코드를 스캔해 바로 메뉴를 보고 주문하는 웹 전자메뉴판 구조 설계
별도의 전용 앱 설치 없이 테이블에 부착된 QR 코드를 스마트폰으로 스캔하거나 매장 태블릿으로 즉시 주문하는 웹 전자메뉴판은 운영 비용을 줄이고 주문 회전율을 높여 줍니다. 하지만 테이블 식별이 허술하면 타인의 테이블로 음식이 주문되는 보안 문제가 발생하며, 결제 웹훅 누락 시 주문 처리가 중단되는 장애가 생길 수 있습니다. 이 글에서는 안전한 테이블 식별부터 신뢰성 있는 주문·결제 트랜잭션 파이프라인, 주방 알림 구조까지 실제 서비스에 적용 가능한 아키텍처를 다룹니다.
테이블 식별 방식과 QR 코드 구성
테이블 주문 시스템의 첫 단계는 고객이 어떤 매장의 몇 번 테이블에 앉아 있는지 시스템이 안전하게 인식하는 것입니다. 단순하게 https://menu.example.com?store=10&table=4 형태로 URL을 만들면, 악의적인 사용자가 파라미터 숫자만 바꿔 다른 테이블로 무단 주문을 넣는 문제가 생깁니다.
이를 방지하기 위해 HMAC 서명이나 단기 세션 토큰을 URL에 포함해야 합니다. 매장 비밀키로 storeId와 tableId를 서명하여 검증된 요청만 메뉴 접근을 허용합니다.
또한 식당 환경은 음식물이나 기름이 묻기 쉬우므로, 인쇄물 QR 코드에는 리드-솔로몬(Reed-Solomon) 오류 정정 부호화 방식을 적용해야 합니다. QR 코드는 RS 부호를 통해 일부가 오염되거나 훼손되어도 데이터를 복구할 수 있습니다. 매장 테이블용 QR 코드는 기본값(Level L, 약 7% 복원) 대신 Level M(약 15%) 또는 Level Q(약 25%) 수준으로 오류 정정 레벨을 올려 생성하고 코팅 마감 처리를 하는 것이 안전합니다.
| 비교 항목 | 고객 모바일 QR 스캔 (BYOD) | 테이블 거치형 전용 태블릿 |
|---|---|---|
| 초기 도입 비용 | QR 인쇄물만 필요하여 매우 저렴함 | 테이블별 단말기 구매 및 거치대 비용 발생 |
| 유지 관리 | 분실 및 충전 관리 불필요 | 배터리 충전, 도난 방지, 화면 파손 관리 필요 |
| 접근성 | 노년층 등 스마트폰 조작이 낯설 수 있음 | 누구나 큰 화면으로 즉시 조작 가능 |
| 보안 구조 | 테이블 위변조 방지용 서명 토큰 필수 | 고정 단말기별 영구 디바이스 토큰 바인딩 |
주문 및 결제 라이프사이클 설계
주문과 결제는 데이터 유실이나 중복 결제가 발생하지 않도록 상태 머신(State Machine) 구조로 엄격하게 관리해야 합니다. 결제 완료 신호는 사용자의 브라우저 화면 리디렉션뿐만 아니라 결제 대행사(PG)의 비동기 콜백(Webhook)을 통해 신뢰성을 확보해야 합니다.
- 사전 주문 생성 (PENDING): 고객이 메뉴를 선택하고 주문을 요청하면 서버는 재고를 임시 확인하고
PENDING상태의 주문 레코드를 생성합니다. - 결제 요청 (PAY_REQUESTED): 결제창을 띄우거나 선불 결제 세션을 시작합니다.
- 비동기 웹훅 검증 (PAID): PG사에서 전달하는 비동기 통지(Webhook)의 위변조 방지 서명을 검증한 뒤 주문 상태를
PAID로 전환합니다. - 누락 보상 및 타임아웃 처리: 사용자가 결제를 중단하고 이탈하면 스케줄러가 일정 시간 경과 후 주문을
CANCELLED처리합니다. 반대로 결제는 되었으나 웹훅이 유실된 경우를 대비해 스케줄러가 결제사 API를 능동적으로 조회하여 상태를 동기화하는 보상 배치(Job)를 둡니다. - 주방 전달 (CONFIRMED -> COMPLETED): 결제가 확인되면 WebSocket 또는 SSE(Server-Sent Events)를 통해 주방 디스플레이 시스템(KDS)으로 주문서가 실시간 전송됩니다.
백엔드 핵심 주문 검증 및 처리 구현
다음은 Node.js(Express) 환경에서 테이블 서명을 검증하고 주문을 처리하는 핵심 구조 예제입니다.
const express = require('express');
const crypto = require('crypto');
const app = express();
app.use(express.json());
const SECRET_KEY = 'store-secure-signing-secret'; // 환경변수로 분리하여 관리
// 테이블 식별용 HMAC 토큰 생성 유틸리티
function generateTableToken(storeId, tableId) {
const payload = `${storeId}:${tableId}`;
const signature = crypto.createHmac('sha256', SECRET_KEY).update(payload).digest('hex');
return `${payload}.${signature}`;
}
// 테이블 토큰 유효성 검증 미들웨어
function verifyTableToken(req, res, next) {
const token = req.headers['x-table-token'];
if (!token) {
return res.status(401).json({ error: '테이블 인증 토큰이 없습니다.' });
}
const [payload, signature] = token.split('.');
if (!payload || !signature) {
return res.status(400).json({ error: '잘못된 토큰 형식입니다.' });
}
const expectedSignature = crypto.createHmac('sha256', SECRET_KEY).update(payload).digest('hex');
// 타이밍 공격을 방지하기 위해 timingSafeEqual 사용
const isValid = crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expectedSignature));
if (!isValid) {
return res.status(403).json({ error: '유효하지 않은 테이블 서명입니다.' });
}
const [storeId, tableId] = payload.split(':');
req.storeContext = { storeId: Number(storeId), tableId: Number(tableId) };
next();
}
// 주문 생성 엔드포인트
app.post('/api/orders', verifyTableToken, async (req, res) => {
const { storeId, tableId } = req.storeContext;
const { items, totalAmount } = req.body;
if (!items || items.length === 0) {
return res.status(400).json({ error: '주문 항목이 비어 있습니다.' });
}
// 고유 주문 번호 생성
const orderId = `ORD-${Date.now()}-${Math.floor(Math.random() * 1000)}`;
const orderRecord = {
orderId,
storeId,
tableId,
items,
totalAmount,
status: 'PENDING',
createdAt: new Date()
};
// 데이터베이스 저장 로직 (예: DB insert)
console.log(`주문 등록 완료: ${orderId} (테이블 ${tableId})`);
res.status(201).json({
success: true,
orderId,
status: orderRecord.status
});
});자주 겪는 문제
- 증상: 인근 테이블 고객이 URL 파라미터를 임의로 변경하여 다른 테이블로 음식을 주문함
- 원인: URL에 테이블 번호를 평문 숫자로만 노출하고 유효성 서명 검증을 하지 않음.
- 해결: URL 발급 시 HMAC-SHA256 기반 서명을 추가하고, 서버 미들웨어에서 서명이 일치하지 않는 요청은 즉시 차단합니다.
- 증상: 고객은 결제를 마쳤으나 주방 화면에 주문서가 뜨지 않고 취소 처리됨
- 원인: PG사의 결제 완료 비동기 콜백(Webhook)이 일시적인 네트워크 지연으로 유실되었거나 방화벽에 막힘.
- 해결: 웹훅 단일 수신에만 의존하지 말고, 미확인 주문을 주기적으로 탐색해 PG사 조회 API로 결제 여부를 동기화하는 누락 보상 스케줄러(Job)를 백엔드에 구축합니다.
- 증상: 출력된 QR 코드가 식당 조명 반사나 물 얼룩 때문에 스마트폰 카메라로 인식되지 않음
- 원인: QR 코드의 오류 정정 레벨이 최저 수준(Level L)으로 생성되었거나, 유광 코팅으로 인해 빛 반사가 일어남.
- 해결: QR 코드 생성 시 리드-솔로몬 오류 복원율을 Level M(15%) 이상으로 지정하고, 무광(Matte) 코팅 라벨지를 사용하여 반사를 방지합니다.
정리
웹 전자메뉴판은 앱 설치 없는 높은 편의성을 제공하지만 테이블 파라미터 변조 방지와 결제 상태 정합성이 필수적으로 보장되어야 합니다. 리드-솔로몬 오류 정정을 고려한 견고한 QR 제작, HMAC 서명을 통한 테이블 식별, 그리고 결제 누락 보상 스케줄러를 함께 구축해야 주문 사고 없는 안정적인 무인 매장 환경을 운영할 수 있습니다.
참고 자료
- Reed–Solomon error correction — Wikipedia · CC BY-SA
- Makiato1999/PayPlus — GitHub · Apache-2.0
공개한 자료는 무료이며, 사용에 따른 결과는 보증하지 않습니다. 상업적 이용이나 재배포 전에는 한 번 문의해 주시면 감사하겠습니다.
댓글 · 문의 0
댓글은 로그인 후 남기실 수 있습니다. 가입은 무료입니다.
로그인 · 회원가입아직 댓글이 없습니다. 첫 질문을 남겨 주세요.