Files

T

ttipo 2bb7fa4cdb docs(rules): 앱 토큰 경로 · 모듈 틀을 flutter 스킬과 공통 규칙에 적는다

- flutter 스킬: 기본 제공 골격을 이번 앱 기반으로(인증 인터셉터 · 토큰 보관 · 세션 노티파이어 ·
  모듈 틀), 새 모듈 붙이는 법, 비밀이 든 요청의 실패 예외, 자동 다시 하기 끔, Flutter 판
- 보안 · 에러 코드 · 코딩 규칙: 앱은 리프레시 토큰을 본문으로 받아 보안 저장소에(kRefreshTokenKey),
  세션 만료 승격은 갱신 뒤 · 스스로 로그아웃한 뒤의 401 은 승격하지 않는다(웹과 같다)
- mobile-dev 역할: 작업 순서 · 완료 기준(apk 빌드 포함)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

2026-11-06 11:11:29 +09:00

2.4 KiB

Raw Blame History

name, description

name	description
coding-common	세 클라이언트(backend/frontend/flutter) 공통 코딩 규칙 — 주석 언어, 타입 정책, 린트, 순수 유틸 분리, 절대경로 alias.

공통 코딩 규칙

모든 코드 주석은 한국어로 작성
웹(frontend)·서버(backend)는 100% TypeScript, 모바일(flutter)은 Dart Sound Null Safety 준수
컴파일러/린터 Warning 방치 금지 — 커밋 전 각 프로젝트 lint / analyze 통과 (lint 스크립트에 --max-warnings 0 이 걸려 있다. 자동 수정은 npm run lint:fix)
아래 규칙은 린트로 강제되므로 위반 시 빌드가 실패한다: any/dynamic 사용, console/print 출력, Vue 인라인 스타일·Options API, Dart const 누락·await 누락, backend 에서 HttpException 직접 생성(→ BusinessException 사용)
유틸 함수는 순수 함수로 분리 — TS는 shared/utils/, Dart는 core/utils/
매직 넘버·하드코딩 문자열 지양 → 상수 또는 환경변수로 분리 (반복 사용되는 키 문자열도 상수로: 예 kRefreshTokenKey, REQUEST_ID_HEADER)
절대경로 alias 사용 (TS @/, Dart package:), 깊은 상대경로(../../) 지양 — backend/frontend 모두 @/ → src/ 로 설정되어 있다 (backend 는 tsconfig.json paths + jest moduleNameMapper)
자동 생성 파일은 직접 수정하지 않는다 — *.generated.ts, *.g.dart 는 생성 스크립트를 통해서만 바꾼다 (error-codes)

네이밍 규약

대상	규칙	예
TS 파일(일반)	kebab-case	`user.store.ts`, `use-api.ts` / 기존 composable 은 `useApi.ts` 형태 유지
Vue 컴포넌트 파일	PascalCase	`BaseButton.vue`, `UserCard.vue`
Dart 파일·디렉터리	snake_case	`dio_client.dart`, `user_repository.dart`
클래스/타입	PascalCase	`UserModel`, `TransformInterceptor`
변수/함수	camelCase (Dart 포함)	`getUser`, `isLoggedIn`
상수	TS `UPPER_SNAKE` 또는 모듈 상수, Dart `lowerCamel`	`MAX_RETRY`, `defaultTimeout`
에러 코드	`DOMAIN_NNN`	`AUTH_001`, `VAL_001` (error-codes)
자동 생성 파일	TS `.generated.ts`, Dart `.g.dart`	`error-codes.generated.ts`, `error_lexicon.g.dart`

도메인별 세부 규칙: nestjs · vue3 · flutter · 테스트: testing · 로깅: logging · API 설계: api-design

2.4 KiB Raw Blame History

공통 코딩 규칙

네이밍 규약

2.4 KiB

Raw Blame History