AI 업무 말투 변환기 (Business Tone Converter)

사용자가 전달하고자 하는 핵심 내용만 입력하면, 메시지를 받는 대상(상사, 동료, 고객 등)에 맞춰 적절하고 정중한 업무용 말투로 변환해주는 웹 서비스입니다. Google Gemini AI를 활용하여 상황에 맞는 자연스러운 문장을 생성합니다.

✨ 주요 기능

• 상황별 맞춤 변환: 타팀 동료, 직장 상사, 친구, 선생님, 거래처 등 수신 대상에 따른 적절한 톤앤매너로 변환합니다.
• AI 기반 문장 생성: Google Gemini Pro 모델(gemini-2.5-pro)을 활용하여 고품질의 비즈니스 문장을 생성합니다.
• 간편한 사용성: 복잡한 설정 없이 입력과 선택만으로 즉시 결과를 확인하고, 원클릭으로 복사하여 사용할 수 있습니다.

🛠 기술 스택 (Tech Stack)

• Frontend: HTML5, CSS3, JavaScript (Vanilla)
• Backend: Python (Flask Framework)
• Infrastructure: Firebase Hosting (프론트엔드), Firebase Cloud Functions (백엔드)
• AI Model: Google Gemini API

🚀 시작 가이드 (Getting Started)

이 프로젝트를 로컬 환경에서 실행하거나 배포하기 위한 가이드입니다.

사전 요구사항 (Prerequisites)

• Python 3.10+
• Node.js (Firebase CLI 실행용)
• Firebase CLI 설치: npm install -g firebase-tools
• Google Cloud Project 생성 및 Gemini API Key 발급

설치 및 환경 설정

1. 저장소 클론 (Clone)

   git clone <repository-url>
   cd hanbit_2

2. Python 가상환경 생성 및 패키지 설치

   cd functions
   python -m venv venv
   source venv/bin/activate  # Windows: venv\Scripts\activate
   pip install -r requirements.txt

3. 환경 변수 설정 functions 폴더 안에 .env 파일을 생성하고, 발급받은 Gemini API 키를 입력하세요.

   # functions/.env
   GOOGLE_API_KEY=여기에_당신의_API_KEY를_입력하세요
   

로컬 서버 실행 (Local Development)

Firebase Emulators를 사용하여 로컬에서 전체 서비스를 테스트할 수 있습니다.

1. 프로젝트 루트 디렉토리로 이동

   cd ..  # functions 폴더에 있다면 상위 폴더로 이동

2. 에뮬레이터 실행

   firebase emulators:start

   • 실행 후 터미널에 표시되는 Hosting URL(보통 http://127.0.0.1:5000)로 접속하여 테스트합니다.

☁️ 배포하기 (Deployment)

Firebase Hosting과 Cloud Functions에 배포하여 서비스를 공개할 수 있습니다.

firebase deploy

📂 프로젝트 구조

hanbit_2/
├── functions/          # Python 백엔드 코드 (Cloud Functions)
│   ├── main.py         # Flask 앱 및 AI 로직 진입점
│   └── requirements.txt # Python 의존성 목록
├── public/             # 프론트엔드 정적 파일
│   ├── index.html      # 메인 페이지
│   ├── script.js       # 프론트엔드 로직
│   └── style.css       # 스타일 시트
├── firebase.json       # Firebase 설정 파일
└── outline.md          # 프로젝트 기획안

📝 라이선스

이 프로젝트는 학습 및 포트폴리오 목적으로 제작되었습니다.