이하진 HAJIN LEE

2인 팀으로 프론트와 백엔드를 역할별로 고정하지 않고, 기능 단위로 함께 개발했습니다

ASAK은 고객의 키오스크 주문부터 매장의 주문 관리까지 연결한 9주 팀 프로젝트입니다. Admin/Backend를 중심으로 개발했고, DB 모델링과 API 구현뿐 아니라 WBS와 QA 기록도 함께 관리했습니다.

메뉴마다 복제되던 옵션을 재사용 가능한 정책으로 분리했습니다

menu
 ├─ menu_option
 └─ menu_option_group

opt_group
 ├─ opt_item
 └─ opt_policy
     └─ opt_policy_item

menu ── menu_opt_policy

공통 선택 규칙과 메뉴 연결을 분리해 중복을 줄이고, 메뉴별 차이는 예외 데이터로 관리할 수 있게 했습니다.

중요한 운영 규칙은 화면이 아닌 서버에서 검증하도록 구현했습니다

• 품절 대상을 메뉴·옵션·재료로 분리했습니다. 관리 화면에서는 한 목록으로 다루되 서버에서는 대상 유형별 규칙을 유지했습니다. MENU와 OPTION_ITEM은 Kiosk 반영을 확인했고, INGREDIENT 연쇄 반영 실패는 QA에 그대로 남겼습니다.
• 매출 API를 조회 목적에 따라 분리했습니다. 오늘 매출, 월별 매출, 일별 매출, 시간대 매출을 각각 독립된 API로 구성했습니다.
  sales-api.http

  GET /api/admin/sales/summary?period=month
  GET /api/admin/sales/monthly?year=2026
  GET /api/admin/sales/daily?from=2026-07-01&to=2026-07-31
  GET /api/admin/sales/daily/time-slots?date=2026-07-20&intervalMinutes=30

• 주문이 없는 시간대는 Service에서 0으로 채웠습니다. DB에는 실제 주문 데이터만 유지하고, 차트에 필요한 연속된 시간대는 영업시간 10:00~22:00 기준으로 Service에서 생성했습니다.
  responsibility

  DB        실제 주문 데이터 저장
  Service   빠진 시간대를 생성하고 0으로 보정
  API       연속된 시간축으로 반환
  Frontend  반환된 데이터를 차트로 표현

• 주문 상태에 따라 가능한 동작을 제한했습니다. RECEIVED → PREPARING → COMPLETED 흐름과 취소 가능 조건을 API에 적용했습니다. READY 주문의 취소 요청은 409 ORDER_CANCEL_NOT_ALLOWED로 차단됩니다.
• 결제 완료 응답의 기준 필드를 고정했습니다. 조회 시점의 건수를 다시 계산하지 않고 결제 시 주문에 저장된 일별 고정 번호 waitingOrderNo를 완료 화면과 영수증 요청에서 사용했습니다.
• 코드가 있다고 해서 완료로 처리하지 않았습니다. API·DB·build 결과를 확인하고, 브라우저와 장치에서 확인하지 못한 범위는 별도로 기록했습니다.

대시보드 응답 약 8초 → 0.43–0.50초

KPI의 중복 조회를 합친 뒤, 전체 데이터를 먼저 집계하던 View 대신 필요한 기간과 최근 주문만 베이스 테이블에서 조회했습니다. 결과값을 기존 View와 비교하면서 단계별로 측정해 최종 응답을 0.43~0.50초까지 줄였습니다.

아직 해결하지 못한 항목도 그대로 남겼습니다. 결제수단의 Kiosk 반영과 일부 재료 품절 연쇄는 최종 QA에서 실패로 기록했습니다. Admin 브라우저 전체 클릭, 실PG, 실물 장치/RTOS E2E는 검증하지 않았습니다.

개발뿐 아니라 팀이 같은 기준으로 작업할 수 있도록 문서와 진행 방식도 정리했습니다

요구사항부터 시나리오·화면·API·WBS·테스트까지 ID로 추적했습니다. API나 DB가 바뀌면 영향을 받는 화면과 작업 순서를 함께 정리하고, 실제로 확인하지 못한 항목은 완료 상태로 두지 않았습니다.

• 요구사항 → 사용자 시나리오 → Screen ID → API → WBS → 테스트 추적
• 코드 존재와 실제 API·DB·화면 검증 상태 분리
• 회의 결정사항, 후속 작업, 일일 워크로그와 온보딩 문서 관리
• 공통 개발 규칙을 6개 도구에 배포하는 ASAK Agent Kit 구성

요구사항 → 시나리오 → 화면 → DB / API → WBS → 테스트 → 최종 시연

07/02  프로젝트 시작
07월   화면·계약·핵심 기능
08월   연동·성능·통합 QA
09/02  최종 검증·시연