오일모아 (OilMoa) 🛢️

!Python !PySide6 !License

전국 주유소의 실시간 유가 정보를 쉽고 빠르게 검색하고 관리할 수 있는 데스크톱 애플리케이션입니다.

🚀 개발 배경

이 프로젝트는 바이브 코딩(Vibe Coding) 방식으로 개발되었습니다. Claude AI와 PyCharm의 조합을 통해 실시간 대화형 개발을 진행했으며, MCP(Model Context Protocol) 서버를 활용하여 AI가 직접 코드를 작성하고 수정할 수 있었습니다.

개발 스택

• AI Assistant: Claude (Anthropic)
• IDE: PyCharm + MCP 서버 연동
• 개발 방식: 대화형 프로그래밍, 실시간 코드 생성 및 수정
• API: 오피넷(Opinet) 오픈 API

✨ 주요 기능

1. 주유소 검색 🔍

• 주유소 상호명으로 실시간 검색
• 검색 결과 테이블 형식으로 표시
• 체크박스를 통한 다중 선택 기능

2. 그룹 관리 시스템 👥

• 최대 5개 그룹 생성 가능
• 그룹별 최대 10개 주유소 등록
• 그룹 추가/수정/삭제 기능
• 그룹별 멤버 관리 기능

3. 실시간 가격 정보 💰

• 고급휘발유: 프리미엄 휘발유 가격
• 휘발유: 일반 휘발유 가격
• 경유: 경유 가격
• 실내등유: 등유 가격
• LPG: LPG 가격
• 비동기 방식으로 가격 정보 로딩

4. 데이터 저장 💾

• 그룹 및 멤버 정보 자동 저장
• JSON 형식으로 로컬 저장
• 프로그램 재실행 시 자동 로드

🛠️ 설치 및 실행

필수 요구사항

• Python 3.6 이상
• pip (Python 패키지 관리자)

1. 필요한 라이브러리 설치

pip install pyside6 requests

2. 오피넷 API 키 설정 (중요! ⚠️)

이 애플리케이션을 사용하기 위해서는 오피넷 무료 API 키가 필요합니다.

API 키 발급 방법:

1. 오피넷 홈페이지 접속
2. 회원가입 및 로그인
3. 오픈API → API 신청하기
4. 무료 API 키 발급 신청
5. 이메일로 받은 API 키 확인

API 키 설정:

프로젝트 루트 디렉토리에 oilmoa.env 파일을 생성하고 다음과 같이 작성:

API_CODE=발급받은_API_키

예시:

API_CODE=F123456789

⚠️ 주의: API 키가 없으면 애플리케이션이 정상적으로 작동하지 않습니다!

3. 애플리케이션 실행

python oilmoa.py

📦 실행 파일(.exe) 생성

Windows 실행 파일 빌드

1. PyInstaller 설치

pip install pyinstaller

2. 실행 파일 생성

python build_windows_exe.py

또는 직접 빌드:

pyinstaller --name=오일모아 --windowed --onefile --clean --icon=favicon.ico --add-data="oilmoa.env;." --add-data="favicon.ico;." oilmoa.py

3. 생성된 실행 파일 확인

• dist 폴더에 오일모아.exe 파일이 생성됩니다
• oilmoa.env 파일을 exe 파일과 같은 폴더에 배치해야 합니다

🎨 UI/UX 특징

• 직관적인 인터페이스: 그룹과 멤버를 좌우 분할로 표시
• 실시간 가격 업데이트: 비동기 방식으로 가격 정보 로딩
• 반응형 테이블: 내용에 맞게 칼럼 너비 자동 조정
• 상태 표시: 로딩 중/판매 안함 등 상태 표시

📝 사용 방법

1. 그룹 생성

   • 그룹명 입력 후 '추가' 버튼 클릭
   • 최대 5개 그룹, 그룹명은 10자 이내

2. 주유소 검색

   • 상호명 입력 후 '검색' 버튼 클릭
   • 검색 결과에서 원하는 주유소 체크

3. 그룹에 멤버 추가

   • 그룹 선택 후 주유소 체크
   • '선택한 주유소를 그룹에 추가' 버튼 클릭

4. 그룹 멤버 조회

   • 그룹 선택 후 '그룹멤버조회' 버튼 클릭
   • 해당 그룹의 모든 주유소 가격 정보 표시

⚙️ 환경 설정

파일 구조

oilmoa/
├── oilmoa.py           # 메인 애플리케이션
├── oilmoa.env          # API 키 설정 파일 (사용자 생성 필요)
├── favicon.ico         # 애플리케이션 아이콘
├── gas_station_data.json  # 그룹/멤버 저장 데이터
└── README.md           # 프로젝트 문서

🐛 알려진 문제

• 네트워크 연결이 필요합니다
• API 일일 호출 제한이 있을 수 있습니다 (무료: 1,000회/일)
• Windows Defender가 exe 파일을 차단할 수 있음 → '추가 정보' → '실행' 클릭

📄 라이선스

이 프로젝트는 MIT 라이선스 하에 배포됩니다.

🙏 감사의 말

이 프로젝트는 Claude AI와의 협업으로 만들어졌습니다. AI와 인간의 창의적인 협업이 만들어낸 결과물입니다.

---

Made by lala-friends
Powered by Claude AI + PyCharm MCP Integration

오피넷 오픈 API를 활용하여 실시간 유가 정보를 제공합니다