CLIVING Setup 문서

요구사항

Python 3.11.9
Django == 5.0.3
moviepy==1.0.3
pillow==10.3.0
mediapipe==0.10.14
opencv-contrib-python==4.9.0.80
opencv-python == 4.9.0.80
yolov8
ultralytics
psycopg2-binary==2.9.9 # postgreSQL 16.2

설치 및 실행 방법

가상환경 세팅

virtualenv venv

또는

python -m venv venv

명령어를 활용하여 가상환경을 만들어 줍니다.

source venv/bin/activate

명령어를 활용하여 가상환경을 활성화 시켜줍니다.

secrets.json 설치하기

.../cliving/page/

위 위치에 secrets.json 을 설치합니다.

postgreSQL DB 설치

https://www.postgresql.org/download/ # 원하는 버전을 설치합니다.
# 설치 과정에서 입력하는 superuser의 비밀번호를 잘 기억해야 합니다.

웹에서 postgreSQL을 설치하고 초기 비밀번호를 설정합니다.
설치된 SQL Shell을 실행하여 엔터를 몇번 누른 뒤, 패스워드 입력란에 초기 비밀번호를 입력합니다.

postgreSQL과 장고 연동하기

CREATE DATABASE ('데이터베이스 이름');
CREATE USER ('유저명') WITH PASSWORD ('비밀번호');
ALTER ROLE ('유저명') SET client_encoding TO 'utf8';
ALTER ROLE ('유저명') SET default_transaction_isolation TO 'read committed';
ALTER ROLE ('유저명') SET TIME ZONE 'Asia/Seoul';
GRANT ALL PRIVILEGES ON DATABASE data_planet_db TO root;
ALTER USER ('유저명') SUPERUSER;

secrets.json 파일에 설정되어 있는 '데이터베이스 이름', '유저명', '비밀번호'를 보고
위 명령어를 차례로 SQL Shell 에서 실행합니다.

postgreSQL이 작동을 멈추었을 경우(Windows)

윈도우 로고 우클릭 > 컴퓨터 관리 > 서비스 및 응용 프로그램 > 서비스 > postgresql-x64-16 을 찾아 우클릭 > 시작

윈도우 최적화 프로그램 등을 사용했을 때, 콘솔이 꺼지는 듯 합니다.
꺼지면 python manage.py runserver가 동작하지 않으므로 오류 발생시 잘 켜주도록 합시다.

의존성 패키지 설치

pip install -r requirements.txt

동봉되어있는 requirements.txt를 활용하여 의존성 패키지를 설치하여 줍니다.

데이터베이스 postgreSQL 설치 및 Django 연동

https://seokii.tistory.com/199 
URL 참조

데이터베이스 초기화

python manage.py makemigrations
python manage.py migrate

위 명령어를 활용하여 데이터베이스를 초기화해 줍니다.
makemigrations 명령어를 실행시키면 각 앱별로 데이터베이스 마이그레이션 파일들이 생성되니
git을 활용할 때, 이때 만들어지는 마이그레이션 파일들도 푸시해 줍니다.

테스트 데이터 추가

python manage.py create_page

위 명령어를 활용하여 데이터페이스에 테스트를 위한 여러 페이지를 자동 생성합니다. 이를 통계 api 활용에 사용할 수 있습니다.

로컬 서버 실행

python manage.py runserver

API 관리 페이지 접속

http://127.0.0.1:8000/v1/

해당 URL로 접속하여 api를 확인하고 사용할 수 있습니다.

프로젝트 구성

cliving-back/
- .github/
- cliving/
  - cliving/
    - init.py
    - asgi.py: ASGI 설정 파일입니다.
    - settings.py: Django 프로젝트 설정 파일입니다.
    - urls.py: URL 라우팅 설정 파일입니다.
    - wsgi.py: WSGI 설정 파일입니다.
  - page/
    - management/commands/: 커스텀 관리 명령어가 위치하는 디렉토리입니다.
      - create_page.py: 여러 페이지를 자동으로 생성하는 커스텀 관리 명령어 파일입니다.
    - migrations/: 데이터베이스 마이그레이션 파일들이 위치하는 디렉토리입니다.
      - init.py
      - ... (기타 마이그레이션 파일들)
    - admin.py: Django 관리자 페이지 설정 파일입니다.
    - apps.py: 'Page' 앱 설정 파일입니다.
    - hold_utils.py: 홀드 관련 유틸리티 함수들이 위치한 파일입니다.
    - models.py: 데이터베이스 모델 정의 파일입니다.
    - pose_detect_utils.py: 포즈 감지 관련 유틸리티 함수들이 위치한 파일입니다.
    - serializers.py: 직렬화 설정 파일입니다.
    - tests.py
    - urls.py: 'Page' 앱의 URL 라우팅 설정 파일입니다.
    - video_utils.py: 비디오 관련 유틸리티 함수들이 위치한 파일입니다.
    - views.py: 뷰 함수와 클래스가 위치한 파일입니다.
cliving_hold_weight.pt: PyTorch 모델 파일입니다. 홀드 탐색을 위한 가중치가 포함되어 있습니다.
debug.log
manage.py
requirements.txt: 프로젝트에 필요한 파이썬 패키지 목록입니다.