운영자 콘솔 사용법 (운영자)

## 운영자 콘솔이란 `/admin` 은 **플랫폼 전체를 운영하는 콘솔**입니다. 고객이 쓰는 `/settings` 와 역할이 명확히 다릅니다. | | `/admin` 운영자 콘솔 | `/settings` 고객 설정 | |---|---|---| | 누가 | 서비스 운영자 | 각 고객 워크스페이스 | | 무엇을 | 플랫폼 앱 자격증명 · 전체 현황 | 자기 회사 채널 연동 · 알림 | | 값의 범위 | **전체 고객 공유** | 해당 워크스페이스만 | ## 8개 탭 | 탭 | 하는 일 | |---|---| | **개요** | 전체 워크스페이스 수 · 활성 수 · 유료 플랜 수 · 전체 사용자 · 오늘 신규 가입 · 최근 관리 이벤트 | | **콘텐츠** | 공지사항 · **이용가이드** · 자주 묻는 질문 · 블로그 작성·발행 | | **리드 수집** | 데모 신청·문의 폼으로 들어온 리드 목록 | | **워크스페이스** | 고객 워크스페이스 목록 | | **사용자** | 전체 계정 목록 | | **연동** | **워크스페이스별 연동 현황** — JIRA · Meta Ads · Gmail · Telegram · KB Bank · AI Key | | **소셜 로그인** | Google · Kakao · Naver · Apple 로그인 자격증명 | | **사용량** | AI 사용량·비용 추이 | | **감사 로그** | 관리 이벤트 전체 이력 | ## 자격증명은 어디에 넣나 ### 소셜 로그인 (로그인용) **소셜 로그인** 탭 → Google · Kakao · Naver · Apple 섹션에 각 플랫폼에서 발급받은 Client ID / Secret 을 입력합니다. 이 값은 **운영자가 한 번만** 설정하면 전체 고객이 사용합니다. ### 데이터 연동 플랫폼 (YouTube · Meta · Cafe24 등) 플랫폼별 앱 자격증명을 해당 섹션에 입력합니다. 등록 절차는 각 플랫폼 문서를 참고하세요. - [Google 앱 등록](/news/guide/operator-google) - [Meta 앱 등록](/news/guide/operator-meta) - [Naver 앱 등록](/news/guide/operator-naver) - [Kakao 앱 등록](/news/guide/operator-kakao) - [Cafe24 앱 등록](/news/guide/operator-cafe24) - [스마트스토어 앱 등록](/news/guide/operator-smartstore) - [오픈뱅킹 사용기관 등록](/news/guide/operator-openbanking) - [Outlook 앱 등록](/news/guide/operator-outlook) ### 저장 후 - 값은 **암호화 저장**되며 화면에는 마스킹됩니다 - **다시 조회할 수 없습니다.** 발급 원본은 별도로 보관하세요 - 변경은 **감사 로그**에 기록됩니다 ## 이용가이드 문서 작성·수정 **콘텐츠** 탭 → **이용가이드** 를 선택합니다. | 필드 | 역할 | |---|---| | **카테고리** | 가이드 사이드바의 대분류. 정해진 목록에서 선택하세요 | | **제목** | 사이드바·목록에 표시 | | **Slug** | URL — `/news/guide/<slug>` | | **요약** | 카드·검색 결과에 표시 | | **노출 순서** | 카테고리 안에서의 순서 (작은 값이 위) | | **본문** | 마크다운 | ### 작성 규칙 - **카테고리는 정해진 목록만** 쓰세요. 목록 밖의 값을 쓰면 사이드바 맨 뒤로 밀립니다 - **Slug 는 바꾸지 마세요.** 다른 문서의 링크가 깨집니다 - **노출 순서는 10 단위**로 부여하세요 (10, 20, 30…). 중간 삽입이 쉬워집니다 - 본문은 **h2 · h3** 만 쓰세요 (h1 은 제목이 이미 차지합니다) - **표를 적극 쓰세요.** 준비물·오류 대응은 표가 훨씬 읽기 쉽습니다 ### 발행 전 미리보기 **초안** 상태로 저장한 뒤 미리보기를 열면 실제 공개 화면 그대로 확인할 수 있습니다. 초안은 비로그인 사용자에게 보이지 않습니다. ### 이미지 넣기 에디터에서 이미지를 업로드하면 마크다운에 삽입됩니다. 플랫폼 콘솔 스크린샷을 넣으면 가이드 품질이 크게 올라갑니다. ### AI 초안 생성 제목과 지시사항을 넣으면 초안을 만들어 줍니다. 이용가이드로 생성하면 정해진 카테고리와 서술 순서를 따르도록 유도됩니다. **초안은 반드시 사람이 검수**하세요 — 실제 화면·필드명과 다를 수 있습니다. ## 대량 작성은 원고 파일로 문서를 수십 개 한 번에 넣어야 하면 웹 폼보다 원고 파일이 빠릅니다. 저장소의 `docs/guide/**/*.md` 에 원고를 작성하고 시드 스크립트를 실행하면 `(종류=guide, slug)` 기준으로 등록됩니다. ```bash python3 scripts/seed_guide_posts.py --dry-run ``` - 기본 동작은 **기존 문서 건너뛰기** — 콘솔에서 편집한 내용을 보호합니다 - 원고를 정본으로 밀어붙일 때만 `--force` 를 씁니다 - `--publish` 를 붙이면 발행까지 진행됩니다 ## 운영 중 점검 | 주기 | 확인 | |---|---| | 월 1회 | **감사 로그** — 예상치 못한 자격증명 변경이 있는지 | | 월 1회 | **연동** 탭 — 워크스페이스별로 끊긴 연동이 있는지 | | 월 1회 | **사용량** 탭 — AI 비용 추이가 급증하지 않았는지 | | 만료 관리 | Azure 클라이언트 비밀 등 만료가 있는 자격증명 | ## 관련 문서 - [OAuth 앱 등록 개요](/news/guide/operator-oauth-overview) - [심사 준비 체크리스트](/news/guide/operator-review)