refboard/프로젝트
최근 수정 시각: 2026-07-11 00:13:16
1. 무엇을 하나
프로젝트는 refboard의 최상위 작업 단위다. GDD 문서와 폴더는 모두 하나의 프로젝트에 속한다. 홈은 프로젝트를 최근 수정 순 카드로 보여주며 카드에는 이름, 설명, 식별 색과 마지막 업데이트 상대 시간이 표시된다.
2. 로그인
라이브 주소로 접속하면 먼저 Clerk 로그인 게이트가 나온다. Apple·Google 또는 이메일 방식이 표시되며, 인증을 통과한 뒤에야 프로젝트 홈으로 들어간다. 공개 스크린샷은 이 게이트까지만 확인된 것이므로 내부 데이터가 공개되어 있다고 오해하면 안 된다.
3. 새 프로젝트 만들기
- 로그인 뒤 홈 상단의 + 새 프로젝트를 누른다.
- 게임이나 IP 이름을 입력한다. 이름은 필수이며 최대 100자다.
- 필요하면 한 줄 콘셉트를 설명에 입력한다. 설명은 최대 400자다.
- 여섯 개 색 중 프로젝트를 구분할 색을 고른다.
- 만들기를 누른다.
생성이 끝나면 새 프로젝트의 /p/<id> 작업 공간으로 바로 이동한다. 프로젝트가 하나도 없으면 “첫 프로젝트를 만들어봐” 안내가 표시된다.
4. 프로젝트 열기
홈의 프로젝트 카드를 선택한다. 카드는 데이터베이스의 updated_at 기준 최신순으로 정렬된다. 색 점은 여러 프로젝트를 빠르게 구분하는 용도이고, 설명은 카드 본문에 표시된다.
프로젝트 안에서는 좌측 문서 트리가 실제 작업의 시작점이다. 새 프로젝트를 만든 뒤 바로 루트 폴더와 첫 문서를 만드는 흐름이 가장 단순하다.
5. 팁과 주의
- 프로젝트 이름은 게임/IP 단위로 짓고, 기능·시스템은 그 아래 폴더로 나누면 Markdown 임포트와 구조를 맞추기 쉽다.
- 현재 홈 UI 소스에는 프로젝트 삭제 버튼이 노출돼 있지 않다. 데이터 정리가 필요하다고 임의로 API를 호출하지 말고 저장소의 현재 관리 흐름을 확인한다.
- 라이브 로그인 게이트가 개발 모드로 표시될 수 있다. 인증 설정과 프로덕션 공개 범위는 앱 운영 설정에서 별도로 관리한다.