전체 그림
⚙️시스템 관리
매일 아침 여는 대시보드부터, 외부 키를 담는 사이트 설정, 신자의 장애 신고 처리, 활동 로그, 그리고 원클릭 업데이트까지.
마지막 업데이트 2026-07-18
매일 아침 여는 대시보드부터, 외부 키를 담는 사이트 설정, 신자의 장애 신고 처리, 활동 로그, 그리고 원클릭 업데이트까지 다룹니다.
권한 안내
사이트 설정·업데이트는 슈퍼관리자 전용 — 위임 운영자에게는 보이지 않습니다.
0 · 관리자 메뉴 — 기본 메뉴와 즐겨찾기
- 관리자 왼쪽 메뉴는 처음에 “기본 메뉴” 모드로 시작합니다 — 주보·공지·일정·게시판·회원 같은 일상 운영 항목만 간추려 보여줍니다. 아래 토글로 언제든 “전체 메뉴”로 전환할 수 있습니다.
- 자주 쓰는 화면은 항목 옆 ☆(별)을 눌러 즐겨찾기에 담으세요 — 메뉴 상단의 즐겨찾기 묶음에 모입니다. 즐겨찾기는 계정별로 서버에 저장되어, 다른 컴퓨터에서 로그인해도 그대로 따라옵니다.
- 아직 정식 공개 전인 기능(편집실·성물방·주보 작성·발행 등)은 “베타” 묶음에 모여 있습니다.
1 · 대시보드 — 매일 아침 5분

- 처리 대기 알림 — AI 추출 검토, AI 임시저장, 기록대기 행사, 장애 신고 미처리 4종이 건수가 있을 때만 카드로 뜹니다.
- 빠른 작업 — 주보 업로드·공지 작성·일정 등록 등 6개 바로가기.
- 통계 — 회원·게시글·주보·오늘 방문 등 7종 숫자.
- 새 버전 배너 — 새 버전이 나오면 슈퍼관리자에게만 상단 배너가 뜹니다.
2 · 사이트 설정 — 외부 키의 금고

| 묶음 | 담는 것 |
|---|---|
| 사이트 | 사이트 URL, 추천 검색어, 사진 모아보기 접근 권한, 발신자 표시 |
| 이메일 | SMTP 서버·계정·비밀번호 (+ 연결 테스트 버튼) |
| AI | AWS Bedrock 키 3종 (주보 AI 추출용) |
| OAuth | 구글·카카오 로그인 키 + 카카오맵 키 |
| 보안 | AUTH_SECRET 등 (건드리지 않는 것이 원칙) |
- 비밀 값은 저장 후 “설정됨” 배지로만 표시됩니다.
- 빈 칸으로 저장하면 기존 값이 유지됩니다.
- 전례 시기·봉헌 목표 같은 값은 여기 없고 각 전용 화면에서 관리합니다.
주의 두 가지
OAuth·보안 키는 반영까지 최대 수 분 걸립니다. 즉시 적용하려면 서버 재시작이 필요합니다. AUTH_SECRET을 바꾸면 전 회원이 강제 로그아웃됩니다.
3 · 장애 신고 — 신자의 목소리

- 공개 사이트 푸터의 “장애 신고” 링크로 누구나 오류를 신고할 수 있습니다.
- 발생 페이지 주소가 자동으로 담겨 들어옵니다.
- 접수 → 처리중 → 완료로 상태를 바꾸고 내부 메모를 남깁니다.
이메일(SMTP) 설정
설정해 두면 신고 접수 즉시 운영 메일함으로 알림 메일이 발송됩니다(v2.0.9 이상). SMTP 미설정 본당은 대시보드의 “장애 신고 미처리” 카드로 확인하세요.
4 · 활동 로그 · 알림 발송 로그
- 활동 로그 — 관리자·운영자의 거의 모든 변경이 자동 기록됩니다. 조회 전용이며 삭제할 수 없습니다.
- 알림 발송 로그 — 분과 알림이 몇 명에게 나갔는지, 안 나갔다면 왜인지 배치별로 확인합니다.

5 · 기술 문서 — 사이트 안의 참고서

- 관리자 화면 안에 내장된 참고 문서입니다.
- 철학, 기능 가이드, 기술 스택, API 표, 변경 이력(슈퍼관리자용), 사용권 안내.
6 · 시스템 업데이트 — 원클릭 업그레이드

- 새 버전이 나오면 대시보드 배너와 버전 카드가 알려 줍니다.
- 업데이트 버튼으로 진행: DB 자동 백업 → 코드 갱신 → 빌드 → 재시작 → 상태 확인.
- 기동 실패 시 이전 버전으로 자동 복귀합니다.
- 진행 중 화면을 닫아도 계속 진행됩니다.
- 서버 저장공간 카드 — 업로드·백업 용량을 보여주고 정리 기능 제공.
- 운영 지표 전송 토글 — 익명 운영 지표(성능·오류 통계)를 개발팀에 보낼지 이 화면에서 켜고 끕니다. 개인정보·콘텐츠는 포함되지 않으며, 옆 ? 버튼에 자세한 설명이 있습니다.
- 정식버전 배지 — 발급된 사이트 키가 확인된 공식 등록 사이트에는 “✓ 정식버전” 배지가 표시됩니다.
자동 복귀 안내
자동 복귀는 코드를 되돌리는 것이며, 업데이트 중 변경된 데이터까지 복구하는 것은 아닙니다.
자주 묻는 질문
Q.사이트 설정 메뉴가 안 보여요
슈퍼관리자 전용입니다. 위임 운영자 계정에는 보이지 않습니다.
Q.카카오맵 키는 어느 묶음인가요
“OAuth” 묶음에 함께 있습니다 (KAKAO_MAP_KEY).
Q.키를 바꿨는데 바로 적용이 안 돼요
OAuth·보안 항목은 최대 수 분 걸립니다. 급하면 서버 재시작.
Q.장애 신고가 온 걸 몰랐어요
이메일(SMTP)을 설정하면 접수 즉시 운영 메일함으로 알림이 옵니다(v2.0.9 이상). 미설정이면 대시보드 미처리 카드를 확인하세요.
Q.활동 로그에 영어가 보여요
새로 추가된 작업이 드물게 영문으로 보일 수 있으며 기록 자체는 정상입니다 (v2.0.9부터 대부분 한글화).
Q.전례 시기 색은 어디서 바꾸나요
사이트 설정이 아니라 [레이아웃 › 전례 시기 테마]입니다.
Q.업데이트가 실패하면요
자동으로 이전 버전으로 복귀합니다. 반복 실패하면 서버 저장공간과 진행 로그를 확인하고 설치 지원에 문의하세요.
Q.업데이트 버튼 대신 “공식 등록 사이트에서 이용할 수 있습니다” 안내가 떠요
버튼 업데이트는 공식 등록된 사이트에서만 동작합니다. 화면의 안내를 따라 도입 문의로 공식 등록을 요청하세요.