Add AI DEV Node deployment foundation
This commit is contained in:
@@ -322,3 +322,64 @@
|
||||
- `ACS_COOKIE_SECURE`
|
||||
- `ACS_SMS_PROVIDER`
|
||||
- SMTP 또는 사내 메시지 API 설정
|
||||
|
||||
## 2026-07-13
|
||||
|
||||
### Node.js 전환 착수
|
||||
- 사용자가 `C:\ai-dev\workspace\acs - 복사본`에 기존 소스 백업이 있으므로, 원본 `C:\ai-dev\workspace\acs`를 AI DEV 표준 배포 구조로 전환하기로 결정.
|
||||
- 목표:
|
||||
- Spring Boot 백엔드 배포 방식에서 Node.js 앱 배포 방식으로 전환.
|
||||
- DB는 자체 PostgreSQL 컨테이너가 아니라 AI DEV `.project-env`의 `DATABASE_URL` 사용.
|
||||
- 기존 React 프론트와 `/api` 계약은 최대한 유지.
|
||||
- 추가 문서:
|
||||
- `docs/node-migration-plan.md`
|
||||
- 추가된 Node 골격:
|
||||
- 루트 `package.json`, `tsconfig.json`
|
||||
- `server/index.ts`
|
||||
- `server/config/env.ts`
|
||||
- `server/db/pool.ts`
|
||||
- `server/db/migrate.ts`
|
||||
- `server/http/apiResponse.ts`
|
||||
- `server/http/errors.ts`
|
||||
- `server/routes/health.ts`
|
||||
- `server/routes/index.ts`
|
||||
- Flyway SQL을 Node migration 구조로 1차 이관:
|
||||
- `migrations/001_init.sql`
|
||||
- `migrations/002_audit_log.sql`
|
||||
- `migrations/003_pass_delivery.sql`
|
||||
- `migrations/004_visit_request_contact_fields.sql`
|
||||
- 검증:
|
||||
- `npm install` 완료.
|
||||
- `npm run typecheck` 성공.
|
||||
- `npm audit --omit=dev` 결과 운영 의존성 취약점 0건.
|
||||
- `npm run build` 성공. 단, 로컬 PC 권한 정책상 프론트 `esbuild`는 승인 권한으로 실행 필요.
|
||||
- `node dist/server/index.js` 기동 후 `GET /api/health` 응답 확인.
|
||||
- 정적 React build(`/`) 응답 200 확인.
|
||||
- 다음 작업:
|
||||
- Auth/session/role middleware 구현.
|
||||
- PostgreSQL session store 연결.
|
||||
- 사용자 seed 전략 확정.
|
||||
- `/api/auth/login`, `/api/auth/logout`, `/api/auth/me`, `/api/auth/change-password`부터 Spring 기능 parity 구현.
|
||||
|
||||
### AIdev.md 배포 가이드 준수 보완
|
||||
- `docs/AIdev.md` 기준 ACS 배포 필수 항목을 재점검.
|
||||
- 보완 사항:
|
||||
- 루트 `Dockerfile` 추가. AI DEV Coolify/Kubero Dockerfile build pack 기준으로 빌드.
|
||||
- 루트 `.dockerignore` 추가.
|
||||
- Node engine 기준을 `>=22`로 조정.
|
||||
- `/healthz` 추가: `{"ok": true}` 응답.
|
||||
- `/db` 추가: `DATABASE_URL`로 PostgreSQL `SELECT now()` 점검.
|
||||
- `/s3` 추가: ACS는 S3/MinIO 미사용이므로 skip 응답.
|
||||
- `npm run db:check` 추가: `.project-env`/`.env` 로드 후 DB 점검.
|
||||
- `npm run minio:check` 추가: ACS S3 미사용 skip 출력.
|
||||
- `npm run start:deploy` 추가: migration 적용 후 Node 서버 기동.
|
||||
- `CLAUDE.md` 추가: AI DEV 배포 제약과 ACS 전환 규칙 명시.
|
||||
- 검증:
|
||||
- `npm run typecheck` 성공.
|
||||
- `npm audit --omit=dev` 운영 의존성 취약점 0건.
|
||||
- `npm run build` 성공. 이 PC에서는 esbuild 실행 정책 때문에 승인 권한 필요.
|
||||
- `GET /healthz` 정상.
|
||||
- `GET /api/health` 정상.
|
||||
- `GET /s3` skip 응답 정상.
|
||||
- `GET /db`는 현재 Windows 로컬에 `DATABASE_URL`이 없어 500과 명확한 오류 메시지를 반환. AI DEV/Coder에서 `.project-env` 로드 후 재검증 필요.
|
||||
- `docker build -t acs-node-guide-check .`는 Docker daemon 미기동(`dockerDesktopLinuxEngine` pipe 없음)으로 실행 전 실패. Docker Desktop 또는 AI DEV/Coder 배포 환경에서 재검증 필요.
|
||||
|
||||
Reference in New Issue
Block a user