Skip to content

0ys/APT

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🏙️ AI 기반 아파트 및 동네 추천 플랫폼

메인 화면

📌 프로젝트 개요

AI 기반 대화 추천, 아파트 실거래 정보, 관심 목록, 리뷰, 문의 기능을 통합한 부동산 정보 플랫폼입니다.


🚀 주요 기능

🤖 AI 추천 기능

  • 사용자 대화 기반 추천
    • 대화 이력 분석을 통해 동네 또는 아파트 추천
  • 동네 추천
    • Pinecone 유사도 검색을 통해 관련 동네 추천
    • 결과는 JSON 형식 반환
  • 아파트 추천
    • Pinecone 유사도 검색을 통해 조건에 맞는 아파트 추천
  • 데이터 업로드
    • OpenAI Embedding API를 활용해 벡터화 후 Pinecone 저장
  • 유사 검색
    • 텍스트 임베딩 기반 유사 동네/아파트 검색
AI 채팅 화면
AI 채팅 화면

메인 화면

메인 화면 1 메인 화면 2
메인 화면 1 메인 화면 2

🏢 APT 기능

  • 지역 기반 아파트 검색 (동/구/시도 코드 기반)
  • Trie 기반 아파트/동 이름 키워드 검색
  • 실거래가 정보 제공 (연도/월/일 정렬)
  • Kakao API를 활용한 지도 및 길찾기 기능
지도 기반 UI/UX Trie 기반 검색
지도 기반 UI/UX Trie 기반 검색
주변 편의시설 지적편집도 / 지형
주변 편의시설 지적편집도 / 지형
지도 기반 필터링 실거래가 상세 정보
지도 기반 필터링 실거래가 상세 정보
실거래가 추가 정보 길찾기 기능
실거래가 추가 정보 길찾기 기능

📬 1:1 문의

  • 문의 작성/조회/수정/삭제
  • 이메일 알림 발송
  • 파일 첨부 기능 (추후 확장 가능)
1:1 문의 자주 묻는 질문
1:1 문의 자주 묻는 질문
공지사항
공지사항

⭐ 관심 목록 (Interest)

  • 최근 열람 및 북마크 관리 (아파트, 동네)
  • 북마크 상태 확인 및 삭제
  • 로컬 스토리지 ↔ DB 동기화
최근 본 목록 찜
최근 본 목록

📝 리뷰 기능

  • 리뷰 작성 (이미지 첨부 가능)
  • 리뷰 조회 (아파트별/사용자별/평점 필터)
  • 리뷰 수정/삭제
  • 업로드 이미지 조회 (URL 반환)
마이페이지 리뷰 목록
마이페이지 리뷰 목록

👤 사용자 기능 (User)

  • 회원가입, 프로필 수정, 비밀번호 암호화
  • 소셜 로그인 (카카오 OAuth)
  • 세션 기반 로그인/로그아웃
  • 이메일 인증 (코드 전송 및 검증)
회원가입 로그인
회원가입 로그인

🧱 기술 스택

구분 기술
Backend Spring Boot, MySQL, Redis
Frontend Vue 3, Vite, Axios, Chart.js, Kakao Map API
AI Server FastAPI (Python), OpenAI API, Pinecone
인증/보안 Spring Security, OAuth2, Email 인증
기타 도구 Docker, GitHub Actions or Jenkins (선택)

Use Case Diagram

ERD

ERD
ERD

클래스 다이어그램

AI APT
AI APT
Board Interest
Board Interest
Review User
Review User

👥 팀 구성 및 역할

본 프로젝트는 총 2명이 참여하였으며, 역할 분담을 명확히 하여 효율적인 협업을 진행했습니다.

이름 담당 역할 주요 업무
👤 공예슬 (FE) 프론트엔드 개발 Vue 기반 UI/UX 구현, AI 챗봇 인터페이스, Kakao 지도 연동, 관심목록/리뷰/1:1 문의 화면 개발
👤 강승엽 (BE) 백엔드 API 개발 Spring Boot 기반 API 서버 구축, 실거래가/검색/리뷰/문의 API 설계 및 구현
👤 강승엽, 공예슬 (AI) AI 추천 시스템 개발 Pinecone + OpenAI Embedding을 활용한 AI 추천 시스템 개발 및 벡터 데이터 관리

💬 협업 방식

  • GitHub Issues 및 Projects를 활용한 작업 분담
  • API 명세서는 Swagger 기반으로 자동 문서화
  • 기능 단위 커밋 및 PR 리뷰로 코드 품질 관리
  • 정기 회의를 통한 진행 상황 공유 및 기능 통합 조율

About

AI 챗봇 기반 아파트 정보 검색 부동산 웹 플랫폼, APT

Resources

Stars

Watchers

Forks