docs: record Node deployment constraint

This commit is contained in:
unknown
2026-07-10 16:51:49 +09:00
parent 98b7f117b5
commit 6abcee3727

View File

@@ -272,6 +272,21 @@
- 자체 DB 컨테이너 대신 플랫폼 제공 PostgreSQL 접속정보(`DATABASE_URL`)를 쓰는 구조로 변경 검토.
- ACS용 `CLAUDE.md` 또는 동등한 작업 규칙 문서를 추가해 Claude/Codex 협업 기준을 명시하는 방안 검토.
### AI DEV 배포 제약 확정
- 인프라 담당자 확인 결과:
- 배포 앱은 Node.js 앱만 허용.
- DB는 반드시 Coder/AI DEV 환경의 `.project-env`에 제공되는 `DATABASE_URL`을 사용해야 함.
- 영향:
- 현재 Spring Boot 백엔드(`backend/`)는 AI DEV 표준 배포 대상이 아님.
- 현재 `infra/docker-compose.yml`의 자체 PostgreSQL 컨테이너 방식은 표준 배포 방식과 맞지 않음.
- ACS를 배포하려면 Node.js 기반 서버/API로 전환하거나, Node.js 배포 앱이 기존 기능을 대체하도록 재구성해야 함.
- 권장 전환 방향:
- React 프론트엔드는 유지 가능.
- 백엔드는 Node.js(Express/Fastify 등)로 재작성 검토.
- DB 접속은 `process.env.DATABASE_URL` 사용.
- 기존 Flyway SQL은 Node 앱 시작/배포 시 적용 가능한 SQL migration 방식으로 재활용 검토.
- 배포 산출물은 단일 Node.js 앱 또는 Node.js + 정적 프론트 서빙 구조로 단순화하는 방향을 우선 검토.
### 인증서 확인
- `infra/certs/fullchain.pem`, `infra/certs/privkey.pem` 존재 확인.
- 현재 인증서는 `CN=localhost`, SAN도 `localhost`, `127.0.0.1`용임.