From 9154c9c0caf3879262bb705ab45c95dfbf845c18 Mon Sep 17 00:00:00 2001
From: kjs <kjs@wace.me>
Date: Wed, 1 Oct 2025 15:03:08 +0900
Subject: [PATCH] =?UTF-8?q?docs:=20=EB=AA=A8=EB=93=A0=20=EB=AC=B8=EC=84=9C?=
 =?UTF-8?q?=EC=97=90=EC=84=9C=20Prisma=20=EC=B0=B8=EC=A1=B0=20=EC=A0=9C?=
 =?UTF-8?q?=EA=B1=B0=20=EB=B0=8F=20Raw=20Query=EB=A1=9C=20=EC=97=85?=
 =?UTF-8?q?=EB=8D=B0=EC=9D=B4=ED=8A=B8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

변경된 파일:

1. DOCKER.md:
   - 기술 스택: Prisma → PostgreSQL (Raw Query)
   - Prisma 관련 섹션 제거
   - 데이터베이스 관련 섹션으로 교체
   - 프로젝트 구조: prisma/ → database/

2. backend-node/Dockerfile.win:
   - npx prisma generate 명령 제거
   - Prisma 클라이언트 생성 단계 삭제

3. backend-node/README.md:
   - ORM: Prisma → Database: PostgreSQL (Raw Query with pg)
   - 프로젝트 구조: prisma/ → database/
   - Prisma 클라이언트 생성 단계 제거
   - npx prisma studio 스크립트 제거
   - 데이터베이스 스키마 변경 가이드 업데이트
   - Phase 1 체크리스트: Prisma → Raw Query

문서 정리 완료:
- ✅ Docker 가이드 업데이트
- ✅ Dockerfile Prisma 명령 제거
- ✅ README 기술 스택 업데이트
- ✅ 개발 가이드 Raw Query로 변경
---
 DOCKER.md                   | 12 ++++++------
 backend-node/Dockerfile.win |  3 ---
 backend-node/README.md      | 31 ++++++++++---------------------
 3 files changed, 16 insertions(+), 30 deletions(-)

diff --git a/DOCKER.md b/DOCKER.md
index e575cb41..1ddad942 100644
--- a/DOCKER.md
+++ b/DOCKER.md
@@ -6,7 +6,7 @@
 
 **기술 스택:**
 
-- **백엔드**: Node.js + TypeScript + Prisma + PostgreSQL
+- **백엔드**: Node.js + TypeScript + PostgreSQL (Raw Query)
 - **프론트엔드**: Next.js + TypeScript + Tailwind CSS
 - **컨테이너**: Docker + Docker Compose
 
@@ -98,12 +98,12 @@ npm install / npm uninstall         # 패키지 설치/제거
 package-lock.json 변경              # 의존성 잠금 파일
 ```
 
-**Prisma 관련:**
+**데이터베이스 관련:**
 
 ```bash
-backend-node/prisma/schema.prisma   # DB 스키마 변경
-npx prisma migrate                  # 마이그레이션 실행
-npx prisma generate                 # 클라이언트 재생성
+db/ilshin.pgsql                    # DB 스키마 파일 변경
+db/00-create-roles.sh              # DB 초기화 스크립트 변경
+# SQL 마이그레이션은 직접 실행
 ```
 
 **설정 파일:**
@@ -207,7 +207,7 @@ ERP-node/
 │   ├── backend-node/
 │   │   ├── Dockerfile                 # 프로덕션용
 │   │   └── Dockerfile.dev             # 개발용
-│   └── src/, prisma/, package.json...
+│   └── src/, database/, package.json...
 │
 ├── 📁 프론트엔드
 │   ├── frontend/
diff --git a/backend-node/Dockerfile.win b/backend-node/Dockerfile.win
index c1ab5ec8..aa14dcc6 100644
--- a/backend-node/Dockerfile.win
+++ b/backend-node/Dockerfile.win
@@ -15,9 +15,6 @@ RUN npm ci
 # 소스 코드 복사
 COPY . .
 
-# Prisma 클라이언트 생성
-RUN npx prisma generate
-
 # 개발 환경 설정
 ENV NODE_ENV=development
 
diff --git a/backend-node/README.md b/backend-node/README.md
index 71eda521..a2d34209 100644
--- a/backend-node/README.md
+++ b/backend-node/README.md
@@ -7,8 +7,7 @@ Java Spring Boot에서 Node.js + TypeScript로 리팩토링된 PLM 시스템 백
 - **Runtime**: Node.js ^20.10.0
 - **Framework**: Express ^4.18.2
 - **Language**: TypeScript ^5.3.3
-- **ORM**: Prisma ^5.7.1
-- **Database**: PostgreSQL ^8.11.3
+- **Database**: PostgreSQL ^8.11.3 (Raw Query with `pg`)
 - **Authentication**: JWT + Passport
 - **Testing**: Jest + Supertest
 
@@ -17,9 +16,9 @@ Java Spring Boot에서 Node.js + TypeScript로 리팩토링된 PLM 시스템 백
 ```
 backend-node/
 ├── src/
-│   ├── config/          # 설정 파일
-│   │   ├── environment.ts
-│   │   └── database.ts
+│   ├── database/        # 데이터베이스 유틸리티
+│   │   ├── db.ts        # PostgreSQL Raw Query 헬퍼
+│   │   └── ...
 │   ├── controllers/     # HTTP 요청 처리
 │   ├── services/        # 비즈니스 로직
 │   ├── middleware/      # Express 미들웨어
@@ -30,9 +29,6 @@ backend-node/
 │   │   └── common.ts
 │   ├── validators/      # 입력 검증 스키마
 │   └── app.ts          # 애플리케이션 진입점
-├── prisma/
-│   └── schema.prisma   # 데이터베이스 스키마
-├── tests/              # 테스트 파일
 ├── logs/               # 로그 파일
 ├── package.json
 ├── tsconfig.json
@@ -59,13 +55,7 @@ PORT=8080
 NODE_ENV=development
 ```
 
-### 3. Prisma 클라이언트 생성
-
-```bash
-npx prisma generate
-```
-
-### 4. 개발 서버 실행
+### 3. 개발 서버 실행
 
 ```bash
 npm run dev
@@ -80,7 +70,7 @@ npm start
 
 ## 📊 데이터베이스 스키마
 
-기존 PostgreSQL 데이터베이스 스키마를 참고하여 Prisma 스키마를 설계했습니다.
+PostgreSQL 데이터베이스를 직접 Raw Query로 사용합니다.
 
 ### 핵심 테이블
 
@@ -146,7 +136,6 @@ npm run test:watch
 - `npm test` - 테스트 실행
 - `npm run lint` - ESLint 검사
 - `npm run format` - Prettier 포맷팅
-- `npx prisma studio` - Prisma Studio 실행
 
 ## 🔧 개발 가이드
 
@@ -160,9 +149,9 @@ npm run test:watch
 
 ### 데이터베이스 스키마 변경
 
-1. `prisma/schema.prisma` 수정
-2. `npx prisma generate` 실행
-3. `npx prisma migrate dev` 실행
+1. SQL 마이그레이션 파일 작성 (`db/` 디렉토리)
+2. PostgreSQL에서 직접 실행
+3. 필요 시 TypeScript 타입 정의 업데이트 (`src/types/`)
 
 ## 📋 마이그레이션 체크리스트
 
@@ -170,7 +159,7 @@ npm run test:watch
 
 - [x] Node.js + TypeScript 프로젝트 설정
 - [x] 기존 데이터베이스 스키마 분석
-- [x] Prisma 스키마 설계 및 마이그레이션
+- [x] PostgreSQL Raw Query 시스템 구축
 - [x] 기본 인증 시스템 구현
 - [x] 에러 처리 및 로깅 설정