문서 전체 지도
SOLE 문서는 얇은 기능 소개가 아니라 운영 매뉴얼에 가까워야 해요. 모듈만 32개이고, 설정 스키마는 53개, AI가 다룰 수 있는 작업 카탈로그도 85개예요. 그래서 최종 문서는 수십 페이지가 아니라 수백 페이지 규모로 보는 것이 맞아요.
[!팁] 지금 이 페이지의 목적 여기서는 “어떤 페이지에 어떤 내용을 넣을지”를 확정해요. 실제 본문과 캡처는 우선순위가 높은 묶음부터 한 페이지씩 완성해요.
최종 규모
| 묶음 | 예상 페이지 수 | 기준 | | --- | --- | | 시작과 개념 | 15-25 | 초대, 로그인, 서버 선택, 권한, 저장·적용·게시, 시스템 점검 | | AI로 만들기 | 25-40 | Architect, 작업실, 서버 빌드, 자동화, 이미지, 승인, 크레딧 | | 모듈 상세 | 140-220 | 32개 모듈을 개요, 설정, 옵션, 문제해결로 분리 | | 자동화 레퍼런스 | 30-60 | 트리거, 조건, 동작, 디버그, 실행 로그, 안전 제한 | | 마켓플레이스와 결제 | 25-40 | 설치, 구매, 셀러, 스튜디오, 크레딧, 요금제 | | 문제해결 | 30-50 | 권한, 역할 순서, 게시 실패, AI 실패, 결제 실패 |
최종 목표는 대략 200-350페이지예요. 모든 페이지를 한 번에 얇게 만들지 않고, 사용자가 가장 많이 막히는 기능부터 실제 화면 캡처와 함께 완성해요.
공통 페이지 단위
| 페이지 단위 | 내용 |
|---|---|
| 개요 | 기능이 해결하는 문제, 언제 쓰는지, 필요한 권한 |
| 설정하기 | 패널에서 켜고 저장, 적용, 게시, 테스트하는 실제 순서 |
| 세부 옵션 | 채널, 역할, 메시지, 제한값, 템플릿 변수, 예외 처리 |
| AI로 맡기기 | Architect에게 어떤 말로 요청하면 되는지와 승인 범위 |
| 운영 팁 | 실서버에서 안전하게 켜는 순서, 권장값, 주의할 흐름 |
| 문제해결 | 안 될 때 확인할 권한, 상태, 흔한 실수 |
단순한 기능은 네 장이면 충분해요. 티켓, 녹음, TTS, 자동화처럼 화면과 상태가 많은 기능은 더 쪼개요.
시작하기 묶음
| 페이지 | 넣을 내용 |
|---|---|
| 소개 | SOLE의 역할, 제품 영역, 문서 읽는 법 |
| 빠른 시작 | 초대, 로그인, 서버 선택, 첫 기능 설정 |
| 서버 선택과 권한 | 서버가 안 보이는 이유, 서버 관리 권한, 봇 권한 |
| 저장·적용·게시 | 버튼별 의미와 기능별 반영 시점 |
| 시스템 점검 | 봇 권한, 채널 접근, 역할 순서, 최근 오류 |
| 패널 접근 권한 | 서버 관리자와 기능별 위임 권한 |
| 용어 사전 | 모듈, 패널, 작업실, 게시, 적용, 크레딧 같은 기본 용어 |
AI로 만들기 묶음
| 페이지 | 넣을 내용 |
|---|---|
| SOLE Architect 개요 | 말로 서버를 만들 수 있는 범위와 안전 승인 구조 |
| AI 작업실 사용법 | 대화, 실행 상태, 질문, 승인 카드, 변경 패널, 파일 패널 |
| 서버 초안 만들기 | 채널, 카테고리, 역할, 권한, 운영진 공간 설계 |
| 온보딩 구성 | Discord 커뮤니티, 기본 채널, 안내 화면, 온보딩 질문 |
| SOLE 기능 연결 | 웰컴, 티켓, 역할 패널, AutoMod, 공지 같은 모듈 설정 |
| 자동화 만들기 | 자연어 요청을 트리거, 조건, 동작으로 바꾸는 흐름 |
| 서버 이미지 만들기 | 아이콘, 배너, 입장 이미지, 패널 아트 생성과 선택 |
| 승인과 위험 작업 | 삭제, 권한 변경, 역할 순서, 대량 변경의 승인 기준 |
| 크레딧과 실행 제한 | 크레딧 차감, 실행 실패, 재시도, 첨부 제한 |
| 좋은 요청 예시 | 게임, 스터디, 고객지원, 크리에이터, 학교 서버별 요청문 |
온보딩 & 멤버 묶음
| 기능 | 필요한 페이지 |
|---|---|
| 웰컴 | 개요, 환영 메시지, 퇴장 메시지, DM, CAPTCHA 인증, 자동 역할, 변수, 테스트, 문제해결 |
| 역할 패널 | 개요, 버튼 역할, 셀렉트 역할, 패널 메시지, 게시와 갱신, 역할 순서, 문제해결 |
| 티켓 | 개요, 패널 만들기, 티켓 채널, 스태프 권한, 접수 폼, 닫기와 재열기, 로그와 보관, 게시, 문제해결 |
| 폼 | 개요, 질문 타입, 제출 채널, 승인 흐름, 첨부와 개인정보, 미리보기, 문제해결 |
| 초대 추적기 | 개요, 초대 링크 추적, 멤버별 초대 기록, 이탈 기록, 보상 연결, 문제해결 |
운영 & 보안 묶음
| 기능 | 필요한 페이지 |
|---|---|
| 모더레이션 | 개요, 로그 수집, 멤버 타임라인, 백필, 타임아웃·밴·킥 기록, 문제해결 |
| AutoMod | 개요, 금칙어, 링크, 스팸, 멘션, 제재 강도, 예외 채널·역할, 테스트, 문제해결 |
| 감사 로그 | 개요, 관리자 작업 기록, 자동화 기록, 필터, 페이로드 확인, 보존 범위 |
| 공지 | 개요, 예약 공지, 반복 주기, 메시지 템플릿, 히스토리, 미리보기, 문제해결 |
| 일반 알림 | 개요, 예약 알림, 대상 채널, 반복 조건, 실패 상태, 문제해결 |
| YouTube 알림 | 채널 찾기, 업로드 감지, 메시지 템플릿, 전송 채널, 문제해결 |
| 치지직 알림 | 채널 찾기, 방송 시작 감지, 메시지 템플릿, 전송 채널, 문제해결 |
| 시스템 점검 | 권한 점검 항목, 역할 순서, 채널 접근, 모듈 상태, 최근 오류 |
| 패널 접근 권한 | 유저·역할별 모듈 위임, 관리자 영역 제한, 권한 제거 |
커뮤니티 묶음
| 기능 | 필요한 페이지 |
|---|---|
| 레벨 | 개요, XP 규칙, 보상 역할, 알림 메시지, 리더보드, 멤버 XP 조정, 문제해결 |
| 하이라이트 | 개요, 보드, 반응 기준, 제외 채널, 첨부 처리, 주간 요약, 문제해결 |
| 투표 | 개요, 패널, 투표 만들기, 시작 대기, 진행 중, 종료, 결과 공개, 문제해결 |
| 추첨 | 개요, 참여 조건, 당첨자 추첨, 재추첨, 기록, 문제해결 |
| 생일 | 개요, 생일 등록, 축하 메시지, 시간대, 역할 보상, 문제해결 |
| 이코노미 | 개요, 코인, 일일 보상, 송금, 관리자 조정, 리더보드, 문제해결 |
| 음악 퀴즈 | 개요, 문제 은행, 게임 진행, 점수판, 보상, 문제해결 |
| 이모지 | 개요, 이모지 추가, 명령 접근, 역할 제한, 저장된 이모지, 문제해결 |
음성 & 미디어 묶음
| 기능 | 필요한 페이지 |
|---|---|
| 음악 | 개요, 재생과 큐, 검색과 플레이리스트, DJ 역할, 채널 제한, 공개 플레이어, 가사, 문제해결 |
| 음악 설정 | Lavalink 상태, 노드, 소스, 자동 연결, 세션 상태, 문제해결 |
| 녹음 | 개요, 녹음 시작과 종료, 보관 기간, 공지와 DM, 다운로드, 권한, 문제해결 |
| 전사와 요약 | 처리 상태, 화자, 타임라인, 요약 재생성, 요약 채팅, 내보내기 |
| 음성 명령 | 호출어, 음악 제어, 권한, 오인식 줄이기, 문제해결 |
| TTS | 개요, 채널 설정, 음성 선택, 런타임 연결, 모델 사용, 미리듣기, 문제해결 |
| 보이스 랩 | 음성 등록, 동의, 녹음 품질, 업로드, 학습 상태, 문제해결 |
자동화 & 도구 묶음
| 기능 | 필요한 페이지 |
|---|---|
| 자동화 허브 | 워크플로 목록, 활성 상태, 실행 기록, 권한과 요금제 |
| 워크플로 편집기 | 노드, 연결선, 변수, 저장, 컴파일, 시뮬레이션 |
| 트리거 | 멤버 입장, 메시지, 반응, 버튼, 명령, 티켓, 예약 실행 |
| 조건 | 채널, 역할, 텍스트, 링크, 시간대, 재실행 간격, 예외 |
| 동작 | 메시지 보내기, 역할 지급, 반응, 스레드, 타임아웃, 로그 |
| 디버그 | 테스트 실행, 디버그 세션, 트레이스, 실패 원인 |
| 맞춤 명령어 | 명령 만들기, 변수, 응답 메시지, 권한, 문제해결 |
| 임베드 생성기 | 템플릿, 버튼, 셀렉트, 이미지 업로드, 게시, 문제해결 |
| 검색 | 검색 제공자, 서버별 설정, 명령 사용, 문제해결 |
| 파일 공유 | 파일 항목, 다운로드 접근, 만료, 삭제, 문제해결 |
| 통계 채널 | 멤버 수, 온라인 수, 이름 템플릿, 갱신 주기, 문제해결 |
| 임시 음성 채널 | 허브, 자동 생성, 소유자 제어, 제한, 문제해결 |
게임 & 생활 연동 묶음
| 기능 | 필요한 페이지 |
|---|---|
| 마인크래프트 | 서버 연결, 상태 표시, 채팅 연동, 역할 동기화, 페어링, 문제해결 |
| Riot | 계정 조회, 전적 조회, 매치 정보, 권한과 제한, 문제해결 |
| 학교 | 학교 검색, 급식, 시간표, 프로필, 지역 데이터, 문제해결 |
| 날씨 | 도시 조회, 명령 사용, 지역 이름, 문제해결 |
마켓플레이스 & 결제 묶음
| 페이지 | 넣을 내용 |
|---|---|
| 마켓플레이스 개요 | 상품 유형, 베타 상태, 설치 흐름 |
| 상품 탐색 | 검색, 카테고리, 상세 화면, 리뷰, 필요 권한 |
| 설치와 내 구매 | 무료 설치, 유료 구매, 라이브러리 추가, 재설치 |
| 임베드 팩 사용 | 팩에서 불러오기, 메시지 편집기 연결, 게시 |
| 셀러 스튜디오 | 셀러 등록, 상품 목록, 정산 전제 |
| 크리에이터 스튜디오 | 상품 초안, 미리보기, 가격, 버전, 심사 제출 |
| 크레딧 | 잔액, 사용 내역, 충전, 실패 처리 |
| 요금제 | 플랜별 기능, 서버 적용, 변경과 취소 |
| 결제 문제 | 결제 실패, 쿠폰, 영수증, 환불, 결제수단 변경 |
문제해결 묶음
| 페이지 | 넣을 내용 |
|---|---|
| 서버가 안 보여요 | Discord 권한, 로그인 계정, 봇 초대 상태 |
| 봇이 동작하지 않아요 | 봇 권한, 역할 순서, 채널 접근, 명령 동기화 |
| 저장했는데 반영되지 않아요 | 저장, 적용, 게시, 테스트 차이 |
| 게시가 실패해요 | 채널 삭제, 메시지 권한, 임베드 권한, 컴포넌트 제한 |
| 역할이 지급되지 않아요 | 역할 관리 권한, 역할 순서, 관리자 역할 제한 |
| AI 작업이 멈췄어요 | 질문 대기, 승인 대기, 크레딧, 실행 취소, 재시도 |
| 이미지 첨부가 안 돼요 | 지원 형식, 장수, 용량, 작업실 위치 |
| 녹음이 처리되지 않아요 | 세션 상태, 음성 권한, 처리 작업, 다운로드 준비 |
| 자동화가 실행되지 않아요 | 워크플로 활성화, 조건, 봇 메시지 제외, 실행 로그 |
| 결제가 실패해요 | 결제 승인, 쿠폰, 구독 상태, 서버 적용 |
캡처 기준
| 위치 | 이미지 기준 |
|---|---|
| 소개 | 제품 전체를 설명하는 표와 링크 중심. 무리한 AI 작업실 풀샷은 넣지 않아요 |
| 빠른 시작 | 홈페이지 버튼과 로그인 같은 진입 화면만 실제 캡처해요 |
| AI 문서 | 실제 AI 작업실, 변경 패널, 파일 패널, 승인 카드만 캡처해요 |
| 모듈 문서 | 해당 모듈의 실제 패널 화면만 캡처해요 |
| 문제해결 | 오류 배지, 시스템 점검, 권한 경고처럼 원인을 보여 주는 화면만 캡처해요 |
화면 캡처는 기능 설명을 대신하는 장식이 아니에요. 독자가 “이 화면에서 무엇을 봐야 하는지”를 알 수 있을 때만 넣어요.