관리자 패널
모든 게시된 Proyecta 앱에는 관리자 패널이 포함됩니다 — 코드를 건드리지 않고 콘텐츠와 양식 제출을 관리할 수 있는, 로그인으로 보호된 비공개 백오피스입니다.
앱의 공개 화면은 브랜드에 맞게 맞춤 제작됩니다. 그 뒤에는 모든 앱에 동일하게 필요한, 단순하지만 꼭 필요한 백오피스가 있습니다. 콘텐츠를 편집하고, 문의를 검토하고, 일상적인 운영을 처리하는 공간이죠. Proyecta는 스키마 기반의 템플릿 소유 컴포넌트로 이를 자동으로 구성해 주므로, 모든 앱에서 일관되고 올바르게 유지됩니다 — 그리고 AI가 CRUD 화면을 수작업으로 만들어 주기를 기다릴 필요도 없습니다.
관리할 수 있는 항목
섹션 제목: “관리할 수 있는 항목”| 섹션 | 기능 | 상태 |
|---|---|---|
| 콘텐츠 | 각 컬렉션의 항목을 생성, 편집, 게시, 보관 | 사용 가능 |
| 양식 제출 | 양식에서 받은 제출 내용을 검토, 읽음 표시, 보관 | 사용 가능 |
| 커머스 주문 | 스토어의 주문 검토 및 처리 | 사용 가능 |
| 멤버 / 사용자 | 앱에 로그인한 사용자와 그 역할 관리 | 사용 가능 |
어떤 섹션이 보이는지는 앱이 무엇을 하는지에 따라 달라집니다 — 패널이 앱의 실시간 구조를 읽어 해당되는 것만 렌더링합니다. 스토어가 없는 앱에는 주문 섹션이 없습니다.
접근 권한
섹션 제목: “접근 권한”관리자 패널은 RBAC 기반으로 보호됩니다. 패널에 접근하려면 admin 계정으로 로그인해야 하며, 모든 관리자 작업은 UI에서 숨기는 것에 그치지 않고 서버에서 직접 검증됩니다.
관리자 권한은 앱을 만들 때 지정한 이메일에 부여되며, ID 공급자에서 인증된 주소와 대조됩니다. 먼저 로그인한 사람에게 주어지는 것이 아닙니다. 일반적인 앱에서는 첫 방문자를 포함한 나머지 모두가 일반 사용자로 로그인합니다. 로그인 방식과 역할 부여 방법은 Users & Auth를 참고하세요.
구성 요소
섹션 제목: “구성 요소”패널은 템플릿 소유 컴포넌트로 구성됩니다. 직접 작성할 필요는 없습니다 — 모든 앱에 기본으로 포함됩니다 — 하지만 주요 컴포넌트의 역할을 알아두면 도움이 됩니다.
| 컴포넌트 | 제공 기능 |
|---|---|
CollectionManager |
하나의 컬렉션을 위한 완전한 관리 화면: 검색 및 정렬이 가능한 목록과 자동 생성된 생성/편집 폼. 컬렉션당 하나씩 존재합니다. |
SubmissionsInbox |
양식 수신함: 새 항목 / 읽음 / 보관 탭, 읽지 않은 항목 배지, 그리고 제출 항목별 상세 보기. |
AdminShell |
전체를 감싸는 크롬 — 섹션들을 연결하는 접을 수 있는 사이드바와 상단 바. |
CollectionManager: 스키마로부터 자동 CRUD
섹션 제목: “CollectionManager: 스키마로부터 자동 CRUD”CollectionManager는 컬렉션의 스키마를 읽어 거의 수작업 코드 없이 전체 편집 경험을 구성합니다.
- 항목 목록 표시 — 상태 배지, 검색, New 버튼이 있는 테이블로 표시합니다.
- 폼 자동 생성 — 각 필드의 타입에 따라 텍스트 필드는 input, 긴 텍스트는 textarea, 숫자는 number input, 켜기/끄기 값은 스위치, 선택 필드는 드롭다운, 날짜는 날짜 선택기, 참조 필드는 연결된 컬렉션 위의 picker, 이미지 필드는 업로드 버튼(미디어 라이브러리 picker와 URL 붙여넣기 대체 방식 포함)으로 생성합니다.
- 초안으로 먼저 저장 — 게시는 명시적인 별도 작업으로, 실수로 라이브에 반영되는 일이 없습니다. 항목을 게시 취소하거나 보관할 수도 있습니다 (보관은 소프트 삭제 — 앱과 패널에서 사라지지만 실제로 삭제되지는 않습니다).
- 단일 콘텐츠도 처리 — 싱글톤 컬렉션(예: 비즈니스 정보)은 목록 없이 폼을 바로 렌더링합니다.
편집은 진정한 노코드 방식입니다. 패널에서 텍스트, 가격, 사진, 운영 시간을 변경하고 게시하면 라이브 앱이 바로 업데이트됩니다.
참고: 커머스 상품은 카탈로그가 콘텐츠이더라도
CollectionManager가 아닌 커머스 도구로 관리합니다. Commerce를 참고하세요.
관리자 패널이 구성되는 방식
섹션 제목: “관리자 패널이 구성되는 방식”따로 요청할 필요도 없고, AI가 직접 만들어 주는 것도 아닙니다. 이 패널은 “자동 구성되는 통합 관리자 패널“입니다. 모든 앱의 템플릿에 내장된 고정 /admin이 앱의 라이브 콘텐츠 스키마와 기능 설정을 읽어 스스로 렌더링합니다 — AI 연결 작업 없이. 나중에 새 컬렉션을 추가하면 다시 빌드할 필요 없이 자동으로 나타납니다.
콘텐츠와 양식 제출 외에도, 앱이 실제로 하는 일에 맞춰 섹션이 나타납니다 — 주문과 반품, 예약과 일정 관리, 멤버와 역할, 미디어 라이브러리, 이메일과 푸시. 앱에 해당하는 것만 제공되고, 해당하지 않는 것은 제공되지 않습니다.
템플릿이 소유하는 구성이기 때문에 모든 앱에서 일관되고 올바르게 유지되며, AI가 공개 페이지를 수정하더라도 어긋나거나 망가지지 않습니다. 나중에 콘솔 자체를 바꾸고 싶다면 요청하세요 — 그것은 명시적인 수정이며, 첫 빌드가 알아서 처리해 버리는 작업이 아닙니다.
자주 사용되는 패턴
섹션 제목: “자주 사용되는 패턴”관리자 패널 자체를 요청할 필요는 전혀 없습니다. 모든 앱에 기본으로 포함되며, 새 컬렉션도 알아서 그곳에 나타납니다. AI에게 요청할 만한 것은 다음과 같습니다.
"홈페이지에 표시할 항목을 고를 수 있도록 서비스에 '추천' 토글을 추가해 줘."— 새 필드는 관리자 패널에 자동으로 나타납니다."홈페이지의 헤드라인과 영업 시간을 관리자 패널에서 편집할 수 있게 해줘."— 하드코딩된 문구를 콘텐츠로 옮깁니다."이번 주 예약을 한눈에 볼 수 있는 백오피스 페이지를 만들어 줘."— 동일한 구성 요소로 조립한 맞춤 페이지입니다.
관련 문서
섹션 제목: “관련 문서”- Content Management — 관리자 패널에서 편집하는 컬렉션과 항목.
- Forms — 제출 수신함의 원본.
- Users & Auth — 로그인 방식과 관리자 역할 부여 방법.
- Commerce — 카탈로그와 주문 관리.