Craftplan: 소규모 장인 제조업체 및 공예 사업자를 위한 오픈소스 ERP

Craftplan은 카탈로그 관리, 재고 제어, 주문 처리, 생산 계획, 구매, CRM 등 필수 비즈니스 도구를 하나의 플랫폼에 통합하여 여러 개의 별도 플랫폼 비용을 지불하지 않고 빠르게 사업을 시작할 수 있도록 합니다.

기능 (Features)

카탈로그 및 BOM (Catalog & BOM)

• 사진과 라벨이 포함된 제품 카탈로그
• 버전 관리되는 자재 명세서(Bills of Materials) — 최신 버전 편집 가능, 이전 버전은 읽기 전용
• 중첩된 BOM 전체에 걸친 자동 비용 집계
• 시간 및 비용 추적이 가능한 노동 단계 (Labor steps)

주문 및 송장 (Orders & Invoices)

• 캘린더 기반 스케줄링을 통한 고객 주문 처리
• 송장 생성
• 생산 배치(production batches)에 대한 주문 품목 할당

생산 (Production)

• 자동 자재 소모가 이루어지는 생산 배치화
• 배치별 비용 스냅샷
• 생산 수량 추적이 가능한 완료 워크플로우

재고 (Inventory)

• 로트 추적성(lot traceability)을 갖춘 원자재 관리
• 재고 이동 (소모, 입고, 조정)
• 알레르겐 및 영양 성분 추적
• 수요 예측 및 재주문 계획

구매 (Purchasing)

• 구매 주문서 및 공급업체 관리
• 로트 생성을 통한 재고 입고

CRM (Customer Relationship Management)

• 고객 및 공급업체 데이터베이스
• 주문 내역 및 통계

가져오기 / 내보내기 (Import / Export)

• 제품, 자재, 고객에 대한 CSV 일괄 가져오기(bulk import)
• CSV 내보내기

이메일(Email)

• UI에서 설정 가능한 거래 이메일 전송 기능
• SMTP, SendGrid, Mailgun, Postmark, Brevo, Amazon SES 지원
• API 키는 저장 시 암호화됨

캘린더 피드(Calendar Feed)

• Google Calendar, Apple Calendar 또는 모든 iCal 호환 앱용 iCal(.ics) 구독 URL 제공
• 주문 배송 및 생산 배치 일정 포함
• 설정에서 피드를 생성하고 취소할 수 있음

API

• 프로그래밍 방식 접근을 위한 JSON:API 및 GraphQL 엔드포인트 지원
• 암호화된 저장소를 사용한 API 키 인증
• CORS 구성 가능

접근 제어(Access Control)

• 관리자(Admin) 및 직원(Staff) 역할 구분
• 모든 리소스에 대한 정책 기반 권한 부여

글로벌 검색(Global Search)

• 명령어 팔레트(Cmd+K / Ctrl+K)를 사용하여 모든 기록에 즉시 접근 가능
• 제품, 자재, 주문, 고객 및 배치 전반에 걸친 퍼지 검색 지원

스크린샷 (Screenshots)

기술 스택 (Tech Stack)

Elixir · Ash Framework · Phoenix LiveView · PostgreSQL · Tailwind CSS

시작하기 (Getting Started)

Craftplan을 자체 서버에 배포하세요. 저장소 클론이 필요 없습니다:

curl -O https://raw.githubusercontent.com/puemos/craftplan/main/docker-compose.yml
curl -O https://raw.githubusercontent.com/puemos/craftplan/main/.env.example
cp .env.example .env   # 필요한 비밀값 채우기 (참고: .env.example)
...

이 명령은 Craftplan, PostgreSQL, 그리고 SeaweedFS를 시작하며 데이터베이스 마이그레이션을 자동으로 실행합니다.

MinIO에서 업그레이드하나요? 업데이트된 Compose 파일은 Craftplan을 시작하기 전에 기존 사진들을 자동으로 마이그레이션하고 검증합니다. 이후 SeaweedFS를 업그레이드할 때는 마이그레이션을 건너뜁니다. .env와 볼륨은 유지하세요. 디스크 공간 요구 사항 및 복구 방법은 업그레이드 가이드를 참조하세요.

단일 컨테이너 모드, Railway 배포, 리버스 프록시 설정 등 더 많은 정보는 셀프 호스팅 가이드에서 확인하세요.

개발 환경 설정 (Development Setup)

코드베이스에 기여하고 싶은 분들을 위한 내용입니다. 사전 요구 사항: Docker 및 mise

mise install            # mise.toml에서 Elixir, Erlang/OTP, Node.js 버전 설치
mise run services:up    # PostgreSQL + SeaweedFS + Mailpit 시작
mise run setup          # 의존성(deps) 설치, 마이그레이션, 에셋 빌드, 시딩
...

자세한 지침은 개발 환경 설정 가이드를 참고하세요.

Craftplan을 사용해야 하는 이유 (Why Craftplan?)

• 장인 제조업체 전용으로 설계됨 — 범용 ERP에 맞추는 것이 아니라, 소규모 배치(small-batch) 및 주문 제작 생산 방식에 맞춰 워크플로우가 설계되었습니다.
• 알레르겐 및 영양 성분 추적 기능 — 성분 추적 및 영양 라벨 생성이 필요한 식품 및 음료 제조업체를 위한 최고 수준의 지원을 제공합니다.
• BOM 버전 관리와 원가 집계 (cost rollups) — 전체 이력을 유지하고 정확한 원가 계산을 하면서 레시피와 포뮬러를 반복 개선할 수 있습니다.
• 셀프 호스팅, 벤더 종속성 없음 — 데이터는 PostgreSQL로 백업되며 사용자의 인프라에 남아있습니다.

문서 (Documentation)

• 전체 문서
• API 참조 (JSON:API & GraphQL)

기여 (Contributing)

기여를 환영합니다. 주요 변경 사항의 경우, 먼저 이슈(issue)를 열어 제안 내용을 논의해 주시기 바랍니다.

mise run test          # 테스트 스위트 실행
mise run format        # 코드 포맷팅 (Styler, Spark, Tailwind, HEEx)
mise run format:check  # 파일 수정 없이 포맷팅 검사
...

커밋은 다음 규칙을 따릅니다: type(scope): description (예: feat(batching):, fix(orders):, ui(production):).

라이선스

이 프로젝트는 AGPLv3 라이선스 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

지원

• 이슈 열기
• 문서 읽기