Feature-Sliced Design

entities/buyer/
├── api/
│   ├── queries.ts          ← 캐시 키 팩토리 + useQuery hooks
│   ├── mutations.ts        ← useMutation + invalidation
│   └── buyerApi.ts         ← raw HTTP 함수 (내부용, export 안 함)
├── model/
│   ├── constants.ts        ← BUYER_STATUS 등 도메인 상수
│   └── helpers.ts          ← 도메인 특화 변환
├── ui/
│   ├── BuyerAvatar.tsx     ← 순수 표현 컴포넌트
│   └── BuyerStatusBadge.tsx
└── index.ts                ← Public API

// index.ts — 외부에 노출할 것만 명시
export { useBuyer, useBuyerList, buyerKeys } from './api/queries'
export { usePatchBuyerEmail, usePatchBuyerAddress } from './api/mutations'
export { BuyerAvatar, BuyerStatusBadge } from './ui'
// buyerApi.ts는 export 안 함 → 내부 구현

shared/
├── api/
│   ├── httpClient.ts          ← Axios 인스턴스, 인터셉터
│   ├── queryClient.ts         ← TanStack QueryClient 설정
│   ├── dto.ts                 ← 전체 DTO 타입 (한 파일)
│   └── index.ts
├── ui/
│   ├── Button/
│   ├── Input/
│   ├── Modal/
│   ├── DataTable/             ← 범용 (도메인 무관)
│   └── index.ts
├── lib/
│   ├── format/
│   ├── validation/
│   └── index.ts
└── config/
    ├── env.ts
    └── routes.ts

// Import은 세그먼트별로:
import { http } from '@/shared/api'
import type { BuyerDto } from '@/shared/api/dto'
import { Button } from '@/shared/ui'
import { formatDate } from '@/shared/lib'

module.exports = {
  plugins: ['boundaries', '@typescript-eslint'],
  settings: {
    'boundaries/elements': [
      { type: 'shared',   pattern: 'src/shared/*' },
      { type: 'entities',  pattern: 'src/entities/*' },
      { type: 'features',  pattern: 'src/features/*' },
      { type: 'widgets',   pattern: 'src/widgets/*' },
      { type: 'app',       pattern: 'app/*' },
    ],
  },
  rules: {
    // ── Import 흐름 강제 ──
    'boundaries/element-types': ['error', {
      default: 'disallow',
      rules: [
        { from: 'app',      allow: ['widgets','features','entities','shared'] },
        { from: 'widgets',  allow: ['features','entities','shared'] },
        { from: 'features', allow: ['entities','shared'] },
        { from: 'entities', allow: ['shared'] },
        { from: 'shared',   allow: ['shared'] },
      ],
    }],

    // ── any 완전 금지 ──
    '@typescript-eslint/no-explicit-any': 'error',
    '@typescript-eslint/no-unsafe-argument': 'error',
    '@typescript-eslint/no-unsafe-assignment': 'error',
    '@typescript-eslint/no-unsafe-call': 'error',
    '@typescript-eslint/no-unsafe-member-access': 'error',
    '@typescript-eslint/no-unsafe-return': 'error',

    // ── Public API 우회 방지 ──
    'no-restricted-imports': ['error', {
      patterns: [
        '@/entities/*/*/**',
        '@/features/*/*/*/**',  ← 도메인/슬라이스/내부
        '@/widgets/*/*/*/**',
      ],
    }],
  },
}

// 설치
npm install -D husky lint-staged
npx husky init

// .husky/pre-commit
npx lint-staged

// package.json
{
  "lint-staged": {
    "*.{ts,tsx}": [
      "eslint --max-warnings=0",    ← warning도 0개
      "tsc-files --noEmit"           ← 타입 체크
    ]
  }
}

// 흐름:
// 1. 개발 중 → IDE 빨간 줄 (즉시 피드백)
// 2. git commit → pre-commit hook → ESLint 실행
//    → any or 잘못된 import → 커밋 거부
// 3. CI → 이중 검증