본문으로 건너뛰기

비개발자의 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** | ⬜ 예정 | 이미지 생성 기능 모듈 |

2

함께 이야기해요 2

로그인하고 댓글을 남겨 주세요

테
테소라2026.04.12

비개발자로서 여기까지 구현한 게 정말 대단하고 동감되네요. 로그인, AI, 결제까지 SaaS 핵심을 한 번에 정리한 구조가 인상적이예요. 기대됩니다!!

스쿨셰프 프로필 이미지
스쿨셰프2026.06.04

와 현지와님 감사합니다 😀 뒤늦게 확인했네요 ㅎ
격려해주셔서 감사하고, 열심히 실행가능한 사이트로 발전시켜보겠습니다.^^

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기