1. 회원 관리 개요

DXCMS 관리자 패널의 [회원 관리] 메뉴는 서비스에 가입한 회원을 조회•추가•수정•삭제하고, 권한과 접속 상태를 제어하는 핵심 관리 도구입니다. 또한 개별 회원의 실시간 접속 현황 및 로그인/로그아웃 이력을 모니터링하는 기능도 제공합니다.

📌  접근 경로: 관리자 대시보드 → 회원 관리 (또는 URL: /admin/members)

1.1 주요 기능 요약

기능	설명
회원 목록 조회	전체 회원을 최신 가입 순(ID 내림차순)으로 표시. 페이지당 20명. 이름·아이디·이메일 통합 검색.
회원 직접 추가	관리자가 직접 회원 계정을 생성합니다. 로그인 ID·이름·이메일·비밀번호·권한·메모 입력.
회원 정보 수정	이름·이메일·비밀번호·권한·메모를 수정합니다. 로그인 ID는 수정 불가(읽기 전용).
권한 즉시 변경	목록에서 드롭다운으로 즉시 권한 변경(회원/매니저/관리자). 폼 제출 없이 즉시 적용.
접속 차단/해제	회원의 로그인을 일시 차단하거나 해제합니다. 관리자 계정과 본인 계정은 차단 불가.
회원 영구 삭제	회원 계정을 DB에서 완전 삭제합니다. 본인 계정 삭제 불가.
실시간 모니터링	개별 회원의 접속 상태(온라인/오프라인), 총 로그인 횟수, 접속 시간, IP, 브라우저, 활동 로그, 세션 기록을 확인.

1.2 화면 구성

회원 관리 화면은 상단 헤더(검색•회원 추가 버튼)와 회원 목록 테이블로 구성됩니다. 특정 회원 수정 또는 추가 시 목록 위에 폼이 표시됩니다. 모니터링 탭 클릭 시에는 모니터링 패널이 목록 위에 삽입됩니다.
 

영역	설명
페이지 헤더	총 회원 수 배지, 검색 폼(이름·아이디·이메일 통합검색), [회원 추가] 파란색 버튼.
메시지 배너	POST 처리 후 성공(초록)/오류(빨강) 메시지 배너가 목록 위에 표시됩니다.
수정 폼	특정 회원의 수정 URL(/admin/members/{id}) 접근 시 목록 위에 6개 필드 수정 폼이 표시됩니다.
추가 폼	/admin/members/add 경로 접근 시 새 회원 등록 폼이 표시됩니다.
모니터링 패널	?tab=monitor 파라미터 접근 시 해당 회원의 접속 통계·로그·세션 패널이 표시됩니다.
회원 목록 테이블	회원정보·아이디·권한·상태·가입/로그인일·관리 버튼 6개 컬럼.
페이지네이션	페이지당 20명. 현재 페이지 ±3 범위의 페이지 버튼 표시.

2. 회원 목록 테이블

회원 목록 테이블은 모든 회원을 최신 가입 순(ID DESC)으로 나열합니다. 각 컬럼의 의미와 동작을 상세히 설명합니다.

2.1 목록 컬럼 상세

컬럼	표시 내용 및 설명
회원정보	권한별 색상 아바타(이름 첫 글자) + 이름 + [ME] 배지(본인) + 이메일 주소. 아바타 색상: 관리자=하늘색, 매니저=인디고, 회원=회색.
사용자 아이디	로그인 시 사용하는 고유 ID. 모노스페이스 폰트로 표시됩니다.
권한설정	드롭다운(회원/매니저/관리자) 선택 즉시 폼 자동 제출 → 권한이 즉시 변경됩니다. 별도 저장 버튼이 필요 없습니다.
상태	정상 활성(초록 점 깜빡임) / 접속 차단(빨간색 정지). 배지 형태로 표시.
가입/로그인	가입일(join_date 날짜), 마지막 로그인(last_login 날짜+시간), 마지막 접속 IP(last_ip) 3줄 표시.
관리 액션	[수정] 파란 연필 / [모니터링] 인디고 차트 / [차단·해제] 노랑·초록(관리자·본인 제외) / [삭제] 빨간 쓰레기통(본인 제외) 버튼.

2.2 관리 액션 버튼 4종

버튼	URL/액션	색상	동작 및 제한
✏️ 수정	/admin/members/{id}	하늘색	해당 회원 수정 폼 페이지로 이동. 수정 폼에서 이름·이메일·비밀번호·권한·메모 변경 가능.
📊 모니터링	?tab=monitor	인디고	해당 회원의 실시간 접속 모니터링 패널을 표시. DxMemberMonitor 클래스가 있어야 사용 가능.
차단/해제	act=status	노랑/초록	status 0↔1 전환. 관리자(role=admin) 계정과 현재 로그인 중인 본인 계정에는 이 버튼이 표시되지 않습니다.
🗑 삭제	act=delete	빨간색	"[회원명] 회원을 영구 삭제하시겠습니까?" 확인 창 후 DB에서 완전 삭제. 본인 계정은 삭제 불가.

⚠️  관리자(role=admin) 계정은 접속 차단이 불가능합니다. 관리자 보호 정책으로 실수로 잠그는 상황을 방지합니다. 또한 현재 로그인한 본인 계정은 차단 및 삭제 버튼이 모두 표시되지 않습니다.

2.3 검색 기능

상단 검색 폼(GET 방식)에서 검색어를 입력하면 이름(name), 로그인 ID(login_id), 이메일(email) 세 필드에 대해 LIKE 검색이 수행됩니다.
 

검색 방식	이름 LIKE %검색어% OR 로그인ID LIKE %검색어% OR 이메일 LIKE %검색어%. 세 필드를 동시에 검색합니다.
URL 파라미터	?s=검색어. 페이지네이션과 함께 사용 시 ?s=검색어&page=N 형태로 유지됩니다.
검색 초기화	검색어를 지우고 검색하면 전체 목록으로 돌아갑니다.

2.4 권한 즉시 변경 드롭다운

목록의 [권한설정] 컬럼에 있는 드롭다운에서 권한을 선택하면 onchange 이벤트로 폼이 자동 제출(act=role)됩니다. 별도 저장 버튼 클릭이 필요 없이 즉시 변경됩니다.
 

권한값	표시명	설명
member	회원	일반 회원. 게시글 작성·댓글 등 기본 권한. 기본값.
manager	매니저	운영진. 일반 회원보다 높은 권한. 사이트 정책에 따라 특정 관리 기능 접근 가능.
admin	관리자	최고 관리자. 모든 관리자 메뉴 접근 가능. 접속 차단 제외 모든 기능 사용 가능.

💡  권한 변경은 즉각 적용됩니다. 관리자로 변경된 회원은 다음 로그인부터(또는 즉시) 관리자 메뉴에 접근할 수 있습니다.

3. 회원 추가

상단 [+ 회원 추가] 버튼 클릭 시 /admin/members/add 경로로 이동하여 새 회원 등록 폼이 표시됩니다.

3.1 추가 폼 필드 전체 설명

필드	필수 여부	설명 및 유의사항
로그인 ID (login_id)	필수	영문·숫자·_·- 조합. maxlength=50. 가입 후 변경 불가(관리자 수정 폼에서 읽기 전용). 중복 불가.
이름 / 닉네임 (name)	필수	사이트에 표시되는 회원 이름. maxlength=100. 아바타 첫 글자로 사용됩니다.
이메일 주소 (email)	필수	유효한 이메일 형식이어야 합니다. 중복 불가. 비밀번호 재설정 등에 사용됩니다.
초기 비밀번호 (password)	필수	BCRYPT 해시로 암호화되어 저장됩니다. 저장 후 원문 조회 불가.
권한 등급 (role)	선택	기본값: 일반 회원(member). member/manager/admin 중 선택.
관리 메모 (memo)	선택	관리자만 볼 수 있는 참고 메모. 회원에게는 표시되지 않습니다.

3.2 추가 처리 로직

• CSRF 토큰 검증
• 로그인 ID•이름•이메일•비밀번호 필수값 확인
• 이메일 형식(filter_var FILTER_VALIDATE_EMAIL) 검증
• 로그인 ID 중복 확인 → 이미 사용 중이면 오류
• 이메일 중복 확인 → 이미 사용 중이면 오류
• role 값 유효성 검증 (member/manager/admin 외 값이면 member로 강제)
• password_hash()로 BCRYPT 암호화 후 members 테이블에 INSERT
• join_date = 현재 날짜/시간, status = 1(활성)로 자동 설정
• "회원이 추가되었습니다." 성공 메시지 표시

3.3 추가 절차

• 상단 [+ 회원 추가] 버튼 클릭
• 로그인 ID 입력 (영문•숫자•_•-)
• 이름/닉네임 입력
• 이메일 주소 입력
• 초기 비밀번호 입력
• 권한 등급 선택 (기본: 일반 회원)
• 관리 메모 입력 (선택사항)
• [새로운 회원 생성 완료] 버튼 클릭
• 성공 메시지 확인

4. 회원 정보 수정

목록에서 [✏️ 수정] 버튼 클릭 시 /admin/members/{id} 경로로 이동하여 수정 폼이 표시됩니다.

4.1 수정 폼 필드

필드	편집 가능	설명
로그인 ID	불가	읽기 전용(readonly). 회원 생성 후 ID 변경 불가. 식별자로 고정됩니다.
이름 / 닉네임	가능	회원 표시 이름 변경 가능.
이메일 주소	가능	변경 시 형식 검증 + 타 회원과 중복 여부를 체크합니다.
비밀번호 변경	선택	비워두면 기존 비밀번호 유지. 입력 시 BCRYPT로 재암호화 후 저장.
계정 권한 등급	가능	member/manager/admin 변경 가능.
관리자 비공개 메모	가능	관리자용 참고 메모. 회원에게는 표시되지 않습니다.

4.2 수정 처리 로직

• CSRF 토큰 검증
• id•이름•이메일 필수값 확인 (비밀번호는 선택)
• 이메일 형식 검증
• 이메일 중복 체크: 본인 제외(WHERE email=? AND id!=?) 조건으로 타 회원 중복 확인
• role 값 유효성 검증
• 비밀번호 입력 시 password_hash()로 재암호화
• members 테이블 UPDATE (name, email, role, memo, [password])
• "회원 정보가 수정되었습니다." 성공 메시지 표시

💡  비밀번호 필드를 비워두면 기존 비밀번호가 그대로 유지됩니다. 비밀번호를 변경할 때만 입력하세요. 입력한 비밀번호는 BCRYPT 암호화 후 저장되어 원문 복원이 불가능합니다.

5. 접속 차단 및 해제

목록에서 [차단] 또는 [해제] 버튼으로 회원의 로그인 가능 여부를 즉시 제어합니다. 이 버튼은 관리자(role=admin) 계정과 현재 로그인 중인 본인 계정에는 표시되지 않습니다.

5.1 차단/해제 동작

동작	처리 내용
차단 (status=0)	status를 0으로 변경. 다음 로그인 시도부터 차단됩니다. 이미 로그인 중인 세션은 즉시 종료되지 않을 수 있습니다.
해제 (status=1)	status를 1로 변경. 즉시 로그인 가능 상태로 복구됩니다.

5.2 차단 예외 규칙

관리자 계정(role=admin)	차단 버튼이 표시되지 않습니다. 실수로 관리자를 잠그는 상황을 방지합니다.
본인 계정(isMe=true)	차단 버튼이 표시되지 않습니다. 자신의 계정을 잠그는 상황을 방지합니다.
서버 측 추가 보호	act=status POST 처리 시 서버에서도 role=admin 또는 id=로그인ID 조건으로 다시 검증합니다.

⚠️  관리자 계정이 잠기면 관리자 패널 접근이 불가능해집니다. DXCMS는 관리자 계정 차단을 UI•서버 양쪽에서 모두 차단하여 이 상황을 예방합니다.

6. 회원 영구 삭제

목록에서 [🗑] 삭제 버튼 클릭 시 확인 창이 표시됩니다. 확인 후 해당 회원이 DB에서 완전히 삭제됩니다.

🚨  삭제된 회원은 복구할 수 없습니다. 게시글•댓글 등 회원의 활동 데이터는 별도로 처리되지 않으며(orphan 상태) 해당 게시글이 삭제되지는 않습니다. 접속을 막으려면 삭제보다 [차단]을 먼저 고려하세요.

6.1 삭제 처리 로직

1. CSRF 토큰 검증
2. id 유효성 확인 (0이면 처리 안 함)
3. 본인 계정(id === $myId) 삭제 시도 시 오류 메시지 → 중단
4. members 테이블에서 id에 해당하는 레코드 삭제
5. "회원이 삭제되었습니다." 성공 메시지 표시

6.2 삭제 시 주의사항

• 본인 계정은 삭제 버튼 자체가 표시되지 않으며, 서버에서도 이중으로 차단됩니다.
• 관리자 계정도 삭제할 수 있습니다. 마지막 관리자 계정은 삭제 전 반드시 신중하게 확인하세요.
• 삭제 후 해당 회원의 게시글•댓글은 작성자 정보가 없는 상태(고아 데이터)로 남습니다.
• 대안: 회원을 바로 삭제하지 않고 [차단] 처리하면 로그인만 막으면서 데이터를 보존할 수 있습니다.

7. 실시간 접속 모니터링

목록에서 [📊 모니터링] 버튼 클릭 시 /admin/members/{id}?tab=monitor 경로로 이동합니다. DxMemberMonitor 클래스가 설치된 경우에만 모니터링 패널이 표시됩니다.

💡  DxMemberMonitor 클래스가 없으면 모니터링 패널이 표시되지 않습니다. 모니터링 기능은 별도 member_logs 테이블과 member_sessions 테이블이 필요합니다.

7.1 요약 KPI 카드 (6개)

카드	표시 내용 및 설명
접속 상태	ONLINE(초록 깜빡임) / 오프라인(회색). 온라인 시 현재 로그인 시간, 오프라인 시 마지막 로그아웃 시간 표시.
총 로그인	전체 누적 로그인 횟수(total_logins). 천 단위 쉼표 포함.
마지막 로그인	마지막 로그인 일자(YYYY-MM-DD)와 시각(HH:MM:SS).
마지막 로그아웃	마지막 로그아웃 일자와 시각. 로그아웃 이력이 없으면 "-" 표시.
평균 접속시간	1회 세션 평균 접속 시간(avg_duration_sec)과 총 누적 접속 시간(total_duration_sec). DxMemberMonitor::formatDuration()으로 "X시간 Y분" 형식으로 표시.
마지막 IP	마지막 접속 IP 주소(last_ip)와 브라우저·OS 정보(last_ua에서 파싱).

7.2 활동 이력 로그 탭

모니터링 패널 하단의 [활동 이력 로그] 탭에 최근 20개의 로그인/로그아웃/세션만료 이벤트가 표시됩니다.
 

컬럼	내용
이벤트	🟢 로그인(초록) / 🔴 로그아웃(빨강) / ⏰ 세션만료(노랑). 색상 배지로 구분.
일시	이벤트 발생 일시(created_at). YYYY-MM-DD HH:MM:SS 형식.
IP 주소	이벤트 발생 시 클라이언트 IP 주소.
브라우저	DxMemberMonitor::parseBrowser(user_agent)로 파싱된 브라우저 명칭.
운영체제	DxMemberMonitor::parseOS(user_agent)로 파싱된 OS 명칭.

7.3 접속 세션 기록 탭

[접속 세션 기록] 탭에 최근 10개의 세션 이력이 표시됩니다. 각 로그인 세션의 전체 기록을 확인할 수 있습니다.
 

컬럼	내용
시작	세션 시작(로그인) 일시.
종료	세션 종료(로그아웃/만료) 일시. 아직 진행 중인 세션은 "-" 표시.
마지막 접속	세션 중 마지막으로 활동한 시각(last_seen_at).
접속 시간	해당 세션의 총 접속 시간(duration_sec). "X시간 Y분" 형식으로 표시.
종료 사유	🔴 로그아웃 / ⏰ 만료 / ❓ 불명 / 🟢 접속중(깜빡임). 현재 진행 중인 세션은 초록 "접속중" 배지 표시.
IP 주소	해당 세션의 접속 IP.

7.4 탭 전환 동작

탭 버튼 클릭 시 dxMonTab() JavaScript 함수가 실행됩니다. 페이지 새로고침 없이 로그 패널과 세션 패널의 display를 전환합니다. 선택된 탭은 진한 배경(bg-slate-900)으로, 비선택 탭은 투명 배경으로 표시됩니다

8. 전체 사용 절차

8.1 회원 검색 및 조회

1. 관리자 대시보드 → [회원 관리] 메뉴 클릭
2. 검색 필드에 이름•아이디•이메일 중 하나를 입력 후 [🔍 검색] 클릭
3. 검색 결과 목록에서 원하는 회원 확인
4. 페이지네이션으로 여러 페이지 탐색

8.2 새 회원 직접 등록

1. [+ 회원 추가] 버튼 클릭
2. 로그인 ID, 이름, 이메일, 비밀번호 입력 (필수)
3. 권한 등급 선택 (기본: 일반 회원)
4. 관리 메모 입력 (선택)
5. [새로운 회원 생성 완료] 클릭
6. 성공 메시지 확인 후 목록에서 추가된 회원 확인

8.3 회원 정보 수정

1. 목록에서 수정할 회원의 [✏️] 버튼 클릭
2. 이름•이메일•비밀번호•권한•메모 중 변경할 항목 수정
3. 비밀번호는 변경할 경우에만 입력 (비워두면 기존 유지)
4. [설정 저장하기] 버튼 클릭
5. 성공 메시지 확인

8.4 회원 접속 차단/해제

1. 목록에서 해당 회원의 [차단] 버튼 클릭
2. 페이지 새로고침 후 상태 컬럼에 "접속 차단" 표시 확인
3. 해제 시 [해제] 버튼 클릭
4. 상태 컬럼이 "정상 활성"으로 변경 확인

8.5 회원 모니터링

1. 목록에서 모니터링할 회원의 [📊] 버튼 클릭
2. KPI 카드에서 온라인 상태•총 로그인 수•평균 접속시간 확인
3. [활동 이력 로그] 탭에서 최근 로그인/로그아웃/세션만료 이벤트 확인
4. [접속 세션 기록] 탭에서 각 접속 세션의 상세 시간 및 종료 사유 확인
5. [✕ 닫기] 링크로 모니터링 패널 닫기

9. 회원 권한 체계 상세

DXCMS는 member•manager•admin 3단계 권한 체계를 사용합니다.
 

role 값	관리자 표시명	주요 권한 및 특성
member	회원	기본 가입 권한. 게시글 작성·댓글·좋아요 등 일반 기능 사용. 게시판 설정의 쓰기 권한(write_level=1)에 해당.
manager	매니저	운영진 권한. 사이트 정책에 따라 특정 관리 기능이나 비공개 게시판 접근 가능. 관리자 패널 접근 불가.
admin	관리자	최고 권한. 관리자 패널 전체 접근. 접속 차단 불가(보호). 게시판 설정의 접근 권한 레벨 9에 해당.

9.1 권한과 게시판 접근 레벨의 관계

read_level=0 / write_level=0	비회원(비로그인) 포함 모든 방문자 접근 가능. role 무관.
read_level=1 / write_level=1	로그인한 회원만 접근 가능. role: member 이상(member/manager/admin 모두).
read_level=9 / write_level=9	관리자(role=admin)만 접근 가능.

10. 자주 묻는 질문 (FAQ)

Q1. 회원의 비밀번호를 확인할 수 있나요?

A. 불가능합니다. 비밀번호는 BCRYPT 단방향 해시로 암호화되어 저장됩니다. 원문 복원이 수학적으로 불가능한 구조입니다. 회원이 비밀번호를 잊었다면 관리자가 수정 폼에서 새 비밀번호를 설정해 주세요.

Q2. 관리자 계정을 실수로 비활성화할 수 있나요?

A. 불가능합니다. DXCMS는 role=admin 계정에 대한 차단 버튼을 UI에서 표시하지 않으며, 서버 측 POST 처리에서도 관리자 계정 비활성화를 차단합니다.

Q3. 회원 ID(login_id)를 변경하고 싶습니다.

A. 관리자 수정 폼에서 login_id는 읽기 전용으로 변경이 불가능합니다. 변경이 꼭 필요하다면 해당 회원을 삭제하고 새 ID로 재가입시키는 방법을 사용하세요. 단, 기존 게시글•댓글 연결은 끊어집니다.

Q4. 모니터링 패널이 표시되지 않습니다.

A. DxMemberMonitor 클래스가 시스템에 등록되어 있어야 합니다(class_exists("DxMemberMonitor") 조건). member_logs, member_sessions 테이블이 존재해야 합니다. 관련 플러그인이나 확장이 설치되어 있는지 확인하세요.

Q5. 검색이 되지 않거나 결과가 없습니다.

A. 검색어가 이름•아이디•이메일 중 어느 것과도 LIKE 매칭되지 않는 경우입니다. 정확한 키워드 일부를 입력하거나 검색어를 초기화하고 전체 목록을 확인하세요. 대소문자는 DB 콜레이션 설정에 따라 구분될 수 있습니다.

Q6. 회원을 대량으로 등록하려면?

A. 현재 버전의 관리자 UI에서는 회원을 1명씩 추가해야 합니다. 대량 등록이 필요하면 CSV 등을 파싱하여 DB에 직접 INSERT하는 별도 스크립트를 작성하거나 개발자에게 문의하세요.

Q7. 삭제된 회원의 게시글은 어떻게 되나요?

A. 회원 삭제 후 해당 회원의 게시글•댓글은 DB에 그대로 남습니다. 단, posts.member_id가 삭제된 회원 ID를 가리켜도 JOIN이 실패하여 작성자가 "(알 수 없음)" 또는 비어있게 표시될 수 있습니다. 게시글도 정리하려면 회원 삭제 전 게시글을 먼저 삭제하거나 별도 정리 절차를 거치세요.

Q8. 회원 목록을 엑셀로 내보내려면?

A. 현재 버전에서는 엑셀 내보내기 기능이 관리자 UI에 없습니다. DB에서 직접 SELECT INTO OUTFILE 또는 phpMyAdmin 등의 DB 관리 도구를 사용하여 내보내세요.

11. 용어 정리

용어	설명
members	회원 데이터를 저장하는 DB 테이블. id, login_id, password, name, email, role, status, memo, join_date, last_login, last_ip 컬럼.
login_id	회원 고유 로그인 아이디. 생성 후 변경 불가. 영문·숫자·_·- 허용.
password	BCRYPT 해시로 암호화된 비밀번호. password_hash() / password_verify() 사용.
role	회원 권한 등급. member(일반)/manager(운영진)/admin(최고관리자).
status	회원 활성 여부. 1: 정상 활성, 0: 접속 차단.
memo	관리자 비공개 메모. 회원에게는 표시되지 않음.
join_date	회원 가입 일시. 관리자가 직접 추가 시 현재 날짜/시간으로 자동 설정.
last_login	마지막 로그인 일시. 로그인 성공 시 자동 갱신.
last_ip	마지막 접속 IP 주소. 로그인 성공 시 자동 갱신.
$myId	현재 로그인 중인 관리자의 ID. 본인 계정 차단·삭제 방지에 사용.
$adminSub	관리자 URL의 서브 경로. /admin/members/{id} → adminSub = id. /admin/members/add → adminSub = "add".
DxMemberMonitor	회원 접속 모니터링 기능을 제공하는 클래스. getSummary·getLogs·getSessions·formatDuration·parseBrowser·parseOS 메서드 포함.
member_logs	DxMemberMonitor가 사용하는 이벤트 로그 테이블. event(login/logout/session_expire), ip, user_agent, created_at 컬럼.
member_sessions	DxMemberMonitor가 사용하는 세션 기록 테이블. login_at, logout_at, last_seen_at, duration_sec, end_reason, ip 컬럼.
total_logins	DxMemberMonitor::getSummary()가 반환하는 전체 누적 로그인 횟수.
avg_duration_sec	평균 세션 접속 시간(초). DxMemberMonitor::formatDuration()으로 "X시간 Y분" 형식 변환.
is_online	현재 접속 중 여부. last_seen_at이 5분 이내이면 온라인으로 판단.
act=status	POST 파라미터. 회원 상태(차단/해제) 변경 액션 식별자.
act=role	POST 파라미터. 회원 권한 변경 액션 식별자.
act=delete	POST 파라미터. 회원 삭제 액션 식별자.
CSRF 토큰	모든 POST 요청(추가/수정/상태변경/권한변경/삭제)에 자동 포함되는 보안 토큰.