플러스프로젝트 배경
1) 예상 리스크 및 대응 계획 - NFC Web API가 Android Chrome에서만 지원되는 플랫폼 제약 속에서 iOS 환경에서는 QR 코드 대체 흐름을 자연스럽게 제공하는 크로스플랫폼 UX 설계 과제 - 프로필 조회 이벤트를 응답 흐름과 분리하여 비동기로 저장하면서 서버 재시작 시에도 이벤트 유실이 발생하지 않도록 보장하는 내구성 설계 과제 - Redis 캐시 무효화 시점을 프로필 업데이트 이벤
프로젝트 성과
Redis 기반 NFC 단축 URL 라우터 구현
태그 스캔 요청 시 Redis에서 프로필 URL을 즉시 조회하여 리다이렉션 응답 시간을 최소화하는 고성능 라우팅 구조를 설계합니다.
비동기 통계 수집 파이프라인 설계
FastAPI BackgroundTask로 프로필 뷰어 응답과 통계 저장을 분리하여 트래픽 급증 시에도 수집 누락 없는 이벤트 기록 체계를 구현합니다.
RBAC 기반 관리자 권한 격리 아키텍처
FastAPI Depends 체인으로 관리자 역할을 미들웨어 레벨에서 검증하고 일반 사용자 API와 완전히 분리된 권한 경계를 설계합니다.
Canvas API QR 코드 로고 합성 구현
서버에서 생성한 QR 이미지 위에 Canvas API로 브랜드 로고를 합성하여 커스터마이즈된 QR 코드 다운로드 기능을 구현합니다.
SQLAlchemy 감사 로그 자동 기록 설계
관리자 조치 이벤트마다 AuditLog 레코드를 자동 삽입하는 이벤트 훅을 구현하여 모든 운영 액션의 추적 가능성을 확보합니다.
핵심 기능
관리자 통합 대시보드
전체 사용자 및 프로필 현황을 실시간으로 모니터링하는 관리자 허브
진행 단계
FastAPI RBAC 인증 미들웨어 및 DB 모델 설계
2026.04
SQLAlchemy 7개 모델 정의, FastAPI Depends 기반 관리자 권한 격리, JWT 검증 미들웨어 구현
프로젝트 상세
1) 포트폴리오 소개 MVP 이후 단계의 관리자 시스템과 NFC/QR 태그 매핑 기능을 통합한 확장 플랫폼을 설계합니다. 실시간 통계 대시보드와 사용자 분석 모듈로 서비스 운영에 필요한 데이터 가시성을 확보하고, Redis 캐싱으로 고빈도 조회 성능을 최적화합니다. 2) 작업 범위 - 관리자 통합 대시보드: 전체 사용자 및 프로필 현황을 실시간으로 모니터링하는 관리자 허브 - NFC/QR 태그 매핑
