Skip to content

chore(env): Cloud Agent 개발 환경 설정 추가 - #62

Draft
ghandhitechnology wants to merge 1 commit into
mainfrom
cursor/setup-dev-environment-66e1
Draft

chore(env): Cloud Agent 개발 환경 설정 추가#62
ghandhitechnology wants to merge 1 commit into
mainfrom
cursor/setup-dev-environment-66e1

Conversation

@ghandhitechnology

Copy link
Copy Markdown
Owner

개요

Cloud Agent가 인텍트 저장소를 바로 개발·구동할 수 있도록 .cursor/ 개발 환경 설정을 추가합니다. Docker가 없는 Cloud Agent VM 환경에 맞춰, AGENTS.md의 "소스 직접 실행" 경로를 재현합니다(PostgreSQL·Redis·MinIO를 VM에 네이티브로 기동).

변경 사항

  • .cursor/environment.jsoninstall/start 단계와 web·realtime terminals 정의
  • .cursor/install.sh (idempotent)
    • 시스템 패키지 설치: PostgreSQL 16, Redis, python3-venv(verify의 riro-bridge 검증용), MinIO 서버/클라이언트 바이너리
    • corepack yarn 활성화, client·server/chat 의존성 설치, Prisma client 생성
    • 개발용 client/.env 생성(없을 때만, 무작위 비밀값 — 운영 값 미사용)
    • Web standalone 프로덕션 빌드 + static/public 복사, realtime tsc 빌드
  • .cursor/start.sh (idempotent)
    • PostgreSQL/Redis/MinIO 기동, igwak role·db·igwak-uploads 버킷 보장
    • prisma migrate deploy

설계 노트

  • dev 서버 대신 프로덕션 빌드 실행: 앱 CSP(next.config.js)가 script-srcunsafe-eval을 허용하지 않아 next dev의 HMR이 브라우저에서 차단되어 UI가 로딩 화면에서 멈춥니다. docker-compose와 동일하게 standalone 프로덕션 빌드(node .next/standalone/server.js)를 실행해 CSP를 유지하면서 UI가 정상 렌더링됩니다. 앱 코드/CSP는 수정하지 않았습니다.
  • .cursor/ 외 저장소 코드 변경은 없습니다.

검증

  • bash scripts/verify.sh 전체 게이트 통과(Prisma validate → migration → lint → typegen → typecheck → 테스트 → Next 프로덕션 빌드 → realtime 빌드 → moderation 구문 → riro-bridge venv/pip check/unittest).
  • install.sh·start.sh 재실행 시 idempotent 동작 확인.
  • Web /api/health = {"status":"ok"}, realtime /health = {"ok":true,...,"redis":"ready"}.
  • 관리자 로그인 API 및 브라우저 UI 로그인 end-to-end 성공(초기 비밀번호 변경 화면으로 정상 이동), PostgreSQL에 기본 게시판 6개·admin 계정·36개 테이블 생성 확인.
Open in Web Open in Cursor 

- .cursor/environment.json: install/start 단계와 web/realtime terminals 정의
- .cursor/install.sh: 시스템 패키지(PostgreSQL/Redis/MinIO), 의존성, Prisma
  client 생성, Web standalone 프로덕션 빌드, realtime 빌드 (idempotent)
- .cursor/start.sh: PostgreSQL/Redis/MinIO 기동, role/db/bucket 보장,
  prisma migrate deploy (idempotent)

dev 서버는 앱 CSP가 unsafe-eval을 허용하지 않아 HMR이 막히므로 운영과 동일한
standalone 프로덕션 빌드를 실행합니다.

Co-authored-by: Andy  <heemang12bo@gmail.com>
@coderabbitai

coderabbitai Bot commented Aug 26, 2026

Copy link
Copy Markdown

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

Comment @coderabbitai help to get the list of available commands.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants