🔎 BizScan

공공데이터 + AI로 완성하는 소상공인 맞춤형 비즈니스 컨설팅 웹 서비스, 비즈스캔

2025.12.28 ~ 2026.02.20

💡 프로젝트 요약

서비스 개요

BizScan은 공공 상권 데이터를 AI가 분석하여
소상공인에게 즉시 실행 가능한 전략(Action Plan) 을 제공하는
실행 중심 비즈니스 컨설팅 웹 서비스입니다.

기존 상권 분석 서비스가 “데이터 시각화”에 그쳤다면, BizScan은 데이터 → 인사이트 → 실행 전략까지 연결합니다.

문제 정의

상권 데이터는 많지만, 소상공인이 실제로 무엇을 해야 하는지에 대한 구체적인 전략은 부족합니다.

BizScan의 Solution

데이터 → 인사이트 → 실행 전략(Action Plan)

BizScan은 분석에서 그치지 않고 실행까지 이어지는 AI 상권 컨설턴트를 목표로 합니다.

🚀 Service Goals

[1] AI 상권 스캐너

공공데이터와 지역 정보를 자동 수집 및 분석하여 가게 현황을 한눈에 제공

[2] 실행형 AI 리포트

SWOT 기반 분석 + 구체적인 실행 전략 제시

[3] 소상공인의 성장 루트 설계

실행 → 기록 → 성과 확인 → 재분석
지속 가능한 비즈니스 개선 구조

Backend Overview

BizScan Backend는 Spring Boot 기반 API 서버와 FastAPI 기반 AI 서버로 구성됩니다.

Backend Core Features

🔐 JWT 기반 인증
🏪 매장 정보 CRUD
📊 상권 데이터 수집 및 저장 (RDB + VectorDB)
🤖 AI SWOT 리포트 및 실행 전략 생성
📈 실행 관리 및 성과 추적
🚀 Docker 기반 CI/CD 자동 배포

Infrastructure & DevOps

• CI/CD 파이프라인 최적화 (GitHub Actions + Self-hosted Runner)
• Prometheus + Grafana 기반 모니터링 시스템 구축
• Redis 캐시 도입 (JWT Refresh Token 관리 및 조회 성능 개선)
• Nginx 기반 HTTPS 도메인 연결 및 SSL 적용
• Docker 기반 컨테이너 환경 구성

System Architecture

ERD

Contributors

공공 상권 데이터를 기반으로 AI 분석 시스템을 설계하고,
실행 가능한 비즈니스 전략을 제공하는 BizScan 팀입니다.

PM	Design
최근영	이연수

FE Developer	FE Developer	FE Developer
김도형	박하은	백수민

BE Developer	BE Developer	BE Developer	BE Developer	BE Developer
김종혁	신채린	김가빈	편선아	윤수정

Stacks

Design (UI/UX)

Frontend

Backend

• Core Application (API Server)

  

• AI Server

  

• Database & Cache

  

• Infra & Deployment

  

• Monitoring

  

• API Documentation

  

Communication

협업 규칙

1) Git 브랜치 전략

• main : 배포용(항상 안정 상태 유지)
• develop : 개발 통합 브랜치
• feature/#이슈번호-기능명 : 기능 개발
• fix/#이슈번호-버그명 : 버그 수정
• refactor/#이슈번호-내용 : 리팩토링
• deploy/#이슈번호-내용 : 배포

2) 프로젝트 구조 결정

• 도메인형 구조로 구성
  • 도메인 별로 controller / service / repository / dto / entity / exception / mapper 등을 묶어서 관리
  • 공통(전역) 영역은 global 또는 common 패키지로 분리

3) 코드 컨벤션

• 네이밍: 클래스 PascalCase, 변수/메서드 camelCase, 상수 UPPER_SNAKE_CASE
• 커밋 메시지: :emoji: Type: 내용 형식 사용
• 공통 응답 포맷 유지 (BaseResponse / ErrorCode 규칙 통일)
• Controller는 요청/응답 처리 중심, 비즈니스 로직은 Service에 위치

🎯 Git Commit Convention

  🎉 Start: Start New Project [:tada]  
  ✨ Feat: 새로운 기능을 추가 [:sparkles]  
  🐛 Fix: 버그 수정 [:bug]  
  🎨 Design: CSS 등 사용자 UI 디자인 변경 [:art]  
  ♻️ Refactor: 코드 리팩토링 [:recycle]  
  🔧 Settings: Changing configuration files [:wrench]  
  🗃️ Comment: 필요한 주석 추가 및 변경 [:card_file_box]  
  ➕ Dependency/Plugin: Add a dependency/plugin [:heavy_plus_sign]  
  📝 Docs: 문서 수정 [:memo]  
  🔀 Merge: Merge branches [:twisted_rightwards_arrows:]  
  🚀 Deploy: Deploying stuff [:rocket]  
  🚚 Rename: 파일 혹은 폴더명을 수정하거나 옮기는 작업만인 경우 [:truck]  
  🔥 Remove: 파일을 삭제하는 작업만 수행한 경우 [:fire]  
  ⏪️ Revert: 전 버전으로 롤백 [:rewind]

4) PR 규칙

• PR은 작게(기능 단위) 올리기
• PR 템플릿 사용:
  • 관련 이슈 연결: Close #이슈번호
  • 변경 내용 요약 작성
  • 테스트/검증 내용 작성(가능하면 스크린샷/로그 포함)
• 최소 1명 이상 리뷰 승인 후 머지
• 머지는 원칙적으로 Squash and merge (커밋 히스토리 정리)