Introduction
Allra Fintech Frontend UI Library는 Allra Fintech의 프론트엔드 개발을 위한 통합 개발 가이드입니다. shadcn/ui를 기반으로 한 UI 컴포넌트 라이브러리와 함께, 팀 전체가 일관된 코드 품질과 개발 방식을 유지할 수 있도록 돕는 개발 핸드북을 제공합니다.
목적
이 핸드북은 다음과 같은 목적을 가지고 있습니다:
- 코드 일관성: 팀 전체가 동일한 컨벤션과 패턴을 따르도록 가이드라인 제공
- 개발 효율성: 검증된 아키텍처와 패턴을 통해 빠른 개발 속도 달성
- 유지보수성: 명확한 구조와 명명 규칙으로 코드의 가독성과 유지보수성 향상
- 품질 보장: 에러 처리, 테스트, 타입 안정성 등 개발 품질 표준 정의
주요 섹션
Convention
프로젝트 전반에 걸쳐 지켜야 할 개발 컨벤션을 다룹니다:
- 아키텍처: DATA Layer와 UI Layer 분리, 프로젝트 구조 설계 방법
- 프로젝트 구조: 디렉토리 구조와 파일 조직 방법
- 명명 규칙: 파일/폴더 명명과 코드 명명 규칙
- TypeScript: 타입 정의 및 사용 가이드라인
- React: 컴포넌트 작성 및 상태 관리 컨벤션
- Server Action: Next.js Server Action 사용 가이드
- 스타일: CSS 및 스타일링 규칙
- 에러 처리: 에러 핸들링 및 로깅 표준
- E2E 테스트: End-to-End 테스트 작성 및 관리 방법
시작하기
이 핸드북은 Allra Fintech 프론트엔드 개발팀의 모든 구성원을 대상으로 합니다. 새로 프로젝트에 합류한 개발자부터 기존 팀원까지, 일관된 개발 방식을 유지하기 위해 참고하세요.
각 섹션은 독립적으로 읽을 수 있도록 구성되어 있으며, 필요에 따라 관련 섹션을 참고하여 개발을 진행하시면 됩니다.
확인 후 추가하실 내용이나 수정이 필요한 사항이 있다면 GitHub에 이슈를 남겨주세요.