graph TB
    subgraph "FSD Layers"
        direction TB
        Routes["routes/<br/>라우트 셸 (5줄 이하)"]
        Features["features/<br/>독립된 기능 슬라이스"]
        Shared["shared/<br/>공통 인프라"]
    end

    Routes -->|"import via index.ts"| Features
    Features -->|"import"| Shared
    Routes -->|"import"| Shared

    style Routes fill:#e1f5fe,stroke:#0288d1
    style Features fill:#fff3e0,stroke:#f57c00
    style Shared fill:#e8f5e9,stroke:#388e3c

graph LR
    subgraph "Feature 슬라이스 (예: users)"
        direction LR
        Entity["Entity<br/><small>types/entities/</small>"]
        ExtRes["ExternalResources<br/><small>externalResources/</small>"]
        GW["Gateway<br/><small>Remote + InMemory</small>"]
        Repo["Repository<br/><small>TanStack Query 래퍼</small>"]
        Sel["Selector<br/><small>읽기 전용 ViewModel</small>"]
        UC["Use Case<br/><small>쓰기 작업 조율</small>"]
        View["View<br/><small>Controller + Presenter</small>"]
    end

    Entity --> GW
    ExtRes --> GW
    GW --> Repo
    Repo --> Sel
    Repo --> UC
    Sel --> View
    UC --> View

    style Entity fill:#f3e5f5,stroke:#7b1fa2
    style ExtRes fill:#fce4ec,stroke:#c62828
    style GW fill:#fff8e1,stroke:#f9a825
    style Repo fill:#e0f2f1,stroke:#00897b
    style Sel fill:#e8eaf6,stroke:#3949ab
    style UC fill:#e8eaf6,stroke:#3949ab
    style View fill:#e1f5fe,stroke:#0288d1

flowchart LR
    API["Spring Boot API<br/>(DTO)"]
    RGW["RemoteGateway<br/>zod.parse()"]
    Entity["UserEntity<br/>(도메인 모델)"]
    Repo["Repository<br/>(TanStack Query)"]
    Sel["Selector<br/>(ViewModel 변환)"]
    View["View<br/>(React 컴포넌트)"]

    API -->|"fetch"| RGW
    RGW -->|"DTO → Entity 매핑"| Entity
    Entity --> Repo
    Repo --> Sel
    Sel -->|"displayName, initials"| View

    MGW["InMemoryGateway<br/>(Mock 데이터)"]
    MGW -->|"VITE_USE_MOCK=true"| Entity

    style API fill:#ffebee,stroke:#c62828
    style RGW fill:#fff8e1,stroke:#f9a825
    style MGW fill:#f1f8e9,stroke:#558b2f
    style Entity fill:#f3e5f5,stroke:#7b1fa2
    style Repo fill:#e0f2f1,stroke:#00897b
    style Sel fill:#e8eaf6,stroke:#3949ab
    style View fill:#e1f5fe,stroke:#0288d1

sequenceDiagram
    participant User
    participant LoginForm
    participant AuthGateway
    participant SpringBoot
    participant Browser

    User->>LoginForm: email, password 입력
    LoginForm->>AuthGateway: login(credentials)
    AuthGateway->>SpringBoot: POST /auth/login
    SpringBoot-->>AuthGateway: token + expiresAt
    Note over SpringBoot,Browser: 서버가 HttpOnly Secure 쿠키 설정
    AuthGateway->>Browser: document.cookie 저장
    AuthGateway-->>LoginForm: TokenEntity
    LoginForm->>Browser: /users 로 리다이렉트

    Note over User,Browser: 이후 모든 API 호출
    Browser->>SpringBoot: Authorization Bearer token
    Note over SpringBoot: JWT 검증 (실제 보안)
    Note over Browser: 클라이언트 만료 체크는 UX 전용

flowchart LR
    subgraph "OpenAPI 동기화"
        BE["Spring Boot<br/>openapi.yaml 변경"]
        Dispatch["repository_dispatch"]
        Sync["sync-openapi.yml"]
        PR["PR 생성<br/>(Breaking Changes 포함)"]
    end

    subgraph "배포"
        Push["main push"]
        Build["npm run build"]
        S3["S3 + CloudFront"]
    end

    BE --> Dispatch --> Sync --> PR
    Push --> Build --> S3

    style BE fill:#ffebee,stroke:#c62828
    style PR fill:#fff8e1,stroke:#f9a825
    style S3 fill:#e8f5e9,stroke:#388e3c

flowchart TD
    A["1. src/features/users/ 복사"] --> B["2. User/Users를 도메인 이름으로 교체"]
    B --> C["3. src/routes/_dashboard/[name].tsx 라우트 추가<br/>(5줄)"]
    C --> D["4. src/features/[name]/index.ts에서 export"]
    D --> E["완료"]

    style A fill:#f3e5f5,stroke:#7b1fa2
    style E fill:#e8f5e9,stroke:#388e3c