의존성과 워크트리

앱은 격리된 PostgreSQL, 관리형 결제 mock, 공유 로컬 검색과 원격 API를 함께 사용할 수 있습니다. 기본 체크아웃의 .redpact/settings.json에 이 고정 구성을 한 번 정의하고 연결된 모든 워크트리가 공유합니다. 의존성은 연동 서비스이며 Docker 빌드에서 설치하는 npm 패키지 목록이 아닙니다.

종류 이름만으로 소프트웨어가 설치되거나 mock이 구현되지는 않습니다. 실제 동작하는 연결만 선언하세요. 의존성마다 고정 정의 하나를 사용하며 선택 가능한 모드나 추천은 없습니다. 기본 설정이 시작 서비스·의존성 서비스·바인딩을 제공하고 Compose 선행 의존성이 서비스 집합을 확장합니다. 변수 바인딩만으로 대상 서비스를 시작하지 않습니다.

flowchart TD
    S["하나의 공유 설정 파일"] --> A["시작 애플리케이션 서비스"]
    S --> D["고정 의존성 정의"]
    D -->|"애플리케이션 환경 변수 바인딩"| A
    S -->|"tests.env"| R["Integration / Playwright 러너"]
    R -->|"요청과 assertion"| A

개요 읽기

관계도에서 노드를 선택하면 이름, 앱/의존 서비스 유형, 설정된 종류와 작성된 설명을 확인할 수 있습니다. Compose 서비스는 개수와 함께 접힌 상태로 표시됩니다. 사용하는 서비스(Used by)와 의존하는 서비스(Uses)는 관계 수, 상대 서비스의 이름과 유형을 보여주며 관계 설명은 항상 표시합니다. 코드 근거를 펼치면 전체 경로와 지정된 줄 번호를 볼 수 있습니다. 이는 작성된 소스 참조이며 관찰된 실행 결과가 아닙니다. 빈 관계는 작성된 관계가 없다는 뜻입니다.

앱 상세는 상세 영역 너비가 640px 이상이면 두 방향의 관계를 나란히 배치하고, 좁은 화면에서는 세로로 배치합니다. 관계도와 서비스 상세는 공통 768px 읽기 영역 하나를 가운데 배치하여 폭과 왼쪽 시작선을 맞춥니다. 설정 목록도 같은 읽기 폭 기준을 적용하며 텍스트는 왼쪽 정렬을 유지합니다. 큰 관계도는 글자를 축소하지 않고 읽기 영역 안에서 스크롤합니다. 의존 서비스는 사용하는 서비스만 전체 폭으로 표시합니다. 노드와 접기 버튼은 키보드로 조작할 수 있으며 노드 선택은 포커스를 이동하거나 코드를 실행하지 않습니다. 없는 설명을 추측하지 않으며 설정과 종류는 준비 상태, 연결 성공이나 승인을 입증하지 않습니다.

공통 설정과 독립 실행

rulesRoot는 공통 설정 위치입니다. Compose·Dockerfile·앱·테스트 경로는 실행하는 체크아웃에서 해석하므로 기능 작업은 자신의 코드를 사용합니다. 실행마다 새 컨테이너와 네트워크를 소유합니다. 설정 공유가 환경 재사용을 허용하지는 않습니다. 워크트리 선택 파일과 의존성 overlay는 실행에 영향을 주지 않습니다.

실제 체크아웃으로 redpact settings validate --scope project --path /absolute/checkout을 실행하세요. 검증은 서비스를 시작하거나 연결을 입증하거나 승인을 부여하지 않습니다. 실행은 설정을 캡처하고 리소스 준비·상태 확인· 테스트 후 자신의 리소스만 제거합니다. 독립적으로 운영되는 공유·원격 서비스는 계속 실행되므로 테스트가 fixture 데이터를 격리해야 합니다.

앱 바인딩과 공통 러너 환경은 별도로 명시합니다. Integration과 Playwright 모두 tests.env와 같은 연결 파일 형식을 받습니다. 선언은 설정, DNS· 공유 호스트 접근·브라우저 origin은 러너 연결을 보세요.

에이전트에게 요청하기

앱의 DB·캐시·외부 API 연결을 조사해줘. 모든 워크트리가 공유하는 고정 Redpact 구성을 작성하고 실제 소비자에서 각 연결을 검증해줘. 설정 검증과 런타임 증거를 구분해줘.

프로젝트 설정 또는 첫 변경 검토로 이어가세요.