English | 한국어
직접 제작한 모바일 결혼식 청첩장 어플리케이션입니다.
AI 챗봇, 방명록, RSVP, 사진 업로드, 관리자 페이지 등의 기능을 제공합니다.
상업적인 용도 외에 개인 청첩장으로는 자유롭게 사용하셔도 됩니다. 🤗
| Animation |
|---|
 |
페이지 접속 시 재생되는 애니메이션. 지정된 사진과 문구가 나타납니다.
| Example1 | Example2 |
|---|---|
 |
 |
신랑신부에 대한 질문에 자연스럽게 답변하는 RAG 기반 챗봇.
| 방명록 | 방명록 작성 페이지 | RSVP | RSVP |
|---|---|---|---|
 |
 |
 |
 |
실시간 축하 메시지 작성/수정/삭제, 참석 여부 확인 및 통계. 비밀번호 보호, 신랑/신부측 구분.
| 사진 업로드 페이지 | 사진 업로드 성공 페이지 |
|---|---|
 |
 |
AWS S3를 이용한 사진 업로드 기능. 하객들이 결혼식 사진을 쉽게 공유할 수 있는 기능.
| Admin Login | Admin Page |
|---|---|
 |
 |
세션 기반 인증, RSVP 및 방명록 통합 관리, CSV 내보내기, 실시간 통계.
🗺️ 지도 & 교통편 | 💰 카카오페이 송금 | 📅 구글 캘린더 연동
🎵 배경음악 | 📱 카카오톡 공유 | 📊 방문자 통계
- Python 3.10+
- OpenAI API 키 (AI 챗봇용)
- AWS 계정 및 S3 버킷 (사진 업로드 기능용)
- (프로덕션) PostgreSQL 또는 Railway 계정
1️⃣ 프로젝트 클론 및 설치
git clone https://github.com/sooftware/wedding-invitation.git
cd wedding-invitation
pip install -r requirements.txt2️⃣ 환경변수 설정
cp .env.example .env
# OpenAI API 키와 관리자 비밀번호 설정3️⃣ 실행
python main.py
# http://localhost:8000 접속📖 자세한 가이드: 설치 가이드 | Railway 배포 가이드
| 카테고리 | 문서 |
|---|---|
| 시작하기 | 설치 가이드 · Railway 배포 |
| 설정 | config.json 설정 · AI 챗봇 설정 · 디자인 커스터마이징 |
| 도움말 | FAQ (자주 묻는 질문) |
-
Backend: FastAPI · LangChain · LangGraph · Chroma · PostgreSQL/SQLite
-
Frontend: Vanilla JS · Lucide Icons · CSS3
-
AI/ML: OpenAI GPT-4o-mini · OpenAI Embeddings · LangSmith
-
Storage: AWS S3 (boto3)
-
DevOps: Railway · Docker · GitHub Actions
wedding-invitation/
├── app/ # 백엔드 (FastAPI, LangGraph 챗봇, DB)
├── config/ # 설정 (결혼 정보, 챗봇 지식베이스)
├── static/ # 정적 파일 (CSS, JS, 이미지)
├── templates/ # HTML 템플릿
├── scripts/ # 유틸리티 (비밀번호 생성, 이미지 최적화)
├── docs/ # 문서
└── main.py # 앱 엔트리포인트
📖 자세한 구조는 아키텍처 문서 참고
이 프로젝트는 CC BY-NC-SA 라이선스를 따릅니다.
- ✅ 개인 결혼식 사용 가능
- ✅ 수정 및 재배포 가능 (단, 동일 라이선스 적용 및 출처 명시)
- ❌ 상업적 이용 금지
- ❌ 청첩장 제작 서비스 금지
자세한 내용은 LICENSE 파일을 확인하세요.
Made with ❤️ by Soohwan Kim & Soyoung Cho & Claude Code