24 KiB
24 KiB
InvoiceLink MVP PRD
버전: 0.1.0 | 작성일: 2026-03-14 | 작성자: 1인 개발
1. 배경 및 문제 정의
Pain Point
| # | 현재 방식 | 문제 |
|---|---|---|
| 1 | 이메일 첨부 (Word/HWP) | 파일 버전 불일치, 수정 후 재발송 필요, 모바일에서 열기 어려움 |
| 2 | 엑셀 공유 (Google Sheets 링크) | 브랜딩 부재, 인쇄 레이아웃 깨짐, 실수로 수정 가능 |
| 3 | 구두/카카오톡 문자 전달 | 공식 증빙 불가, 분쟁 발생 시 근거 없음, PDF 재요청 빈번 |
타겟 페르소나
- 노션을 이미 사용하는 프리랜서 / 소규모 에이전시 (1~5인)
- 월 10~50건 견적서 발행
- 별도 ERP 도입 비용을 감당하기 어렵고, 노션 DB를 이미 운영 중
핵심 문제 정의
노션에 입력한 견적 데이터를 클라이언트에게 전문적인 웹 뷰어로 즉시 공유하고, 단일 PDF로 제공하는 통합 수단이 없다.
구현 시 주의사항: 문제 범위를 "노션 사용자"로 명시적으로 한정함으로써 범용 견적 SaaS와의 차별점을 유지한다.
2. 목표 (Goals & Non-Goals)
MVP Goals
| # | 목표 | 측정 기준 |
|---|---|---|
| G1 | 견적서 발행에서 클라이언트 PDF 수령까지 5분 이내 | 사용자 테스트 3명 중 3명 달성 |
| G2 | 노션 DB 속성 매핑 오류율 0% (필수 속성 10개 기준) | QA 체크리스트 통과 |
| G3 | PDF 생성 응답 시간 10초 이내 (A4 1페이지 기준) | Vercel 함수 p95 지표 |
Non-Goals (MVP 제외)
- 클라이언트 전자 서명 / 결재 기능
- 다국어 지원 (한국어 단일)
- Notion OAuth 앱 등록 (Public Integration)
- 반복 견적 템플릿 / 자동 발송 스케줄러
- 결제 연동 (세금계산서 발행, PG 연동)
- 멀티 워크스페이스 지원
구현 시 주의사항: Non-Goal은 스코프 크리프 방어선이다. 기능 요청이 들어오면 이 목록을 먼저 확인한다.
3. 사용자 스토리
공급자 (Supplier)
S1. 노션 연동
나는 공급자로서, 기존 노션 DB를 그대로 사용하기 위해 Integration Token을 InvoiceLink에 등록할 수 있다.
- AC1: Token 저장 후 "연결 테스트" 버튼 클릭 시 DB 접근 가능 여부를 3초 이내에 표시한다.
- AC2: 토큰이 유효하지 않으면 구체적인 오류 메시지(인증 실패 / 권한 없음)를 표시한다.
- AC3: Token은 암호화되어 Supabase에 저장되며 UI에서 마스킹(
ntn_****)으로 표시된다.
S2. 견적서 발행
나는 공급자로서, 노션 DB 항목을 선택하여 고유 링크를 즉시 생성할 수 있다.
- AC1: 필수 속성 10개가 모두 있을 때만 "발행" 버튼이 활성화된다.
- AC2: 발행 클릭 시
/q/[uuid-v4]형식의 URL이 클립보드에 복사되고 토스트 알림이 표시된다. - AC3: 발행된 견적서는 대시보드 목록에
sent상태로 즉시 반영된다.
S3. 링크 관리
나는 공급자로서, 발행한 링크를 비활성화하여 클라이언트가 더 이상 열람하지 못하게 할 수 있다.
- AC1: 대시보드에서 토글 클릭 → 1초 이내 상태가
expired로 변경된다. - AC2: 비활성화된 링크 접근 시 클라이언트에게 "만료된 견적서" 안내 페이지를 표시한다.
- AC3: 비활성화는 토글로 재활성화할 수 있다.
S4. 열람/다운로드 추적
나는 공급자로서, 클라이언트가 견적서를 열람했는지 PDF를 다운로드했는지 확인할 수 있다.
- AC1: 클라이언트가 견적서 링크를 열면 대시보드의 상태가
viewed로 변경된다. - AC2: PDF 다운로드 시 대시보드에 "다운로드 완료" 배지가 표시된다.
- AC3: 최초 열람 일시가 KST 기준으로 표시된다.
클라이언트 (Client)
C1. 견적서 열람
나는 클라이언트로서, 링크 하나만으로 로그인 없이 견적서를 확인할 수 있다.
- AC1: 링크 접근 시 로그인 요구 없이 견적서 페이지가 로드된다.
- AC2: 모바일(375px)에서 품목 테이블이 가로 스크롤로 열람 가능하다.
- AC3: 유효기간이 지난 견적서는 만료 안내만 표시하고 내용은 노출하지 않는다.
C2. PDF 다운로드
나는 클라이언트로서, 견적서를 PDF로 저장하여 내부 결재에 사용할 수 있다.
- AC1: "PDF 다운로드" 버튼 클릭 시 10초 이내에 파일이 저장된다.
- AC2: 파일명은
견적서_{견적번호}_{YYYYMMDD}.pdf규칙을 따른다. - AC3: A4 1페이지에 모든 내용이 인쇄 최적화된 레이아웃으로 출력된다.
C3. 견적서 진위 확인
나는 클라이언트로서, 견적서가 공식적으로 발행된 것임을 신뢰할 수 있다.
- AC1: 견적서 페이지에 발행 일시와 견적번호가 명시된다.
- AC2: 링크가 만료되었거나 비활성화된 경우 변조 가능성 없이 안내 메시지만 표시한다.
구현 시 주의사항: 클라이언트는 계정이 없으므로 모든 클라이언트 기능은 Public 라우트로 설계하되, uuid-v4로 추측 공격을 방어한다.
4. 기능 명세
F1. 노션 연동
연동 방식
- Notion Internal Integration Token 사용 (OAuth Public App은 Non-Goal)
- 설정 위치: 대시보드 → 설정 → 노션 연동
- Token 저장: Supabase
suppliers.notion_token컬럼 (AES-256 암호화, 서버 사이드 복호화)
환경변수 (서버 전용)
NOTION_TOKEN=ntn_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
// nuxt.config.ts
runtimeConfig: {
notionToken: process.env.NOTION_TOKEN, // 서버 전용, public 미노출
}
SDK 초기화
// server/utils/notion.ts
import { Client } from '@notionhq/client'
export function createNotionClient(token: string) {
return new Client({ auth: token, timeoutMs: 30_000 })
}
필수 데이터베이스 속성 매핑
| 노션 속성명 | 노션 타입 | InvoiceLink 필드 | 추출 방법 | 필수 여부 |
|---|---|---|---|---|
| 견적번호 | title |
quote_number |
prop.title.map(t => t.plain_text).join('') |
필수 |
| 발행일 | date |
issued_at |
prop.date.start |
필수 |
| 유효기간 | date |
expires_at |
prop.date.start |
필수 |
| 수신자명 | rich_text |
client_name |
prop.rich_text.map(t => t.plain_text).join('') |
필수 |
| 수신자 이메일 | email |
client_email |
prop.email || '' |
선택 |
| 항목명 | rich_text |
item_name |
prop.rich_text.map(t => t.plain_text).join('') |
필수 |
| 수량 | number |
quantity |
prop.number |
필수 |
| 단가 (원) | number |
unit_price |
prop.number |
필수 |
| 세율 (%) | number |
tax_rate |
prop.number |
필수 |
| 비고 | rich_text |
notes |
prop.rich_text.map(t => t.plain_text).join('') |
선택 |
속성 추출 헬퍼 (TypeScript)
// server/utils/notion-extract.ts
import type { PageObjectResponse } from '@notionhq/client/build/src/api-endpoints'
type Prop = PageObjectResponse['properties'][string]
export const extract = {
title: (p: Prop): string =>
p.type === 'title' ? p.title.map(t => t.plain_text).join('') : '',
text: (p: Prop): string =>
p.type === 'rich_text' ? p.rich_text.map(t => t.plain_text).join('') : '',
number: (p: Prop): number | null =>
p.type === 'number' ? p.number : null,
date: (p: Prop): string | null =>
p.type === 'date' && p.date ? p.date.start : null,
email: (p: Prop): string =>
p.type === 'email' ? (p.email ?? '') : '',
}
동기화 트리거: 수동 버튼
- 선택: 수동 버튼 (대시보드 "동기화" 클릭)
- 근거: Notion Webhook은 Public Integration만 지원하여 Internal Token 방식으로는 불가. 자동 폴링은 rate limit(3 req/s) 소진 위험. 1인 MVP에서 수동 동기화가 구현 복잡도 대비 충분한 UX를 제공함.
Rate Limit 대응
- Notion API: 평균 3 req/s per integration
- 서버 라우트에서 Nitro
defineCachedFunction적용 (TTL: 60초) - 429 응답 시 지수 백오프(1s → 2s → 4s, 최대 3회 재시도)
// server/utils/notion-retry.ts
import { APIResponseError } from '@notionhq/client'
export async function withRetry<T>(fn: () => Promise<T>, max = 3): Promise<T> {
for (let i = 0; i <= max; i++) {
try { return await fn() }
catch (e) {
if (e instanceof APIResponseError && e.status === 429 && i < max) {
const wait = Math.pow(2, i) * 1000
await new Promise(r => setTimeout(r, wait))
continue
}
throw e
}
}
throw new Error('unreachable')
}
에러 처리
| HTTP 상태 | 원인 | 사용자 메시지 |
|---|---|---|
| 400 | 잘못된 속성명/필터 | "DB 속성명을 확인하세요. 대소문자와 공백이 정확해야 합니다." |
| 401 | 토큰 만료/무효 | "Notion Integration Token이 유효하지 않습니다." |
| 404 | DB ID 오류 또는 권한 미부여 | "데이터베이스를 찾을 수 없습니다. DB에 Integration을 연결했는지 확인하세요." |
| 429 | Rate limit 초과 | "잠시 후 다시 시도하세요. (요청 제한)" |
구현 시 주의사항: 노션 속성명은 한국어 포함 대소문자·공백이 완전히 일치해야 하므로, 설정 화면에서 속성명 매핑을 사용자가 직접 입력하는 방식을 고려한다.
F2. 고유 링크 생성
- URL 구조:
/q/[uuid-v4]— 128비트 랜덤, 추측 불가 - 유효기간: 기본값 30일. 발행 시 커스터마이징 가능 (7일 / 14일 / 30일 / 무제한)
- 접근 제어: 링크 소유 공급자만 비활성화 가능. 비활성화 즉시 클라이언트 접근 차단.
- 클립보드 복사 UX:
navigator.clipboard.writeText()+@nuxt/uiToast 알림
// server/api/quotes/index.post.ts
import { v4 as uuidv4 } from 'uuid'
const slug = uuidv4() // e.g. "550e8400-e29b-41d4-a716-446655440000"
// quote 레코드 생성 후 /q/${slug} 반환
구현 시 주의사항: crypto.randomUUID()를 Node.js 환경에서 직접 사용할 수 있으나, 브라우저 호환성을 위해 uuid 패키지를 명시적으로 사용한다.
F3. 견적서 웹 뷰어
레이아웃 구성
┌─────────────────────────────────────────┐
│ [로고] 상호명 / 연락처 / 이메일 │ ← 헤더
├─────────────────────────────────────────┤
│ 견적번호: Q-2026-001 발행일: 2026-03-14 │
│ 유효기간: 2026-04-14 수신자: 홍길동 님 │ ← 견적 메타
├─────────────────────────────────────────┤
│ 항목명 수량 단가 세액 소계 │
│ ────────────────────────────────────── │
│ 웹 개발 1 3,000,000 300,000 3.3M │ ← 품목 테이블
│ 디자인 1 1,000,000 100,000 1.1M │
├─────────────────────────────────────────┤
│ 공급가액 4,000,000 │
│ 세액 400,000 │ ← 합계 영역
│ 총액 4,400,000 │
├─────────────────────────────────────────┤
│ 비고: 계약금 50% 선입금 후 착수 │
│ 사업자번호: 000-00-00000 │ ← 푸터
└─────────────────────────────────────────┘
반응형 요구사항
- 모바일(375px): 품목 테이블
overflow-x: auto, 헤더는 세로 스택 - PDF 출력:
@media printCSS로 A4(210×297mm) 최적화, 푸터 고정
브랜딩 커스터마이징 (MVP)
- 로고 이미지 업로드 → Supabase Storage 저장
- Primary 컬러 6가지 프리셋:
#2563EB#16A34A#DC2626#D97706#7C3AED#0891B2
구현 시 주의사항: @nuxt/ui 컴포넌트의 color prop과 CSS 변수(--color-primary)를 연동하여 동적 테마 전환을 구현한다.
F4. PDF 다운로드
- 생성 방식: 서버사이드 헤드리스 렌더링
- 라우트:
server/api/quote/[id]/pdf.get.ts - 라이브러리:
@sparticuz/chromium+puppeteer-core - 근거: 클라이언트
window.print()는 브라우저별 출력 차이 발생. 서버사이드가 레이아웃 일관성 보장.
// server/api/quote/[id]/pdf.get.ts
import chromium from '@sparticuz/chromium'
import puppeteer from 'puppeteer-core'
export default defineEventHandler(async (event) => {
const id = getRouterParam(event, 'id')
// 1. DB에서 quote 조회
// 2. HTML 템플릿 렌더링
// 3. Puppeteer로 PDF 생성
const browser = await puppeteer.launch({
args: chromium.args,
executablePath: await chromium.executablePath(),
headless: chromium.headless,
})
const page = await browser.newPage()
await page.setContent(htmlContent, { waitUntil: 'networkidle0' })
const pdf = await page.pdf({ format: 'A4', printBackground: true })
await browser.close()
setResponseHeaders(event, {
'Content-Type': 'application/pdf',
'Content-Disposition': `attachment; filename*=UTF-8''${encodeURIComponent(filename)}`,
})
return pdf
})
- 파일명 규칙:
견적서_{quote_number}_{YYYYMMDD}.pdf - 이벤트 로깅: 다운로드 완료 시
quote_events테이블에{ type: 'pdf_downloaded', quote_id, created_at }삽입 - Vercel 제약: 서버리스 함수 메모리 1GB, 실행 시간 최대 60초(Pro 플랜).
@sparticuz/chromium은 50MB 이하로 제한 내 처리 가능.
구현 시 주의사항: Vercel Edge Runtime은 Node.js API 미지원. PDF 라우트는 반드시 export const runtime = 'nodejs'를 명시한다.
F5. 공급자 대시보드
- 견적서 목록: 발행일 내림차순, 20개씩 페이지네이션
- 상태 뱃지:
| 상태 | 조건 | 색상 |
|---|---|---|
draft |
발행 전 | 회색 |
sent |
링크 생성 완료 | 파란색 |
viewed |
클라이언트 최초 열람 | 초록색 |
expired |
유효기간 경과 또는 수동 만료 | 빨간색 |
- 이벤트 표시: "열람 ✓" / "PDF 다운로드 ✓" 아이콘 배지
- 링크 만료 토글:
UToggle컴포넌트, PATCH/api/quotes/[id]호출
구현 시 주의사항: 상태 전환 로직은 서버에서만 처리하며 클라이언트에서 직접 status 필드를 조작하지 않는다.
5. 데이터 모델
-- suppliers: 공급자 (Supabase Auth users와 1:1)
CREATE TABLE suppliers (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
user_id UUID NOT NULL REFERENCES auth.users(id) ON DELETE CASCADE,
company_name TEXT NOT NULL,
contact TEXT,
logo_url TEXT,
primary_color CHAR(7) DEFAULT '#2563EB',
notion_token TEXT, -- AES-256 암호화 저장
notion_db_id TEXT,
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
UNIQUE(user_id)
);
-- RLS: 본인 레코드만 읽기/쓰기
ALTER TABLE suppliers ENABLE ROW LEVEL SECURITY;
CREATE POLICY "suppliers_self" ON suppliers
USING (auth.uid() = user_id);
-- quotes: 견적서 헤더
CREATE TABLE quotes (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
supplier_id UUID NOT NULL REFERENCES suppliers(id) ON DELETE CASCADE,
slug UUID NOT NULL UNIQUE DEFAULT gen_random_uuid(), -- /q/[slug]
notion_page_id TEXT,
quote_number TEXT NOT NULL,
client_name TEXT NOT NULL,
client_email TEXT,
issued_at DATE NOT NULL,
expires_at DATE,
notes TEXT,
status TEXT NOT NULL DEFAULT 'sent'
CHECK (status IN ('draft','sent','viewed','expired')),
is_active BOOLEAN NOT NULL DEFAULT TRUE,
total_amount NUMERIC(12,2),
tax_amount NUMERIC(12,2),
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
);
-- RLS: 공급자는 본인 견적만, 공개 slug 읽기는 허용
ALTER TABLE quotes ENABLE ROW LEVEL SECURITY;
CREATE POLICY "quotes_supplier" ON quotes
USING (supplier_id IN (SELECT id FROM suppliers WHERE user_id = auth.uid()));
CREATE POLICY "quotes_public_read" ON quotes
FOR SELECT USING (is_active = TRUE);
-- quote_items: 견적 항목
CREATE TABLE quote_items (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
quote_id UUID NOT NULL REFERENCES quotes(id) ON DELETE CASCADE,
item_name TEXT NOT NULL,
quantity NUMERIC(10,2) NOT NULL DEFAULT 1,
unit_price NUMERIC(12,2) NOT NULL,
tax_rate NUMERIC(5,2) NOT NULL DEFAULT 10,
sort_order SMALLINT NOT NULL DEFAULT 0
);
-- RLS: quotes와 동일 공급자 정책 상속
ALTER TABLE quote_items ENABLE ROW LEVEL SECURITY;
CREATE POLICY "quote_items_via_quotes" ON quote_items
USING (quote_id IN (SELECT id FROM quotes
WHERE supplier_id IN (SELECT id FROM suppliers WHERE user_id = auth.uid())));
CREATE POLICY "quote_items_public_read" ON quote_items
FOR SELECT USING (quote_id IN (SELECT id FROM quotes WHERE is_active = TRUE));
-- quote_events: 열람/다운로드 이벤트 로그
CREATE TABLE quote_events (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
quote_id UUID NOT NULL REFERENCES quotes(id) ON DELETE CASCADE,
event_type TEXT NOT NULL CHECK (event_type IN ('viewed','pdf_downloaded')),
ip_hash TEXT, -- 개인정보 최소화: IP를 SHA-256 해시로 저장
user_agent TEXT,
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
);
-- RLS: 공급자만 이벤트 읽기, 삽입은 서버(service_role)만
ALTER TABLE quote_events ENABLE ROW LEVEL SECURITY;
CREATE POLICY "events_supplier_read" ON quote_events
FOR SELECT USING (quote_id IN (
SELECT id FROM quotes
WHERE supplier_id IN (SELECT id FROM suppliers WHERE user_id = auth.uid())
));
구현 시 주의사항: quote_events 삽입은 서버 라우트에서 service_role 키로 처리하고 클라이언트에 해당 키를 노출하지 않는다.
6. API 설계 (Nuxt Server Routes)
| Method | Route | 설명 | Auth |
|---|---|---|---|
GET |
/api/quote/[slug] |
슬러그로 견적서 + 항목 조회 | Public (slug 보유자) |
GET |
/api/quote/[slug]/pdf |
PDF 생성 및 스트림 응답 | Public |
POST |
/api/quotes |
견적서 생성 (노션 데이터 포함) | Supplier (세션 필요) |
PATCH |
/api/quotes/[id] |
상태/활성화 변경 | Supplier |
DELETE |
/api/quotes/[id] |
견적서 삭제 | Supplier |
GET |
/api/notion/sync |
노션 DB 페이지 목록 조회 | Supplier |
POST |
/api/notion/validate |
Token + DB ID 유효성 검사 | Supplier |
요청/응답 예시
// POST /api/quotes
// Request body (Zod 검증)
const createQuoteSchema = z.object({
notionPageId: z.string(),
expiresAt: z.string().date().optional(),
primaryColor: z.string().regex(/^#[0-9A-F]{6}$/i).optional(),
})
// GET /api/quote/[slug] Response
interface QuoteResponse {
quote: { quoteNumber: string; clientName: string; issuedAt: string; expiresAt: string | null }
items: Array<{ itemName: string; quantity: number; unitPrice: number; taxRate: number }>
supplier: { companyName: string; contact: string; logoUrl: string | null; primaryColor: string }
}
구현 시 주의사항: 모든 입력값은 Zod로 서버에서 재검증. 클라이언트 검증만으로는 부족하다.
7. 기술 스택 최종 제안
| 용도 | 라이브러리 | 선택 이유 |
|---|---|---|
| PDF 생성 | @sparticuz/chromium + puppeteer-core |
Vercel 서버리스 환경에서 Chromium 번들링 가능한 유일한 실용적 옵션 |
| 노션 API 클라이언트 | @notionhq/client |
Notion 공식 TypeScript SDK, 타입 완전 지원 |
| 날짜 처리 | date-fns |
경량(tree-shaking), 순수 함수형, format(date, 'yyyyMMdd') 직관적 API |
| 숫자/통화 포맷 | Intl.NumberFormat (내장) |
외부 의존성 없이 new Intl.NumberFormat('ko-KR').format(n) 으로 천 단위 콤마 처리 |
| 이메일 발송 (선택) | Resend + react-email |
Vercel 환경 최적화, 무료 플랜 월 3,000건 충분, SDK 단순함 |
| 입력 검증 | zod |
기존 스택 일관성, Nuxt server route와 네이티브 통합 |
| UUID 생성 | crypto.randomUUID() (Node 내장) |
외부 의존성 불필요, RFC 4122 v4 준수 |
구현 시 주의사항: puppeteer-core 버전은 @sparticuz/chromium과 호환 버전을 반드시 맞춘다. (패키지 README에서 버전 매트릭스 확인)
8. MVP 마일스톤
| Phase | 기간 | 완성 기준 |
|---|---|---|
| Phase 1 인프라 + 노션 연동 | Week 1~2 | Supabase 스키마 적용, 노션 토큰 등록·검증, DB 항목 목록 조회 API 동작 |
| Phase 2 핵심 기능 | Week 3~4 | 견적서 발행(링크 생성), 웹 뷰어 렌더링, PDF 다운로드 (A4 출력 확인) |
| Launch 대시보드 + 안정화 | Week 5 | 공급자 대시보드(상태·이벤트 추적), 에러 처리 완비, Vercel 배포 |
런치 기준 (Launch Criteria)
- 노션 연동 → 견적서 발행 → PDF 수령 E2E 시나리오 3회 반복 성공
- PDF 생성 p95 응답 시간 10초 이내 (Vercel 로그 확인)
- 만료된 링크 접근 시 클라이언트에게 적절한 안내 페이지 표시
- Supabase RLS 정책 검증: 타 공급자 데이터 접근 불가 확인
- 모바일(375px) Chrome에서 웹 뷰어 및 PDF 다운로드 정상 동작
구현 시 주의사항: 런치 기준은 QA 체크리스트로 관리하며, 모든 항목 체크 완료 전까지 프로덕션 도메인 공유를 금한다.
9. 성공 지표 (Metrics)
Primary Metric (북극성)
- 주간 활성 견적서 발행 수 (WAQ: Weekly Active Quotes)
- 측정: Supabase
quotes테이블created_at집계 - 목표: 런치 4주 후 WAQ ≥ 10
- 측정: Supabase
Supporting Metrics
| 지표 | 설명 | 측정 도구 |
|---|---|---|
| PDF 변환 성공률 | 전체 다운로드 시도 중 성공 비율 ≥ 95% | Supabase quote_events + Vercel 함수 에러 로그 |
| 견적서 열람률 | 발행된 링크 중 클라이언트가 실제 열람한 비율 | quote_events viewed / quotes sent |
| 평균 발행 소요 시간 | 노션 동기화 클릭 → 링크 복사 완료까지 | 브라우저 Performance API (PostHog 커스텀 이벤트) |
구현 시 주의사항: PostHog는 무료 플랜(월 100만 이벤트)으로 충분. Nuxt 플러그인으로 초기화하고 usePostHog()로 이벤트 전송.
10. 리스크 & Open Questions
리스크
| 리스크 | 발생 확률 | 영향도 | 대응 전략 |
|---|---|---|---|
| Vercel 서버리스 Cold Start (Chromium) | 높음 | 중간 | Vercel Pro Fluid Compute 또는 최소 warm-up 요청 설정. 대안: html-pdf-node 검토 |
| Notion API Rate Limit (3 req/s) | 중간 | 중간 | Nitro 60초 캐시 + 지수 백오프. 동기화는 수동 트리거로 제한 |
| Notion API 속성명 변경 | 낮음 | 높음 | 속성명 매핑을 대시보드에서 사용자가 설정 가능하게 구현 |
| Supabase Free Tier 제한 (500MB DB) | 낮음 | 낮음 | quote_events 90일 이상 데이터 주기적 아카이브 또는 자동 삭제 정책 |
Open Questions
| # | 질문 | 현재 유력 가설 |
|---|---|---|
| OQ1 | 노션 속성명 매핑을 코드에 하드코딩할 것인가, 대시보드에서 설정 가능하게 할 것인가? | 설정 가능하게 구현. 초기 기본값 제공, 변경 허용. |
| OQ2 | PDF 생성을 Vercel 서버리스로 할 것인가, 별도 마이크로서비스(Render)로 분리할 것인가? | MVP는 Vercel 단일 배포. 10초 초과 시 Render 분리 검토. |
| OQ3 | 클라이언트 열람 이벤트를 IP 기반으로 중복 제거할 것인가? | SHA-256 해시로 저장, 24시간 내 동일 IP 재열람은 이벤트 미중복 기록. |
| OQ4 | 견적서 항목이 여러 노션 페이지(하위 DB)에 분산된 경우를 지원할 것인가? | MVP는 단일 DB, 단일 페이지 = 단일 견적서 구조만 지원. |
| OQ5 | 무료 플랜과 유료 플랜을 MVP에서 구분할 것인가? | MVP는 전체 무료. 100건 발행 초과 시 유료 전환 검토. |
구현 시 주의사항: OQ1~OQ5는 Phase 1 시작 전에 의사결정을 완료하고 CLAUDE.md 또는 별도 ADR 문서에 기록한다.