비개발자의 SaaS도전기: 로그인(구글,카카오) Gemini AI채팅, 결제구독, 배포 와 추가 대시보드 생성까지
2026.04.11
# saas-engine — 전체 작업 기록 (Phase별 구조 정리)
> 작성 기준: 2026-04-11
> 목적: 설계 → 구현 → QA → 개선까지 전 작업을 단계별로 체계적으로 정리 https://saas-engine-xi.vercel.app/
---
## 📋 프로젝트 한 줄 요약
> Supabase 인증 + Polar 구독 결제 + Gemini AI 채팅을 하나로 묶은 재사용 가능한 SaaS 공통 엔진.
> 실서비스 구현과 강의용 튜토리얼을 동시에 목표로 한다.
> 추가 예정 작업: 대시보드 작업후, 5개 메인 섹터 작업
## Phase 0. 프로젝트 설계 · 기획
**목표**: 무엇을 어떤 순서로 만들지 결정
1. **목적 이중 설정**: 실서비스 구현 + 강의용 튜토리얼
2. **엔진 분리 전략**: engine/ → features/ → apps/ 레이어 구조로 재사용성 확보
3. **외부 서비스 선정**:
- Auth: Supabase (OAuth SSR, RLS 기반 Row 보안)
- 결제: Polar.sh (구독 기반, 웹훅 동기화)
- AI: Gemini API (스트리밍 응답)
4. **튜토리얼 매핑 **:
- 프로젝트 세팅 (Next.js, GitHub)
- 인증 (Supabase + Google OAuth)
- 결제 (Polar + Checkout + 웹훅)
---
#Phase 1. 프로젝트 초기 세팅
**목표**: Next.js 앱 생성, 폴더 구조 확립, 환경 변수 체계 수립
#작업 내역
1. **Next.js 16 앱 생성** (App Router, Turbopack)
2. **폴더 구조 확립**
3. **환경 변수 체계**
#필수 환경 변수
```
NEXT_PUBLIC_SUPABASE_URL
NEXT_PUBLIC_SUPABASE_ANON_KEY (또는 PUBLISHABLE_KEY)
NEXT_PUBLIC_APP_URL
SUPABASE_SERVICE_ROLE_KEY
POLAR_ACCESS_TOKEN
POLAR_WEBHOOK_SECRET
POLAR_PRODUCT_ID_PRO
POLAR_SERVER (sandbox | production)
```
---
Phase 2. 인증 엔진 구축
**목표**: Google + Kakao OAuth, SSR 라우트 보호, 사용자 DB 동기화
2-1. Supabase 클라이언트 설정
2-2. DB 마이그레이션
2-3. 라우트 보호 (SSR)
2-4. 로그인 UI
#### 2-5. Kakao 연동 (추가)
- Kakao 앱 등록
- Supabase Provider 활성화, Redirect URI 등록
## Phase 3. AI 채팅 기능 구현
**목표**: Gemini API 스트리밍 채팅, 대화 저장, 사용량 연동
3-1. DB 마이그레이션
3-2. 기능 모듈 (`features/gemini-chat/`)
3-3. 사용량 엔진 (`engine/usage/`)
3-4. API 라우트
3-5. 채팅 UI (`app/chat/page.tsx`)
## Phase 4. 결제·구독 엔진 구축 (WALL 3)
**목표**: Polar.sh Checkout, 웹훅 수신, 구독 상태 DB 동기화
4-1. DB 마이그레이션
4-2. API 라우트
4-3. 웹훅 동기화 (`lib/polar-subscription-sync.ts`)
4-4. 결제 UI
4-5. Polar 설정 순서 (운영 체크리스트)
---
## Phase 5. 대시보드 · UI 구축
**기간**: 2026-04-07 ~ 2026-04-08
**목표**: 로그인 후 사용자가 구독·사용량·워크스페이스를 한 눈에 보는 허브
### 5-1. 대시보드 (`app/dashboard/page.tsx`)
| 섹션 | 내용 |
| 환영 카드 | 구독 플랜·상태 요약 (`GET /api/subscription`) |
| 사용량 바 | 일일 AI 채팅 사용량 진행 바 (`GET /api/usage`) |
| 워크스페이스 타임라인 | 프로젝트 목록·진행 단계 |
| 구독 상세 | Polar 고객 포털 링크, 기간 만료일 |
| 계정 정보 | 이메일, 로그아웃 |
5-2. 헬스 체크 API (`GET /api/health`)
5-3. 요금제 페이지 (`/pricing-meta`)
5-4. 허브 페이지 구조 (`docs/hub-template-standard.md`)
- 모든 서브프로젝트 소개 페이지는 동일 Bento 허브 컴포넌트 패턴 적용
---
### 코드 리뷰 (`/bkit:code-review`)
**목표**: 전체 코드 품질·보안 점검, 문제 발생 시 대응
- Critical: 인증 흐름 재검토
- High: 환경 변수 체계, 타입 안전성
- Medium: API 보일러플레이트 반복, 빈 스캐폴드 파일
### Vercel 배포
- https://saas-engine-xi.vercel.app/ 배포 완료
- .env.example 기반 환경 변수 정리 커밋
---
## Phase 7. E2E QA — Playwright 자동화
**목표**: 실제 사용자 관점 3개 플로우 테스트, 보안 취약점 자동 검증
### 테스트 설계
| 파일 | 시나리오 | 테스트 수 |
|------|---------|---------|
| 01-new-user.spec.ts | 신규 유저 (랜딩→로그인→보호 라우트) | 22개 |
| 04-security.spec.ts | 보안 (비인증 API, 오픈 리다이렉트, 웹훅, 소유권) | 13개 |
**`playwright.config.ts`** — 4개 프로젝트 구성: new-user, payment-user, returning-user, security
## Phase 8. Top 5 보안 패치
**목표**: 발견된 Critical 취약점 즉시 수정, 35/35 테스트 통과
**결과: 35/35 전부 통과 ✅**
## 📊 전체 진도 현황 (2026-04-11 기준)
| 모듈 | 상태 | 비고 |
|------|------|------|
| **인증 엔진** | ✅ 완료 | Google + Kakao OAuth, SSR 보호, 오픈 리다이렉트 방어 |
| **Gemini 채팅** | ✅ 완료 | 스트리밍, 대화 저장, 소유권 검증, 사용량 연동 |
| **Polar 결제** | ✅ 완료 | Checkout, 웹훅 동기화, 구독 상태 UI |
| **사용량 엔진** | ✅ 완료 | 플랜별 한도, RPC 원자적 증가, 이중 조회 제거 |
| **대시보드** | ✅ 완료 | 구독·사용량·워크스페이스·포털 |
| **E2E 테스트** | ✅ 완료 | Playwright 35개 (신규 유저 + 보안) |
| **Vercel 배포** | ✅ 완료 | saas-engine-xi.vercel.app |
| **rate-limit** | ⬜ 예정 | /api/chat 엔드포인트 요청 제한 |
| **Analytics** | ⬜ 예정 | Vercel Analytics 또는 PostHog |
| **image-saas** | ⬜ 예정 | 이미지 생성 기능 모듈 |




비개발자로서 여기까지 구현한 게 정말 대단하고 동감되네요. 로그인, AI, 결제까지 SaaS 핵심을 한 번에 정리한 구조가 인상적이예요. 기대됩니다!!
와 현지와님 감사합니다 😀 뒤늦게 확인했네요 ㅎ
격려해주셔서 감사하고, 열심히 실행가능한 사이트로 발전시켜보겠습니다.^^