전체 그림
⚙️시스템 관리
매일 아침 여는 대시보드부터, 외부 키를 담는 사이트 설정, 신자의 장애 신고 처리, 활동 로그, 그리고 원클릭 업데이트까지.
마지막 업데이트 2026-08-01
매일 아침 여는 대시보드부터, 외부 키를 담는 사이트 설정, 신자의 장애 신고 처리, 활동 로그, 그리고 원클릭 업데이트까지 다룹니다.
권한 안내
사이트 설정·업데이트는 슈퍼관리자 전용 — 위임 운영자에게는 보이지 않습니다.
0 · 관리자 메뉴 — 기본 메뉴와 즐겨찾기
- 관리자 왼쪽 메뉴는 처음에 “기본 메뉴” 모드로 시작합니다 — 주보·공지·일정·게시판·회원 같은 일상 운영 항목만 간추려 보여줍니다. 아래 토글로 언제든 “전체 메뉴”로 전환할 수 있습니다. (최고관리자 화면 기준입니다.)
- 자주 쓰는 화면은 항목 옆 ☆(별)을 눌러 즐겨찾기에 담으세요 — 메뉴 상단의 즐겨찾기 묶음에 모입니다. 즐겨찾기는 계정별로 서버에 저장되어, 다른 컴퓨터에서 로그인해도 그대로 따라옵니다.
- 아직 정식 공개 전인 기능(편집실·성물방·주보 작성·발행 등)은 “베타” 묶음에 모여 있습니다.
- 화면 오른쪽 위 [사용설명서] 버튼은 지금 보고 있는 화면의 설명서로 바로 갑니다 — 목차에서 다시 찾을 필요가 없습니다(v2.14.0 이상).
- 그 옆 [릴리스 안내]는 세파스의 새 버전·변경 소식을 모아 둔 공지로 갑니다(v2.15.0 이상).
- 관리 화면 위쪽 “사이트맵”은 지금 보고 있는 페이지가 어느 묶음에 속하는지 알려주고, 같은 묶음의 다른 화면으로 바로 건너뛰는 탭을 함께 보여줍니다 — 왼쪽 메뉴를 열지 않아도 옆 화면으로 오갈 수 있습니다(v2.16.0 이상).
- 로그인이 만료되면 보고 있던 화면이 곧바로 로그인 화면으로 바뀝니다 — 예전에는 최대 30초간 그대로 남아 있었습니다(v2.15.0 이상). 작업 중에는 자동으로 연장되고, 25분간 아무 조작이 없으면 안내 후 자동 로그아웃됩니다.
- 권한이 없는 화면에 들어가면 빈 화면 대신 “접근 권한이 없습니다”와 무엇이 필요한지가 나옵니다(v2.10.0 이상).
v2.19.0 이상이 기능은 새 버전에서 쓸 수 있습니다. 관리자 › 시스템 업데이트에서 버전을 올리면 나타납니다.
운영자(권한을 위임받은 회원)의 메뉴는 조금 다릅니다. 기본/전체 전환 없이, 자기가 권한을 가진 화면만 한 목록으로 나열됩니다 — 맡은 일이 무엇이든 그 화면이 첫 화면부터 다 보입니다. 메뉴 아래에는 “권한이 있는 메뉴만 표시 중”이라고 적혀 있습니다.
운영자에게 메뉴가 안 보인다면 권한을 확인하세요
메뉴에 없는 화면은 그 운영자에게 권한이 없다는 뜻입니다. 시스템 › 권한 센터 › 운영자에서 필요한 권한을 더해 주면 메뉴에 바로 나타납니다.
v2.21.0 이상이 기능은 새 버전에서 쓸 수 있습니다. 관리자 › 시스템 업데이트에서 버전을 올리면 나타납니다.
휴대폰으로 관리하실 때 메뉴(≡)를 열면 맨 위에 지금 누구로 들어와 있는지 — ‘슈퍼관리자’·‘주임신부’·‘운영자’ 같은 등급과 계정 이름 — 이 보입니다. 그동안은 화면이 좁아 이 표시가 감춰져 있었습니다.
0-1 · 관리 화면의 단추 이름이 하나로 맞춰졌습니다
v2.20.0 이상이 기능은 새 버전에서 쓸 수 있습니다. 관리자 › 시스템 업데이트에서 버전을 올리면 나타납니다.
화면마다 다르게 불리던 단추 이름을 온 사이트에서 하나로 맞췄습니다. 이미 쓰고 계신 분을 위해 무엇이 무엇으로 바뀌었는지 적어 둡니다 — 자리는 그대로이고 이름만 바뀌었습니다.
| 예전 이름 | 지금 이름 |
|---|---|
| 저장하기 · 고침 반영 · 다 고쳤습니다 | 저장 |
| 그만 고치기 · 그만두기 | 취소 |
| 수정 | 고치기 |
| 삭제 | 지우기 |
| 등록 · 추가 | 넣기 |
- 저절로 저장되는 화면(본당 정보·기도문·게시판 설정 등)에는 저장 단추가 아예 없습니다 — [닫기]로 나오시면 됩니다.
- 글자만 작던 [수정]·[삭제]는 손가락으로 누를 만한 크기의 단추가 되었고, 화면마다 파랑·검정으로 제각각이던 색도 본당 색으로 맞췄습니다(관리 화면 49곳).
- 무엇을 적는 칸인지 이름만 봐도 알 수 있게 바꿨습니다 — 일정의 ‘구분’·‘분류’는 ‘어떤 종류인가요(달력 색이 갈립니다)’·‘어느 분야인가요’로, ‘보기 권한(열람 등급)’은 ‘누가 볼 수 있나요’로, ‘사건명’은 ‘무슨 일이 있었나요’로.
- 화면 주소(/about 같은 표기)나 내부 번호는 관리 화면에 더 이상 보이지 않습니다.
- 지울 때는 무엇이 함께 사라지는지 먼저 알려 드리고 여쭙니다 — “게시판을 지우면 그 안의 글과 댓글·사진이 모두 함께 사라지고 되돌릴 수 없습니다”처럼.
1 · 대시보드 — 매일 아침 5분
- 처리 대기 알림 — AI 추출 검토, AI 임시저장, 기록대기 행사, 장애 신고 미처리 4종이 건수가 있을 때만 카드로 뜹니다.
- 빠른 작업 — 주보 업로드·공지 작성·일정 등록 등 6개 바로가기.
- 통계 — 회원·게시글·주보·오늘 방문 등 7종 숫자.
- 새 버전 배너 — 새 버전이 나오면 슈퍼관리자에게만 상단 배너가 뜹니다.
2 · 사이트 설정 — 외부 키의 금고
| 묶음 | 담는 것 |
|---|---|
| 사이트 | 사이트 URL, 추천 검색어, 사진 모아보기 접근 권한, 발신자 표시 |
| 이메일 | SMTP 서버·계정·비밀번호 (+ 연결 테스트 버튼) |
| AI | Anthropic API 키 1개 — 또는 AWS Bedrock 키 3종 (주보 AI 추출용) |
| OAuth | 구글·카카오 로그인 키 + 카카오맵 키 |
| 보안 | AUTH_SECRET 등 (건드리지 않는 것이 원칙) |
- 비밀 값은 저장 후 “설정됨” 배지로만 표시됩니다.
- 빈 칸으로 저장하면 기존 값이 유지됩니다.
- 전례 시기·봉헌 목표 같은 값은 여기 없고 각 전용 화면에서 관리합니다.
주의 두 가지
OAuth·보안 키는 반영까지 최대 수 분 걸립니다. 즉시 적용하려면 서버 재시작이 필요합니다. AUTH_SECRET을 바꾸면 전 회원이 강제 로그아웃됩니다.
3 · 장애 신고 — 신자의 목소리
- 공개 사이트 푸터의 “장애 신고” 링크로 누구나 오류를 신고할 수 있습니다.
- 발생 페이지 주소가 자동으로 담겨 들어옵니다.
- 접수 → 처리중 → 완료로 상태를 바꾸고 내부 메모를 남깁니다.
이메일(SMTP) 설정
설정해 두면 신고 접수 즉시 운영 메일함으로 알림 메일이 발송됩니다(v2.0.9 이상). SMTP 미설정 본당은 대시보드의 “장애 신고 미처리” 카드로 확인하세요.
4 · 활동 로그 · 알림 발송 로그
- 활동 로그 — 관리자·운영자의 거의 모든 변경이 자동 기록됩니다. 조회 전용이며 삭제할 수 없습니다.
- 알림 발송 로그 — 분과 알림이 몇 명에게 나갔는지, 안 나갔다면 왜인지 배치별로 확인합니다.
v2.20.0 이상이 기능은 새 버전에서 쓸 수 있습니다. 관리자 › 시스템 업데이트에서 버전을 올리면 나타납니다.
무엇을 지웠는지도 남습니다 — 그동안 댓글·첨부 사진·행사 기록·위원회 안건 등 12곳은 지운 흔적이 남지 않거나 대상이 비어 있어, 나중에 “무엇이 없어졌나”를 확인할 길이 없었습니다.
지울 때 한 번 더 여쭙는 자리들
주보·일정·게시판을 지우실 때 사람이 쓴 기록(행사 후기·사진·신자 댓글)이 달려 있으면 몇 건인지 보여 드리고 한 번 더 여쭙습니다. 잘못 올린 주보를 걷어내거나 예전 주보를 나중에 올리는 일은 그대로 하실 수 있습니다 — 확인하고 누르시면 그대로 진행됩니다.
4-1 · 그 밖의 도구
- QR 코드 생성기(시스템 › QR 코드) — 주소나 문구를 넣으면 QR 코드를 즉석에서 만들어 내려받습니다. 주보에 홈페이지 주소를 싣거나 게시판 안내문에 붙일 때 씁니다(v2.4.0 이상).
- 알림 발송 로그 — 어떤 알림이 언제 누구에게 나갔는지 확인합니다.
- 관리 화면을 휴대폰 홈 화면에 두기 — 관리 화면을 열어 둔 채로 브라우저의 ‘홈 화면에 추가’를 하면, 관리 화면으로 바로 여는 별도 앱 아이콘(‘○○ 관리자’)이 만들어집니다. 신자용 홈 아이콘과 별개로 둘 다 둘 수 있습니다(v2.18.0 이상, 안드로이드·아이폰 iOS 16.4 이상).
관리 화면 로그인 유지
관리 화면에서 작업하는 동안에는 로그인이 자동으로 연장되어, 글을 쓰다가 갑자기 저장이 막히는 일이 없습니다. 반대로 오래 자리를 비워 실제로 만료되면 화면만 남아 조용히 실패하지 않고 로그인 화면으로 안내합니다(v2.5.0 이상).
5 · 기술 문서 — 사이트 안의 참고서
- 관리자 화면 안에 내장된 참고 문서입니다.
- 철학, 기능 가이드, 기술 스택, API 표, 변경 이력(슈퍼관리자용), 사용권 안내.
6 · 시스템 업데이트 — 원클릭 업그레이드
- 새 버전이 나오면 대시보드 배너와 버전 카드가 알려 줍니다.
- 업데이트 버튼으로 진행: DB 자동 백업 → 코드 갱신 → 빌드 → 재시작 → 상태 확인.
- 기동 실패 시 이전 버전으로 자동 복귀합니다.
- 진행 중 화면을 닫아도 계속 진행됩니다.
- 서버 저장공간 카드 — 업로드·백업 용량을 보여주고 정리 기능 제공.
- 운영 지표 전송 토글 — 익명 운영 지표(성능·오류 통계)를 개발팀에 보낼지 이 화면에서 켜고 끕니다. 개인정보·콘텐츠는 포함되지 않으며, 옆 ? 버튼에 자세한 설명이 있습니다.
- 정식버전 배지 — 발급된 사이트 키가 확인된 공식 등록 사이트에는 “✓ 정식버전” 배지가 표시됩니다.
자동 복귀 안내
자동 복귀는 코드를 되돌리는 것이며, 업데이트 중 변경된 데이터까지 복구하는 것은 아닙니다.
자주 묻는 질문
Q.사이트 설정 메뉴가 안 보여요
슈퍼관리자 전용입니다. 위임 운영자 계정에는 보이지 않습니다.
Q.카카오맵 키는 어느 묶음인가요
“OAuth” 묶음에 함께 있습니다 (KAKAO_MAP_KEY).
Q.키를 바꿨는데 바로 적용이 안 돼요
OAuth·보안 항목은 최대 수 분 걸립니다. 급하면 서버 재시작.
Q.장애 신고가 온 걸 몰랐어요
이메일(SMTP)을 설정하면 접수 즉시 운영 메일함으로 알림이 옵니다(v2.0.9 이상). 미설정이면 대시보드 미처리 카드를 확인하세요.
Q.활동 로그에 영어가 보여요
새로 추가된 작업이 드물게 영문으로 보일 수 있으며 기록 자체는 정상입니다 (v2.0.9부터 대부분 한글화).
Q.전례 시기 색은 어디서 바꾸나요
사이트 설정이 아니라 [레이아웃 › 전례 시기 테마]입니다.
Q.업데이트가 실패하면요
자동으로 이전 버전으로 복귀합니다. 반복 실패하면 서버 저장공간과 진행 로그를 확인하고 설치 지원에 문의하세요.
Q.업데이트 버튼 대신 “공식 등록 사이트에서 이용할 수 있습니다” 안내가 떠요
버튼 업데이트는 공식 등록된 사이트에서만 동작합니다. 화면의 안내를 따라 도입 문의로 공식 등록을 요청하세요.