나는 Peppermint-labs의 Peppermint를 포크한 것을 다시 포크했습니다

Source: Dev.to

Pepperminto-Enhanced 🍵의 뒷이야기

배경

React를 공부하던 중 Peppermint.sh라는 탄탄한 오픈‑소스 티켓 관리 시스템을 발견했습니다. 커뮤니티 포크인 Pepperminto가 Knowledge Base (KB)를 추가하기 시작했지만, 사실상 “뼈대”에 불과했으며 버그가 많고 기능이 반쯤 구현됐으며 워크플로우가 깨져 있었습니다. 그래서 직접 뛰어들어 깨진 부분을 고치기로 했습니다.

진행 작업

• KB 복구 – Knowledge Base의 깨진 CRUD 워크플로우를 복구했습니다.
• 아키텍처 정리 – 중복된 애플리케이션(문서와 랜딩‑페이지)을 제거해 모노레포를 더 가볍고 빠르게 만들었습니다.
• 클라이언트 포털 리팩터링 – 새로운 사이드바와 직관적인 설정 페이지로 클라이언트 경험을 재설계했습니다.
• SEO 및 안정성 – KB 기사에 대한 슬러그 마이그레이션을 구현하고 CI/CD 워크플로우를 전면 개편했습니다.

학습 경험

포크 작업을 통해 다음과 같은 실무 경험을 얻었습니다:

• Next.js & Fastify 통합
• Turborepo와 pnpm을 활용한 모노레포 관리
• 현대적이고 접근성 높은 컴포넌트를 위한 shadcn/ui

상태 관리 버그를 직접 고치는 것이 문서만 읽는 것보다 훨씬 교육적이었습니다.

알려진 이슈

• 게스트 티켓이 아직 웹훅을 트리거하지 않음.
• 티켓 리스트에 실시간 새로고침 로직이 필요함.
• SMTP 핸드셰이크가 까다로울 수 있음.

이 포크가 Peppermint의 가장 안정적인 버전이 될 때까지 매주 업데이트를 약속합니다.

로드맵

• 문서에 대한 완전한 Markdown 지원.
• 맞춤형 테마 및 폰트 (자신만의 헬프 센터 브랜딩).
• 커스텀 박스/컬럼을 갖춘 향상된 칸반.

저장소

가벼우면서도 실제로 작동하는 Knowledge Base를 갖춘 Zendesk 또는 HelpScout의 오픈‑소스 대안을 찾고 있다면, 저장소를 확인해 보세요:

👉 Repo: