프로젝트 소개

Cal.diy는 커뮤니티 주도의 완전 오픈소스 일정 관리 플랫폼으로, Cal.com을 포크하여 모든 기업 및 상업용 코드를 제거한 형태입니다. 전체 코드베이스는 MIT 라이선스이며, proprietary "Enterprise Edition" 기능이 없고 라이선스 키가 필요하지 않습니다. README에 따르면 Cal.com과의 차이점은 Teams, Organizations, Insights, Workflows 및 SSO/SAML과 같은 기업 기능이 제거되었고, "Open Core" 분할이 없다는 점입니다. 프로젝트는 커뮤니티가 유지 관리하며, 호스팅되거나 관리되는 버전이 없어 사용자는自身의 인프라에서 실행해야 합니다. README는 개인용 비프로덕션 용도로만 사용해야 하며, 서버 관리, 데이터베이스 관리 및 민감한 데이터 보안에 대한 고급 지식이 필요하다고 명시적으로 경고합니다. 언급된 기술 스택에는 Next.js, tRPC, React.js, Tailwind CSS, Prisma.io 및 Daily.co가 포함됩니다. 사전 요구 사항은 Node.js >=18.x, PostgreSQL >=13.x 및 Yarn(권장)입니다. 시작 방법은 `yarn dx`를 통한 빠른 시작이 있으며, Docker와 Docker Compose가 필요하고 시드된 테스트 사용자(무료, 프로, 트라이얼, 관리자, 온보딩 계정, 문서화된 자격 증명)와 함께 로컬 Postgres 인스턴스를 시작합니다. 수동 설정 경로는 저장소 클론, 패키지 설치, 생성된 `NEXTAUTH_SECRET` 및 `CALENDSO_ENCRYPTION_KEY` 값으로 `.env` 파일 구성, `DATABASE_URL` 설정, Prisma 마이그레이션 또는 배포 실행, 그리고 `yarn dev`로 앱 시작을 포함합니다. Gitpod 설정도 문서화되어 있습니다. README는 Windows 특정 단계, 예를 들어 Prisma `.env` 심볼릭 링크를 실제 파일로 교체하는 방법을 언급합니다. 배포는 Docker와 Docker Compose를 통해 문서화되며, DockerHub에 이미지가 있고 ARM 변형 접미사가 있습니다. 필수 런타임 시크릿은 `NEXTAUTH_SECRET` 및 `CALENDSO_ENCRYPTION_KEY`이며, 선택적 변수는 웹 앱 URL, 인증 URL, 이용 약관 및 개인정보 처리방침 URL, 텔레메트리 비활성화를 포함합니다. 웹 푸시 알림을 위해 VAPID 키가 필요합니다. README는 또한 스택 업데이트, Docker를 사용한 소스から의 빌드, SSL 엣지 종료, Prisma 사용자 생성 오류 및 `CLIENT_FETCH_ERROR` 같은 문제 해결 주제를 문서화합니다. 테스트는 Playwright 기반 엔드투엔드 테스트(`yarn test-e2e`) 및 개발 이메일 확인을 위한 MailHog을 지원합니다. README는 커뮤니티 참여를 위한 기여 가이드와 이슈 트래커를 가리킵니다.