@restnfeel/agentc-starter-kit
Version:
한국어 기업용 CMS 모듈 - Task Master AI와 함께 빠르게 웹사이트를 구현할 수 있는 재사용 가능한 컴포넌트 시스템
342 lines (221 loc) • 9.26 kB
Markdown
# AgentC 다중 사이트 관리 시스템 관리자 교육 가이드
## 목차
1. [시스템 개요](#시스템-개요)
2. [관리자 인터페이스 소개](#관리자-인터페이스-소개)
3. [사이트 생성 및 관리](#사이트-생성-및-관리)
4. [템플릿 관리](#템플릿-관리)
5. [도메인 설정](#도메인-설정)
6. [사용자 권한 관리](#사용자-권한-관리)
7. [모니터링 및 유지보수](#모니터링-및-유지보수)
8. [문제 해결](#문제-해결)
## 시스템 개요
### AgentC 다중 사이트 관리 시스템이란?
AgentC 다중 사이트 관리 시스템은 하나의 중앙 관리 인터페이스에서 여러 고객 사이트를 효율적으로 관리할 수 있는 플랫폼입니다.
### 주요 기능
- **중앙 집중식 사이트 관리**: 모든 고객 사이트를 한 곳에서 관리
- **템플릿 기반 사이트 생성**: 표준화된 템플릿으로 빠른 사이트 구축
- **도메인 관리**: 서브도메인 및 커스텀 도메인 설정
- **권한 관리**: 사이트별 접근 권한 제어
- **실시간 모니터링**: 사이트 상태 및 성능 모니터링
## 관리자 인터페이스 소개
### 로그인 및 대시보드 접근
1. **로그인 페이지 접속**
- URL: `https://your-domain.com/admin/login`
- 관리자 계정으로 로그인
2. **대시보드 개요**
- 전체 사이트 현황
- 최근 활동 내역
- 시스템 상태 정보
### 메인 네비게이션
- **사이트 관리** (`/admin/sites`): 모든 사이트 목록 및 관리
- **사용자 관리** (`/admin/users`): 사용자 계정 및 권한 관리
- **템플릿 관리** (`/admin/templates`): 사이트 템플릿 관리
- **설정** (`/admin/settings`): 시스템 전반 설정
## 사이트 생성 및 관리
### 새 사이트 생성
#### 1단계: 기본 정보 입력
1. **사이트 관리** 페이지에서 **"새 사이트 생성"** 버튼 클릭
2. 다음 정보 입력:
- **사이트 이름**: 고객사 또는 프로젝트 이름
- **슬러그**: URL에 사용될 고유 식별자 (자동 생성됨)
- **설명**: 사이트에 대한 간단한 설명
#### 2단계: 템플릿 선택
1. **비즈니스 템플릿**: 일반 기업 사이트용
- 회사 소개, 서비스, 연락처 페이지 포함
- 깔끔하고 전문적인 디자인
2. **포트폴리오 템플릿**: 개인 또는 크리에이티브 업체용
- 작품 갤러리, 프로필, 연락처 페이지 포함
- 시각적으로 매력적인 디자인
#### 3단계: 도메인 설정
1. **서브도메인 사용**: `sitename.agentc.com` 형태
2. **커스텀 도메인**: 고객의 독립 도메인 연결
3. **나중에 설정**: 사이트 생성 후 도메인 설정
### 사이트 목록 관리
#### 사이트 상태 이해
- **활성**: 정상 운영 중인 사이트
- **비활성**: 일시적으로 비활성화된 사이트
- **초안**: 아직 공개되지 않은 사이트
- **보관**: 더 이상 사용하지 않는 사이트
#### 검색 및 필터링
1. **텍스트 검색**: 사이트 이름으로 검색
2. **상태별 필터**: 특정 상태의 사이트만 표시
3. **정렬**: 생성일, 이름, 상태별 정렬
#### 대량 작업
1. **여러 사이트 선택**: 체크박스로 다중 선택
2. **일괄 상태 변경**: 선택된 사이트들의 상태 일괄 변경
3. **일괄 템플릿 적용**: 여러 사이트에 동일한 템플릿 적용
### 개별 사이트 관리
#### 사이트 편집
1. **기본 정보 수정**
- 사이트 이름, 설명 변경
- 슬러그 수정 (주의: URL 변경됨)
2. **상태 관리**
- 실시간 게시/비게시 토글
- 상태 변경 시 즉시 반영
3. **도메인 설정**
- 서브도메인 변경
- 커스텀 도메인 추가/수정
#### 사이트 미리보기
- **미리보기 버튼**: 새 탭에서 사이트 확인
- **편집 모드**: 사이트 내용 직접 편집
## 템플릿 관리
### 템플릿 유형
#### 비즈니스 템플릿
- **용도**: 일반 기업, 서비스업체
- **포함 페이지**: 홈, 회사소개, 서비스, 연락처
- **특징**: 전문적이고 신뢰감 있는 디자인
#### 포트폴리오 템플릿
- **용도**: 개인 작가, 디자이너, 크리에이티브 에이전시
- **포함 페이지**: 홈, 포트폴리오, 소개, 연락처
- **특징**: 시각적 임팩트가 강한 디자인
### 템플릿 적용 및 변경
1. **사이트 편집** 페이지에서 **"템플릿 변경"** 선택
2. 원하는 템플릿 선택
3. **미리보기**로 변경 결과 확인
4. **적용** 버튼으로 변경 완료
⚠️ **주의사항**: 템플릿 변경 시 기존 콘텐츠가 새 템플릿 구조에 맞게 재배치됩니다.
## 도메인 설정
### 서브도메인 설정
1. **자동 생성**: 사이트 슬러그 기반으로 자동 생성
- 예: `mycompany.agentc.com`
2. **수동 설정**: 원하는 서브도메인 직접 입력
- 중복 확인 후 설정
### 커스텀 도메인 연결
#### 1단계: DNS 설정 안내
고객에게 다음 DNS 설정을 안내:
```
CNAME 레코드:
이름: www (또는 원하는 서브도메인)
값: your-site.agentc.com
A 레코드 (루트 도메인용):
이름: @
값: 123.456.789.123 (AgentC 서버 IP)
```
#### 2단계: 도메인 검증
1. **도메인 입력**: 연결할 도메인 주소 입력
2. **DNS 검증**: 시스템이 자동으로 DNS 설정 확인
3. **SSL 인증서**: 자동으로 SSL 인증서 발급 및 적용
#### 3단계: 최종 확인
- 도메인 접속 테스트
- HTTPS 연결 확인
- 리다이렉션 설정 확인
## 사용자 권한 관리
### 권한 레벨
1. **슈퍼 관리자**: 모든 기능 접근 가능
2. **사이트 관리자**: 특정 사이트들만 관리 가능
3. **편집자**: 콘텐츠 편집만 가능
4. **뷰어**: 읽기 전용 접근
### 사용자 초대
1. **사용자 관리** 페이지에서 **"사용자 초대"** 클릭
2. 이메일 주소 및 권한 레벨 설정
3. 초대 이메일 자동 발송
4. 사용자가 초대 링크를 통해 계정 활성화
### 권한 수정
1. 기존 사용자 목록에서 수정할 사용자 선택
2. 권한 레벨 변경
3. 사이트별 접근 권한 설정
4. 변경사항 즉시 적용
## 모니터링 및 유지보수
### 사이트 상태 모니터링
#### 대시보드 지표
- **전체 사이트 수**: 관리 중인 총 사이트 개수
- **활성 사이트**: 현재 운영 중인 사이트
- **트래픽 현황**: 사이트별 방문자 통계
- **저장공간 사용량**: 사이트별 용량 사용 현황
#### 알림 설정
1. **사이트 다운**: 사이트 접속 불가 시 즉시 알림
2. **높은 트래픽**: 평소보다 높은 트래픽 발생 시 알림
3. **저장공간 부족**: 용량 한계 근접 시 알림
4. **SSL 만료**: SSL 인증서 만료 예정 시 알림
### 정기 유지보수
#### 주간 작업
- [ ] 모든 사이트 접속 상태 확인
- [ ] 백업 상태 점검
- [ ] 보안 업데이트 확인
#### 월간 작업
- [ ] 사용량 통계 리포트 생성
- [ ] 성능 최적화 검토
- [ ] 사용자 권한 검토
#### 분기별 작업
- [ ] 전체 시스템 보안 감사
- [ ] 백업 복원 테스트
- [ ] 재해 복구 계획 점검
## 문제 해결
### 일반적인 문제들
#### 사이트 접속 불가
**증상**: 사이트에 접속할 수 없음
**해결 방법**:
1. 사이트 상태 확인 (활성 상태인지)
2. 도메인 설정 확인
3. DNS 설정 검증
4. 서버 상태 확인
#### 템플릿 적용 오류
**증상**: 템플릿 변경 후 사이트가 제대로 표시되지 않음
**해결 방법**:
1. 브라우저 캐시 클리어
2. 템플릿 재적용
3. 콘텐츠 재배치 확인
#### 도메인 연결 실패
**증상**: 커스텀 도메인이 연결되지 않음
**해결 방법**:
1. DNS 설정 재확인
2. DNS 전파 대기 (최대 48시간)
3. 도메인 등록 상태 확인
### 고급 문제 해결
#### 데이터베이스 문제
**증상**: 사이트 데이터가 표시되지 않음
**해결 방법**:
1. 데이터베이스 연결 상태 확인
2. 백업에서 데이터 복원
3. 기술 지원팀 연락
#### 성능 문제
**증상**: 사이트 로딩이 느림
**해결 방법**:
1. 이미지 최적화
2. 캐시 설정 확인
3. CDN 설정 검토
## 지원 및 연락처
### 기술 지원
- **이메일**: tech-support@agentc.com
- **전화**: 02-1234-5678
- **운영시간**: 평일 09:00-18:00
### 긴급 상황
- **24시간 긴급 지원**: emergency@agentc.com
- **긴급 전화**: 010-1234-5678
### 추가 자료
- **온라인 문서**: https://docs.agentc.com
- **비디오 튜토리얼**: https://tutorials.agentc.com
- **커뮤니티 포럼**: https://community.agentc.com
## 부록
### 키보드 단축키
- `Ctrl + N`: 새 사이트 생성
- `Ctrl + S`: 변경사항 저장
- `Ctrl + P`: 사이트 미리보기
- `Esc`: 모달 창 닫기
### 브라우저 호환성
- **권장 브라우저**: Chrome 90+, Firefox 88+, Safari 14+
- **모바일**: iOS Safari, Android Chrome
### 시스템 요구사항
- **인터넷 연결**: 안정적인 브로드밴드 연결
- **화면 해상도**: 최소 1280x720
- **JavaScript**: 활성화 필수