5조 소지품 체크 브레인스토밍(수정).md

CI-CD 수정사항.md

5조작품 제작 워크시트(수정).md

소지품 체크 프로젝트 기획안(수정).md

최종구조도.drawio

<aside> 📦

SmartScan Hub — 노터치 소지품 체크 시스템

진행 상태: 진행 중 | 개발 기간: 2026-03-10 ~ | 도메인: smartscan-hub.com

팀원: 황찬영, 이동주, 김준표, 박준영, 임재영

클라우드 + Lambda + RFID : 황찬영

백엔드(FastAPI) + RFID: 이동주

프론트엔드 : 임재영, 김준표

카카오톡 챗봇 : 박준영

</aside>

1. 프로젝트 개요

문제 정의

외출 시마다 반복되는 "지갑/차키 챙겼나?" 직접 눈으로 확인해야 하는 반복적 불안

해결 방안

현관 앞 UHF RFID 리더기가 가방·의류 속 소지품을 자동 다중 스캔 → 누락 감지 시 이메일 알림 즉시 발송 (No-Touch)

기획 의도

하드웨어 + 클라우드 서비스를 결합한 HaaS(Hardware as a Service) 모델로, DIY 설치 + 저비용 운영이 가능한지 검증

핵심 키워드

Edge: Raspberry Pi 4B, Python 3.12, pyserial

BaaS: Supabase (Auth, PostgreSQL, Realtime)

Backend: FastAPI (Render 호스팅)

Lambda: boto3, supabase-py, resend

Frontend: HTML/CSS/JS + supabase-js (S3 + CloudFront)

IaC: Terraform

CI/CD: GitHub Actions + Render 자동 배포

<aside> 💡

핵심 기술 포인트: AWS RDS → Supabase PostgreSQL 마이그레이션, FastAPI를 Render 무료 호스팅, Lambda 4개 유지 (Python 코드 재사용), Resend 이메일 알림, 가족 단위 소지품 관리 구조

</aside>

2. 시스템 아키텍처

웹사이트 흐름

사용자 → smartscan-hub.com (CloudFront + S3) → Supabase Auth (로그인) → FastAPI (Render) → Supabase DB

RFID 스캔 흐름

Raspberry Pi → API Gateway → Lambda (inbound) → Supabase DB → 누락 시 → Lambda (outbound) → Resend 이메일

원격 알림 흐름

웹사이트 → API Gateway → Lambda (remote) → Resend 이메일 → 가족 구성원에게 발송

챗봇 흐름

카카오톡 → API Gateway → Lambda (chatbot) → Supabase DB → 조회/등록 응답

<aside> 🏗️

아키텍처 설계 핵심 결정 사항

• Supabase 도입: RDS MySQL → Supabase PostgreSQL 마이그레이션. Auth, Realtime, REST API 내장으로 인프라 단순화
• FastAPI on Render: 팀원(이동주)이 구현 완료한 FastAPI 코드 그대로 활용. Render 무료 티어로 호스팅
• Lambda 유지 (Edge Functions 미사용): 기존 Python 코드 재사용, CI/CD 워크플로우 유지, TypeScript 학습 불필요
• EventBridge 제거: Lambda 간 직접 호출 (boto3 lambda.invoke)로 변경 → 아키텍처 단순화
• 알림 방식 변경: 카카오톡 Push → Resend 이메일 발송 (비용 절감 + 가족 구성원별 개인 알림)
• 가족 구조 도입: 단일 사용자 → Owner/Member 역할 기반 가족 단위 소지품 관리 </aside>

3. 기술 스택