> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 여러 아티팩트 vs. 별도 프로젝트

> Replit에서 아티팩트를 하나의 프로젝트에 합칠 때와 별도 프로젝트를 만들 때를 알아보세요.

[프로젝트](/references/projects-and-artifacts/projects)는 Replit에서 빌드하는 모든 것의 컨테이너입니다. 프로젝트에는 디자인, 앱, 슬라이드, 데이터, 그리고 생성하는 모든 결과물이 담겨 있습니다.
[아티팩트](/references/projects-and-artifacts/artifacts)는 프로젝트 내의 게시 가능한 결과물입니다: 웹 앱, 모바일 앱, 슬라이드 덱, 비디오.

두 가지 이상을 빌드할 때는 두 가지 선택지가 있습니다:

* 하나의 프로젝트에 여러 아티팩트를 추가하거나,
* 별도의 프로젝트를 만드는 것입니다.

올바른 선택은 앱이 데이터, 로직, 배포 주기를 공유하는지 여부에 따라 달라집니다. 이 가이드에서는 아티팩트를 단일 프로젝트에 유지할 때와 별도로 만들 때를 다룹니다.

## 프로젝트에서 아티팩트가 공유하는 것

[아티팩트](/references/projects-and-artifacts/artifacts)가 같은 [프로젝트](/references/projects-and-artifacts/projects)에 있으면 자동으로 다음을 공유합니다:

* **데이터베이스**: 하나의 아티팩트가 데이터를 작성하면 나머지가 즉시 읽을 수 있습니다
* **백엔드 및 API**: 공유 서버 로직, 코드 중복 없음
* **파일 스토리지**: 아티팩트 전반에서 접근 가능한 이미지, 문서, 업로드 파일
* **배포**: 게시하면 모든 것이 동기화되어 함께 배포됩니다

즉, 아티팩트 간에 연결을 설정하거나 코드를 중복할 필요가 없습니다. 하지만 하나의 아티팩트만 게시하고 나머지는 게시하지 않을 수는 없습니다.

## 빠른 가이드

기존 프로젝트에 아티팩트를 추가할지 별도의 프로젝트를 만들지 결정할 때 고려해야 할 주요 시나리오입니다.

| **하나의 프로젝트에 여러 아티팩트 사용**               | **별도 프로젝트 사용**                   |
| -------------------------------------- | -------------------------------- |
| 앱이 동일한 데이터와 백엔드를 공유할 때                 | 앱이 기본 로직이나 데이터를 공유하지 않을 때        |
| 모든 것을 함께 배포하고 싶을 때                     | 독립적인 배포 주기가 필요할 때                |
| 상호 보완적인 앱일 때 (예: 고객 앱과 관리자 대시보드)       | 관련 없는 제품이거나 다른 클라이언트를 위한 것일 때    |
| 하나의 아티팩트 변경사항이 다른 아티팩트에 자동으로 반영되길 원할 때 | 캠페인 랜딩 페이지나 이벤트 사이트처럼 단기 프로젝트일 때 |

## 예시

### 같은 프로젝트: 하나의 제품을 위한 웹 앱 + 모바일 앱

레스토랑이 고객이 메뉴를 탐색할 수 있는 웹 앱과 직원이 주문을 관리할 수 있는 모바일 앱을 빌드합니다. 두 앱 모두 메뉴 항목, 주문, 고객 정보의 동일한 데이터베이스에 연결됩니다.

**하나의 프로젝트인 이유:** 앱이 동일한 데이터와 백엔드를 공유합니다. 고객이 웹 앱을 통해 주문하면 직원이 모바일 앱에서 즉시 확인할 수 있습니다.

### **같은 프로젝트**: 앱 + 관리자 대시보드 + 투자자 피치 덱

스타트업이 주요 제품, 콘텐츠 관리를 위한 내부 관리 패널, 펀드레이징을 위한 슬라이드 덱 — 모두 하나의 프로젝트에 빌드합니다.
스타트업이 주요 제품, 콘텐츠 관리를 위한 내부 관리 패널, 펀드레이징을 위한 슬라이드 덱 — 모두 하나의 프로젝트에 빌드합니다.

**하나의 프로젝트인 이유:** 관리자 대시보드는 앱이 표시하는 것과 동일한 데이터를 관리하고, 피치 덱은 공유 백엔드의 실시간 지표를 참조할 수 있습니다.

### **별도 프로젝트**: 관련 없는 두 클라이언트 앱

프리랜서가 한 클라이언트를 위한 이커머스 스토어와 다른 클라이언트를 위한 예약 시스템을 빌드합니다.

**별도 프로젝트인 이유:** 앱에 공유 데이터나 로직이 없습니다. 각 클라이언트는 독립적인 배포가 필요하며 한쪽의 변경사항이 다른 쪽에 영향을 미치지 않아야 합니다.

### **별도 프로젝트**: 주요 제품과 함께 운영되는 캠페인 랜딩 페이지

연중 운영되는 프로덕션 앱과 마케팅 캠페인을 위한 단기 랜딩 페이지가 있습니다.

**별도 프로젝트인 이유:** 캠페인 페이지는 자체 라이프사이클이 있습니다 — 몇 주 동안 운영했다가 종료합니다. 별도로 유지하면 주요 제품이 복잡해지지 않고 독립적으로 게시하거나 제거할 수 있습니다.

## 자주 묻는 질문

<Accordion title="아티팩트를 다른 프로젝트로 이동할 수 있나요?">
  현재는 불가능합니다. 아티팩트를 분리해야 한다면 새 [프로젝트](/references/projects-and-artifacts/projects)를 만들고 Agent에게 거기서 다시 빌드하도록 요청하세요.
</Accordion>

<Accordion title="프로젝트에 담을 수 있는 아티팩트 수에 제한이 있나요?">
  프로젝트는 최대 **7개의 아티팩트**를 담을 수 있습니다. 추가 아티팩트는 더 많은 메모리를 소비해 미리 보기가 느려질 수 있기 때문에 이 제한이 존재합니다. 더 많은 아티팩트가 필요하면 다른 [프로젝트](/references/projects-and-artifacts/projects)를 시작하세요.
</Accordion>

<Accordion title="프로젝트에서 아티팩트 하나만 게시할 수 있나요?">
  현재는 불가능합니다. 게시하면 모든 것이 함께 배포됩니다. 독립적인 배포가 필요하면 별도의 프로젝트를 사용하세요.
</Accordion>