[Chore/#3] 초기 설정 정비 (pnpm·Biome·Tailwind·폴더 구조)

[xeoxxn]

#️⃣연관된 이슈

• Closes 초기 설정 정비 (pnpm·Biome·Tailwind·폴더 구조) #3

🎯 해결하려는 문제가 무엇인가요?

stream-client가 Vite 템플릿 기본값 그대로라 lint/format, 경로 별칭, 폴더 구조, 패키지 매니저, 스타일링 방식이 하나도 정해져 있지 않았다.

❓ 왜 해결해야 하나요?

앞으로 기능 코드가 쌓이기 전에 초기 설정을 잡아둬야 이후 갈아엎는 비용이 없다. mash-up-kr/Promise.9-Web에 이미 검증된 설정이 있어 그중 우리 서비스(순수 웹 SPA)에 맞는 부분만 골라 반영했다.

⭐ 어떻게 해결했나요?

참고: mash-up-kr/Promise.9-Web

1. chore: npm에서 pnpm으로 전환 — corepack으로 pnpm 고정, package-lock.json → pnpm-lock.yaml
2. chore: Node 버전 고정 (.nvmrc)
3. chore: ESLint 제거, Biome 도입 — lint+format+import 정리 단일화 (참고: biome.jsonc)
4. chore: 경로 별칭(@/*) 추가 — tsconfig paths + vite resolve.alias
5. refactor: 기능 기반 폴더 구조로 src/ 정비 — App.tsx를 app/으로 이동, Vite 템플릿 데모 콘텐츠·미사용 자산 정리. components/ui/·hooks/·lib/·utils/는 git이 빈 디렉터리를 못 담고 "빈 폴더 미리 만들지 않기" 원칙과도 맞지 않아 실제로 필요해질 때 만들기로 계획 수정
6. chore: Tailwind CSS v4 도입 — @tailwindcss/vite 플러그인 방식(postcss 불필요), 디자인 토큰 넣을 빈 @theme 블록, Biome에 Tailwind 클래스 정렬 규칙 추가
7. docs: coding-style 컨벤션 문서 추가 — Promise.9-Web shared.md에서 RN/멀티서페이스 부분 제외하고 이식
8. chore: PR 담당자 자동 지정 GitHub Action 추가 — 참고: review-assign.yml, reviewers는 비워두고 assignees만 적용
9. chore: docs/plans를 git 추적에서 제외 — .gitignore의 .docs/plans 오타(docs/plans가 맞음)를 고치고, 이미 커밋됐던 계획 문서를 추적에서 제외 (로컬 전용으로 유지)

🧩 이 PR의 한계 & 트레이드오프

디자인 시스템은 자리(Tailwind 토큰 위치, components/ui/ 규칙)만 마련했고 실제 컴포넌트·토큰 값은 넣지 않았다. review-assign.yml의 리뷰어 목록도 비워뒀다.

⛓️ 기존 기능에 미치는 영향

App.tsx의 Vite 기본 데모 콘텐츠(로고·카운터)를 걷어내고 STREAM 플레이스홀더로 교체했다. 실제 제품 코드가 아직 없어 영향 없음.

🔀 Edge Case & 실패 시나리오

해당 없음 (tooling 초기 설정).

📋 검토한 대안과 선택 이유

• Tailwind 적용 방식: postcss 설정 대신 Vite 전용 플러그인(@tailwindcss/vite) 사용 — RN 대응이 필요 없는 순수 웹이라 공식 권장 방식을 그대로 따름.
• 폴더 구조: entities/·features/는 실제 도메인이 생기기 전까지 만들지 않기로 함 (5번 커밋 참고).

💬 리뷰 포인트

• biome.jsonc 룰셋(포맷 스타일 double quote/세미콜론/trailing comma, a11y 룰 일부 off)이 팀 취향과 맞는지
• 아직 정하지 못한 것: PR 리뷰어 목록(팀원 아이디 확정되면 채우기), 디자인 시스템을 자체 구축할지 shadcn/ui 같은 헤드리스 라이브러리 기반으로 할지 — 의견 있으면 코멘트 부탁드립니다