money.sori.studio/docs/project-guidelines.md

프로젝트 지침

제품 방향

• 모바일 입력을 가장 중요하게 본다.
• 모바일 전용 고정 폭 앱으로 만들지 않는다.
• PC에서는 넓은 작업영역, 사이드바, 표/목록 밀도를 활용한다.
• 기능은 회계 앱처럼 복잡하게 확장하지 않는다.
• 거래 데이터가 금액 계산의 Source of Truth다.

UI 기준

• 모바일: 하단 탭, 플로팅 추가 버튼, 바텀 시트 선택 UI를 우선한다.
• PC: 사이드바 내비게이션과 넓은 콘텐츠 영역을 사용한다.
• 입력 화면은 한 화면에서 빠르게 끝나는 흐름을 유지한다.
• 거래 입력에서는 시간 입력을 요구하지 않고 날짜만 선택한다.
• 날짜 선택은 모바일 친화적인 바텀 시트 캘린더를 사용한다.
• 금액 입력은 기본값 0을 채우지 않고 placeholder로만 안내한다.
• 셀렉트 박스보다 모바일 친화적인 바텀 시트를 우선한다.
• 활성/비활성 같은 상태는 텍스트 버튼보다 토글처럼 현재 상태가 보이는 UI를 쓴다.
• 통계 화면은 그래프보다 숫자와 분류별 리스트를 우선한다.
• 방향 이동 UI는 assets/icons의 키보드 화살표 SVG를 사용한다.
• 거래 목록의 카테고리 표시는 하위 카테고리가 있으면 하위 이름만, 없으면 상위 이름만 보여준다.

데이터 기준

• PostgreSQL을 기본 DB로 사용한다.
• Prisma migration은 저장소에 포함한다.
• 자산 잔액은 현재값을 저장하지 않고 거래 합계로 계산한다.
• 카테고리와 자산은 완전 삭제보다 비활성화를 우선한다.
• CSV Export는 데이터 보존을 위한 필수 기능으로 유지한다.

개발/운영 기준

• 주요 수정 후 npm run build로 검증한다.
• 개발 서버가 켜져 있어 빌드 락이 걸리면 NUXT_IGNORE_LOCK=1 npm run build로 검증한다.
• git 커밋 사용자 정보는 아래 값을 사용한다.

user.name: zenn
user.email: zenn.message@gmail.com

• 의미 있는 수정 단위마다 변경 내역을 문서에 남기고 커밋/푸시한다.
• 원격 저장소는 https://git.sori.studio/zenn/money.sori.studio.git를 사용한다.