namerong 님의 블로그

이번 작업에서는 냉파마스터의 구독 결제 데이터를 운영 관점에서 확인할 수 있도록 월별 정산 집계와 관리자 정산 관리 기능을 구현했다.이전까지는 TossPayments를 통해 결제 승인, 자동결제, 결제 이력 저장까지는 가능했지만, 운영자가 “이번 달 매출이 얼마인지”, “수수료를 제외하면 실제 순매출은 얼마인지”, “정산이 확정되었는지”를 확인할 수 있는 구조는 부족했다.그래서 이번에는 결제 데이터를 단순히 저장하는 데서 끝내지 않고, 월별로 집계하고 상태를 관리하는 정산 흐름까지 확장했다.1. 작업 배경구독 결제가 들어오면 payments 테이블에는 결제 성공/실패 이력이 쌓인다.하지만 운영 관점에서는 개별 결제 내역만 보는 것보다 월 단위로 다음 정보를 확인하는 것이 더 중요하다.해당 월 총매출결제 ..

이번 글에서는 냉파마스터의 구독 결제 흐름을 중심으로, 무료체험, 해지 예약, 자동결제, 결제 실패 상태를 어떤 기준으로 설계하고 구현했는지 정리해보려고 한다.이번 작업은 단순히 “결제 버튼을 만든다”에서 끝나는 작업이 아니었다.구독 기능은 한 번 결제하고 끝나는 기능이 아니라, 시간이 지나면서 상태가 계속 바뀐다.무료체험이 시작되고, 체험이 끝나면 자동결제가 진행되고, 사용자가 해지하면 현재 기간까지는 유지하되 다음 결제는 막아야 한다.또 결제가 실패하면 실패 이력을 남기고, 일정 횟수까지 재시도한 뒤 최종적으로 구독을 만료해야 한다.그래서 이번 작업은 구독의 전체 생명주기를 정리하는 작업에 가까웠다.먼저 한 줄로 정리하면냉파마스터의 구독 결제 흐름은 단순 결제 기능이 아니라, 무료체험, 해지 예약, ..

작업 범위#327 TossPayments 결제 정책 및 API 명세 작성#328 TossPayments 빌링키 등록 구현#329 TossPayments 구독 결제 승인 및 자동결제 구현#330 TossPayments 웹훅 수신 및 중복 처리 구현#367 구독 결제 관리 화면 연동1. 작업 배경냉파마스터 2차 프로젝트에서는 기존 냉장고, 장보기, AI 기능을 단순 기능으로만 제공하는 것이 아니라, 프리미엄 기능으로 확장할 수 있는 구조를 만들고 있다.이번 작업은 그중에서도 프리미엄 기능을 실제 서비스처럼 운영하기 위한 구독 결제 흐름을 만드는 작업이었다.처음에는 “TossPayments 결제 API만 붙이면 되지 않을까?”라고 생각했지만, 막상 구현을 시작해보니 결제는 단순 API 호출만으로 끝나는 기능이..

작업 범위#325 OCR 후보 재료 자동 매칭 및 후보 목록 조회 API 구현#326 영수증 후보 수정/제외/승인 후 냉장고 등록 API 구현#358 영수증 OCR 기반 냉장고 등록 화면 연동1. 작업 배경이전 작업에서는 영수증 이미지를 업로드하고, FastAPI Agent에서 OpenAI Vision을 통해 영수증 내용을 OCR로 분석하는 흐름까지 구현했다.이번 작업에서는 OCR 결과를 실제 서비스 기능으로 이어지게 만드는 것이 목표였다.단순히 영수증에서 텍스트를 추출하는 것만으로는 사용자가 바로 냉장고에 등록할 수 없다.OCR 결과에는 브랜드명, 원산지, 용량, 행사 문구 등이 섞일 수 있고, 사전 재료와 정확히 일치하지 않는 경우도 있기 때문이다.그래서 이번에는 다음 흐름을 구현했다.영수증 OCR ..

이번 글에서는 냉파마스터 2차 프로젝트에서 진행한 영수증 OCR Agent 기반 구축 작업을 정리해보려고 한다.이번 작업은 단순히 API 하나를 추가한 것이 아니라, 사용자가 영수증 사진을 업로드하면 AI가 구매한 식재료 후보를 추출하고, 이후 냉장고 등록까지 이어질 수 있도록 기반 흐름을 만든 작업이었다.작업 기간2026.08.07 ~ 2026.08.10작업 범위#322 영수증 Agent 기반 테이블 추가#323 영수증 이미지 업로드 및 S3 임시 저장 구현#324 OpenAI Vision 기반 영수증 OCR 분석 구현1. 작업 배경기존 냉장고 등록 기능은 사용자가 직접 재료명을 검색하고 수량, 유통기한, 메모를 입력하는 방식이었다.하지만 실제 사용 흐름에서는 장을 본 뒤 여러 재료를 한 번에 냉장고에..

이번 작업은 냉파마스터 2차 프로젝트의 리팩토링 및 확장 작업이다.1차 프로젝트에서는 냉장고 재료 관리, 장보기 목록 관리, 사전 재료 검색, 관리자 사전 재료 관리 기능을 중심으로 기본 CRUD 흐름을 구현했다.2차 프로젝트에서는 여기서 한 단계 확장해, 사용자의 냉장고와 장보기 상태를 기반으로 AI가 필요한 재료를 추천하고, 추천 결과를 사용자가 직접 승인해 장보기 목록에 추가할 수 있는 구조를 구현했다.이번 작업 범위는 다음과 같다.#238 AI 장보기 추천 MVP 구현#239 AI 대화 세션 및 메시지 기록 구현#240 LLM 사용량 로그 저장 구현#316 프론트 AI 장보기 추천 화면 연동#317 관리자 LLM 사용량 전체 조회 API 구현#318 관리자 LLM 사용량 로그 화면 구현1. 작업 ..

1. 학습 주제애플리케이션을 개발한 뒤 서버에 배포하는 흐름과, 이를 자동화하는 CI/CD 개념을 학습했다.또한 AWS 환경에서 직접 배포를 진행하며 EC2와 Elastic Beanstalk 같은 배포 방식의 차이를 정리했다.핵심 내용은 다음과 같다.CI/CD 개념GitHub ActionsJenkinsArgo CDKubernetesAWS EC2 배포Elastic BeanstalkVPC 기본 개념2. CI/CD란?CI/CD는 개발한 코드를 자동으로 검사하고 배포하기 위한 개발 자동화 흐름이다.코드 작성-> Git push-> 빌드-> 테스트-> 이미지 생성-> 서버 배포CI와 CD는 역할이 조금 다르다.구분의미역할CIContinuous Integration코드 변경 사항을 자주 통합하고 빌드/테스트CDCo..

1차 프로젝트에서는 냉장고, 사전 재료, 장보기 기능의 기본 CRUD와 프론트 연동을 중심으로 구현했다.2차 프로젝트에서는 단순 기능 추가보다는 기존 기능을 더 안정적으로 다듬고, 이후 AI Agent 기능으로 확장할 수 있는 구조를 만드는 것을 목표로 잡았다.이번 작업 범위는 크게 세 가지였다.첫째, 장보기 항목 중복 등록 방지둘째, AI Agent가 사용할 Tool API 구조 정리셋째, 냉장고와 장보기 상태를 기반으로 한 장보기 추천 MVP 구현관련 이슈는 다음과 같다.이슈작업 내용#234장보기 항목 중복 등록 방지#235AI 장보기 자동화 Agent API 명세 작성#236Agent 냉장고/장보기 조회 Tool API 구현#237Agent 장보기 추가 Tool API 구현#238AI 장보기 추천 ..

1. 학습 주제Dockerfile로 애플리케이션 이미지를 만들고, Docker Compose로 여러 컨테이너를 함께 실행하는 흐름을 학습했다.추가로 AWS EC2 같은 클라우드 서버에 파일을 올리고, 서버에서 Docker 이미지로 실행하는 기본 배포 흐름도 정리했다.핵심 내용은 다음과 같다.DockerfileDocker 이미지와 컨테이너JRE와 JDK 차이Spring Boot JAR Docker 이미지 생성scp로 EC2 서버에 파일 전송EC2 방화벽 설정Docker ComposeDocker NetworkDocker VolumeCloud, IaaS, PaaS, SaaSAWS 주요 서비스2. Dockerfile이란?Dockerfile은 Docker 이미지를 만들기 위한 설명서이다.이미지를 만들 때 필요한 ..

1. 학습 주제Linux와 Ubuntu의 기본 개념, 터미널 명령어, 에디터 사용법, Docker의 이미지와 컨테이너 개념을 학습했다.서버 환경에서는 GUI보다 터미널을 많이 사용하기 때문에 기본 명령어와 파일 편집 도구에 익숙해지는 것이 중요하다.핵심 내용은 다음과 같다.Linux와 Ubuntu 개념Shell과 터미널Nano, vi, vim 차이절대경로와 상대경로기본 Linux 명령어리디렉션과 grepDocker 이미지와 컨테이너Docker 컨테이너 실행, 접속, 중지, 삭제2. Linux란?Linux는 운영체제의 핵심인 Kernel을 기반으로 만들어진 운영체제 계열이다.서버, 클라우드, Docker, 안드로이드 등 다양한 환경에서 많이 사용된다.Linux 자체는 하나의 완성된 제품이라기보다, 여러 배..