ID: key_26_22_05_25_17_00_00_00000
Created date: 5월 25 2026 월요일, 22주 17:00
개요
Claude Code 개발 의뢰 전, 확정되어야 하는 항목을 정의한다.
아래 항목이 결정되어야 각 개발 영역(DB / 서버 / UI / 모바일)에 대한 코드 생성 의뢰가 가능하다.
1. 기존 운영 서비스 현황
현재 개발·운영 중인 서비스와 기술 스택을 기재
| 서비스명 | 설명 | 언어 / 프레임워크 | DB | 배포 환경 | 비고 |
|---|
| | | | | |
| | | | | |
| | | | | |
2. 기술 스택 확정
기존 서비스 스택과의 일관성, 팀 역량, 유지보수 용이성을 고려하여 결정
2-1. 서버 (Backend)
| 항목 | 결정값 | 후보 / 비고 |
|---|
| 언어 | | Node.js / Python / Java |
| 프레임워크 | | Express / FastAPI / Spring Boot |
| ORM | | Prisma / TypeORM / SQLAlchemy |
| 인증 방식 | | JWT (기본값) |
| 실시간 통신 | | WebSocket / Socket.io |
| 메시지 큐 | | Redis BullMQ / RabbitMQ |
2-2. 데이터베이스 (DB)
| 항목 | 결정값 | 후보 / 비고 |
|---|
| 주 DB | | PostgreSQL (권장) / MySQL |
| 캐시 | | Redis |
| 검색 | | Elasticsearch / PostgreSQL FTS |
| 파일 스토리지 | | AWS S3 / GCS / MinIO |
2-3. UI (Web Frontend)
| 항목 | 결정값 | 후보 / 비고 |
|---|
| 프레임워크 | | React / Vue / Angular |
| 상태 관리 | | Zustand / Redux / Pinia |
| UI 컴포넌트 | | Ant Design / MUI / Shadcn |
| 스타일링 | | Tailwind CSS / CSS Modules |
| 차트 | | Recharts / Chart.js |
| 에디터 | | TipTap / Milkdown |
| 드래그 앤 드롭 | | @hello-pangea/dnd |
2-4. 모바일
| 항목 | 결정값 | 후보 / 비고 |
|---|
| 플랫폼 전략 | | 크로스 플랫폼 / 네이티브 |
| 프레임워크 | | React Native / Flutter |
| 상태 관리 | | Redux / MobX / GetX |
| 로컬 저장소 | | AsyncStorage / SQLite / Realm |
| 푸시 알림 | | FCM (Firebase) |
3. 프로젝트 구조
3-1. 레포지토리 전략
| 항목 | 결정값 | 비고 |
|---|
| 레포 구조 | | Monorepo / 멀티 레포 |
| 버전 관리 | | GitHub / GitLab / Bitbucket |
| 브랜치 전략 | | Git Flow / Trunk-based |
3-2. 폴더 구조 (확정 후 기재)
(프로젝트명)/
├── apps/
│ ├── server/ # 백엔드
│ ├── web/ # 웹 프론트엔드
│ └── mobile/ # 모바일
└── packages/
└── shared/ # 공통 타입, 유틸
실제 구조는 레포 전략 결정 후 수정
4. 개발 환경
| 항목 | 결정값 | 비고 |
|---|
| 로컬 환경 구성 | | Docker Compose / 직접 설치 |
| Node 버전 | | |
| 패키지 매니저 | | npm / yarn / pnpm |
| 코드 포맷터 | | Prettier / ESLint |
| 환경 변수 관리 | | .env / AWS Secrets Manager |
5. 배포 환경
| 항목 | 결정값 | 비고 |
|---|
| 클라우드 | | AWS / GCP / Azure / 온프레미스 |
| 서버 배포 방식 | | Docker / EC2 / Lambda |
| 웹 배포 | | Vercel / Netlify / S3+CloudFront |
| 모바일 배포 | | App Store / Play Store |
| CI/CD | | GitHub Actions / Jenkins |
6. 설계 원칙 및 컨벤션
개발 전 팀 내 합의 필요
| 항목 | 결정값 |
|---|
| API 응답 포맷 (공통 구조) | |
| 에러 코드 체계 | |
Soft Delete 정책 (deleted_at vs is_deleted) | |
| 타임존 기준 | |
| 다국어 지원 범위 (i18n) | 한국어 / 영어 |