덕구펀치 통합 매뉴얼

작성일: 2026-06-20
대상: 학원 운영자, 직원, 보호자, 회원
범위: 덕구펀치 본앱, 학원알림장

처음 시작하기: 10분 체크리스트

처음 보는 원장님이나 데스크 직원은 전체 문서를 읽지 않아도 됩니다. 아래 순서대로 한 번만 따라가면 학원 운영에 필요한 기본 흐름을 확인할 수 있습니다.

첫 세팅에서 가장 많이 헷갈리는 부분은 반과 강의입니다. 예를 들어 중3 A반이라는 반 하나에 수학, 영어, 과학 강의 3개를 연결할 수 있습니다. 반은 학생을 묶는 운영 단위이고, 강의는 실제 수업과 청구 기준이 되는 단위입니다.

핵심 작업 1분 흐름

회원 등록하기

회원관리 → 우측 상단 등록 → 이름/연락처/학교/학년 입력 → 저장 → 회원상세조회에서 보호자, 반/강의, 청구 이력을 확인합니다.

반과 강의 준비하기

반관리 → 반 생성 → 강의관리 → 강의 생성 → 반에 강의 연결 → 시간표관리에서 요일과 시간을 배치합니다. 시간표에 수업이 보여야 출결과 청구 흐름이 자연스럽게 이어집니다.

반에 회원 등록하기

반관리 → 반선택 → 반별회원 → 편집 → 반에 회원 연결.

청구 만들기

청구원장관리 → 우측 상단 개별청구, 항목일괄청구, 강의청구 생성 중 선택 → 회원 또는 강의 선택 → 청구항목과 청구연월 확인 → 저장 → 청구누락 점검에서 빠진 대상이 없는지 확인합니다.

수납 처리하기

청구원장관리에서 미납 청구 선택 → 수동수납 또는 결제 링크 발송 → 수납내역에서 성공/취소/부분취소 이력을 확인합니다. 온라인 결제를 사용하실 학원은 지점별 결제제공자 설정과 PG 가맹점 정보가 맞아야 사용할 수 있습니다.

상담 답변하기

상담내역관리 → 요청 상태 상담 선택 → 상담 방식과 상태 확인 → 답변 또는 상담 내용을 입력 → 저장 → 보호자/회원 학원알림장에서 답변을 확인할 수 있습니다.

성적과 과제 공개하기

시험관리 또는 과제관리 → 대상 배정 → 성적/제출 상태와 피드백 입력 → 공개 또는 알림 처리 → 학원알림장의 학습 화면에서 학생과 보호자가 확인할 수 있습니다.

FAQ

학생이 안 보여요

먼저 회원관리에서 회원의 재원상태와 사용여부를 확인합니다. 그다음 반/강의 배정이 되어 있는지, 조회 조건에 지점이나 학년대가 너무 좁게 들어가 있지 않은지 확인합니다.

출결 대상이 안 떠요

출결은 시간표와 반별강의 기준으로 대상을 찾습니다. 반관리, 강의관리, 시간표관리 순서로 반과 강의가 연결되어 있고 오늘 날짜에 해당하는 시간표가 있는지 확인합니다.

청구가 안 만들어져요

청구연월, 청구항목, 회원 상태, 반/강의 배정, 이미 생성된 청구가 있는지 확인합니다. 정기 수납항목은 적용 시작일과 종료일이 청구하려는 달과 맞아야 합니다.

청구누락 점검에 학생이 떠요

누락 후보는 "무조건 청구해야 한다"는 뜻이 아닙니다. 회원이 재원상태인지, 해당 강의를 듣는지, 정기 수납항목 적용 기간에 포함되는지, 기존 청구가 취소된 상태인지 확인한 뒤 처리합니다.

결제 링크가 열리지 않아요

지점 결제제공자 설정에서 결제제공자, Client ID, Chain ID, 테스트 여부가 맞는지 확인합니다. 실제 결제는 학원별 PG 가맹점 승인과 운영 키가 필요합니다.

납부했는데 미납이 남아요

부분수납인지, 취소 또는 부분취소가 있었는지 수납내역에서 확인합니다. 청구금액과 납부금액이 다르면 미납금액이 남을 수 있습니다.

보호자가 학원알림장에서 자녀상태를 못 봐요

보호자 계정이 회원과 연결되어 있는지 확인합니다. 보호자 정보만 등록되어 있고 회원 연결이 빠져 있으면 알림장에서 자녀가 보이지 않을 수 있습니다.

알림이 안 와요

문자와 학원알림장 알림은 다릅니다. 문자는 발신번호와 외부 발송 설정을 확인하고, 학원알림장 알림은 학원알림장 설치 여부와 브라우저/기기 알림 허용 상태를 확인합니다.

상담 요청은 됐는데 상담내역이 안 보여요

상담 상태, 사용여부, 지점 조건을 확인합니다. 홈페이지나 학원알림장에서 들어온 상담은 덕구펀치 본앱의 상담관리에서 조회할 수 있습니다.

성적이나 과제가 학원알림장에 안 보여요

시험/과제 대상 배정, 점수나 피드백 입력 여부, 공개 처리 여부를 확인합니다. 공개 전 데이터는 보호자/회원 화면에 보이지 않을 수 있습니다.

수강신청 승인 후 반 배정이 안 보여요

수강신청 승인만으로 끝나는지, 실제 회원 생성과 반/강의 배정까지 처리됐는지 확인합니다. 승인 후 회원 상세에서 반/강의가 보이는지 보는 것이 가장 빠릅니다.

메뉴가 안 보여요

직원 역할권한을 확인합니다. 메뉴가 숨겨져 있거나 읽기 권한이 없으면 화면에 접근할 수 없습니다.

1. 덕구펀치 본앱

덕구펀치 본앱은 학원 운영자가 회원, 수업, 상담, 시험/과제, 청구/수납, 메시지 발송을 관리하는 화면입니다. 이 장은 현재 덕구펀치 본앱 매뉴얼의 사용자 흐름과 화면별 설명을 기준으로 정리했습니다.

사용자 관점

접속과 로그인

학원별 주소로 접속한 뒤 직원 계정으로 로그인합니다. 같은 아이디처럼 보여도 접속한 주소에 따라 다른 학원 데이터로 들어갈 수 있으므로, 로그인 전 주소를 확인합니다.

로그인 후에는 직원 역할과 개인 설정에 따라 시작 화면이 달라질 수 있습니다.

오늘 업무 확인

업무를 시작하면 먼저 대시보드 성격의 화면을 확인합니다.

• 내 오늘 할일: 직원 개인이 오늘 처리해야 할 수업, 출결, 상담, 수강신청을 확인합니다.
• 일별전체상황조회: 학원 전체의 청구, 수납, 미납, 신규 회원 흐름을 확인합니다.
• 원장 홈: 원장이 매출과 운영 흐름을 빠르게 보는 요약 화면입니다.

운영 기본값 준비

처음 사용하는 학원은 아래 순서로 준비하면 대부분의 화면이 자연스럽게 연결됩니다.

1. 사업자, 지점, 직원, 역할권한을 준비합니다.
2. 청구항목, 과목, 강의실처럼 여러 화면에서 공통으로 쓰는 기준값을 정리합니다.
3. 반, 강의, 시간표를 만든 뒤 회원을 배정합니다.
4. 상담, 수강신청, 시험, 과제, 청구, 수납 흐름을 테스트합니다.
5. 알림장 초대와 메시지 전달 상태를 확인합니다.

회원과 보호자 등록

회원은 상담, 수업, 출결, 시험, 과제, 청구, 알림장의 중심 데이터입니다.

1. 회원관리에서 회원 기본정보를 등록합니다.
2. 보호자 연락과 학원알림장이 필요하면 보호자관리에서 보호자를 등록합니다.
3. 회원과 보호자를 연결합니다.
4. 회원을 반/강의에 배정합니다.
5. 회원상세조회에서 상담, 수업, 청구, 수납, 과제, 시험 흐름이 이어지는지 확인합니다.

회원관리에서는 초등, 중등, 고등처럼 학년대를 선택해 빠르게 조회할 수 있습니다.

본앱 설치와 알림 허용

덕구펀치 본앱은 브라우저에서 바로 사용할 수 있고, Chrome 또는 Edge에서는 앱처럼 설치해서 사용할 수도 있습니다. 설치해 두면 매번 주소를 입력하지 않고 바로 열 수 있으며, 브라우저가 지원하는 환경에서는 업무 알림을 웹푸시로 받을 수 있습니다.

1. 덕구펀치 본앱에 로그인합니다.
2. 상단의 앱 설치 아이콘이 보이면 눌러 설치합니다.
3. 설치한 앱 또는 브라우저에서 상단 알림 아이콘을 엽니다.
4. 알림 켜기를 누르고 브라우저 알림 권한을 허용합니다.
5. 알림이 켜졌다는 안내가 보이면 웹푸시 수신 준비가 완료된 상태입니다.

알림 버튼이 보이지 않거나 알림 권한을 허용할 수 없다면 브라우저가 푸시 알림을 지원하는지, 사이트 알림이 차단되어 있지 않은지 확인합니다.

수업 준비와 출결

수업 운영은 반, 강의, 반별강의, 시간표, 출결 순서로 이어집니다.

• 반은 강의와 학생을 묶는 운영 단위입니다.
• 강의는 실제 수업 또는 청구 기준이 되는 단위입니다.
• 한 반에는 여러 강의를 연결할 수 있습니다.
• 시간표의 기준은 반과 강의가 연결된 반별강의입니다.
• 출결체크는 시간표와 반별강의 기준으로 대상을 찾습니다.

시간표 블록 색상은 강의를 구분하기 위한 파스텔톤 안내 색상입니다. 색상이 진하거나 빨갛다고 해서 미납, 결석, 오류 같은 상태를 뜻하지 않습니다.

상담 요청과 수강신청 처리

상담은 온라인 상담과 오프라인 상담을 함께 관리합니다.

• 온라인 상담: 보호자나 회원이 남긴 요청을 확인하고 답변합니다.
• 오프라인 상담: 방문 또는 전화 상담 일정을 잡고, 상담 후 내용을 기록합니다.

수강신청은 홈페이지나 학생용 화면에서 들어온 신청을 관리자가 검토하는 흐름입니다. 승인 전에는 신청 내용과 배정할 반을 확인하고, 승인 후 실제 반 배정 상태를 다시 확인합니다.

시험과 과제 운영

시험과 과제는 회원, 반, 강의 단위로 배정할 수 있습니다.

시험 흐름:

1. 시험관리에서 시험을 등록합니다.
2. 대상 회원을 배정합니다.
3. 성적 입력에서 점수, 등수, 통과 여부, 재시험 여부, 피드백을 입력합니다.
4. 성적 공개 및 알림으로 보호자/회원이 알림장에서 확인할 수 있게 합니다.

과제 흐름:

1. 과제관리에서 과제를 등록합니다.
2. 대상 회원, 반, 강의에 배정합니다.
3. 제출 상태를 확인합니다.
4. 점수와 피드백을 입력합니다.

현재 성적 입력의 자동 분석 버튼은 준비중 안내만 표시합니다.

청구 생성

청구는 크게 네 가지 방식으로 만듭니다.

• 개별청구: 특정 회원에게 필요한 항목을 직접 선택해 청구합니다.
• 항목일괄청구: 교재비, 차량비, 촬영비처럼 같은 항목을 여러 회원에게 한 번에 청구합니다.
• 강의청구 생성: 반/강의 배정과 강의 설정을 기준으로 정기 청구를 만듭니다.
• 정기항목청구: 청구항목관리에서 월납으로 입력된 항목에서 정기 수납항목에 등록된 기준으로 청구합니다.

청구를 만든 뒤에는 청구누락 점검에서 빠진 회원이나 항목이 없는지 확인하면 좋습니다. 누락 후보가 보인다고 항상 청구해야 하는 것은 아니므로 회원 상태, 반/강의 배정, 정기 수납항목 적용 기간, 기존 청구 취소 여부를 먼저 봅니다.

납부 확인과 수납 처리

수납 처리 흐름:

1. 청구원장관리에서 미납 또는 부분수납 청구를 선택합니다.
2. 필요하면 수동수납을 처리합니다.
3. 온라인 결제 링크를 사용하는 학원은 지점 결제설정과 PG 가맹점 정보가 맞는지 확인합니다.
4. 수납내역에서 결제 성공, 취소, 정정 내역을 확인합니다.

온라인 결제는 학원별 지점 결제설정과 PG 가맹점 정보가 맞아야 사용할 수 있습니다. 기존 결제 방식을 바꾸지 않고도 청구와 미납, 수납 기록을 먼저 정리할 수 있습니다.

학원알림장 확인과 메시지 발송

덕구펀치 본앱에서 처리한 내용은 일부 학원알림장으로 이어집니다.

문자와 앱 메시지는 다르게 봐야 합니다. 문자 발송 실패는 발신번호, 허용 IP, 외부 발송 설정 문제일 수 있고, 앱 메시지는 학원알림장 설치와 푸시 구독 상태의 영향을 받을 수 있습니다.

화면별 설명

이 장은 캡쳐를 보면서 실제 화면에서 무엇을 확인해야 하는지 설명합니다. 각 화면은 화면 목적, 주요 구성, 확인 포인트, 주의사항 순서로 읽으면 됩니다.

화면 목록

홈

일별전체상황조회

화면 목적

학원 전체 운영 상태를 가장 먼저 확인하는 기본 대시보드입니다. 기준 월의 청구, 수납, 미납, 신규 회원을 한 화면에서 보고, 오늘 바로 확인해야 할 위험 신호를 찾습니다.

주요 구성

• 상단 기준 정보: 기준 월, 오늘 날짜, 지점 합산 여부, 확인 필요 금액.
• 주요 카드: 이번 달 총 청구금액, 이번 달 총 수납금액, 현재 미납금액, 미납 인원, 오늘 수납, 신규회원.
• 하단/확장 영역: 지점별 흐름, 최근 수납, 청구/수납 추이.

확인 포인트

• 빨간 테두리 또는 확인 필요 표시는 먼저 확인해야 하는 운영 이슈입니다.
• 청구금액은 청구를 만든 기준이고, 수납금액은 실제 납부가 처리된 기준입니다.
• 신규 표시는 해당 기준 기간에 데이터가 새로 발생했음을 알려주는 보조 표시입니다.

주의사항

• 청구액이 높아도 수납액이 낮으면 미납 관리가 필요합니다.
• 지점이 여러 개인 학원은 전체 지점 합산 상태인지 먼저 확인한 뒤 금액을 해석합니다.

내 오늘 할일

화면 목적

직원 개인이 오늘 처리해야 할 업무를 빠르게 확인하는 화면입니다. 수업, 출결, 상담, 수강신청처럼 당일 처리할 일이 흩어지지 않도록 모아 보여줍니다.

주요 구성

• 오늘 수업 또는 출결 대상.
• 미응답 상담, 처리 대기 신청, 확인이 필요한 알림.
• 화면으로 바로 이동하는 링크형 항목.

확인 포인트

• 담당자 기준으로 업무가 보이므로 직원 권한과 담당 업무 설정이 중요합니다.
• 오늘 처리해야 하는 업무를 누르면 해당 관리 화면으로 이동해 상세 처리를 이어갑니다.

원장 홈

화면 목적

원장 관점에서 학원의 주요 흐름을 보는 화면입니다. 매출, 미납, 상담, 수강신청, 신규 회원처럼 의사결정에 필요한 지표를 요약합니다.

주요 구성

• 청구/수납/미납 요약.
• 신규 회원과 상담, 수강신청 현황.
• 운영 흐름을 확인하기 위한 지점별 또는 기간별 요약.

확인 포인트

• 신규 상담이나 수강신청이 쌓이면 실제 등록으로 이어지는지 확인합니다.
• 미납이 늘면 청구 메시지 발송, 수동수납, 결제 링크 상태를 함께 확인합니다.

회원

회원관리

화면 목적

회원 기본정보를 등록하고 조회하는 화면입니다. 상담, 수업, 출결, 시험, 과제, 청구, 알림장 기능은 모두 회원 정보를 기준으로 연결됩니다.

주요 구성

• 조회조건: 회원명, 연락처, 학교, 학년대, 재원상태, 사용여부.
• 회원 목록: 이름, 연락처, 학교/학년, 재원상태, 등록상태, 사용여부.
• 등록/수정 패널: 기본정보, 연락처, 학교, 주소, 로그인 정보.

확인 포인트

• 초등/중등/고등 전체 조회 조건으로 회원을 빠르게 구분할 수 있습니다.
• 회원이 보이지 않으면 재원상태, 사용여부, 지점 조건을 먼저 확인합니다.
• 알림장을 쓰려면 회원 정보만으로는 부족하고 보호자 연결 또는 회원 로그인 정보가 필요합니다.

주의사항

• 같은 회원이 중복 등록되지 않도록 이름, 전화번호, 보호자 정보를 함께 확인합니다.
• 재원상태 코드가 잘못 들어가면 청구, 수업 배정, 검색 결과가 어긋날 수 있습니다.

회원상세조회

화면 목적

회원 한 명의 전체 이력을 모아 보는 화면입니다. 회원에게 어떤 수업이 배정되어 있고, 어떤 상담/청구/수납/학습 이력이 있는지 확인합니다.

주요 구성

• 회원 기본정보와 현재 상태.
• 상담, 반/강의, 청구, 수납, 시험, 과제 관련 탭 또는 요약 영역.
• 변경 이력과 등록/수정 정보.

확인 포인트

• 회원이 특정 화면에서 검색되지 않을 때는 이 화면에서 재원상태와 반/강의 배정을 먼저 확인합니다.
• 알림장에 정보가 보이지 않으면 보호자 연결, 회원 로그인, 공개 여부를 함께 봅니다.

보호자관리

화면 목적

보호자 계정과 연락처를 관리합니다. 보호자는 회원과 연결되어야 학원알림장에서 자녀의 납부, 상담, 학습 정보를 확인할 수 있습니다.

주요 구성

• 보호자명, 연락처, 로그인 ID, 사용여부.
• 보호자 등록/수정 패널.
• 회원 연결 여부를 확인할 수 있는 관계 정보.

확인 포인트

• 보호자가 로그인은 되는데 자녀가 보이지 않으면 회원과 보호자 연결 상태를 확인합니다.
• 보호자 휴대폰 번호는 상담, 알림장, 청구 안내의 기준 정보가 될 수 있습니다.

수업

반관리

화면 목적

학생을 묶는 반 정보를 관리합니다. 반은 운영상 학생 그룹이고, 실제 수업/청구 기준인 강의와는 구분됩니다.

주요 구성

• 지점, 반명, 담당자, 사용여부.
• 반 등록/수정 패널.
• 반별 회원 또는 반별 강의 연결 흐름.

확인 포인트

• 한 반에 여러 강의를 연결할 수 있습니다.
• 반명에 강의명을 섞어 쓰면 시간표와 청구 확인이 어려워집니다.

강의관리

화면 목적

실제 수업과 청구 기준이 되는 강의를 관리합니다. 수업료, 회차, 납부 방식, 과목 정보는 강의청구 생성 결과에 영향을 줍니다.

주요 구성

• 강의명, 과목, 수업료, 회차, 납부 방식.
• 사용여부와 적용 기간.
• 반별강의 연결에 사용할 기본 강의 정보.

확인 포인트

• 월납, 회차, 일시납 같은 납부 기준은 청구 중복과 청구 가능 여부에 직접 영향을 줍니다.
• 강의가 등록되어도 반과 연결되지 않으면 시간표와 출결 대상이 만들어지지 않습니다.

강의실관리

화면 목적

지점별 강의실을 관리합니다. 시간표관리에서 지점 조건에 맞는 강의실을 선택할 수 있게 합니다.

주요 구성

• 지점, 강의실명, 수용 인원, 사용여부.
• 등록/수정 패널.

확인 포인트

• 시간표에서 강의실이 검색되지 않으면 지점 조건과 사용여부를 확인합니다.
• 같은 이름의 강의실이 여러 지점에 있을 수 있으므로 지점명을 함께 확인합니다.

시간표관리

화면 목적

반별 강의를 요일, 시간, 강의실에 배치하는 화면입니다. 출결, 오늘 수업, 알림장 홈 요약의 기준이 됩니다.

주요 구성

• 조회조건: 지점, 요일, 강의실, 반, 강의, 사용여부.
• 요일별 시간표 그리드.
• 기본 주간 생성, 시간표 설정, 시간표 등록/수정 기능.

확인 포인트

• 시간표의 핵심 기준은 반과 강의가 연결된 반별강의입니다.
• 블록 색상은 강의 구분용 파스텔톤 안내 색상이며 상태값을 뜻하지 않습니다.
• 반은 같고 강의가 여러 개인 경우, 강의명과 강의실을 함께 확인합니다.

주의사항

• 시간표가 있어도 회원이 반에 배정되어 있지 않으면 출결 대상에 나타나지 않을 수 있습니다.
• 시간 중복이 생기면 실제 수업 운영과 출결 체크가 꼬일 수 있으므로 저장 전 시간을 확인합니다.

출결체크

화면 목적

수업 기준으로 회원의 출석, 지각, 결석을 처리하는 화면입니다. 처리된 출결은 알림장 홈과 등하원/출결 안내의 근거가 됩니다.

주요 구성

• 날짜, 지점, 반, 강의, 강의실 조건.
• 수업별 출결 대상 목록.
• 출석/지각/결석 처리 버튼과 발송 관련 옵션.

확인 포인트

• 대상 회원이 보이지 않으면 반 배정, 반별강의, 시간표, 회원 재원상태를 순서대로 확인합니다.
• 출결 문자 또는 앱 알림을 보낼 때는 발송 설정과 비용 발생 여부를 확인합니다.

등원하원

화면 목적

회원의 등원/하원 기록을 확인하는 화면입니다. 보호자에게 오늘 학원 도착/귀가 상태를 안내하는 근거가 됩니다.

주요 구성

• 날짜, 회원, 지점 조건.
• 등원/하원 시각 목록.
• 수동 등록 또는 정정 흐름.

확인 포인트

• 하루에 등원/하원 기록이 여러 번 남을 수 있습니다.
• 학원알림장 홈에 오늘 상태가 이상하게 보이면 이 화면의 기록을 먼저 확인합니다.

상담과 신청

상담내역관리

화면 목적

온라인 상담과 오프라인 상담을 함께 관리합니다. 보호자/회원이 남긴 상담 요청에 답변하고, 방문/전화 상담은 예정일과 상담 내용을 기록합니다.

주요 구성

• 상담 상태, 상담 방식, 회원/보호자, 상담 예정일.
• 상담 내용과 관리자 피드백.
• 답변 저장, 완료 처리, 상담 방식 변경.

확인 포인트

• 학원알림장에서는 기본적으로 온라인 상담이 자연스럽습니다.
• 오프라인 상담은 상담 예정일을 잡고 실제 상담 후 내용을 입력하는 방식으로 관리합니다.
• 상담 상태와 피드백은 사용자가 가장 자주 보는 정보이므로 저장 전 내용을 다시 확인합니다.

수강신청관리

화면 목적

홈페이지나 학생용 화면에서 들어온 수강신청을 관리자가 검토, 승인, 반려하는 화면입니다.

주요 구성

• 신청자, 연락처, 신청 강의, 신청 상태.
• 검토 내용, 승인/반려 처리.
• 승인 시 연결할 회원/반/강의 정보.

확인 포인트

• 승인 전 신청 내용과 실제 배정할 반을 반드시 확인합니다.
• 이미 등록된 회원인지 먼저 확인하면 중복 회원 생성을 줄일 수 있습니다.
• 반려 시 사용자가 이해할 수 있는 사유를 남기는 것이 좋습니다.

시험/과제

시험관리

화면 목적

시험을 등록하고 대상 배정, 성적 입력, 문항관리, 성적 공개를 처리합니다.

주요 구성

• 시험명, 시험일, 과목, 만점, 공개 여부.
• 대상 배정 버튼.
• 성적 입력, 문항관리, 성적 공개 및 알림.

확인 포인트

• 시험 대상은 회원, 반, 강의 기준으로 배정할 수 있습니다.
• 대상 검색에서 회원이 보이지 않으면 재원상태, 사용여부, 검색 조건을 확인합니다.
• 성적 공개 전에는 점수와 피드백이 정확한지 확인합니다.

성적 입력

화면 목적

배정된 학생의 점수, 등수, 통과 여부, 재시험 여부, 피드백을 입력하는 다이얼로그입니다.

주요 구성

• 상단 조회조건: 학생명, 지점, 반, 강의, 상태.
• 성적 그리드: 만점, 취득점수, 등수, 통과, 재시험, 비고, 피드백.
• 성적 공개 및 알림, 자동 분석, 편집 버튼.

확인 포인트

• 결시, 채점완료, 재시험대상 상태를 구분해 봅니다.
• 피드백은 알림장 학습 화면에 노출될 수 있으므로 사용자에게 보여도 되는 문장으로 작성합니다.
• 자동 분석은 현재 준비중 안내만 표시합니다.

과제관리

화면 목적

과제 등록, 대상 배정, 제출 확인, 점수와 피드백 입력을 처리합니다.

주요 구성

• 과제명, 제출기한, 과목, 공개 여부.
• 대상 배정과 제출 현황.
• 점수, 제출 상태, 피드백 입력.

확인 포인트

• 회원, 반, 강의 기준으로 대상 배정이 가능합니다.
• 제출/미제출 상태와 피드백은 알림장 학습 화면에 이어질 수 있습니다.
• 시험과 마찬가지로 공개 여부를 확인한 뒤 알림을 보냅니다.

수납/매출

청구원장관리

화면 목적

회원별 청구를 만들고 상태를 확인하는 수납 업무의 중심 화면입니다. 개별청구, 항목일괄청구, 강의청구 생성, 청구메시지 발송, 수동수납으로 이어집니다.

주요 구성

• 조회조건: 청구연월, 회원, 지점, 청구상태, 수납상태.
• 청구 목록: 청구금액, 수납금액, 미납금액, 상태.
• 주요 버튼: 개별청구, 항목일괄청구, 강의청구 생성, 청구메시지 발송, 수동수납.

확인 포인트

• 청구취소와 수납취소는 다릅니다. 청구 자체를 없애는지, 납부 처리만 되돌리는지 구분합니다.
• 온라인 결제 링크는 메시지 발송 전에도 생성될 수 있습니다. 발송은 사용자에게 안내하는 단계입니다.
• 동일 항목의 중복 청구 여부는 청구연월, 회원, 청구항목, 강의 기준을 함께 봅니다.

개별청구

화면 목적

특정 회원에게 필요한 항목을 직접 선택해 청구합니다. 촬영비, 교재비, 특강비처럼 대상과 금액을 관리자가 직접 판단해야 할 때 사용합니다.

주요 구성

• 회원 선택.
• 청구연월, 청구항목, 금액, 비고.
• 저장 후 청구원장 목록 반영.

확인 포인트

• 매월 반복 가능한 항목인지, 회원 생애 1회성 항목인지 구분해야 합니다.
• 같은 회원에게 같은 항목을 다시 청구할 수 있는 정책인지 확인한 뒤 저장합니다.

항목일괄청구

화면 목적

같은 청구항목을 여러 회원에게 한 번에 청구합니다. 차량비, 교재비, 행사비처럼 다수 회원에게 동일 항목을 적용할 때 사용합니다.

주요 구성

• 청구항목과 청구연월.
• 대상 회원 검색과 선택.
• 생성 전 미리보기 또는 결과 확인.

확인 포인트

• 대상 회원이 너무 넓게 잡히지 않았는지 확인합니다.
• 이미 같은 조건으로 청구된 회원은 중복 생성 여부를 확인합니다.

강의청구 생성

화면 목적

반/강의 배정과 강의 설정을 기준으로 정기 청구를 생성합니다. 일반 수강료 청구에 가장 많이 쓰는 흐름입니다.

주요 구성

• 청구연월, 지점, 반, 강의 조건.
• 회원별 강의 배정과 금액 기준.
• 생성 대상과 제외 대상 확인.

확인 포인트

• 회원이 반에만 있고 강의 배정이 없으면 청구 대상에서 빠질 수 있습니다.
• 중도 합류, 일부 회차, 할인 또는 예외 금액이 있으면 생성 전 금액을 확인합니다.
• 강의 설정의 납부 방식과 회차가 청구 결과에 영향을 줍니다.

청구누락 점검

화면 목적

청구가 빠졌을 가능성이 있는 회원이나 항목을 찾는 점검 화면입니다. 청구 생성 후 운영자가 빠진 대상을 확인하는 용도입니다.

주요 구성

• 기준 월과 지점/반/강의 조건.
• 누락 후보 목록.
• 후보별 회원 상태와 배정 정보.

확인 포인트

• 누락 후보가 보인다고 항상 청구해야 하는 것은 아닙니다.
• 회원 상태, 반/강의 배정, 정기 수납항목 적용 기간, 기존 청구 취소 여부를 함께 확인합니다.

수납내역

화면 목적

수납 성공, 취소, 정정 내역을 확인합니다. 결제수단별 실제 납부 처리 결과를 관리합니다.

주요 구성

• 수납일, 회원, 결제수단, 수납상태 조건.
• 수납금액, 청구 연결, 승인번호, 취소 여부.
• 수납 정정 또는 취소 기능.

확인 포인트

• 카드/간편결제 수납은 승인번호와 결제제공자 상태를 함께 확인합니다.
• 수납 취소는 결제 취소와 내부 수납 취소가 모두 필요한지 업무 정책에 맞게 확인합니다.

매출조회

화면 목적

청구와 수납 데이터를 기준으로 매출, 수납, 미납 흐름을 확인합니다. 원장 또는 관리자가 기간별 운영 성과를 볼 때 사용합니다.

주요 구성

• 기준 월/기간과 지점 조건.
• 청구, 수납, 미납 요약.
• 지점별 또는 항목별 집계.

확인 포인트

• 청구 기준 매출과 실제 수납 기준 매출을 구분합니다.
• 여러 지점이 있는 경우 지점 합산과 지점별 금액을 나눠 봅니다.

가상계좌관리

화면 목적

회원별 가상계좌 정보를 관리합니다. 가상계좌를 사용하는 학원에서 회원별 입금 계좌를 조회하고 상태를 확인합니다.

주요 구성

• 회원, 은행, 계좌번호, 사용여부.
• 가상계좌 생성 또는 연결 정보.

확인 포인트

• 가상계좌는 PG 또는 은행 연동 정책에 따라 사용 가능 여부가 달라질 수 있습니다.
• 회원에게 안내하기 전 계좌 상태와 회원 연결이 맞는지 확인합니다.

메시지와 알림장

발송이력

화면 목적

문자, 앱 메시지, 청구 안내 발송 결과를 조회합니다. 실제 안내가 나갔는지, 실패했는지 확인하는 화면입니다.

주요 구성

• 발송일, 채널, 수신자, 발송상태 조건.
• 메시지 제목/내용, 성공/실패 결과.
• 외부 발송 결과 또는 오류 메시지.

확인 포인트

• 문자 실패는 발신번호, 허용 IP, 외부 API 설정을 함께 확인합니다.
• 앱 메시지는 알림장 설치, 푸시 구독, 읽음 처리 상태와 함께 봐야 합니다.

알림장관리

화면 목적

앱 메시지방과 초대/발송 상태를 확인합니다. 보호자/회원에게 안내가 실제로 전달되고 읽혔는지 확인하는 화면입니다.

주요 구성

• 앱 메시지방 목록.
• 수신자, 읽음 여부, 푸시 발송 상태.
• 초대 또는 알림장 사용 상태.

확인 포인트

• 본앱에서 발송한 메시지는 학원알림장의 알림장 목록과 상세 화면으로 이어집니다.
• 푸시가 안 와도 앱 메시지 자체는 방에 남을 수 있으므로 푸시 실패와 메시지 저장 실패를 구분합니다.

운영설정

사업자관리

화면 목적

청구, 결제, 영수증, 홈페이지 표시에 사용할 사업자 정보를 관리합니다.

주요 구성

• 사업자명, 사업자등록번호, 대표자, 주소, 연락처.
• 사용여부와 기본 사업자 여부.

확인 포인트

• 결제나 영수증을 쓰는 경우 사업자 정보가 외부 결제 심사 정보와 맞아야 합니다.
• 홈페이지에 공개되는 정보와 내부 청구 정보가 같은지 확인합니다.

지점관리

화면 목적

지점 기본정보, 청구설정, 결제설정을 관리합니다. 온라인 결제 링크와 청구 기준은 지점 설정의 영향을 받습니다.

주요 구성

• 지점명, 주소, 연락처, 사용여부.
• 청구 설정.
• 결제제공자 설정: 토스페이먼츠, 카카오페이, 네이버페이 등.

확인 포인트

• 온라인 결제가 실패하면 지점 결제설정의 Client ID, Chain ID, 테스트 여부를 먼저 확인합니다.
• 실제 운영 키와 샌드박스 키가 섞이면 유효하지 않은 가맹점 오류가 날 수 있습니다.

직원관리

화면 목적

직원 계정, 사용여부, 담당 업무, 역할 배정, 도움말 수정 가능 여부를 관리합니다.

주요 구성

• 직원명, 로그인 ID, 연락처, 담당 업무, 사용여부.
• 역할 배정.
• 화면별 도움말 수정 가능 여부.

확인 포인트

• 직원이 로그인되지 않으면 사용여부, 로그인 ID, 비밀번호, 역할을 확인합니다.
• 메뉴가 보이지 않으면 역할권한관리에서 해당 역할의 메뉴 권한을 확인합니다.

청구항목관리

화면 목적

강의 외 청구 항목을 관리합니다. 교재비, 차량비, 촬영비, 입학금처럼 강의청구와 별도로 청구할 항목을 정의합니다.

주요 구성

• 청구항목명, 금액, 사용여부.
• 반복/1회성 성격을 구분하기 위한 설정.
• 항목일괄청구와 개별청구에서 사용할 기준값.

확인 포인트

• 월별 반복 항목과 회원 생애 1회성 항목은 정책이 다릅니다.
• 청구 중복을 막으려면 청구연월, 회원, 항목, 반복 정책을 함께 확인해야 합니다.

과목관리

화면 목적

강의와 시험에서 사용할 과목을 관리합니다. 학원별로 사용하는 과목만 사용 상태로 두면 화면 선택지가 깔끔해집니다.

주요 구성

• 과목명, 과목 구분, 사용여부.
• 강의/시험에서 선택할 수 있는 과목 목록.

확인 포인트

• 과목이 선택 목록에 보이지 않으면 사용여부와 테넌트별 과목 데이터 상태를 확인합니다.
• 사용하지 않는 공교육 과목은 사용여부를 끄고 필요한 과목만 켜는 방식이 좋습니다.

역할권한관리

화면 목적

역할별 메뉴 조회, 등록, 수정, 삭제, 수납 권한을 관리합니다. 직원에게 어떤 화면과 기능을 열어줄지 정합니다.

주요 구성

• 역할 목록.
• 메뉴 트리.
• 조회/등록/수정/삭제/수납 등 권한 체크.

확인 포인트

• 메뉴가 보이지 않는 문제는 대부분 역할권한 또는 메뉴 사용여부 문제입니다.
• 수납 관련 버튼은 일반 조회 권한과 별도 권한이 필요할 수 있습니다.
• 고객에게 숨겨야 하는 운영자 전용 메뉴는 메뉴 목록과 역할권한 검색 양쪽에서 보이지 않아야 합니다.

시스템환경설정관리

화면 목적

학원 단위 시스템 설정을 관리합니다. 화면 언어, 메시지 발송 방식, 기본 다운로드 경로, 알림장 푸시 정책 같은 운영 기준을 설정합니다.

주요 구성

• 설정 코드, 설정명, 설정값.
• 사용여부와 수정 정보.
• 메시지/알림장/화면 표시 관련 옵션.

확인 포인트

• 운영 중인 고객 학원에서는 직접 수정하기보다 변경 범위를 확인한 뒤 신중하게 처리합니다.
• 메시지 발송, 알림장 푸시, 기본 화면 설정은 여러 화면에 영향을 줄 수 있습니다.

운영 전 체크리스트

• 사업자와 지점 정보가 실제 학원 정보와 맞는지 확인했습니다.
• 지점 청구설정과 결제설정을 확인했습니다.
• 직원 로그인, 역할, 메뉴 권한을 확인했습니다.
• 반, 강의, 시간표, 회원 배정을 확인했습니다.
• 테스트 청구와 테스트 수납을 해봤습니다.
• 알림장 초대와 보호자 로그인 흐름을 확인했습니다.
• 실제 문자/결제 같은 외부 비용 발생 기능은 운영 전 별도 점검했습니다.

2. 본앱과 학원알림장 연결

본앱에서 직원이 처리한 데이터는 보호자/회원이 사용하는 학원알림장에 이어집니다. 아래 표는 사용자가 실제로 체감하는 연결 지점입니다.

3. 학원알림장

학원알림장은 보호자와 회원이 모바일에서 알림장, 납부, 학습, 상담을 확인하는 화면입니다. 이 장은 현재 학원알림장 매뉴얼을 기준으로 정리했습니다.

1. 화면 목록

2. 사용자 빠른 안내

앱 설치

• Android Chrome에서는 알림장 접속 후 설치 안내가 보이면 앱 설치하기를 누른다.
• Samsung Internet에서는 설치 버튼을 숨기고 Chrome에서 설치하도록 안내한다.
• iPhone Safari에서는 하단 ...를 누른 뒤 공유를 선택하고, 공유 메뉴 하단의 더보기 또는 동작 편집에서 홈 화면에 추가를 켠 다음 선택한다. 공유 아이콘이 바로 보이는 기기는 공유 버튼에서 같은 순서로 진행한다.
• 카카오 인앱 브라우저에서는 설치가 매끄럽지 않을 수 있으므로 Safari 또는 Chrome으로 다시 열어 설치한다.

알림 받기

• 앱 설치 후 상단 벨 아이콘을 눌러 알림 권한을 허용한다.
• 권한 허용만으로 끝나는 것이 아니라 서버에 푸시 구독 정보가 저장되어야 수신 준비 상태가 된다.
• 알림이 오지 않으면 앱의 알림 허용 상태와 휴대폰 설정의 브라우저/앱 알림 권한을 함께 확인한다.

알림장 확인

• 하단 알림장에서 학원이 보낸 안내 방을 확인한다.
• 방에 들어가면 최신 메시지 기준으로 내용을 확인하고, 필요한 경우 확인했습니다 또는 문의하기를 누른다.
• 확인했습니다는 해당 안내를 읽고 확인했다는 의미로 처리한다.

납부 확인

• 하단 납부에서 현재 미납, 이번 달 납부, 미납 청구, 납부 내역을 확인한다.
• 결제는 미납 청구 카드의 이 청구 결제하기에서 진행한다.
• 영수증은 납부가 완료된 납부 내역을 선택했을 때만 확인한다.
• 납입증명서는 기간을 선택해 해당 기간의 납부 합계를 확인하는 문서다.

학습 확인

• 하단 학습에서 시험과 과제 내역을 확인한다.
• 시험 카드를 누르면 점수, 공개 상태, 피드백을 확인한다.
• 과제 카드를 누르면 제출 상태, 점수, 피드백을 확인한다.

상담 요청

• 하단 상담에서 상담을 요청하거나 답변을 확인한다.
• 상담 내역이 없으면 입력 폼이 먼저 열리고, 상담 내역이 있으면 요청 버튼과 최근 상담 내역을 먼저 보여준다.
• 요청 상태의 상담은 수정할 수 있고, 처리/완료 상태는 답변 확인 중심으로 보여준다.

로그아웃

• 상단 로그아웃 아이콘을 누르면 현재 로그인 세션을 종료한다.
• 앱 설치 후 로그인 만료가 뜨면 다시 로그인해야 하며, 모바일 알림장 경로에서는 로그인 후 학원알림장으로 돌아와야 한다.

3. 학원알림장 공통 구조

목적

• 보호자/회원이 문자 대신 학원 안내를 앱 형태로 확인한다.
• 알림장, 납부, 학습, 상담을 모바일 우선 화면으로 제공한다.
• PWA 설치와 Web Push 구독을 통해 새 안내를 휴대폰 알림으로 받을 수 있게 한다.

공통 진입 조건

• 보호자 GD 또는 회원 MB 로그인 필요.
• 보호자는 연결된 자녀 목록을 기준으로 자녀를 선택한다.
• 회원 로그인은 본인 1명 기준이며 자녀 선택 셀렉트박스가 필요 없다.
• 선택한 회원 번호는 로컬 저장소에 보존되어 새로고침 후에도 유지되어야 한다.

공통 버튼

• 벨 아이콘: 푸시 알림 허용/구독 상태 확인.
• 확성기 아이콘: 알림센터 또는 앱 안내성 알림 확인.
• 로그아웃 아이콘: 현재 로그인 세션 종료.
• 하단 탭: 홈, 알림장, 납부, 학습, 상담.

주의사항

• 설치 여부는 PWA standalone 표시와 TB_PUSH_SUBSCRIPTION의 설치/구독 정보를 함께 봐야 한다.
• 앱을 삭제해도 서버가 즉시 알 수는 없다. 이후 push endpoint 실패 시 구독이 무효 처리된다.
• 삼성인터넷은 설치 프롬프트가 PWA가 아닌 바로가기처럼 동작할 수 있어 Chrome 설치 안내를 우선한다.

4. 홈

화면 목적

• 보호자/회원이 앱을 열었을 때 오늘 확인해야 할 상태를 한 화면에 보여준다.
• 오늘 수업/등하원, 납부 상태, 상담 답변, 학습 확인 건을 우선순위로 보여준다.

주요 구성

• 앱명/오늘 날짜 영역
• 선택 회원 카드: 이름, 지점/반 정보
• 오늘 우리 아이 또는 오늘 나의 상태
• 지금 할 일
• 바로가기
• 최근 알림

업무 흐름 예시

1. 보호자가 학원알림장을 실행한다.
2. 연결 자녀가 여러 명이면 자녀를 선택한다.
3. 홈에서 오늘 수업, 미납, 상담 답변, 학습 확인 건을 본다.
4. 필요한 카드나 바로가기를 눌러 해당 탭으로 이동한다.

주의사항

• 학생 로그인 화면에서 보호자 상담이 보이면 안 된다.
• 수업이 없는 날에는 수업 타임라인을 억지로 보여주지 않는다. 단, 등하원 기록이 있으면 타임라인을 표시한다.
• 하루에 등원/하원 기록이 여러 번 남을 수 있으므로 타임라인은 다건 표시가 가능해야 한다.

5. 알림장 목록

화면 목적

• 학원에서 보낸 앱 메시지 방을 회원 기준으로 보여준다.
• 읽지 않은 방은 레드닷 또는 새 알림 표시로 구분한다.

주요 구성

• 방 목록 카드
• 방 제목: 회원명/방명
• 최신 메시지 요약
• 최신 시간
• 읽지 않음 표시

터치 동작

• 방을 터치하면 알림장 대화방으로 진입한다.
• 푸시 알림에서 들어온 경우 URL 파라미터의 roomNo 또는 messageRoomNo를 기준으로 해당 방을 연다.

주의사항

• 자녀 선택을 변경하면 방 목록과 홈 요약을 다시 조회해야 한다.
• 새로고침 후에도 마지막 탭과 선택 자녀는 유지하되, 푸시 클릭으로 들어온 임시 탭 파라미터가 계속 남아 다른 탭 이동을 방해하면 안 된다.

6. 알림장 대화방

화면 목적

• 학원 안내와 보호자/회원 답장을 채팅방 형태로 확인한다.
• 결제 링크, 시험/과제 링크 같은 링크형 카드를 함께 표시한다.

주요 구성

• 상단 방 제목
• 메시지 목록
• 링크 카드
• 확인했습니다 버튼
• 문의하기 버튼

주요 버튼

• 확인했습니다: 해당 방을 읽음 처리하고 사용자에게 완료 피드백을 보여준다.
• 문의하기: 상담 탭으로 이동하면서 기존 메시지 내용을 상담 제목/내용에 참고할 수 있게 한다.

주의사항

• 방 진입 시 최신 메시지가 보이도록 메시지 목록 하단으로 스크롤해야 한다.
• 새로고침이나 앱 재진입 시 최초 메시지 위치로 돌아가면 안 된다.
• 파일 첨부는 비용 관리 목적상 제공하지 않는다. 필요한 경우 링크 카드만 사용한다.

7. 납부센터

화면 목적

• 보호자가 현재 미납, 이번 달 납부, 미납 청구, 납부 내역을 확인한다.
• 납부해야 할 청구가 있으면 미납 청구 카드에서 선택한 청구 단위로 결제 링크를 생성하거나 기존 링크로 이동한다.

주요 구성

• 납부센터 요약 카드
• 현재 미납
• 이번 달 납부
• 온라인 납부 안내
• 미납 청구 건수
• 미납 청구
• 납부 내역

주요 버튼

• 이 청구 결제하기: 미납 청구 카드에서 선택한 청구만 결제한다.
• 납부 내역 선택: 납부 상세 화면을 연다.
• 납입증명서: 기간 선택 후 납입증명서를 출력한다.

주의사항

• 청구만 생성되고 메시지를 보내지 않아도 납부센터에는 청구가 보여야 한다.
• 결제 링크는 메시지 발송 이력에 의존하면 안 된다.
• 납부센터 요약 카드에서는 결제 버튼을 두지 않고, 실제 결제 이동은 미납 청구 카드에서만 제공한다.
• 영수증은 실제 납부 내역을 선택했을 때만 제공한다.
• 납입증명서는 기간 기준 납부 합계로 제공한다.

8. 납부 상세/영수증

화면 목적

• 선택한 납부 1건의 상세 정보를 보여준다.
• 해당 납부 건에 대해서만 영수증 저장/인쇄를 제공한다.

주요 구성

• 납부내용
• 납부일
• 납부수단
• 납부금액
• 취소금액
• 실제 납부금액
• 영수증 저장/인쇄

주의사항

• 결제하기와 영수증 저장 버튼은 같은 카드에 두지 않는다.
• 취소/부분취소 건은 실제 납부금액이 명확히 보이도록 표시한다.

9. 납입증명서

화면 목적

• 기간을 선택해 해당 기간의 납입 합계를 출력한다.

주요 구성

• 시작일
• 종료일
• 납입 건수
• 납입 합계
• 납입 내역 목록
• 저장/인쇄 버튼

주의사항

• 납입증명서는 영수증과 다르다. 영수증은 납부 1건, 납입증명서는 기간 내 납부 합계 문서다.
• 실제 법정 증빙으로 쓰려면 사업자 정보, 발급번호, 직인/발급자 정보 정책이 추가로 필요하다.

10. 학습

화면 목적

• 선택 회원의 시험/과제 내역을 보여준다.
• 학습 내역은 실제 시험/과제 데이터만 표시하고, 임의의 수신 예정 카드는 표시하지 않는다.

주요 구성

• 학습 요약 카드
• 시험 내역
• 과제 내역
• 빈 상태 안내

터치 동작

• 시험 카드: 시험 상세 모달을 연다.
• 과제 카드: 과제 상세 모달을 연다.

주의사항

• 시험 그룹으로 배정된 경우 그룹 카드와 개별 시험을 구분해서 보여준다.
• 시험 점수와 상태가 중복 표시되지 않도록 한다.
• 시험 피드백은 TB_MEMBER_TEST.FDBK_CN 기준으로 표시한다.
• 과제 점수와 피드백도 과제 상세에서 확인 가능해야 한다.

11. 상담

화면 목적

• 보호자/회원이 상담을 요청하고, 등록된 답변을 확인한다.

주요 구성

• 상담 요청하기 버튼
• 상담 입력 폼
• 상담 내역
• 상담 답변
• 방문 상담 희망일/희망시간

등록/수정 방식

• 상담 내역이 없으면 상담 입력 폼을 기본으로 펼친다.
• 상담 내역이 있으면 입력 폼은 접고 상담 요청하기 버튼을 상담 내역보다 위에 둔다.
• 요청 상태의 상담은 수정 가능하게 한다.
• 처리/완료 상태의 상담은 답변 확인 중심으로 보여준다.

방문 상담 매핑

• 방문 상담 여부가 켜져 있으면 상담 방식은 방문 상담으로 저장한다.
• 방문 희망일은 상담 예정일 컬럼에 저장한다.
• 희망 시간은 상담 시작 시간 컬럼에 저장한다.

주의사항

• 학생으로 로그인했을 때 보호자의 상담 내역이 보이면 안 된다.
• 보호자는 자녀 상담 내역을 볼 수 있어야 하나, 표시 범위는 정책적으로 명확히 유지해야 한다.
• 후속조치내용 같은 내부 관리성 컬럼은 보호자에게 그대로 노출하지 않고, 답변 내용만 노출하는 것이 안전하다.

12. 설치 안내

화면 목적

• 사용자가 학원알림장을 휴대폰 홈 화면에 설치하도록 안내한다.

플랫폼별 정책

• Android Chrome: beforeinstallprompt가 있을 때만 앱 설치 버튼을 노출한다.
• Android Samsung Internet: 설치 프롬프트를 숨기고 Chrome에서 설치하라는 안내를 우선한다.
• iOS Safari: 공유 버튼에서 홈 화면에 추가 안내를 제공한다.
• 카카오 인앱 브라우저: 외부 브라우저로 열어 설치하라는 안내를 제공한다.

주의사항

• appinstalled 이벤트가 실제로 발생했을 때만 설치 성공으로 처리한다.
• prompt가 없는 상태에서 설치 버튼처럼 보이면 안 된다.

13. 알림 허용

화면 목적

• Web Push 권한과 구독 상태를 확인하고 서버에 저장한다.

업무 흐름 예시

1. 사용자가 알림 허용 버튼을 누른다.
2. 브라우저 권한 팝업에서 허용한다.
3. 서비스워커 구독 endpoint를 서버에 저장한다.
4. 테스트 푸시를 보내 수신 가능 상태를 확인한다.

주의사항

• 웹/PWA는 앱 첫 실행만으로 권한 팝업을 강제로 띄우는 방식을 신뢰하면 안 된다.
• 사용자 버튼 클릭 안에서 권한 요청을 해야 성공 가능성이 높다.
• 권한 허용과 endpoint 저장은 별개다. 둘 다 성공해야 수신 준비 상태다.

14. 본앱 알림장 관리

화면 목적

• 직원이 알림장 방, 메시지, 답장, 미읽음, 설치/푸시 준비 상태를 확인한다.
• 아직 앱 메시지 방이 없는 회원에게 초대메시지를 전송한다.

검색 조건

• 지점
• 회원
• 보호자명
• 방/메시지
• 최근일자 시작/종료
• 답장 있음
• 미읽음
• 설치
• 푸시 준비

목록 컬럼

• 번호
• 최근일시
• 지점
• 회원
• 반
• 최근발신
• 최근메시지
• 메시지 수
• 답장 수
• 미읽음 수
• 설치 상태
• 푸시 상태

주요 버튼

• 조회: 검색 조건으로 알림장 방 목록을 다시 조회한다.
• 초기화: 검색 조건을 기본값으로 돌린다.
• 엑셀 다운로드: 현재 목록을 엑셀로 다운로드한다.
• 초대메시지 보내기: 선택 회원에게 알림장 설치 링크를 문자로 보낸다.
• 답장 전송: 선택 방에 직원 메시지를 앱 메시지로 전송한다.

주의사항

• 알림장 관리 목록은 메시지 발송 이력이 있는 회원만 보이면 안 된다. 앱 메시지 방이 없어도 기본 수신자 후보는 표시되어야 한다.
• 초대메시지는 알림톡이 아닌 문자 우선으로 보내는 것이 안전하다. 카카오 인앱 브라우저에서 설치 경험이 나빠질 수 있기 때문이다.
• 앱 메시지와 푸시 알림은 같은 개념이 아니다. 앱 메시지는 알림장 방에 남는 내용이고, 푸시는 휴대폰에 띄우는 전달 수단이다.