Energy Meal Docs

기능명세서 아카이브

사주 기반 오늘의 메뉴 추천 서비스 Energy Meal의 기능명세 기록입니다.
버전별 명세를 남겨 서비스가 어떻게 고도화되었는지 추적합니다.

기능명세서 v1

구버전

현재 서비스에 구현된 기능의 전체 명세. 온보딩 · 정보 입력 · 오늘의 추천 화면과 생일 규칙 기반 v1 추천 엔진, 데이터 스키마, 테스트 현황을 다룹니다.

문서 보기 →

기능명세서 v2

현행 · 추천 엔진

만세력 기반 사주팔자 · 오행 분석 엔진 명세. 음양력 변환, 오행 스코어링, 오늘의 일진, 사주 풀이 노출 기능을 정의하고 구현 과정에서 확정된 결정을 기록합니다.

문서 보기 →

기능명세서 v3

현행 · 안주 페어링

술 · 안주 페어링 명세와 이후 개정 기록. 안주 모드(술 6종 · 사주 결합 스코어링 · 나이트 파운데이션)부터 설치 배너, 이미지 장면·각도 다변화, 콘텐츠 현실성 재정비(253종), 404 · 오프라인 화면까지의 변경 이력을 담습니다.

문서 보기 →

디자인 시안

Pencil 쇼케이스

스플래시부터 404 · 오프라인까지 화면 플로우 16종과 디자인 시스템 5종(컬러 · 타이포 · 컴포넌트 · 나이트 팔레트)을 한눈에 보는 갤러리 페이지입니다.

시안 보기 →

버전 기록

버전일자상태요약
v1.0 2026-04-23 구버전 출시 기능 기준 최초 명세화 — 생일 규칙 기반 추천 엔진
v2.0 Draft 2026-07-29 설계 만세력 사주팔자 · 오행 기반 추천 엔진 고도화 설계
v2.0 2026-07-29 As-Built 사주 엔진 구현 완료 — 확정 결정(라이브러리 · 가중치 · 진태양시) 반영
v2.1 2026-07-29 구버전 콘텐츠 확장 — 메뉴 232종 · 요리별 AI 이미지 196종 (사용자 피드백 대응, 이후 282종 · 246종으로 지속 확장)
v2.2 2026-08-17 구버전 재추천 방지 — 최근 추천 이력(FR-508) 신설과 스코어링 감점, 동점 정렬에 날짜 시드 타이브레이크(FR-506)
v2.3 2026-08-22 현행 · 추천 엔진 알림 진입 시 본 끼니 교체(FR-509) 신설 — 열람 기록 기준으로 이미 본 끼니만 다음 후보로, "이전 메뉴 보기"로 복원
v3.0 Draft 2026-07-29 설계 술 · 안주 페어링 설계 — 술 6종 × 사주 결합 스코어링 · 나이트 파운데이션 · Pencil 3장면
v3.0 2026-07-29 As-Built 안주 페어링 구현 완료 — 기존 78종 태깅 + 안주 전용 23종 · 포차/바 씬 이미지 · 확정 3건 반영
v3.0.1 2026-07-30 구버전 안주 진입 배너 상시 노출 — 아침 · 점심 탭에서도 미리 이용 가능하도록 dinner 한정 해제
v3.0.2 2026-08-14 구버전 셸 · 추천 UX 개정 3건 — 앱 설치 배너 신설(크로미움 프롬프트 · iOS 가이드 시트) · 앱 웹뷰 저장 유지 수정 · 다시 추천 결과 하루 유지
v3.0.3 2026-08-14 구버전 앱 스플래시 · 로딩 화면 브랜드 통일 — 로고 · 워드마크 · 태그라인 스플래시 시안 반영, 앱 버전 1.0.1
v3.0.4 2026-08-14 구버전 결과 화면 진입 가드 — 미입력 상태로 /today 직접 진입 시 기본 프로필 결과 대신 온보딩으로 리다이렉트
v3.0.5 2026-08-15 구버전 결과 화면 로딩 스켈레톤 — 저장값 확인 전 전체 페이지 스켈레톤 표시, 첫 페인트·리다이렉트 깜빡임 해소
v3.0.6 2026-08-15 구버전 끼니 간 추천 중복 제거 — 같은 날 같은 메뉴가 여러 시간대 탭에 반복 추천되지 않게 한 끼니에만 배분
v3.0.7 2026-08-15 구버전 콘텐츠 확장 3차 — 메뉴 30종·이미지 30장 추가(아침 12 · 점심 9 · 저녁 9), 총 335종·이미지 299종
v3.0.8 2026-08-15 구버전 콘텐츠 확장 4차 · 이미지 배경 다변화 — 메뉴 60종 추가로 총 395종·이미지 359종, 신규 90장을 요리별 장면 배경으로 재촬영
v3.0.9 2026-08-15 구버전 전 이미지 배경 다변화 완료 — 레거시 269장까지 요리별 장면 뱅크(24종)로 재촬영, 전체 359장
v3.0.10 2026-08-15 구버전 이미지 장면·각도 다변화 2차 — 장면 48종 × 카메라 앵글 7종 조합으로 359장 전체 재촬영
v3.0.11 2026-08-16 구버전 콘텐츠 확장 5차 — 메뉴 80종 추가(아침 20 · 점심 30 · 저녁 30), 총 475종·이미지 439장
v3.0.12 2026-08-16 구버전 콘텐츠 확장 6차 — 메뉴 80종 추가(아침 15 · 점심 30 · 저녁 35), 총 555종·이미지 519장
v3.0.13 2026-08-16 구버전 콘텐츠 확장 7차 — 메뉴 80종 추가(아침 15 · 점심 30 · 저녁 35), 총 635종·이미지 599장
v3.0.14 2026-08-16 구버전 콘텐츠 확장 8차 — 메뉴 70종 추가(아침 12 · 점심 28 · 저녁 30), 총 705종·이미지 669장
v3.0.15 2026-08-16 구버전 콘텐츠 확장 9차 — 메뉴 70종 추가(아침 12 · 점심 28 · 저녁 30), 총 775종·이미지 739장
v3.0.16 2026-08-16 구버전 콘텐츠 확장 10차 — 메뉴 75종 추가(아침 12 · 점심 30 · 저녁 33), 총 850종·이미지 814장
v3.0.17 2026-08-16 구버전 콘텐츠 확장 11차 — 메뉴 75종 추가(아침 12 · 점심 30 · 저녁 33), 총 925종·이미지 889장
v3.0.18 2026-08-16 구버전 콘텐츠 확장 12차(최종) — 메뉴 75종 추가, 목표 1,000종 달성 · 이미지 964장
v3.0.19 2026-08-17 구버전 재추천 방지 — 최근 14일에 본 메뉴는 다시 추천하지 않도록 이력 기반 감점, 동점 정렬에 날짜 시드 랜덤 도입
v3.0.20 2026-08-19 구버전 메뉴 현실성 재정비 — 향토·궁중·초희귀 메뉴 753종 제거로 총 247종, 미사용 이미지 736장 삭제
v3.0.21 2026-08-19 구버전 프랜차이즈 메뉴 6종 추가(맥모닝 · 서브웨이 · 맥도날드 · 버거킹 · 롯데리아 · 어묵탕) + 피자 2종 점심 겸용 — 총 253종
v3.0.22 2026-08-22 구버전 알림 진입 시 이미 본 끼니만 새 메뉴로 교체 — "이전 메뉴 보기"로 되돌리기 가능(v2 FR-509 신설)
v3.1.0 2026-08-27 구버전 404 · 오프라인 화면 신설(FR-609 · FR-610) — 앱 웹뷰 내장 에러 페이지를 브랜드 화면으로 교체, 연결 복구 시 자동 재로드. 시안 6장 추가
v3.1.1 2026-08-28 구버전 앱 스플래시 정리(FR-611 신설) — 로고 화질 · 이음매 · 노출 시간 · 스피너. 오프라인 화면이 옛 캐시로 뜨던 문제 수정(서비스워커 캐시 버전 상향)
v3.1.2 2026-08-29 구버전 재검토 결함 수정 — 앱 오프라인 실제 경로(형제→오버레이 · 자동 복구 probe 미작동 · 웹뷰 sw 미등록) · 네이티브 스플래시 배경 전용 · 404 하이드레이션 · sw 자산 캐시. 앱 v1.1.10
v3.1.3 2026-08-31 구버전 스플래시 최소 노출 1.5초 복원(첫 실행만) · 루트 문서 · web/README 현행화. 앱 v1.1.11
v3.1.4 2026-08-31 구버전 웹 화면 셸 개편(FR-612) — 폰 베젤 · 숨긴 내부 스크롤 제거, 430px 가운데 열 + 문서 스크롤(vidding-re 방식). 공용 app-shell.tsx · 앱 변경 없음(v1.1.11 그대로)
v3.1.5 2026-08-31 구버전 넓은 화면 배율 규칙(FR-612 개정) — 폰 화면을 그대로 확대(min(폭/430, 높이/600), 1~1.5), 아이패드 · 펼친 폴드 꽉 채움, 이미지 카드 60dvh 상한. 폴드 7/8 · 폴드형 아이패드 대비 · 앱 변경 없음
v3.1.6 2026-08-31 구버전 넓은 화면 규칙 재정의(FR-612 개정) — 통째 확대 철회. 마우스 웹은 430px 열 그대로, 터치 기기(폰 · 펼친 폴드 · 아이패드)는 화면 폭 그대로 채움(pointer: coarse). 앱 변경 없음
v3.1.7 2026-09-08 현행 알림 진입 시 본 끼니 교체(FR-509) 개정 — 열람 기준을 1.5초 체류에서 탭 직접 누름 · 첫 탭 즉시 기록으로(자동 전환 탭만 체류 기준 유지), 결과 화면 첫 탭은 0~4시도 아침. 앱 변경 없음