timsquad 2.0.0

package/templates/common/timsquad/architectures/fsd/frontend.xml

@@ -0,0 +1,288 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<directory-structure architecture="fsd" target="frontend">
+  <description>Feature-Sliced Design for React/Next.js Frontend</description>
+
+  <root name="src">
+    <!-- Layer 1: App -->
+    <dir name="app" layer="app">
+      <description>앱 초기화, 프로바이더, 전역 스타일, 라우팅</description>
+
+      <dir name="providers">
+        <description>React Context Providers 조합</description>
+        <file name="index.tsx" example="모든 프로바이더를 조합하는 컴포넌트" />
+        <file name="with-auth.tsx" />
+        <file name="with-theme.tsx" />
+        <file name="with-query.tsx" />
+      </dir>
+
+      <dir name="routing">
+        <description>라우팅 설정 (React Router / Next.js)</description>
+        <file name="index.tsx" />
+        <file name="routes.ts" />
+      </dir>
+
+      <dir name="styles">
+        <description>전역 스타일</description>
+        <file name="global.css" />
+        <file name="variables.css" />
+      </dir>
+
+      <file name="index.tsx" example="앱 진입점" />
+    </dir>
+
+    <!-- Layer 2: Pages -->
+    <dir name="pages" layer="pages">
+      <description>라우트별 페이지. widgets, features 조합</description>
+
+      <dir name="home">
+        <file name="ui.tsx" example="HomePage 컴포넌트" />
+        <file name="index.ts" example="export { HomePage } from './ui'" />
+      </dir>
+
+      <dir name="profile">
+        <dir name="ui">
+          <file name="ProfilePage.tsx" />
+          <file name="ProfileEditPage.tsx" />
+        </dir>
+        <file name="index.ts" />
+      </dir>
+
+      <dir name="order">
+        <dir name="ui">
+          <file name="OrderListPage.tsx" />
+          <file name="OrderDetailPage.tsx" />
+        </dir>
+        <file name="model.ts" example="페이지 로컬 상태" />
+        <file name="index.ts" />
+      </dir>
+    </dir>
+
+    <!-- Layer 3: Widgets -->
+    <dir name="widgets" layer="widgets">
+      <description>독립적인 UI 블록. 여러 features 조합 가능</description>
+
+      <dir name="header">
+        <dir name="ui">
+          <file name="Header.tsx" />
+          <file name="Navigation.tsx" />
+          <file name="UserMenu.tsx" />
+        </dir>
+        <file name="index.ts" />
+      </dir>
+
+      <dir name="sidebar">
+        <dir name="ui">
+          <file name="Sidebar.tsx" />
+          <file name="SidebarItem.tsx" />
+        </dir>
+        <file name="model.ts" example="sidebar 열림/닫힘 상태" />
+        <file name="index.ts" />
+      </dir>
+
+      <dir name="order-summary">
+        <description>주문 요약 위젯 (여러 features 조합)</description>
+        <dir name="ui">
+          <file name="OrderSummary.tsx" />
+        </dir>
+        <file name="index.ts" />
+      </dir>
+    </dir>
+
+    <!-- Layer 4: Features -->
+    <dir name="features" layer="features">
+      <description>사용자 시나리오. 비즈니스 기능 단위</description>
+
+      <dir name="auth">
+        <description>인증 기능 (로그인, 로그아웃, 회원가입)</description>
+        <dir name="ui">
+          <file name="LoginForm.tsx" />
+          <file name="SignupForm.tsx" />
+          <file name="LogoutButton.tsx" />
+        </dir>
+        <dir name="model">
+          <file name="auth.store.ts" example="인증 상태 관리" />
+          <file name="use-auth.ts" example="인증 관련 훅" />
+        </dir>
+        <dir name="api">
+          <file name="auth.api.ts" example="로그인/로그아웃 API 호출" />
+        </dir>
+        <file name="index.ts" example="export { LoginForm, useAuth, logout }" />
+      </dir>
+
+      <dir name="add-to-cart">
+        <description>장바구니 추가 기능</description>
+        <dir name="ui">
+          <file name="AddToCartButton.tsx" />
+        </dir>
+        <dir name="model">
+          <file name="use-add-to-cart.ts" />
+        </dir>
+        <dir name="api">
+          <file name="cart.api.ts" />
+        </dir>
+        <file name="index.ts" />
+      </dir>
+
+      <dir name="search">
+        <description>검색 기능</description>
+        <dir name="ui">
+          <file name="SearchInput.tsx" />
+          <file name="SearchResults.tsx" />
+        </dir>
+        <dir name="model">
+          <file name="search.store.ts" />
+          <file name="use-search.ts" />
+        </dir>
+        <dir name="api">
+          <file name="search.api.ts" />
+        </dir>
+        <file name="index.ts" />
+      </dir>
+
+      <dir name="checkout">
+        <description>결제 프로세스</description>
+        <dir name="ui">
+          <file name="CheckoutForm.tsx" />
+          <file name="PaymentMethod.tsx" />
+          <file name="OrderConfirmation.tsx" />
+        </dir>
+        <dir name="model">
+          <file name="checkout.store.ts" />
+          <file name="use-checkout.ts" />
+        </dir>
+        <dir name="api">
+          <file name="checkout.api.ts" />
+        </dir>
+        <dir name="lib">
+          <file name="validation.ts" />
+        </dir>
+        <file name="index.ts" />
+      </dir>
+    </dir>
+
+    <!-- Layer 5: Entities -->
+    <dir name="entities" layer="entities">
+      <description>비즈니스 엔티티. 데이터 모델 + 관련 UI</description>
+
+      <dir name="user">
+        <dir name="ui">
+          <file name="UserCard.tsx" />
+          <file name="UserAvatar.tsx" />
+        </dir>
+        <dir name="model">
+          <file name="user.types.ts" example="interface User { id: string; name: string; email: string; }" />
+          <file name="user.store.ts" />
+        </dir>
+        <dir name="api">
+          <file name="user.api.ts" />
+        </dir>
+        <file name="index.ts" example="export { UserCard, UserAvatar, type User }" />
+      </dir>
+
+      <dir name="product">
+        <dir name="ui">
+          <file name="ProductCard.tsx" />
+          <file name="ProductImage.tsx" />
+          <file name="ProductPrice.tsx" />
+        </dir>
+        <dir name="model">
+          <file name="product.types.ts" />
+        </dir>
+        <dir name="api">
+          <file name="product.api.ts" />
+        </dir>
+        <file name="index.ts" />
+      </dir>
+
+      <dir name="order">
+        <dir name="ui">
+          <file name="OrderCard.tsx" />
+          <file name="OrderStatus.tsx" />
+          <file name="OrderItemList.tsx" />
+        </dir>
+        <dir name="model">
+          <file name="order.types.ts" />
+        </dir>
+        <dir name="api">
+          <file name="order.api.ts" />
+        </dir>
+        <file name="index.ts" />
+      </dir>
+    </dir>
+
+    <!-- Layer 6: Shared -->
+    <dir name="shared" layer="shared">
+      <description>공유 리소스. 비즈니스 로직 없음</description>
+
+      <dir name="ui">
+        <description>UI Kit - 도메인 무관한 컴포넌트</description>
+        <file name="Button.tsx" />
+        <file name="Input.tsx" />
+        <file name="Modal.tsx" />
+        <file name="Card.tsx" />
+        <file name="Spinner.tsx" />
+        <file name="index.ts" />
+      </dir>
+
+      <dir name="lib">
+        <description>유틸리티 함수</description>
+        <file name="format-date.ts" />
+        <file name="format-currency.ts" />
+        <file name="cn.ts" example="className 병합 유틸" />
+        <file name="index.ts" />
+      </dir>
+
+      <dir name="api">
+        <description>API 기반 설정</description>
+        <file name="api-client.ts" example="axios/fetch 인스턴스" />
+        <file name="api-types.ts" />
+        <file name="index.ts" />
+      </dir>
+
+      <dir name="config">
+        <description>앱 설정</description>
+        <file name="env.ts" />
+        <file name="constants.ts" />
+        <file name="index.ts" />
+      </dir>
+
+      <dir name="types">
+        <description>공통 타입</description>
+        <file name="common.ts" />
+        <file name="index.ts" />
+      </dir>
+
+      <dir name="hooks">
+        <description>공통 훅</description>
+        <file name="use-debounce.ts" />
+        <file name="use-local-storage.ts" />
+        <file name="use-media-query.ts" />
+        <file name="index.ts" />
+      </dir>
+    </dir>
+  </root>
+
+  <import-rules>
+    <rule>상위 레이어만 하위 레이어를 import 가능</rule>
+    <rule>같은 레이어 내 슬라이스 간 import 금지</rule>
+    <rule>모든 import는 Public API (index.ts)를 통해서만</rule>
+
+    <allowed from="app" to="pages,widgets,features,entities,shared" />
+    <allowed from="pages" to="widgets,features,entities,shared" />
+    <allowed from="widgets" to="features,entities,shared" />
+    <allowed from="features" to="entities,shared" />
+    <allowed from="entities" to="shared" />
+    <allowed from="shared" to="없음" />
+
+    <forbidden>같은 레이어 내 cross-import (features/auth → features/checkout 금지)</forbidden>
+  </import-rules>
+
+  <path-aliases>
+    <alias name="@/app" path="src/app" />
+    <alias name="@/pages" path="src/pages" />
+    <alias name="@/widgets" path="src/widgets" />
+    <alias name="@/features" path="src/features" />
+    <alias name="@/entities" path="src/entities" />
+    <alias name="@/shared" path="src/shared" />
+  </path-aliases>
+</directory-structure>

package/templates/common/timsquad/architectures/hexagonal/ARCHITECTURE.md

@@ -0,0 +1,60 @@
+---
+name: hexagonal-architecture
+description: Hexagonal Architecture (Ports and Adapters)
+aliases: [ports-and-adapters, onion-architecture]
+suitable-for: [api-backend, platform, fintech]
+target: backend
+---
+
+# Hexagonal Architecture (Ports and Adapters)
+
+<architecture name="hexagonal">
+  <philosophy>
+    <principle>애플리케이션을 육각형의 중심에, 외부 세계를 가장자리에</principle>
+    <principle>포트(인터페이스)로 경계 정의, 어댑터로 연결</principle>
+    <principle>인바운드(Driving) vs 아웃바운드(Driven) 명확 구분</principle>
+    <principle>도메인은 외부에 대해 무지해야 함</principle>
+  </philosophy>
+
+  <core-concepts>
+    <concept name="port">
+      <description>애플리케이션 경계의 인터페이스</description>
+      <type name="inbound">외부에서 애플리케이션으로 들어오는 요청 (Use Case)</type>
+      <type name="outbound">애플리케이션에서 외부로 나가는 요청 (SPI)</type>
+    </concept>
+
+    <concept name="adapter">
+      <description>포트의 구체적 구현</description>
+      <type name="primary">외부 → 애플리케이션 (Controller, CLI, Message Consumer)</type>
+      <type name="secondary">애플리케이션 → 외부 (Repository, API Client, Message Publisher)</type>
+    </concept>
+
+    <concept name="application-core">
+      <description>비즈니스 로직의 핵심. 포트로만 외부와 소통</description>
+    </concept>
+  </core-concepts>
+
+  <layers>
+    <layer name="domain" position="center">
+      <description>비즈니스 엔티티와 규칙. 가장 안정적</description>
+    </layer>
+
+    <layer name="application" position="inner-ring">
+      <description>유스케이스와 포트 정의</description>
+    </layer>
+
+    <layer name="adapters" position="outer-ring">
+      <description>포트 구현. Primary + Secondary</description>
+    </layer>
+
+    <layer name="infrastructure" position="edge">
+      <description>프레임워크, 설정, 조립</description>
+    </layer>
+  </layers>
+
+  <dependency-flow>
+    <rule>의존성은 항상 바깥에서 안으로 향함</rule>
+    <rule>안쪽 레이어는 바깥쪽을 모름</rule>
+    <rule>포트 = 안쪽에서 정의, 어댑터 = 바깥에서 구현</rule>
+  </dependency-flow>
+</architecture>

package/templates/common/timsquad/architectures/hexagonal/backend.xml

@@ -0,0 +1,300 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<directory-structure architecture="hexagonal" target="backend">
+  <description>Hexagonal Architecture (Ports and Adapters) for Node.js Backend</description>
+
+  <root name="src">
+    <!-- Domain (Core Center) -->
+    <dir name="domain" layer="center">
+      <description>비즈니스 핵심. 외부 의존성 완전 제거</description>
+
+      <dir name="model">
+        <description>도메인 모델 (Aggregate Root, Entity, Value Object)</description>
+
+        <dir name="user">
+          <file name="user.ts" example="Aggregate Root" />
+          <file name="user-id.ts" example="Value Object (Branded Type)" />
+          <file name="email.ts" example="Value Object with validation" />
+          <file name="password.ts" example="Value Object (hashed)" />
+        </dir>
+
+        <dir name="order">
+          <file name="order.ts" />
+          <file name="order-id.ts" />
+          <file name="order-item.ts" />
+          <file name="order-status.ts" example="enum OrderStatus" />
+        </dir>
+
+        <dir name="product">
+          <file name="product.ts" />
+          <file name="product-id.ts" />
+          <file name="money.ts" example="Value Object for price" />
+        </dir>
+      </dir>
+
+      <dir name="service">
+        <description>도메인 서비스 (여러 엔티티에 걸친 로직)</description>
+        <file name="pricing.service.ts" />
+        <file name="inventory.service.ts" />
+      </dir>
+
+      <dir name="event">
+        <description>도메인 이벤트</description>
+        <file name="domain-event.ts" />
+        <file name="user-registered.event.ts" />
+        <file name="order-placed.event.ts" />
+        <file name="payment-completed.event.ts" />
+      </dir>
+
+      <dir name="error">
+        <description>도메인 에러</description>
+        <file name="domain-error.ts" />
+        <file name="validation-error.ts" />
+        <file name="not-found-error.ts" />
+        <file name="business-rule-error.ts" />
+      </dir>
+    </dir>
+
+    <!-- Application (Inner Ring - Use Cases + Ports) -->
+    <dir name="application" layer="inner-ring">
+      <description>애플리케이션 서비스와 포트 정의</description>
+
+      <dir name="port">
+        <description>포트 인터페이스 (애플리케이션 경계)</description>
+
+        <dir name="inbound">
+          <description>인바운드 포트 (Primary Ports / Driving)</description>
+          <note>외부에서 애플리케이션을 호출하기 위한 인터페이스</note>
+
+          <dir name="user">
+            <file name="register-user.port.ts" example="interface RegisterUserUseCase { execute(cmd: RegisterUserCommand): Promise&lt;UserId&gt;; }" />
+            <file name="get-user.port.ts" />
+            <file name="update-user.port.ts" />
+          </dir>
+
+          <dir name="order">
+            <file name="create-order.port.ts" />
+            <file name="cancel-order.port.ts" />
+            <file name="get-order.port.ts" />
+          </dir>
+        </dir>
+
+        <dir name="outbound">
+          <description>아웃바운드 포트 (Secondary Ports / Driven)</description>
+          <note>애플리케이션이 외부 리소스에 접근하기 위한 인터페이스</note>
+
+          <file name="user-repository.port.ts" example="interface UserRepository { findById(id: UserId): Promise&lt;User | null&gt;; save(user: User): Promise&lt;void&gt;; }" />
+          <file name="order-repository.port.ts" />
+          <file name="product-repository.port.ts" />
+          <file name="payment-gateway.port.ts" />
+          <file name="email-sender.port.ts" />
+          <file name="event-publisher.port.ts" />
+        </dir>
+      </dir>
+
+      <dir name="service">
+        <description>애플리케이션 서비스 (유스케이스 구현)</description>
+
+        <dir name="user">
+          <file name="register-user.service.ts" example="RegisterUserUseCase 구현" />
+          <file name="get-user.service.ts" />
+          <file name="update-user.service.ts" />
+        </dir>
+
+        <dir name="order">
+          <file name="create-order.service.ts" />
+          <file name="cancel-order.service.ts" />
+          <file name="get-order.service.ts" />
+        </dir>
+      </dir>
+
+      <dir name="command">
+        <description>Command 객체 (유스케이스 입력)</description>
+        <file name="register-user.command.ts" />
+        <file name="create-order.command.ts" />
+        <file name="update-user.command.ts" />
+      </dir>
+
+      <dir name="query">
+        <description>Query 객체 (조회 입력)</description>
+        <file name="get-user.query.ts" />
+        <file name="get-order.query.ts" />
+        <file name="list-orders.query.ts" />
+      </dir>
+
+      <dir name="dto">
+        <description>Result DTO (유스케이스 출력)</description>
+        <file name="user-result.dto.ts" />
+        <file name="order-result.dto.ts" />
+      </dir>
+    </dir>
+
+    <!-- Adapters (Outer Ring) -->
+    <dir name="adapter" layer="outer-ring">
+      <description>포트 구현 (Primary + Secondary Adapters)</description>
+
+      <dir name="inbound">
+        <description>Primary Adapters (Driving Adapters)</description>
+        <note>외부에서 애플리케이션으로 들어오는 진입점</note>
+
+        <dir name="http">
+          <description>HTTP REST API 어댑터</description>
+          <file name="user.controller.ts" />
+          <file name="order.controller.ts" />
+          <file name="health.controller.ts" />
+
+          <dir name="dto">
+            <description>HTTP 요청/응답 DTO</description>
+            <file name="register-user.request.ts" />
+            <file name="create-order.request.ts" />
+            <file name="user.response.ts" />
+            <file name="order.response.ts" />
+          </dir>
+
+          <dir name="mapper">
+            <description>HTTP DTO ↔ Command/Query 매퍼</description>
+            <file name="user.mapper.ts" />
+            <file name="order.mapper.ts" />
+          </dir>
+        </dir>
+
+        <dir name="grpc">
+          <description>gRPC 어댑터 (선택적)</description>
+          <file name="user.grpc.ts" />
+          <file name="order.grpc.ts" />
+        </dir>
+
+        <dir name="cli">
+          <description>CLI 어댑터 (선택적)</description>
+          <file name="migrate.cli.ts" />
+          <file name="seed.cli.ts" />
+        </dir>
+
+        <dir name="message">
+          <description>메시지 컨슈머 어댑터</description>
+          <file name="order-event.consumer.ts" />
+          <file name="payment-event.consumer.ts" />
+        </dir>
+      </dir>
+
+      <dir name="outbound">
+        <description>Secondary Adapters (Driven Adapters)</description>
+        <note>애플리케이션에서 외부로 나가는 구현</note>
+
+        <dir name="persistence">
+          <description>영속성 어댑터 (Repository 구현)</description>
+
+          <dir name="prisma">
+            <file name="prisma-user.repository.ts" example="UserRepository 구현" />
+            <file name="prisma-order.repository.ts" />
+            <file name="prisma-product.repository.ts" />
+          </dir>
+
+          <dir name="mapper">
+            <description>DB 모델 ↔ 도메인 모델 매퍼</description>
+            <file name="user.mapper.ts" />
+            <file name="order.mapper.ts" />
+          </dir>
+        </dir>
+
+        <dir name="external">
+          <description>외부 서비스 어댑터</description>
+          <file name="stripe-payment.adapter.ts" />
+          <file name="sendgrid-email.adapter.ts" />
+          <file name="aws-s3-storage.adapter.ts" />
+        </dir>
+
+        <dir name="message">
+          <description>메시지 퍼블리셔 어댑터</description>
+          <file name="kafka-event.publisher.ts" />
+          <file name="redis-event.publisher.ts" />
+        </dir>
+      </dir>
+    </dir>
+
+    <!-- Infrastructure (Edge) -->
+    <dir name="infrastructure" layer="edge">
+      <description>프레임워크 설정 및 조립</description>
+
+      <dir name="http">
+        <description>HTTP 서버 설정</description>
+        <file name="app.ts" example="Hono 앱 인스턴스" />
+        <file name="routes.ts" />
+        <file name="middleware.ts" />
+        <file name="error-handler.ts" />
+      </dir>
+
+      <dir name="database">
+        <description>데이터베이스 설정</description>
+        <file name="prisma.ts" />
+        <dir name="migrations" />
+      </dir>
+
+      <dir name="config">
+        <description>환경 설정</description>
+        <file name="env.ts" />
+        <file name="constants.ts" />
+      </dir>
+
+      <dir name="di">
+        <description>의존성 주입 컨테이너</description>
+        <file name="container.ts" example="어댑터와 서비스 조립" />
+        <file name="tokens.ts" example="DI 토큰 정의" />
+      </dir>
+
+      <dir name="logging">
+        <file name="logger.ts" />
+      </dir>
+
+      <dir name="monitoring">
+        <file name="metrics.ts" />
+        <file name="tracing.ts" />
+      </dir>
+    </dir>
+
+    <!-- Entry Point -->
+    <file name="index.ts" layer="infrastructure">
+      <description>애플리케이션 진입점</description>
+    </file>
+  </root>
+
+  <import-rules>
+    <rule from="domain" to="없음">domain은 외부 의존성 없음</rule>
+    <rule from="application" to="domain">포트는 domain 타입만 사용</rule>
+    <rule from="adapter" to="application,domain">어댑터는 포트 구현, 도메인 사용</rule>
+    <rule from="infrastructure" to="all">infrastructure는 모든 레이어 조립</rule>
+  </import-rules>
+
+  <testing-structure>
+    <dir name="__tests__">
+      <dir name="unit">
+        <description>유닛 테스트 (도메인, 서비스)</description>
+        <dir name="domain" />
+        <dir name="application" />
+      </dir>
+
+      <dir name="integration">
+        <description>통합 테스트 (어댑터)</description>
+        <dir name="adapter">
+          <dir name="inbound" note="컨트롤러 테스트" />
+          <dir name="outbound" note="리포지토리 테스트" />
+        </dir>
+      </dir>
+
+      <dir name="e2e">
+        <description>E2E 테스트</description>
+      </dir>
+
+      <dir name="fixtures">
+        <description>테스트 픽스처</description>
+        <file name="user.fixture.ts" />
+        <file name="order.fixture.ts" />
+      </dir>
+
+      <dir name="mocks">
+        <description>목 어댑터</description>
+        <file name="mock-user-repository.ts" />
+        <file name="mock-payment-gateway.ts" />
+      </dir>
+    </dir>
+  </testing-structure>
+</directory-structure>