퍼널리 (Funnely)
비즈니스 광고 통합 관리 플랫폼 | 프로젝트 진행률: 95% 🎉
🎉 최신 업데이트 (2025-11-13)
- ✨ Recharts 고급 차트: 캠페인 성과를 4가지 차트 (Line, Area, Bar)로 시각화
- 📄 PDF 리포트: Excel과 PDF 형식 모두 지원
- 👥 팀 관리 시스템: 팀원 초대, 권한 변경, 삭제 기능
- 🚀 배포 준비 완료: Vercel 배포 가이드 문서 제공
📋 개요
퍼널리는 비즈니스의 마케팅 담당자가 Meta Ads, Kakao Moment, Google Ads를 한 곳에서 관리하고 분석할 수 있는 통합 SaaS 플랫폼입니다.
주요 기능
- ✅ 통합 광고 관리: Meta, Kakao, Google Ads 통합 관리
- 📊 실시간 대시보드: 광고 성과를 한눈에 확인
- 📈 고급 차트: Recharts 기반 4가지 차트 (Line, Area, Bar, Dual Axis)
- 📄 리포트 내보내기: Excel + PDF 형식 지원
- 👥 팀 관리: 팀원 초대, 권한 관리, 5단계 권한 시스템
- 🔔 실시간 알림: Supabase Realtime 기반 알림 시스템
- 🔐 안전한 권한 관리: 회사별 데이터 격리 및 역할 기반 접근 제어
🚀 빠른 시작
필수 요구사항
- Node.js 18.17 이상
- npm 또는 pnpm
- Supabase 계정
설치
# 1. 저장소 클론
cd ~/funnely
# 2. 의존성 설치
npm install
# 3. 환경 변수 설정
cp .env.example .env.local
# .env.local 파일을 열어서 Supabase 정보 입력
# 4. 개발 서버 실행
npm run dev
브라우저에서 http://localhost:3000 접속
자세한 설정 방법은 개발 환경 설정 가이드를 참조하세요.
🏗️ 기술 스택
Frontend
- Framework: Next.js 14 (App Router)
- Language: TypeScript
- Styling: Tailwind CSS + shadcn/ui
- State: TanStack Query + Zustand
- Charts: Recharts
- Forms: React Hook Form + Zod
Backend & Infrastructure
- Hosting: Vercel
- Database: Supabase (PostgreSQL)
- Authentication: Supabase Auth
- Storage: Supabase Storage
- API: Next.js API Routes
Ad Platforms
- Meta Marketing API v18.0
- Kakao Moment API v2
- Google Ads API v15
📁 프로젝트 구조
funnely/
├── docs/ # 프로젝트 문서
│ ├── PROJECT_OVERVIEW.md
│ ├── DATABASE_SCHEMA.md
│ ├── AD_PLATFORM_INTEGRATION.md
│ └── DEVELOPMENT_SETUP.md
├── src/
│ ├── app/ # Next.js 14 App Router
│ ├── components/ # React 컴포넌트
│ ├── lib/ # 유틸리티 및 헬퍼
│ ├── types/ # TypeScript 타입
│ ├── hooks/ # 커스텀 훅
│ └── styles/ # 글로벌 스타일
├── supabase/
│ └── migrations/ # DB 마이그레이션
├── public/ # 정적 파일
└── tests/ # 테스트 파일
📚 문서
🔐 보안
퍼널리는 데이터 보안 규정(개인정보보호법)을 준수합니다:
- ✅ End-to-end 암호화
- ✅ Row Level Security (RLS)
- ✅ 역할 기반 접근 제어 (RBAC)
- ✅ 감사 로그 (Audit Trail)
- ✅ API 키 암호화 저장
- ✅ 세션 타임아웃
🎯 로드맵
Phase 1: MVP (4-6주) ✅
Phase 2: 확장 (4-6주)
Phase 3: 프로덕션 (2-3주)
💰 비용
무료 티어 (500 사용자까지)
- Vercel: $0/월
- Supabase: $0/월
- Meta API: $0
- Kakao API: $0
- Google Ads API: $0
총 비용: $0/월
스케일업 시
- Vercel Pro: $20/월
- Supabase Pro: $25/월
총 비용: $45/월
🤝 기여
프로젝트에 기여하고 싶으시다면:
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature)
- Commit your Changes (
git commit -m 'Add some AmazingFeature')
- Push to the Branch (
git push origin feature/AmazingFeature)
- Open a Pull Request
📝 라이선스
이 프로젝트는 MIT 라이선스 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.
📞 연락처
프로젝트 관련 문의:
🙏 감사의 말
이 프로젝트는 다음 기술과 서비스를 사용합니다:
퍼널리 - 광고 관리를 더 쉽고 효율적으로 ✨
