🛠️ 관리자 사용법
실벗을 운영하는 관리자를 위한 안내입니다. 회원·SOS·결제 현황을 한눈에 보고, 동네 복지 정보를 등록할 수 있습니다.
🔐
관리자 전용 화면입니다.
관리자 권한(role=admin)을 가진 계정으로 로그인해야 관리자 화면에 들어갈 수 있습니다. 일반 회원에게는 보이지 않습니다.
관리자 권한(role=admin)을 가진 계정으로 로그인해야 관리자 화면에 들어갈 수 있습니다. 일반 회원에게는 보이지 않습니다.
관리자 대시보드에서 볼 수 있는 것
👥
회원 현황
전체·활성·대기·오늘 가입 수
💬
오늘의 대화
오늘 오간 AI 대화 수
🚨
SOS 현황
진행 중·오늘 발생 SOS
💳
구독·매출
활성 구독 수, 이달 매출
관리자가 하는 일
- 1회원 관리회원을 검색하고, 상태(대기·활성·정지·삭제)를 바꿀 수 있습니다.
- 2SOS·결제 점검긴급 SOS 기록과 결제 내역을 확인합니다.
- 3우리 동네 정보 등록경로식당·건강검진·복지관 행사 등을 등록하면 어르신 화면에 나타납니다.
[관리자용] 관리 기능은 어떻게 작동하나요?
관리자 API(/api/v1/admin/*)는 모두 require_admin()으로 보호되어, 관리자만 호출할 수 있습니다.
| 기능 | API | 설명 |
|---|---|---|
| 통계 | GET /admin/stats | 회원·대화·SOS·구독·매출·동네행사 수치를 한 번에 집계 |
| 회원 목록 | GET /admin/users | 이메일·이름으로 검색, 최근 200명 |
| 상태 변경 | POST /admin/users/{id}/status | pending/active/suspended/deleted |
| SOS 기록 | GET /admin/sos | 최근 100건 SOS와 어르신 정보 |
| 결제 내역 | GET /admin/payments | 최근 100건 결제 |
| 감사 로그 | GET /admin/audit | 중요 행위 기록 200건 |
| 동네 등록 | POST /admin/village | 지역·종류·기간·장소·연락처로 등록 |
| 동네 비활성 | DELETE /admin/village/{id} | 지우지 않고 숨김 처리 |
- 감사 로그(audit_logs): 회원 상태 변경, 결제 성공, 구독 취소 등 중요한 행위는 누가·언제·무엇을 했는지 모두 기록됩니다.
- 매출 집계: ‘paid’ 상태 결제 중 이번 달 것만 합산합니다.