일상적인 개발과 문서 작업에 쓰이는 유틸리티를 한곳에 모은 도구 모음입니다. 각 도구는 독립된 애플리케이션으로 구성되어 개별 디렉터리에서 바로 실행하고 배포할 수 있으며, 공통 디자인 토큰과 UI 프리미티브로 일관된 사용 경험을 제공합니다.
기술 스택: React 19 · Next.js · TypeScript · Vite · Tailwind CSS · Electron · Kotlin · Spring Boot
- API·데이터·설정:
json-yaml-converter: JSON·YAML 양방향 변환, 포맷팅, 문법 오류 위치 진단openapi-editor: Swagger 2.0 및 OpenAPI 3.0/3.1/3.2 편집·검증·버전 변환api-contract-test-generator: OpenAPI 명세 기반 정상·경계값·오류·인증 테스트 계획 생성ddl-seed-generator: DDL 분석 후 외래키(FK) 순서에 맞는 seed·rollback SQL 생성config-diff-viewer: YAML/JSON/properties/.env 비교 및 누락 키·위험 설정·민감정보 탐지
- 설계·문서·파일:
class-diagram-generator: 소스 코드 ZIP 업로드를 통한 클래스 설계서(다이어그램, XLSX, DOCX, MD) 생성sign-maker: 캔버스 기반 손글씨 서명 작성 및 투명 배경 이미지 다운로드dummy-file-generator: 지정한 형식과 용량의 테스트용 더미 파일 생성
- 데스크톱·허브:
webpage-capture-tool: 등록한 URL을 내장 브라우저로 촬영하는 Electron 캡처 도구home: 전체 도구를 탐색하고 실행 경로를 안내하는 랜딩 페이지
- mise — 프로젝트별 런타임(Node.js 24, Java 21) 버전은 각 디렉터리의
mise.toml에 고정되어 있으며mise가 설치합니다.
실행하려는 도구의 디렉터리로 이동해 초기 설정과 개발 서버를 실행합니다.
cd home # 실행할 도구 디렉터리로 이동 (예: home, openapi-editor)
mise trust # 최초 1회, mise.toml 검토 후 신뢰
mise run bootstrap # 고정된 런타임 설치 + 의존성 설치
mise run dev # 개발 서버 실행 (webpage-capture-tool은 mise run start)루트 디렉터리는 공통 디자인 시스템의 동기화와 검증만 담당하며, 하위 앱 전체를 일괄 실행하지 않습니다.
각 도구 디렉터리에서 아래 명령을 사용할 수 있습니다.
| 명령 | 설명 |
|---|---|
mise run bootstrap |
고정된 런타임 및 패키지 의존성 설치 |
mise run dev |
개발 서버 실행 (webpage-capture-tool은 mise run start) |
mise run test |
단위·컴포넌트 테스트 실행 |
mise run check |
테스트·린트·타입체크·빌드·E2E 통합 검증 |
mise run verify |
프로젝트 품질 게이트 실행 |
루트 디렉터리에서 공통 디자인 시스템을 수정한 경우에는 npm run design-system:sync와 mise run verify로 정본 동기화 상태를 검증합니다.
전체 작업 목록은 해당 디렉터리에서 mise tasks로 확인할 수 있습니다. dev/prod 환경 프로필과 개인 설정 방법은 기여자 가이드의 Mise Environment Configuration을 참고하세요.
변경 전 기여 가이드를 확인해 주세요.