gh_mirrors/co/community-platform은 다양한 문제를 해결하기 위한 커뮤니티를 신속하게 구축할 수 있도록 설계된 강력한 오픈 소스 플랫폼입니다. 이 가이드를 통해 개발 환경 설정부터 첫 커뮤니티 생성까지의 전 과정을 단 몇 분 안에 완료하고, 이 유용한 커뮤니티 구축 도구를 활용하는 방법을 습득할 수 있습니다.

1. 빠른 설치: 3단계 환경 설정

1.1 프로젝트 저장소 클론

먼저 터미널을 열고 다음 명령어를 실행하여 프로젝트 저장소를 로컬에 복제합니다.

git clone https://gitcode.com/gh_mirrors/co/community-platform
cd community-platform

1.2 프로젝트 의존성 설치

프로젝트는 Yarn을 사용하여 패키지를 관리합니다. 다음 명령어를 실행하여 모든 의존성을 설치합니다.

yarn install

1.3 개발 서버 실행

설치가 완료되면 다음 명령어를 실행하여 로컬 개발 서버를 시작합니다.

yarn start

서버가 성공적으로 시작되면 브라우저에서 http://localhost:3000에 접속하여 프로젝트 홈 페이지를 확인할 수 있습니다.

2. 데이터베이스 초기화: Supabase 설정

2.1 Supabase 이해하기

이 프로젝트는 PostgreSQL 기반의 오픈 소스 Firebase 대안인 Supabase를 백엔드 데이터베이스로 활용합니다. 더 자세한 정보는 공식 문서(docs/supabase.md)를 참조하십시오.

2.2 데이터베이스 초기화

다음 명령어를 실행하여 데이터베이스를 초기화하고 마이그레이션 스크립트를 실행합니다.

yarn db:seed

이 명령어는 필요한 데이터베이스 테이블 구조를 생성하고 초기 데이터를 추가합니다. 심층적인 데이터베이스 작업이 필요한 경우 docs/db-seeding.md를 참고할 수 있습니다.

3. 첫 커뮤니티 생성: 간단한 3단계

3.1 계정 등록 및 로그인

프로젝트 홈 페이지에서 "Sign Up" 버튼을 클릭하고 필요한 정보를 입력하여 등록을 완료합니다. 등록 성공 후 해당 계정으로 시스템에 로그인합니다.

3.2 커뮤니티 생성 페이지 접속

로그인 후, 상단 내비게이션 바의 "Create" 버튼을 클릭하고 "Community" 옵션을 선택하여 커뮤니티 생성 페이지로 이동합니다.

3.3 커뮤니티 정보 입력 및 제출

커뮤니티 생성 양식에 커뮤니티 이름, 설명, 커버 이미지 업로드 등 필요한 정보를 입력합니다. 작성을 완료한 후 "Create Community" 버튼을 클릭하여 제출합니다.

4. 커뮤니티 관리의 기본

4.1 멤버 초대

커뮤니티 생성 후 "Invite Members" 기능을 통해 다른 사용자를 커뮤니티에 초대하여 함께 커뮤니티를 구축할 수 있습니다.

4.2 콘텐츠 게시

커뮤니티 홈 페이지에서 "New Post" 버튼을 클릭하여 글, 토론 주제 등 다양한 콘텐츠를 게시하고 커뮤니티 멤버들과 소통할 수 있습니다.

4.3 커뮤니티 설정

커뮤니티 설정 페이지를 통해 권한 설정, 외관 테마 등 다양한 커뮤니티 파라미터를 조정하여 독특한 커뮤니티 공간을 만들 수 있습니다.

5. 일반적인 문제 해결

5.1 서버 시작 실패

yarn start 실행 후 서버가 시작되지 않는다면, 최신 버전의 Node.js와 Yarn이 설치되어 있는지 확인하거나, node_modules 디렉토리를 삭제한 후 의존성을 다시 설치해 보십시오.

5.2 데이터베이스 연결 문제

데이터베이스 연결 실패는 주로 Supabase 설정이 올바르지 않아 발생합니다. docs/supabase.md의 지침에 따라 Supabase 인스턴스를 정확히 구성했는지 확인하십시오.

5.3 커뮤니티 생성 후 목록에 나타나지 않음

커뮤니티를 생성한 후 목록에 보이지 않는다면, 페이지를 새로고침하거나 네트워크 연결을 확인해 보십시오. 문제가 계속되면 브라우저 콘솔에서 오류 메시지를 확인하시기 바랍니다.