src/
├── app/                    # 라우팅 레이어 (Next.js App Router)
├── features/               # 기능 모듈
├── shared/                 # 공용 모듈
├── config/                 # 설정 (상수, 환경변수)
└── styles/                 # 글로벌 스타일

app/
├── (public)/               # 공개 페이지 그룹
│   ├── page.tsx
│   └── [dynamic]/page.tsx
├── (auth)/                 # 인증 필요 페이지
├── (admin)/                # 관리자 전용
├── api/
│   └── v1/                 # 버전된 API
└── layout.tsx

features/
└── {feature-name}/
    ├── components/         # UI 컴포넌트
    │   ├── FeatureComponent.tsx
    │   └── index.ts
    ├── hooks/              # 커스텀 훅
    │   └── useFeature.ts
    ├── api/                # API 함수
    │   └── feature.ts
    ├── lib/                # 비즈니스 로직
    │   └── calculator.ts
    ├── types.ts            # Feature 전용 타입
    └── index.ts            # Public API (barrel export)

shared/
├── components/
│   ├── ui/                 # 기본 UI (Button, Card, Badge, Modal)
│   ├── layout/             # 레이아웃 (Header, Footer, Sidebar)
│   └── charts/             # 차트 컴포넌트
├── hooks/                  # 공용 훅 (useLocalStorage, useMediaQuery)
├── lib/
│   ├── api/                # API 클라이언트
│   ├── utils/              # 순수 유틸 (date, format, validation)
│   └── analytics/          # 데이터 분석 (youtube, market, sentiment)
└── types/                  # 공용 타입

config/
├── constants.ts            # 앱 상수
├── env.ts                  # 환경변수 타입 및 검증
└── {domain}.ts             # 도메인별 설정 (analysts.ts 등)

styles/
├── tokens/
│   ├── colors.css
│   ├── typography.css
│   └── spacing.css
└── globals.css

// ✅ Feature에서 shared 사용
import { Button } from '@/shared/components/ui'
import { formatDate } from '@/shared/lib/utils'

// ✅ Feature 외부에서 public API 사용
import { HoneyIndex } from '@/features/honey-index'

// ✅ Feature 내부에서 상대 경로
// (features/honey-index/components/Chart.tsx에서)
import { useHoneyIndex } from '../hooks/useHoneyIndex'
import type { HoneyData } from '../types'

// ✅ app에서 features 사용
import { HoneyIndexChart } from '@/features/honey-index'

// ❌ Feature 내부 직접 참조 (barrel 우회)
import { Chart } from '@/features/honey-index/components/Chart'

// ❌ Feature 간 직접 의존
// (features/voting/에서)
import { something } from '@/features/predictions'

// ❌ shared에서 feature 의존
// (shared/lib/에서)
import { something } from '@/features/honey-index'

// ❌ 상대 경로로 레이어 탈출
import { something } from '../../../shared/lib'

features/analysts/
├── components/
│   ├── AnalystCard.tsx
│   ├── AnalystList.tsx
│   ├── AnalystProfile.tsx
│   └── index.ts
├── hooks/
│   └── useAnalyst.ts
├── api/
│   └── analysts.ts
├── types.ts
└── index.ts

// Public API만 노출
export { AnalystCard } from './components'
export { AnalystList } from './components'
export { AnalystProfile } from './components'
export { useAnalyst } from './hooks/useAnalyst'
export type { Analyst, AnalystStats } from './types'

// app/analysts/page.tsx
import { AnalystList } from '@/features/analysts'

export default function AnalystsPage() {
  return <AnalystList />
}