쌤 — 사용법

1인 과외 선생님용 학생관리. 수업 메모 한 줄 → 청구 자동 합성. 데이터는 이 폰에만.

⚡ 쌤의 핵심 가치

"이번 달 8회 수업, 시급 4만원 × 6시간 = 24만원" — 강사가 손으로 계산할 일 0.
수업 끝날 때 메모 한 줄 → 월말에 카톡 발송 메시지 자동 생성 → 입금 토글로 미수금 추적.

🔒 Local-only PWA — 회원가입·로그인 없음. 모든 데이터(학생·수업·청구·강사 정보)가 이 폰 브라우저에만 저장됩니다. 서버에 일체 저장 X. 폰 잃거나 브라우저 데이터 삭제하면 데이터 손실 — ⚙ 설정 → 백업 다운로드 정기 권장.

5분 시작
일과 — 3개 탭
청구 메시지 + 입금 추적
메시지 템플릿 변수
보안 · 개인정보
자주 묻는 질문

1. 5분 시작

1우상단 ⚙ → 강사 정보 입력

강사 이름 · 은행 · 계좌번호 · 예금주 · 기본 호칭. 청구 메시지에 자동으로 들어갑니다. 이 정보는 폰 안에만 저장 됩니다 (서버 X).

2＋ 학생 추가

이름 · 학년 · 과목 · 수업료 (시급 / 월정액 / 회당 중 1개 선택). 연락처 메모는 선택. 이 학생이 청구 자동 집계의 기본 단위.

3학생 카드 클릭 → 💬 수업 탭 → 첫 수업 기록

날짜 · 시간(분) · Q&A · 진도. 저장 즉시 청구 합계가 자동 갱신됩니다.

완성! 이걸로 청구가 자동 집계되고, 💰 청구 탭에서 카톡 발송용 메시지가 자동 만들어집니다.

2. 일과 — 3개 탭

💬 수업	수업 끝나면 메모/Q&A/진도 입력. 과거 기록 모두 시간순으로 보임.
📚 진도	진도 메모만 골라서 모아 보기. 시간순. 학생이 어디까지 했는지 한눈에.
💰 청구	이번 달 수업 횟수·시간·청구액 자동 집계. 카톡 발송용 메시지 자동 생성. 카톡 보냄·입금 받음 토글.

3. 청구 메시지 + 입금 추적

💰 청구 탭의 핵심 흐름:

A메시지 자동 생성

학생 통계 (수업 횟수·시간·합계) + 강사 정보 (이름·계좌, 폰 저장) + ⚙ 템플릿을 조합해서 카톡 발송용 메시지 자동 생성. textarea 에서 직접 편집 가능.

B📋 카톡 메시지 복사

버튼 클릭 → 메시지가 클립보드로 복사 + 그 학생 카드에 "📋 카톡으로 복사함" 표시. 카톡 학생/학부모 톡방에 그대로 붙여넣기.

C💸 입금 받음

학생/학부모가 입금하면 토글 ON. 메인 화면 학생 카드에 "✓ 입금 받음" 마크 표시. 미수금은 자동 차감.

4. 메시지 템플릿 변수

⚙ 설정의 메시지 템플릿에서 사용. {{변수}} 형식 — 자동으로 값으로 치환됨.

변수	출처	예시 값
`{{student}}`	학생	Alice
`{{salutation}}`	학생별 호칭 (없으면 ⚙ 기본 호칭)	어머님께
`{{year}}` `{{month}}`	청구 월	2026 / 5
`{{sessions}}`	이번 달 수업 횟수	8
`{{hours}}`	총 시간 (예: 6.5)	6.5
`{{minutes}}`	총 분	390
`{{rate}}`	수업료 (천단위 콤마)	40,000
`{{rateUnitLabel}}`	단위 라벨 (시간당 / 월정액 / 회당)	시간당
`{{rateUnit}}`	단위 키 (hour / month / session)	hour
`{{hourly}}`	(레거시) 수업료 — `{{rate}}` 와 동일	40,000
`{{total}}`	합계 (모드별 자동 계산, 천단위 콤마)	260,000
`{{teacher}}`	⚙ 강사 이름	김쌤
`{{bank}}`	⚙ 은행	국민은행
`{{account}}`	⚙ 계좌번호	123-456-789012
`{{holder}}`	⚙ 예금주	홍길동

기본 템플릿

[{{student}} {{salutation}}]
{{year}}년 {{month}}월 과외 수업료 안내드립니다.

• 수업 {{sessions}}회 (총 {{hours}}시간)
• {{rateUnitLabel}} {{rate}}원
• 합계: *{{total}}원*

{{bank}} {{account}} ({{holder}})

감사합니다 🙏

청구 단위별 계산식

단위	계산	예
시급 (hour)	`수업료 × (총 분 / 60)`	40,000 × 6h = 240,000
월정액 (month)	`수업료` 그대로 (수업 횟수 무관)	매달 300,000
회당 (session)	`수업료 × 수업 횟수`	50,000 × 8회 = 400,000

5. 보안 · 개인정보

모든 데이터	학생·수업·청구·강사 정보 전부 이 폰 브라우저 localStorage 에만. 서버에 일체 저장 X. ssem.ppai-lab.com 운영자도 학생 데이터 못 봄.
회원가입/로그인	없음. URL 열면 바로 본인 데이터. 다른 사람 폰에서는 본인 데이터 볼 수 없음 (각자 폰의 localStorage 가 다름).
백업 책임	강사 본인. ⚙ → 백업 다운로드 → JSON 파일을 본인 클라우드(드라이브/iCloud/이메일)에 보관. 폰 잃으면 백업으로 복원.
전송	HTTPS (Let's Encrypt). 페이지 로드 외에는 서버에 데이터 보내는 호출 0.
인덱싱	`X-Robots-Tag: noindex` — 검색엔진 노출 X.
다른 폰	다른 폰에서 같은 URL 열어도 데이터 빈 상태. ⚙ → 백업 복원 으로 가져옴.

6. 자주 묻는 질문

회원가입·로그인 어디 있어요?

없습니다. Day 9 부터 ssem 은 local-only PWA — URL 열면 바로 본인 데이터. 다른 사람이 같은 URL 열어도 본인 데이터 못 봄 (각자 폰 브라우저 localStorage 가 다름).

다른 폰에서도 쓸 수 있나요?

각 폰마다 빈 상태로 시작. 한 폰에서 ⚙ → 백업 다운로드 → JSON 파일을 다른 폰에 옮긴 후 ⚙ → 백업 복원. 자동 동기화는 없음 (의도 — 데이터가 폰 밖으로 안 나감).

폰 잃어버리면?

데이터 손실. 백업 파일이 없으면 복구 불가. 정기적으로 ⚙ → 백업 다운로드 후 본인 클라우드(드라이브/iCloud/이메일)에 보관 권장. 한 달에 한 번 정도.

학생 삭제하면?

그 학생의 모든 수업·청구 기록도 함께 삭제됨 (확인 다이얼로그 1회). 백업 파일이 있으면 복원 가능.

이번 달 청구가 0원으로 나옴

① 학생 수업료가 박혔는지 (학생 편집 → 수업료) ② 시급/회당 모드면 이번 달 수업이 1건 이상 있는지. 월정액 모드면 수업 0회여도 청구액은 정해진 금액 그대로 — 0원이 나오면 학생 수업료가 0이거나 모드 설정 문제.

"카톡 발송 메시지" 가 ⚠ 강사 정보 미설정으로 떠요

⚙ 설정 → 강사 이름·은행·계좌·예금주 입력 후 저장. 폰에 저장되면 메시지 자동 합성됨.

옛 서버 데이터 (Day 1~8) 어디 있어요?

강사 본인이 쓰던 데이터는 백업 JSON 파일로 보존됨 (서버에 archive). 강사 본인이 SCP/Telegram 등으로 받은 후 ⚙ → 백업 복원 으로 가져오면 polished. Simon 본인은 /root/uploads/ssem-backup-2026-05-07.json.