JOYCEQL/magic-resume

그것이 무엇인가

Magic Resume는 온라인 이력서 편집기입니다. 브라우저에서 전문적인 이력서를 작성, 편집, 스타일링할 수 있는 웹 앱으로, 입력하는 동안 실시간 미리보기를 제공합니다.

핵심 기능(README에서)

실시간 미리보기 — 변경 사항을 즉시 확인
사용자 정의 테마 — 이력서의 모양 변경
다크 모드 — 어두운 색 구성표 옵션
PDF로 내보내기 — 완성된 이력서를 PDF로 다운로드
자동 저장 — 작업이 자동으로 저장됩니다
로컬 저장소 — 데이터는 서버가 아닌 브라우저에 저장됩니다
반응형 디자인 — 다양한 화면 크기에서 작동
부드러운 애니메이션 — Framer Motion 기반
AI 지원 작성 — 완료된 로드맵 항목으로 나열
다국어 지원 — 완료로 나열
PDF, Markdown 등 가져오기 — 완료로 나열
사용자 정의 모델 — 완료로 나열
자동 한 페이지 — 완료로 나열

기술 스택

이 프로젝트는 다음으로 구축되었습니다: TanStack Start(React 프레임워크), TypeScript, Motion(애니메이션 라이브러리), Tiptap(리치 텍스트 편집기), Tailwind CSS(스타일링), Zustand(상태 관리), Shadcn/ui(UI 구성 요소), Lucide Icons.

로컬에서 실행하는 방법

저장소를 클론합니다: git clone git@github.com:JOYCEQL/magic-resume.git
종속성을 설치합니다: pnpm install
개발 서버를 시작합니다: pnpm dev
브라우저에서 http://localhost:3000을 엽니다

배포 옵션

Docker Compose: 프로젝트 루트에서 docker compose up -d를 실행하여 컨테이너에서 앱을 빌드하고 시작합니다.
Cloudflare Workers: 지원됨(네이티브 fetch 사용, 프록시 불필요).
Node.js/Docker: 지역에서 AI 제공업체(OpenAI, Gemini, Anthropic)에 직접 연결할 수 없는 경우 AI_PROXY_URL 또는 HTTPS_PROXY/HTTP_PROXY 환경 변수를 설정할 수 있습니다. DeepSeek, Qwen, Doubao는 항상 직접 연결을 사용합니다.

선택적 AI 제공업체: OrcaRouter

AI 제공업체로 OrcaRouter를 선택할 수 있습니다. 사용하려면 README의 추천 링크를 통해 등록한 다음 OrcaRouter로 로그인하거나 자신의 API 키를 입력합니다. README는 이것이 파트너 추천 링크이며 Magic Resume가 추천 가입의 적격 사용에 대해 커미션을 받을 수 있다고 명시합니다. 다른 AI 제공업체도 계속 사용할 수 있습니다.

앱 사용 귀속을 위한 선택적 VITE_ORCA_APP_ID 빌드 타임 변수도 있습니다. 이는 공개 앱 식별자(비밀 키 아님)이며 빌드 시 설정해야 합니다. 실행 중인 컨테이너에 설정해도 효과가 없습니다.

라이선스 및 사용 제한

소스 코드는 Apache 2.0으로 릴리스되며 추가 비상업적 제한이 있습니다:

개인 사용 무료 — 학습, 자신의 이력서 작성 등.
상업적 사용 금지 — 유료 서비스(SaaS/PaaS), 기업 상업 운영, 재판매 또는 2차 상업 개발은 코드를 수정하더라도 금지됩니다.

로드맵 상태

완료: AI 지원 작성, 다국어 지원, 추가 내보내기 형식, PDF/Markdown 가져오기, 사용자 정의 모델, 자동 한 페이지.

미완료: 추가 이력서 템플릿, 온라인 이력서 호스팅.

프로젝트 세부 정보

저자: Siyue
연락처: X (@GuangzhouY81070), Discord 커뮤니티, 이메일 (18806723365@163.com)
홈페이지: https://github.com/JOYCEQL/magic-resume
스폰서: 2명 나열 — @yj147 및 @someone1128

참고 사항

README에는 스타 기록 차트와 Trendshift 배지가 포함되어 있어 프로젝트가 어느 정도 커뮤니티의 주목을 받고 있음을 나타냅니다.
README에는 이력서 편집기 자체가 어떻게 작동하는지(예: 특정 편집 상호 작용)에 대한 자세한 설명이 없으며, 가격, 호스팅된 데모 URL 또는 자세한 API 문서도 나열되어 있지 않습니다.