1.1 JIMS란?

JIMS는 인플루언서 마케팅 캠페인을 효율적으로 관리하기 위한 통합 플랫폼입니다. 여러 소셜미디어 플랫폼의 데이터를 자동으로 수집하고 분석하여, 인플루언서 선정부터 캠페인 성과 측정까지 전 과정을 지원합니다.

1.2 주요 기능

1.3 지원 플랫폼

1.4 자동 데이터 수집 시스템

1.5 사용자 역할

3.1 주요 통계 카드

대시보드 상단에서 다음 정보를 한눈에 확인할 수 있습니다:

4.1 인플루언서 목록 접속 및 대시보드 이해

1. 상단 네비게이션에서 "인플루언서" 메뉴를 클릭합니다.
2. 로딩이 완료되면 인플루언서 카드 대시보드가 표시됩니다.
3. 각 카드에는 다음 정보가 표시됩니다:
   • 프로필 이미지: 인플루언서의 대표 이미지 (자동 업데이트)
   • 인플루언서명: 등록된 이름 및 별명
   • 주요 플랫폼: YouTube, Instagram, TikTok 등 아이콘
   • 총 팔로워 수: 모든 플랫폼 합계
   • 최근 참여율: 지난 30일 평균 참여율
   • 7일 성장률: 지난 주 대비 팔로워 증감률

4.2 인플루언서 상태 배지 이해

4.3 인플루언서 카드 기능 활용

4.4 목록 내비게이션

4.5 카드 정보 상세 설명

4.6 목록에서 바로 할 수 있는 작업

5.1 자연어 검색 시스템 활용

1. 인플루언서 목록 페이지 상단의 "검색" 입력창을 찾습니다.
2. 자연스러운 문장으로 검색어를 입력합니다.
3. Enter 키를 누르거나 검색 버튼을 클릭합니다.
4. 검색 결과가 자동으로 필터링되어 표시됩니다.

5.2 듀얼 Range Slider 필터 사용법

1. 인플루언서 목록 페이지 상단의 "필터" 영역을 찾습니다.
2. 4개의 듀얼 슬라이더를 확인합니다:
   • 팔로워 수: 최소 1K - 최대 10M
   • 평균 조회수: 최소 100 - 최대 1M
   • 평균 좋아요: 최소 10 - 최대 100K
   • 평균 댓글: 최소 1 - 최대 10K
3. 슬라이더 핸들을 드래그하여 원하는 범위를 설정합니다.
4. 실시간으로 필터링 결과가 업데이트됩니다.

5.3 고급 검색 기능

6.1 상세 페이지 접근 방법

1. 인플루언서 목록에서 관심 있는 인플루언서 카드를 찾습니다.
2. 다음 중 하나의 방법으로 접근:
   • 카드 전체 클릭: 카드 어느 부분이든 클릭
   • "분석" 버튼: 우측 하단의 분석 버튼 클릭
   • 인플루언서명 클릭: 이름 부분 직접 클릭
3. 새 탭 또는 같은 탭에서 상세 분석 페이지가 열립니다.

6.2 상세 페이지 구성 요소

6.3 상호작용 차트 및 그래프 해석

6.4 최근 콘텐츠 분석 활용

1. 페이지 하단의 "최근 콘텐츠" 섹션을 확인합니다.
2. 각 콘텐츠별로 다음 정보를 분석:
   • 제목 및 설명: 콘텐츠 주제와 스타일
   • 업로드 일시: 활동 빈도 파악
   • 조회수: 콘텐츠별 인기도
   • 좋아요/댓글 수: 실제 참여도
   • 참여율 계산: (좋아요+댓글)/조회수 * 100
3. 트렌드 분석: 최근 성과가 좋은 콘텐츠 유형 파악

6.5 인플루언서 평가 기준

7.1 캠페인 목록 페이지 접근

1. 상단 네비게이션에서 "캠페인" 메뉴를 클릭합니다.
2. 캠페인 목록 페이지가 로드되면 전체 캠페인 현황을 확인할 수 있습니다.
3. 테이블 형태로 정리된 캠페인 정보를 한눈에 파악합니다.

7.2 캠페인 상태 배지 이해

7.3 캠페인 목록 정보 해석

7.4 캠페인 목록에서 할 수 있는 작업

7.5 캠페인 목록 필터링 및 정렬

8.1 캠페인 상세 페이지 접근

1. 캠페인 목록에서 관심 있는 캠페인명을 클릭합니다.
2. 캠페인 상세 분석 페이지가 새 탭에서 열립니다.
3. 페이지 상단에서 기본 정보, 하단에서 성과 데이터를 확인합니다.

8.2 캠페인 기본 정보 섹션

8.3 실시간 성과 대시보드 활용

8.4 콘텐츠 성과 분석 테이블

1. 페이지 하단의 "콘텐츠 목록" 섹션을 확인합니다.
2. 각 콘텐츠별 상세 성과 데이터를 분석:
   • 콘텐츠 제목: 영상/포스트 제목 및 링크
   • 인플루언서: 제작자 정보 및 프로필
   • 플랫폼: 발행된 소셜미디어 채널
   • 발행일: 콘텐츠 업로드 날짜 및 시간
   • 조회수: 실시간 조회수 (24시간마다 업데이트)
   • 참여 지표: 좋아요, 댓글, 공유 수
   • 참여율: (좋아요+댓글)/조회수 * 100
3. 성과 순으로 정렬하여 베스트 콘텐츠를 식별합니다.

8.5 캠페인 ROI 및 KPI 계산

8.6 실시간 모니터링 및 최적화

9.1 성과 분석 페이지 접근 및 준비

1. 상단 네비게이션에서 "성과 분석" 또는 "대시보드"를 클릭합니다.
2. 분석 기간을 설정합니다 (지난 7일, 30일, 90일 또는 사용자 지정).
3. 분석하고자 하는 캠페인 또는 인플루언서를 선택합니다.
4. 주요 KPI 대시보드가 로드되면 상세 분석을 시작합니다.

9.2 핵심 성과 지표 분석

9.3 플랫폼별 성과 분석 전략

9.4 성과 리포트 생성 및 활용

1. 데이터 수집: 분석 기간 내 모든 성과 데이터를 수집합니다.
2. 비교 분석: 이전 캠페인, 경쟁사, 업계 평균과 비교합니다.
3. 인사이트 도출: 성과 데이터에서 주요 트렌드와 패턴을 찾습니다.
4. 개선 방안 제시: 다음 캠페인을 위한 구체적인 개선 전략을 수립합니다.

9.5 데이터 드리븐 시나리오 분석

10.1 대량 등록 페이지 접근

1. 상단 네비게이션에서 "대량 등록" 메뉴를 클릭합니다.
2. 대량 등록 페이지가 로드되면 업로드 영역을 확인합니다.
3. 페이지 좌측에 안내 사항, 우측에 업로드 영역이 표시됩니다.

10.2 엑셀 템플릿 다운로드 및 작성

1. "템플릿 다운로드" 버튼을 클릭합니다.
2. influencer_template.xlsx 파일이 다운로드됩니다.
3. 다운로드된 엑셀 파일을 열어 다음과 같이 작성:

10.3 파일 업로드 및 등록 실행

1. 작성된 엑셀 파일을 저장합니다.
2. 다음 중 하나의 방법으로 업로드:
   • 드래그 앤 드롭: 파일을 업로드 영역으로 드래그
   • 파일 선택: "파일 선택" 버튼 클릭 후 파일 선택
3. 파일이 업로드되면 미리보기가 표시됩니다.
4. "업로드 시작" 버튼을 클릭하여 등록을 시작합니다.
5. 실시간 진행 상황을 모니터링합니다.

10.4 등록 진행 상황 모니터링

10.5 등록 결과 확인 및 해석

업로드 완료 후 다음과 같은 상세 리포트가 제공됩니다:

10.6 문제 해결 및 재시도

10.7 대량 등록 베스트 프랙티스

11.1 스케줄러 페이지 접근 및 개요

1. 상단 네비게이션에서 "스케줄러" 메뉴를 클릭합니다.
2. 스케줄러 대시보드가 로드되면 전체 자동화 상태를 확인합니다.
3. 각 스케줄러의 상태, 마지막 실행 시간, 다음 예정 시간을 확인합니다.

11.2 주요 스케줄러 상세 정보

11.3 스케줄러 상태 모니터링

11.4 수동 데이터 수집 실행

1. 스케줄러 페이지에서 "즈시 수집" 영역을 확인합니다.
2. 수집 타입을 선택합니다:
   • "전체 인플루언서": 등록된 모든 인플루언서 데이터 수집
   • "특정 인플루언서": 선택한 인플루언서만 수집
   • "캐페인 콘텐츠": 활성 캠페인 콘텐츠만 수집
3. "수집 시작" 버튼을 클릭하여 수동 수집을 실행합니다.
4. 실시간 진행 상황을 모니터링하며 완료를 기다립니다.

11.5 스케줄러 로그 및 문제 해결

11.6 스케줄러 최적화 및 성능 튜닝

12.1 새 인플루언서 등록

1. 인플루언서 목록 페이지 상단의 "새 인플루언서 추가" 버튼을 클릭합니다.
2. 등록 폼에서 다음 정보를 입력합니다:
   • 인플루언서명: 실명 또는 활동명 (필수)
   • 카테고리: 주요 콘텐츠 분야 선택
   • 연락처: 이메일, 전화번호 등
   • 소속사: 매니지먼트 회사 정보
   • 메모: 추가 특이사항
3. "저장" 버튼을 클릭하여 등록을 완료합니다.

16.2 채널 정보 추가

16.3 인플루언서 정보 수정

1. 인플루언서 카드 또는 목록에서 "수정" 버튼을 클릭합니다.
2. 수정 폼에서 변경할 정보를 업데이트합니다.
3. 변경사항을 확인하고 "저장"을 클릭합니다.

16.4 인플루언서 삭제

1. 삭제할 인플루언서의 상세 페이지로 이동합니다.
2. 페이지 하단의 "삭제" 버튼을 클릭합니다.
3. 삭제 확인 대화상자에서 인플루언서명을 입력하여 확인합니다.
4. "영구 삭제" 버튼을 클릭하여 삭제를 완료합니다.

13.1 새 캠페인 생성

1. 캠페인 목록 페이지에서 "새 캠페인 만들기" 버튼을 클릭합니다.
2. 캠페인 기본 정보를 입력합니다:

   필드명	설명	예시
   캠페인명	고유한 캠페인 식별명	2024 봄 신제품 런칭
   클라이언트	광고주 또는 브랜드명	ABC 화장품
   시작일/종료일	캠페인 진행 기간	2024-03-01 ~ 2024-03-31
   예산	총 캠페인 예산	5,000,000원
   목표	캠페인 주요 KPI	브랜드 인지도 향상

3. "저장 후 계속" 버튼을 클릭하여 다음 단계로 진행합니다.

13.2 참여 인플루언서 선정

13.3 콘텐츠 관리

1. 캠페인 상세 페이지에서 "콘텐츠 관리" 탭을 클릭합니다.
2. 각 인플루언서별 콘텐츠 URL을 등록합니다.
3. 게시 일정과 실제 게시일을 관리합니다.
4. 콘텐츠 품질 및 가이드라인 준수 여부를 확인합니다.

13.4 캠페인 수정 및 관리

13.5 캠페인 종료 및 정산

1. 캠페인 종료일이 되면 자동으로 "종료 대기" 상태로 변경됩니다.
2. "최종 성과 정리" 버튼을 클릭하여 결과를 검토합니다.
3. 각 인플루언서별 성과와 보상을 확인합니다.
4. "정산 완료" 처리하여 캠페인을 완전히 종료합니다.

14.1 새 고객사 등록

1. 메인 메뉴에서 "고객사"를 클릭합니다.
2. "새 고객사 추가" 버튼을 클릭합니다.
3. 고객사 정보를 입력합니다:

   기본 정보

   • 회사명: 정식 회사명
   • 업종: 화장품, 식품, IT 등
   • 규모: 대기업, 중소기업 등
   • 주소: 본사 주소

   담당자 정보

   • 담당자명: 마케팅 담당자
   • 부서: 마케팅팀, 홍보팀 등
   • 연락처: 이메일, 전화번호
   • 직급: 팀장, 과장 등
4. "저장" 버튼을 클릭하여 등록을 완료합니다.

14.2 고객사 정보 수정

1. 고객사 목록에서 수정할 고객사를 클릭합니다.
2. 상세 페이지에서 "편집" 버튼을 클릭합니다.
3. 변경할 정보를 수정하고 "변경사항 저장"을 클릭합니다.

14.3 프로젝트 이력 관리

14.4 고객사 등급 관리

15.1 새 사용자 계정 생성

1. 관리자 메뉴에서 "사용자 관리"를 클릭합니다.
2. "새 사용자 추가" 버튼을 클릭합니다.
3. 사용자 정보를 입력합니다:

   계정 정보

   • 사용자 ID: 로그인용 고유 ID
   • 비밀번호: 초기 비밀번호 설정
   • 이름: 실제 이름
   • 이메일: 연락용 이메일

   권한 및 역할

   • 권한 등급: ADMIN/MANAGER/USER
   • 부서: 마케팅팀, 영업팀 등
   • 담당 영역: 전체/특정 클라이언트
   • 활성 상태: 계정 활성화 여부
4. "계정 생성" 버튼을 클릭하여 완료합니다.

15.2 권한 등급별 기능

15.3 사용자 계정 관리

15.4 계정 보안 관리

15.5 사용자 활동 모니터링

1. "사용자 활동 로그" 메뉴에 접근합니다.
2. 기간별, 사용자별 활동 내역을 조회합니다.
3. 중요 작업(삭제, 수정 등)의 상세 로그를 확인합니다.
4. 비정상적인 활동 패턴을 모니터링합니다.

주요 기능

배치 분석 기능

여러 인플루언서를 한번에 분석할 수 있습니다.

1. 인플루언서 목록 페이지에서 체크박스로 선택
2. "선택 항목 배치 분석" 버튼 클릭
3. 또는 "전체 배치 분석"으로 모든 인플루언서 분석
4. 진행 상황 실시간 표시

검색 예시

검색 프로세스

1. 검색창에 자연어 입력 (예: "팔로워 많은 게임 유튜버")
2. Mistral AI가 검색 의도 분석
3. 플랫폼, 카테고리, 정렬 조건 자동 추출
4. SQL 쿼리 자동 생성 및 실행
5. 검색 결과 즉시 표시

주요 기능

사용 방법

1. 인플루언서 목록 페이지 상단 오른쪽 "그리드 보기" 버튼 클릭
2. 카드 형태로 인플루언서 목록 표시
3. 카드 클릭 시 상세 페이지로 이동
4. 다시 테이블 뷰로 전환하려면 "테이블 보기" 클릭

16.1 효율적인 일일 워크플로우

16.2 인플루언서 선정 전문 가이드

16.3 문제 해결 가이드

16.4 고급 활용 전략

16.5 정기 점검 및 유지관리

16.6 연락처 및 지원

17.1 자동 백업 스케줄러

• 상태 패널: 마지막 실행 시각, 저장 경로, Dropbox 업로드 여부 표시
• 에러 로그: 실패 시 원인이 적색으로 노출 (디스크, 권한, 네트워크 등)
• 중복 실행 방지: 새로운 작업이 시작되면 기존 스케줄이 자동 중단됩니다.

17.2 수동 백업 절차

1. 백업 화면에서 “즉시 백업” 버튼을 클릭합니다.
2. 진행률이 표시되며 완료 시 다운로드 링크와 파일 해시가 생성됩니다.
3. Dropbox 연동이 켜져 있다면 1~2분 후 상태가 SYNCED로 변경됩니다.

17.3 복구/검증 체크리스트

• 주 1회 테스트 DB에 복구하여 덤프 파일이 정상인지 확인
• Dropbox에 최근 3일치 파일이 존재하는지 점검
• 파일 용량이 급증했다면 테이블 정리 또는 압축률 검토
• 백업 경로 권한이 변경되면 DROPBOX_ACCESS_TOKEN 재발급

18.1 환경 변수 구조

backend/settings.py는 JIMS_DB_* → MYSQL_* 순으로 값을 읽고, 누락 시 안전한 기본값을 제공합니다.

• JIMS_DB_HOST / MYSQL_HOST : 기본 localhost
• JIMS_DB_PORT : 정수 입력, 미지정 시 3306
• JIMS_SECRET_KEY : JWT/세션 공통 키
• ENABLE_AUTO_COLLECTION : 스케줄러 자동 실행 여부
• ENVIRONMENT : production, staging, local

18.2 관리자 UI

19.1 디렉터리 구조

• checks/ : 데이터 무결성 검증(예: check_audience_status.py)
• debug/ : 이슈 재현(debug_naver_html.py 등)
• maintenance/ : 마이그레이션/정리(migrate_daily_to_campaign_records.py)
• analytics/ : 통계/리포트(daily_content_tracker.py)

19.2 실행 예시

# 권장: 새 모듈 경로 사용
python -m backend.legacy_scripts.checks.check_audience_status

# 기존 경로도 동작하지만 곧 제거 예정
python backend/check_audience_status.py