견적함 - 프리랜서 견적서/청구서

프리랜서를 위한 간편한 견적서 및 청구서 관리 도구입니다.

🎉 30일 무료 체험

회원가입 시 30일간 프리미엄 기능을 무료로 체험할 수 있습니다.

체험 혜택

• ✅ 무제한 문서 생성
• ✅ 워터마크 제거
• ✅ 모든 프리미엄 기능 이용

체험 종료 후

• 월 3건 무료 생성 가능
• 무료 플랜 PDF에는 워터마크 포함
• 프리미엄 플랜: 월 4,900원 (스텝페이 결제)

⚠️ 중요: 30일 체험 종료만으로 자동 결제되지 않습니다. 프리미엄을 직접 구독한 경우에만 매월 자동 결제되며, 스텝페이 구독 관리에서 해지할 수 있습니다.

주요 기능

• ✅ 견적서 및 청구서 생성
• ✅ 한글 폰트 지원 (NanumGothic)
• ✅ PDF 다운로드 및 공유
• ✅ 회원가입 및 30일 무료 체험
• ✅ 무료 플랜: 월 3건 (견적서+청구서 = 1건)
• ✅ 프리미엄 플랜: 무제한 + 워터마크 제거

시작하기

환경 변수 설정

프로젝트 루트에 .env.local 파일을 생성하고 다음 내용을 추가하세요:

# JWT 세션 암호화 키 (필수)
# 아래 명령어로 생성할 수 있습니다:
# node -e "console.log(require('crypto').randomBytes(32).toString('base64'))"
AUTH_SECRET=your-generated-secret-here

AUTH_SECRET 생성 방법:

# Node.js를 이용한 랜덤 시크릿 생성
node -e "console.log(require('crypto').randomBytes(32).toString('base64'))"

# 또는 OpenSSL 사용
openssl rand -base64 32

설치 및 실행

# 의존성 설치
npm install

# 개발 서버 실행
npm run dev

# 프로덕션 빌드
npm run build

# 프로덕션 실행
npm start

회원가입 및 로그인

회원가입

1. 우측 상단 "회원가입" 버튼 클릭
2. 이메일과 비밀번호(6자 이상) 입력
3. 개인정보 수집 및 이용 안내 확인
4. 이용약관 및 개인정보처리방침 동의
5. 회원가입 완료 시 자동으로 30일 무료 체험 시작

로그인

1. 우측 상단 "로그인" 버튼 클릭
2. 가입한 이메일과 비밀번호 입력
3. 로그인 성공

기능

무료 체험 중 (30일)

• ✅ 무제한 견적서/청구서 생성
• ✅ 워터마크 없는 깔끔한 PDF
• ✅ 고객 관리
• ✅ 거래 내역 관리
• ✅ 입금 상태 추적

무료 플랜 (체험 종료 후)

• ✅ 월 3건 문서 생성
• ⚠️ PDF에 워터마크 포함
• ✅ 기본 고객 관리
• ✅ 기본 거래 관리

프리미엄 플랜 (월 4,900원)

• ✅ 무제한 문서 생성
• ✅ 워터마크 제거
• ✅ 로고 및 브랜드 색상 (예정)
• ✅ 문서번호 자동 생성 (예정)
• ✅ 고급 검색 및 필터 (예정)

데이터 저장

중요 - 데이터 보관 방식

• 로컬 개발: ./data/gyunjukham-db.json에 저장
• Vercel 프로덕션: /tmp/gyunjukham-db.json에 저장

⚠️ Vercel 배포 시 주의사항:

• /tmp는 임시 디렉토리로, 서버리스 인스턴스가 재시작되면 데이터가 초기화됩니다
• 콜드 스타트 또는 새로운 배포 시 데이터가 손실될 수 있습니다
• 프로덕션 환경에서는 데이터가 영구적으로 유지되지 않습니다
• 향후 업데이트에서 영구 스토리지(Vercel Postgres, KV 등)로 전환 예정입니다

현재 저장되는 정보:

• 사용자 계정 정보 (이메일, 암호화된 비밀번호, 체험 종료일)
• 고객 정보
• 견적서/청구서 데이터
• 판매자 정보
• 월간 사용량

개인정보 보호

수집하는 정보

• 회원가입 시: 이메일, 비밀번호(bcrypt 암호화 저장)
• 서비스 이용 시: 판매자 정보, 고객 정보, 거래 내역

수집 목적

• 회원 가입 및 로그인
• 30일 무료 체험 기간 관리
• 서비스 제공 및 고객 지원

보관 기간

• 회원 탈퇴 시까지 (현재 탈퇴 기능 없음)

자세한 내용은 개인정보처리방침을 참고하세요.

기술 스택

• 프레임워크: Next.js 15
• 언어: TypeScript
• 스타일링: Tailwind CSS
• PDF 생성: jsPDF
• 인증: JWT (jose) + bcryptjs
• 데이터 저장: 로컬 파일 시스템 (JSON)

프로덕션 배포

Vercel 배포

# Vercel CLI 설치
npm i -g vercel

# 배포
vercel

# 환경 변수 설정
vercel env add AUTH_SECRET

환경 변수 설정 필수:

• AUTH_SECRET: JWT 세션 암호화 키
• ADMIN_EMAILS: 관리자 접수함(/admin/feedback) 접근을 허용할 이메일, 콤마로 여러 개 구분 (예: [email protected],[email protected])
• STEPPAY_WEBHOOK_SECRET: 스텝페이 결제 웹훅 검증 키

라이선스

이 프로젝트는 개인/상업적 용도로 자유롭게 사용 가능합니다.

문의

문의사항이 있으시면 이메일로 연락주세요.