빠른 시작 가이드

​

사전 요구 사항

시작하기 전에 시스템에 다음이 설치되어 있는지 확인하세요:

• Docker Engine (20.10.0 이상)
• Docker Compose (v2.0.0 이상)
• OpenSSL (SSL 인증서 생성용)

​

Docker 설치

​

macOS용:

1. Docker Hub에서 Docker Desktop을 다운로드하고 설치
2. 설치 마법사를 따르세요
3. 설치 확인:

docker --version
docker-compose --version

​

Linux (Ubuntu/Debian)용:

sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

설치 확인:

docker --version
docker-compose --version

​

Windows용:

1. Docker Hub에서 Docker Desktop을 다운로드하고 설치
2. 설치 마법사를 따르세요
3. 설치 확인:

docker --version
docker-compose --version

​

로컬 배포

​

1단계: 저장소 복제

git clone https://github.com/casebender/casebender.git
cd casebender

​

2단계: 환경 설정

루트 디렉토리에 .env 파일 생성:

cp .env.example .env

.env 파일을 편집하여 환경 변수 구성:

DB_HOST=postgres
DB_PORT=5432
DB_NAME=casebender
DB_USER=postgres
DB_PASSWORD=your_secure_password

REDIS_HOST=redis
REDIS_PORT=6379

JWT_SECRET=your_jwt_secret_key

​

3단계: 서비스 시작

docker-compose up -d

이 명령은 필요한 모든 서비스를 시작합니다:

• API 백엔드 (Node.js)
• 프론트엔드 (React)
• 데이터베이스 (PostgreSQL)
• Redis (캐시 및 큐용)

​

4단계: 배포 확인

모든 컨테이너가 실행 중인지 확인:

docker-compose ps

모든 서비스가 “Up” 상태인지 확인하세요.

​

5단계: 애플리케이션 접근

• 사용자 인터페이스: http://localhost:3000
• API: http://localhost:8000
• API 문서: http://localhost:8000/api-docs

​

기본 로그인 자격 증명

CaseBender를 배포한 후, 다음 기본 자격 증명으로 로그인할 수 있습니다:

사용자 이름: admin@casebender.app
비밀번호: secret1234

​

초기 설정

​

관리자 계정 생성

docker-compose exec api npm run create-admin

관리자 계정을 생성하기 위한 지침을 따르세요.

​

샘플 데이터 가져오기 (선택 사항)

docker-compose exec api npm run import-sample-data

​

문제 해결

​

로그 확인

문제가 발생하면 컨테이너 로그를 확인하세요:

docker-compose logs -f api
docker-compose logs -f frontend
docker-compose logs -f postgres

​

일반적인 문제

​

데이터베이스 연결 오류

.env 파일의 데이터베이스 자격 증명이 올바른지, PostgreSQL 컨테이너가 실행 중인지 확인하세요:

docker-compose ps postgres

​

권한 문제

Docker 볼륨에 접근할 때 권한 문제가 발생하는 경우:

sudo chown -R $(whoami):$(whoami) ./data

​

다음 단계

이제 CaseBender가 로컬에서 실행 중이므로 다음을 수행할 수 있습니다:

1. 통합 구성
2. 워크플로우 사용자 지정
3. 알림 관리 탐색
4. 케이스 관리 학습