사용자 포인트 시스템

한눈에 보기

이 섹션의 기능

이 페이지에는 4개의 탭이 있습니다: 개요 (요약 통계), 사용자 포인트 (포인트 및 등급이 있는 사용자 표), 내역 (포인트 거래 내역), 설정 (시스템 구성 및 활성화된 설정 값).

이 기능을 사용하는 대상

1. 사이드바에서 사용자 포인트를 볼 수 있으며 사용자 포인트 시스템을 조회하거나 관리해야 하는 관리자
2. 포인트 잔액, 등급, 내역 또는 시스템 설정을 검토해야 하는 사용자

가장 일반적인 작업

1. 개요 탭에서 요약 통계 보기
2. 사용자 포인트 표 조회 및 검색 (현재 포인트, 등급, 변동)
3. 포인트 거래 내역 보기 (유형, 금액, 날짜)
4. 설정 조회 또는 편집 (사용자 포인트 시스템 활성화/비활성화, 최소 값, 최소 입금액)

시작하기 전에

1. 다음 권한이 있는지 확인하세요:
   1. user_point: 사용자 포인트, 등급 및 시스템 설정을 관리하는 데 필요합니다.

개요

섹션	설명
개요	사용자 포인트, 등급 및 시스템 설정을 관리하는 페이지입니다.
주요 탭	개요, 사용자 포인트, 내역, 설정

조회 및 검색 기능

기능	설명
개요 통계	개요 탭에 포인트가 있는 총 사용자 수, 총 배분 포인트, 사용자당 평균 포인트, 등급 변동이 있는 사용자 수가 표시됩니다.
사용자 포인트 표	사용자 포인트 탭: 검색... 텍스트 상자, 등급 콤보박스, 사용자, 현재 포인트, 현재 등급, 이전 포인트, 이전 등급, 포인트 변동, 등급 변동, 업데이트 일시, 작업 (내역 보기 버튼) 열이 있는 표.
내역 표	내역 탭: 사용자명 또는 사용자 ID로 검색 텍스트 상자, 모든 유형 콤보박스, 생성일 기준 필터 버튼, 생성일 콤보박스, 사용자, 유형, 금액, 날짜, 추가 데이터 열이 있는 표.
설정	설정 탭: 시스템 구성과 활성화된 설정 값 섹션이 있으며, 각각 편집 버튼이 있습니다.

관리 기능

기능	설명
내역 보기	사용자 포인트 탭: 각 행의 작업 열에 내역 보기 버튼이 있습니다.
편집 (설정)	설정 탭: 사용자 포인트 시스템 옆과 활성화된 설정 값 옆에 편집 버튼이 있습니다.
사용자 링크	사용자 포인트 및 내역 표에서 사용자 셀에 링크가 포함되어 있습니다 (예: /admin/users/{id}).

1. 사용자 포인트 시스템 관리

목적

사용자 포인트 시스템을 조회하고 관리합니다: 요약 통계, 사용자별 포인트 및 등급, 포인트 거래 내역, 시스템 설정.

사용 시기

포인트 배분을 모니터링하거나, 사용자의 포인트 또는 등급을 조회하거나, 유형/날짜별 포인트 내역을 검토하거나, 시스템 설정을 변경해야 할 때 (예: 최소 투자 금액, 최소 입금액) 이 페이지를 사용합니다.

주요 기능

1. 개요 탭: 4개의 요약 지표 (포인트가 있는 총 사용자 수, 총 배분 포인트, 사용자당 평균 포인트, 등급 변동이 있는 사용자 수).
2. 사용자 포인트 탭: 현재/이전 포인트와 등급, 포인트/등급 변동이 있는 사용자의 정렬/필터 가능한 표, 행별 내역 보기 기능.
3. 내역 탭: 사용자, 유형, 금액, 날짜, 추가 데이터 (관찰된 버튼: "1")가 있는 포인트 거래 표.
4. 설정 탭: 사용자 포인트 시스템 스위치 (활성화됨, 편집하지 않을 때는 체크되고 비활성화된 상태로 관찰됨) 및 편집 버튼이 있는 활성화된 설정 값.

2. 탭 및 콘텐츠 구조

주요 탭

탭	설명
개요	기본 탭입니다. 4개의 통계 블록 표시: 포인트가 있는 총 사용자 수 (예: "56"), 총 배분 포인트 (예: 6,080), 사용자당 평균 포인트 (예: "108.57"), 등급 변동이 있는 사용자 수 (예: "52"). 표 없음.
사용자 포인트	포인트가 있는 사용자 표. 열: 사용자, 현재 포인트, 현재 등급, 이전 포인트, 이전 등급, 포인트 변동, 등급 변동, 업데이트 일시, 작업. 표 위에 검색... 및 등급 콤보박스. 페이지당 행 수 (예: "10"), 페이지네이션 (예: 56건 중 1-10).
내역	포인트 거래 표. 열: 사용자, 유형, 금액, 날짜, 추가 데이터. 사용자명 또는 사용자 ID로 검색, 모든 유형 콤보박스, 생성일 기준 필터, 생성일 콤보박스. 페이지네이션 (예: 1847건 중 1-10).
설정	시스템 구성: "사용자 포인트 시스템" 및 "사용자 포인트 시스템 활성화 또는 비활성화" 설명, 편집 버튼, 활성화됨 스위치. 활성화된 설정 값: 편집 버튼; 생성자 시장 및 투자 최소 값 (예: "30"): "생성자 시장 포인트를 위한 최소 투자 금액"; 최소 입금액 (예: "10"): "포인트를 획득하기 위해 필요한 최소 입금액".

열 설명 (사용자 포인트 탭)

열	설명
사용자	아바타 또는 이니셜 (예: "J", "9") 및 /admin/users/{uuid}에 대한 링크인 사용자명 또는 ID.
현재 포인트	숫자 (예: 1,020, 860, 570, 530).
현재 등급	# 기호가 포함된 등급 (예: #1, #2, #6).
이전 포인트	숫자 (예: 1,020, 0, 10).
이전 등급	# 기호가 포함된 등급 (예: #1, #0, #26).
포인트 변동	숫자 (예: 0, 570, 520, 10).
등급 변동	"—" 또는 부호가 있는 변동 (예: +5, -20, +2, +3).
업데이트 일시	날짜/시간 (예: Feb 10 2026, 07:00).
작업	내역 보기 버튼.

열 설명 (내역 탭)

열	설명
사용자	아바타 또는 이니셜 및 /admin/users/{uuid}에 대한 링크인 사용자명/ID.
유형	텍스트 (예: creatorMarketGoesLive, creatorMarketAndInvestMinValue, marketGoesLiveWithLiquidity, matchOrder).
금액	숫자 (예: 30, 10).
날짜	날짜/시간 (예: Feb 10 2026, 19:58).

주요 참고사항

1. 사용자 포인트 표: 등급 콤보박스 라벨이 관찰되었습니다.
2. 내역 표: 모든 유형 및 생성일 콤보박스가 존재했으나 옵션은 열리지 않았습니다.

3. 사용자 포인트 시스템 관리 페이지 접근

목적

관리자 사이드바에서 사용자 포인트 시스템 관리 페이지를 엽니다.

단계

단계	작업	세부 사항
1	백오피스 로그인	예: https://xmarket.app/admin.
2	사이드바에서 사용자 포인트 클릭	사용자 포인트를 클릭합니다.
3	페이지 확인	개요 탭이 선택되어 있습니다.

결과

사용자 포인트 시스템 관리 페이지가 개요 탭이 표시되고 4개의 요약 통계가 나타난 상태로 열립니다.

4. 개요 탭 사용

목적

사용자 포인트 시스템에 대한 상위 수준 통계를 봅니다.

사용 시기

포인트가 있는 사용자 수, 총 배분 포인트, 사용자당 평균 포인트, 등급 변동이 있는 사용자 수에 대한 간략한 요약이 필요할 때 사용합니다.

단계

단계	작업	세부 사항
1	개요 탭 열기	개요는 페이지를 열 때 기본 탭입니다.
2	통계 확인	포인트가 있는 총 사용자 수 (예: "56"), 총 배분 포인트 (예: 6,080), 사용자당 평균 포인트 (예: "108.57"), 등급 변동이 있는 사용자 수 (예: "52").

결과

사용자 포인트 시스템의 현재 개요 지표를 확인했습니다.

주요 참고사항

1. 개요 탭에는 검색 또는 필터가 없으며, 읽기 전용 요약 콘텐츠입니다.

5. 사용자 포인트 탭 사용

목적

포인트가 있는 사용자 목록, 현재 및 이전 포인트와 등급, 포인트/등급 변동을 봅니다. 선택적으로 검색, 등급별 필터링, 사용자 내역 열기가 가능합니다.

사용 시기

사용자의 포인트 또는 등급을 찾거나, 현재와 이전 기간을 비교하거나, 해당 사용자의 포인트 내역을 열어야 할 때 사용합니다.

단계

단계	작업	세부 사항
1	사용자 포인트 탭 열기	사용자 포인트 탭을 클릭합니다. URL이 ?activeTab=user_points로 업데이트될 수 있습니다.
2	검색 사용 (선택)	검색... 텍스트 상자에 입력하여 사용자별로 필터링합니다.
3	등급 필터 사용 (선택)	등급 콤보박스를 사용하여 등급별로 필터링합니다.
4	표 검토	사용자, 현재 포인트, 현재 등급, 이전 포인트, 이전 등급, 포인트 변동, 등급 변동, 업데이트 일시를 확인합니다.
5	사용자 열기 (선택)	사용자 이름/링크를 클릭하여 /admin/users/{uuid}로 이동합니다.
6	내역 보기 (선택)	행의 작업 열에서 내역 보기를 클릭하여 해당 사용자의 포인트 내역을 봅니다.

결과

사용자 포인트 표를 조회했으며 사용자 상세 정보 또는 내역을 열 수 있습니다.

주요 참고사항

1. 현재 등급 및 이전 등급은 # 기호를 사용합니다 (예: #1, #26). 등급 변동은 변동이 없을 때 "—"을 표시하거나 +5, -20, +2와 같은 값을 표시합니다.
2. 포인트 변동은 0 또는 양수일 수 있습니다 (예: 570, 520, 10).
3. 사용자 셀은 아바타 이미지 또는 이니셜 문자와 사용자명 또는 숫자 ID를 표시할 수 있습니다.

6. 내역 탭 사용

목적

포인트 거래 내역을 봅니다: 사용자, 유형, 금액, 날짜, 추가 데이터.

사용 시기

포인트 지급을 감사하거나, 유형 또는 날짜별로 필터링하거나, 특정 사용자의 거래를 조회해야 할 때 사용합니다.

단계

단계	작업	세부 사항
1	내역 탭 열기	내역 탭을 클릭하거나 ?activeTab=history로 이동합니다.
2	검색 (선택)	사용자명 또는 사용자 ID로 검색을 사용하여 사용자를 찾습니다.
3	유형별 필터 (선택)	모든 유형 콤보박스를 사용합니다.
4	날짜별 필터 (선택)	생성일 기준 필터를 클릭하거나 생성일 콤보박스를 사용합니다.
5	표 검토	열: 사용자 (관리자 사용자 링크), 유형, 금액, 날짜, 추가 데이터 (버튼 예: "1").

결과

포인트 거래 내역을 조회했습니다.

주요 참고사항

1. 관찰된 유형 값: creatorMarketGoesLive (금액 30), creatorMarketAndInvestMinValue (10), marketGoesLiveWithLiquidity (10), matchOrder (10).
2. 관찰된 날짜 형식: 예: Feb 10 2026, 19:58.

7. 설정 탭 사용

목적

사용자 포인트 시스템의 시스템 구성을 봅니다: 활성화/비활성화 및 활성화된 설정 값.

사용 시기

사용자 포인트 시스템을 켜거나 끄거나 포인트 획득을 위한 최소 값을 변경해야 할 때 사용합니다.

단계

단계	작업	세부 사항
1	설정 탭 열기	설정 탭을 클릭하거나 ?activeTab=settings로 이동합니다.
2	시스템 구성 보기	사용자 포인트 시스템: "사용자 포인트 시스템 활성화 또는 비활성화" 설명. 편집 버튼. 활성화됨 스위치.
3	활성화된 설정 값 보기	편집 버튼. 생성자 시장 및 투자 최소 값: 값 "30", "생성자 시장 포인트를 위한 최소 투자 금액" 설명. 최소 입금액: 값 "10", "포인트를 획득하기 위해 필요한 최소 입금액" 설명.
4	편집 (선택)	편집을 클릭하여 구성 또는 설정을 변경합니다.

결과

현재 시스템 구성과 활성화된 설정 값을 확인했습니다. 편집을 클릭하면 변경할 수 있습니다.

주요 참고사항

1. 편집하지 않을 때 활성화됨 스위치는 비활성화 상태였습니다.
2. 시스템 구성과 활성화된 설정 값 모두에 편집 버튼이 있었습니다.

8. 필터링 및 검색

목적

검색 및 필터 컨트롤을 사용하여 사용자 포인트 및 내역 목록의 범위를 좁힙니다.

사용 가능한 필터

탭	필터 / 컨트롤	설명	사용 방법
사용자 포인트	검색...	텍스트 검색	검색... 텍스트 상자에 입력합니다.
사용자 포인트	등급	등급 필터	등급 라벨이 있는 콤보박스 (옵션 미열림).
내역	사용자명 또는 사용자 ID로 검색	사용자 검색	"사용자명 또는 사용자 ID로 검색" 플레이스홀더가 있는 텍스트 상자.
내역	모든 유형	유형 필터	모든 유형 콤보박스.
내역	생성일 기준 필터	날짜 필터	생성일 기준 필터 버튼.
내역	생성일	정렬 또는 필터	생성일 콤보박스.

주요 참고사항

1. 사용자 포인트 및 내역 모두 표 아래에 페이지당 행 수 및 페이지네이션이 있습니다.
2. URL 쿼리 activeTab은 선택된 탭을 반영합니다 (user_points, history, settings).

9. 문제 해결

문제	추정 원인
사이드바에 사용자 포인트가 없음	사용자 포인트가 표시되어야 하지만 누락된 경우 역할 또는 환경에 따라 접근이 달라질 수 있습니다.
페이지가 로드되지 않음	/admin/user-point로 이동하면 개요가 선택된 상태로 /admin/user-point/manage가 로드되었습니다.
데이터가 비어 있거나 누락됨	개요에 숫자 통계가 표시되었고, 사용자 포인트에 56개 행, 내역에 1847개 행이 있었습니다.

10. 모범 사례

포인트 및 등급 검토

1. 개요에서 집계 통계를 확인한 후 사용자 포인트에서 개별 사용자와 등급 변동 / 포인트 변동을 검사합니다.
2. 더 많은 맥락이 필요할 때 사용자 링크를 사용하여 사용자의 관리자 프로필을 엽니다.
3. 내역을 사용하여 유형 및 날짜별로 포인트 거래를 확인합니다.

필터 사용

1. 검색... (사용자 포인트) 또는 사용자명 또는 사용자 ID로 검색 (내역)을 사용하여 특정 사용자를 찾습니다.
2. 페이지 이동 전에 등급 (사용자 포인트) 및 모든 유형 / 생성일 기준 필터 (내역)를 사용하여 결과를 좁힙니다.

설정

1. 동작을 변경하기 전에 설정에서 시스템이 활성화됨 상태인지 확인하고 생성자 시장 및 투자 최소 값과 최소 입금액을 확인합니다.
2. 구성이나 값을 변경해야 할 때 편집을 사용합니다.

제품 용어집

용어	설명
추가 데이터	내역 탭의 열; 숫자 라벨이 있는 버튼을 포함합니다 (예: "1").
모든 유형	거래 유형별 필터링을 위한 내역 탭 컨트롤.
생성일	내역 탭 (날짜별 정렬 또는 필터).
생성자 시장 및 투자 최소 값	설정 탭의 설정: "생성자 시장 포인트를 위한 최소 투자 금액" (예: "30").
현재 포인트	사용자 포인트 탭의 열: 사용자의 현재 포인트 잔액.
현재 등급	사용자 포인트 탭의 열: 사용자의 현재 등급 (예: #1, #6).
활성화됨	설정 탭의 사용자 포인트 시스템 아래 스위치; 체크되면 시스템이 활성화됩니다.
활성화된 설정 값	설정 탭의 섹션으로 생성자 시장 및 투자 최소 값과 최소 입금액을 포함합니다.
생성일 기준 필터	내역 탭의 버튼.
내역	포인트 거래 내역을 보여주는 탭 (사용자, 유형, 금액, 날짜, 추가 데이터).
이전 포인트	사용자 포인트 탭의 열: 이전 기간의 사용자 포인트.
이전 등급	사용자 포인트 탭의 열: 이전 등급 (예: #1, #26).
최소 입금액	설정 탭의 설정: "포인트를 획득하기 위해 필요한 최소 입금액" (예: "10").
개요	포인트가 있는 총 사용자 수, 총 배분 포인트, 사용자당 평균 포인트, 등급 변동이 있는 사용자 수를 보여주는 탭.
포인트 변동	사용자 포인트 탭의 열: 포인트 변동 (예: 0, 570, 10).
등급	사용자 포인트 탭의 콤보박스 (등급별 필터).
등급 변동	사용자 포인트 탭의 열: 등급 변동 (예: +5, -20).
설정	시스템 구성과 활성화된 설정 값을 보여주는 탭으로 편집 버튼이 있습니다.
내역 보기	사용자 포인트 탭의 작업 열에 있는 버튼; 해당 사용자의 내역을 보여주기 위한 것입니다.
시스템 구성	설정 탭의 섹션: 사용자 포인트 시스템 활성화/비활성화 및 편집 버튼.
사용자 포인트 시스템	설정 탭의 라벨: "사용자 포인트 시스템 활성화 또는 비활성화."
사용자 포인트 시스템 관리	페이지 제목.
사용자 포인트	포인트, 등급 및 내역 보기 작업이 있는 사용자 표를 보여주는 탭.
등급 변동이 있는 사용자 수	개요 탭의 통계 (예: "52").