🚀 바로가기:
📱 스터디카페 키오스크 📊 점주 실시간 관제 👨‍👩‍👧 학부모 안심 웹 포털 📖 운영 매뉴얼 (현재창)
MQnet StudyCafe & SelfStudy 공식 운영 지침서

📖 점주 및 관리실장 공식 운영 매뉴얼

스터디카페 현장 관제, 순찰 일지 기록, PPH 진도 연산, 소방 Fail-Safe 도어 제어 종합 안내
📊 점주 대시보드로 이동

1. 시스템 개요 및 주요 특징

2. 접속 경로 및 계정 체계

포털 구분 대상 기본 접속 URL 주요 역할
점주 실시간 관제 점주, 관리실장 /studycafe/admin.html 좌석 모니터링, 순찰 일지 등록, 비상 도어 제어, 심야 예외 관리
키오스크 / 학생 수험생, 학생 /studycafe/ 좌석 배정, 이용권 구매, 외출/복귀/퇴실, 오늘 끝 페이지 입력
학부모 안심 웹 포털 보호자 /studycafe/parent.html?phone={전화번호} 실시간 재실 위치, 순공 시간, 현장 순찰 일지, 출결 타임로그 확인
자기주도학습 (MQstudy) 관리형 학생/멘토 /selfstudy/ 주간 계획, AI 멘토링, 과목별 진도율 상세 대시보드
🔑 기본 관리자 계정: admin@mqnet.io / 비밀번호: 1212
(현장 정식 오픈 전 반드시 비밀번호를 변경해 주십시오.)

2.3 이용권 종류별 고정 좌석 & 자주학습(LMS) 운영 매트릭스

스터디카페 이용권은 당일권, 정기권/기간권, 관리형 패스로 구분되며 이용권에 따라 고정 좌석 배정 및 자주학습(SelfStudy LMS) 활용 권한이 엄격히 차등 적용됩니다.

이용권 구분 요금 유효기간 / 시간 로그인 시 구매 스킵 좌석 배정 규칙 (고정석 vs 자유석) 자주학습 (SelfStudy LMS)
2시간 당일권 4,000원 당일 2시간 (퇴실 시 만료) ✕ 매번 구매 일반 자유석 (입실 시 빈 좌석 선택) ⛔ 이용 차단
4시간 당일권 7,000원 당일 4시간 (퇴실 시 만료) ✕ 매번 구매 일반 자유석 (입실 시 빈 좌석 선택) ⛔ 이용 차단
50시간 정기권 75,000원 90일 (분 단위 차감) ✓ 구매 스킵 일반 자유석 (로그인 즉시 빈 좌석 선택) ⛔ 이용 차단
100시간 정기권 130,000원 90일 (분 단위 차감) ✓ 구매 스킵 일반 자유석 (로그인 즉시 빈 좌석 선택) ⛔ 이용 차단
4주 기간권 (일반) 150,000원 28일간 24시간 무제한 ✓ 구매 스킵 일반 자유석 (로그인 즉시 빈 좌석 선택) ⛔ 이용 차단
4주 관리형 프리미엄 280,000원 28일 무제한 + 관리케어 ✓ 구매 스킵 🔒 전용 고정석 (자리 배정 스킵, 자동 입실) 🟢 LMS 풀연동 (PPH/오더)
12주 D-day 올인원 750,000원 84일 무제한 + AI코칭 ✓ 구매 스킵 🔒 전용 고정석 (자리 배정 스킵, 자동 입실) 🟢 LMS 풀연동 (AI 코칭)
💡 현장 실장 운영 팁
1. 고정석 자동 입실: 4주 관리형 및 12주 올인원 패스 회원은 로그인 시 좌석을 고르는 단계가 자동으로 생략되고 자신의 고정 좌석으로 즉시 자동 입실(도어락 5초 개방)됩니다.
2. LMS 권한 분리: 당일권 및 일반 정기권 회원은 자기주도학습 LMS 탭 이용이 제한되며, 퇴실 시 진도 쪽수 입력 모달 없이 간편 퇴실 처리됩니다.
3. 학생 세션 유효성 차등 적용 (SelfStudy 예외): 학생의 스터디카페 현장 좌석 및 출입 이용은 유효 이용권(잔여시간 & 유효기간)이 있는 기간에만 로그인/이용이 유지되며, 만료 즉시 자동 퇴실 및 재충전 화면으로 안내됩니다. 단, 셀프스터디(SelfStudy) 학습 계획 및 PPH 진도표는 이용권 만료와 무관하게 14일 자동 로그인이 보장되어 집과 학교에서도 상시 열람 가능합니다.

3. 점주 관제 대시보드 운영법

점주는 태블릿이나 PC 브라우저로 /studycafe/admin.html을 상시 띄워두고 현장을 관리합니다. (15초마다 자동 새로고침)

주요 제어 버튼 기능

3.2 💰 실시간 매출 통계 및 결제 내역 확인

점주는 관제 대시보드에서 일일 매출, 당월 누적 매출, 이용권별 결제 현황을 실시간으로 확인하실 수 있습니다.

1. 상단 통계 카드 (금일 / 당월 매출)
• 오늘 매출: 오늘 결제된 이용권 금액 및 당일 결제 건수 실시간 집계
• 당월 누적 매출: 이번 달 누적 매출액 및 매장 전체 누적 결제액 자동 계산
2. 하단 매출 상세 섹션 (결제 테이블)
• 관리형 vs 일반형 매출 비교: 고수익 관리형 패스와 일반 자유석 판매 비중 분석
• 실시간 결제 승인 내역: 결제 시각, 상품명, 금액, 회원 ID/전화번호 실시간 확인

3.3 📑 국세청 소득신고 및 부가가치세(10%) 정산 가이드

부가가치세 신고 및 5월 종합소득세 신고 시 세무사 제출용 정산 데이터를 관제 화면에서 1초 만에 추출할 수 있습니다.

📅 월별 매출 (소득 과세표준)
• 1월~12월 월별 집계: 결제 건수, 총 결제액, 공급가액(÷1.1), 부가세(10%) 자동 분리
• 연간 종합 합계: 종합소득세 신고 시 총수입금액 및 과세표준 확정치로 바로 활용
📆 기간 지정 정산 & 📥 CSV 다운로드
• 세무 기간 지정: 반기/분기별 날짜를 지정하여 맞춤형 정산
• 엑셀 호환 CSV: [📥 세무용 CSV 다운로드] 클릭 시 세무회계 프로그램 등록용 UTF-8 BOM 파일 즉시 저장
🌐 통합 게이트웨이 연동: /mqhome/ 포털 메인의 매장 실시간 상황실 (Situation Room)에서도 매장 전체 총 매출 및 주문 건수가 실시간 통합 연동됩니다.

4. 현장 순찰 일지 & 학부모 안심 포털 연동

관리형 스터디카페의 가장 큰 경쟁력은 실장의 실시간 현장 라운딩입니다.

순찰 일지 작성 절차

  1. 30분~1시간 간격으로 열람실을 순찰합니다.
  2. 조는 학생이나 스마트폰 딴짓 학생 발견 시 해당 좌석의 [📋 순찰 기록] 버튼을 클릭합니다.
  3. 점검 항목 선택 후 [📝 순찰 일지 저장 & 학부모 리포트 전송]을 누릅니다.
점검 항목 벌점 지도 예시 학부모 화면 표기
😴 졸음 주의 +1점 가볍게 어깨를 두드려 깨운 뒤 세안 권유 오렌지 배지 + 메모 표시
📱 스마트폰 / 딴짓 +1점 SNS/유튜브 시청 경고, 인강 외 앱 종료 지도 레드 배지 + 메모 표시
🚶 무단 장기 이탈 +2점 사유 없는 60분 초과 자리비움 경고 레드 배지 + 메모 표시
👍 몰입 학습 우수 0점 (칭찬) 3시간 연속 고도의 집중 학습 유지 격려 그린 칭찬 배지 + 칭찬 메모
👨‍👩‍👧 학부모 안심 포털 즉시 반영: 실장이 순찰 일지를 등록하는 순간 학부모 화면에 실시간으로 반영되므로, 관리형 스터디카페에 대한 학부모 신뢰가 크게 향상됩니다.

5. 청소년 22:00 심야 셧다운 및 점주 예외 관리

청소년보호법에 따라 밤 22:00 이후 만 19세 미만 청소년의 이용은 엄격히 제한됩니다.

자동 셧다운 일정

점주 예외 승인 (고3 / 동의서 제출자)

6. SelfStudy(PPH 진도 연산) 연동 워크플로우

🔒 자주학습(LMS) 이용 권한 구분
• 관리형 패스 (4주 관리형 · 12주 올인원): SelfStudy LMS 5과목 진도오더, 0.1초 PPH 리밸런싱, 퇴실 시 교재 쪽수 체크, 학부모 연동 풀패키지 지원.
• 당일권 및 일반 정기권: 단순 자율 독서 목적으로 SelfStudy LMS 탭 연동이 차단되며, 퇴실 시 쪽수 입력 절차 없이 즉시 간편 퇴실 처리됩니다.

관리형 회원이 퇴실할 때 단 10초 만에 학습 실적을 수집하여 다음 날 학습량을 자동 산출합니다.

[학생 키오스크 퇴실] ──▶ [10초 컷 교재 끝 페이지 입력] ──▶ [스마트 퇴실 완료]
                                     │
                                     ▼
                   [PPH(시간당 학습속도) 자동 연산]
                                     │
                                     ▼
                   [내일 분량 자동 스케줄링 & 학부모 리포트 연동]
      
💡 PPH(Pages Per Hour) 공식: 당일 소화 페이지 수 ÷ 실제 순공 시간
오늘 목표치에 미달한 과목은 학생의 PPH 속도에 맞춰 내일 학습 분량으로 지능형 자동 이월(Rebalancing)됩니다.

7. 스마트 출입문 제어 & 화재 비상(Fail-Safe) 매뉴얼

🚨 소방법 피난시설 기준 (Fail-Safe 절대 원칙)
화재 또는 정전 발생 시 모든 출입문은 컴퓨터 조작이나 소프트웨어 정상 여부와 무관하게 물리적으로 즉시 전면 개방되어야 합니다.

하드웨어 배선 구조

소프트웨어 비상 개방 발령 & 복구

8. 개인정보보호 및 데이터 관리 수칙

개인정보보호법(제15조, 제22조 등) 준수를 위해 시스템 전 과정에서 [필수] 개인정보 수집 및 이용 동의를 의무 수집하고 있으며, 미동의 시 기능 이용이 원천 차단됩니다.

단계별 필수 동의 적용 현황

수집 목적 및 90일 경과 기록 안전 파기

9. 자주 묻는 질문(FAQ) & 장애 대응

Q1. 학생이 문 앞인데 문이 안 열린다고 합니다.

점주 대시보드에서 [🔓 출입문 5초 개방]을 눌러 우선 입장시킨 후, 외출 60분 초과로 자동 퇴실되었는지 확인하십시오.

Q2. 학부모님이 자녀 상태를 어디서 보는지 모른다고 하십니다.

점주 화면에서 학생 전화번호를 확인하고 아래 안내 문구를 카카오톡/문자로 전달합니다:
👉 https://{매장도메인}/studycafe/parent.html?phone=010-XXXX-XXXX
"링크 접속 후 [홈 화면에 추가]를 눌러두시면 매일 1-터치로 확인하실 수 있습니다."

Q3. 서버 재시작 명령어 (Windows 콘솔)

cd c:\Users\USER\Desktop\Workstation\integrated
py -3.14 -m uvicorn gateway.main:app --host 0.0.0.0 --port 9000