도봉이 진행 문서

도봉이 진행 문서

지금까지 한 것을 한곳에 모은 문서 · 2026-11-16 정리

기획서목표 관리진행 상황운영 기획화면 기획상세 설계서오픈 계획진행 문서
개발 서버에서 직접 써 보기손님 화면손님 화면 (빠른 시험)AI 관리CCTV카메라 켜기총무 대화AI 관리·CCTV·카메라·총무 대화는 총무 열쇠가 필요해요

마지막 정리: 2026-11-16. 도봉구 무인 스터디카페(첫 고객)를 위한 서비스 "도봉이"의 지금까지 진행을 한곳에 모은 문서다.

1. 한 줄 요약

2. 방향이 바뀐 순서

날짜바뀐 것
11/14아이폰 앱으로 시작. 카메라로 얼굴을 보고 자리 비움·졸음을 잡는 방식. 캐릭터 도봉이 확정(시안 D). 학부모 기능 삭제, 가입은 별명만.
11/14총무 대화·공부방 순위·근처 대화를 서버(Cloudflare)로. XR·14 Pro 에 설치해 두 폰 확인.
11/15졸음을 눈 감김에서 고개 끄덕임으로. AI 총무, 배터리 아끼기, 이탈 경고, CCTV 웹, AI 관리, 이상행동 감지, 고객 공유 사이트 추가. 이름을 "도봉이"로 확정.
11/15앱을 버리고 웹으로 전환. 얼굴 인식 → 사람 인식 → 카메라 인식 전부 삭제(스스로 관리). 소리·진동 삭제.
11/15결제선생 이용권, 회원 혜택, 1등·단체 할인, 부모님 공유·결제, 게시판, 스터디 크루, 목표 인증, CCTV 좌석 관리, 디데이, 돌멩이 포인트, 3D 도봉이 추가.
11/15근처 대화 삭제. 접속·시간·순위를 서버가 계산. Cloudflare·도메인·딥시크·카카오·결제선생을 모두 사장님 명의로 하기로 결정.
11/16손님 폰 알림, 손님이 고르는 카메라, 매장 CCTV 스위치, 디자인 세 가지. 기획서 2판. 웹으로 12/14 오픈하기로 확정.

지금은 쓰지 않는 것: 아이폰 앱(Sungong/, SungongUITests/), 모든 손님을 카메라로 보는 기능(지금은 손님이 직접 켠 경우에만), 근처 대화, 소리·진동 알림, 앱스토어 계획.

3. 주소

지금은 우리 Cloudflare 계정의 개발 주소다. 사장님 전용 주소를 사면 한 번 바뀐다.

누가주소들어가는 법
손님https://sungong-api.johunsang.workers.dev/좌석 QR(/?store=도봉점&seat=A-12) 또는 주소
부모님/watch#토큰손님이 보낸 링크
사장님: AI 관리/manage총무 열쇠
사장님: CCTV 보기/cctv총무 열쇠
매장 카메라 폰/cam총무 열쇠 + 카메라 이름
사장님: 총무 대화/staff총무 열쇠
대시보드(고객 공유)/handover 기획서, /kpi 목표 관리, /progress 진행 상황, /ops 운영 기획, /plan 화면 기획, /spec 상세 설계서, /deploy 오픈 계획공유 코드(주소의 # 뒤) 또는 총무 열쇠

4. 만든 것

손님 웹 (server/public/app.html, app.js)

기능내용
가입별명 → 바로 회원가입 권유(전화번호). 카카오 가입은 "준비 중".
이용권시간당 메뉴(1·2·3·4·6·8·10·12시간) + 기간권. 전화번호를 넣으면 결제선생이 결제창을 보낸다.
할인회원 5%, 1등 연장 10%, 같이 공부(크루 3명 이상) 10%. 합쳐서 50%까지.
돌멩이(포인트)회원이 결제하면 1,000원마다 1개. 10개로 1시간 무료. 홈·공부 화면 오른쪽 위에 표시.
오늘 목표·공부 방식목표 2·4·6·8시간. 50분·10분(기본), 뽀모도로 25·5, 몰입 90·15, 자유.
공부 화면원 모양 24시간 시간표, 목표 고리, 휴식까지 타이머, 매장 순위(1분마다), 디데이, 잠금 표시.
화면 잠금벗어나면 "잠금 풀림"으로 세고 그 시간은 순공에서 뺀다. 휴식 시간에 풀린다. (폰 자체는 못 잠근다.)
연장 유도30분 전 남은 시간, 10분 전 연장 버튼, 끝나면 연장 권유(5분 뒤 퇴실).
스터디 크루소개·약속·하루 목표, 오늘 출석·합계·연속·MVP, 같이 시작(같은 시계로 공부·휴식), 한마디, 크루 순위, 공개 크루, 가입 신청·수락, 모집 글.
게시판공지·주의사항, 응원방, 같이 공부해요, 목표 인증 이벤트(증거 사진 → 무료 30분).
총무AI 도봉이가 답한다. 빠른 요청 4개.
부모님 공유손님이 링크를 만들어 보낸다. 부모님은 진행을 보고 대신 결제한다.
기록날짜별 이력과 관리 내역. 가입 안 해도 폰(IndexedDB)에 남고, 회원은 서버에도 보관.
관리 노트입실 인사, 한 시간마다 챙김, 퇴실 노트 세 줄, 월간 정리(회원).
디데이이름·날짜 저장. 홈 맨 위에 크게.
도봉이3D 모델(끌면 돌고 누르면 춤·웃긴 동작 12가지). 휴식·달성 화면에서 춤춘다.
알람이용권 없이 이용 중이면 빨간 알람과 결제 버튼.

사장님 화면

화면내용
AI 관리 /manage지금 공부 중, 오늘 출결, 도봉이 보고(매시), 할 일, 이상 사용자, 매장 알림, 좌석 현황, 증거 사진, 매출, 결제 내역·환불, 가격·할인·돌멩이 설정, 이용권 직접 주기, 공지 쓰기, 목표 인증 확인.
CCTV /cctv카메라 영상(8대까지), 영상에서 좌석 지정, 좌석 현황, 부정 사용 알람, 증거 사진.
카메라 /cam매장 폰에서 켠다. 영상을 그 폰 안에 5분 조각으로 24시간 저장. 사람 수와 좌석별 사람 유무를 서버에 알린다.

AI 가 하는 일 (딥시크)

서버가 자동으로 하는 일 (규칙)

6. 임시로 잡아 둔 값 (사장님이 정해야 한다)

항목지금 값
시간당 가격비어 있음
회원 할인5%
1등 연장 할인10%
같이 공부 할인같은 크루 3명 이상, 10%
돌멩이1,000원마다 1개, 10개로 1시간 무료
자동 환불결제 후 10분 안
목표 인증 보상무료 30분
이용권 필수꺼짐 (지금은 누구나 무료 입실)
테스트 입실 버튼켜짐 (오픈 전에 끈다)

7. 확인한 것과 못 한 것

확인한 것

못 한 것

8. 사장님 준비물 (첫 주, 11/16~11/22)

안내는 대시보드 "오픈 계획"에 있다. 모두 사장님 명의로 한다.

  1. Cloudflare 가입 → 우리를 관리자로 초대
  2. 결제선생 가맹 가입 → 연동 신청 (심사에 며칠 걸릴 수 있어 가장 먼저)
  3. 매장 전용 주소(도메인) 정하고 사기
  4. 딥시크 열쇠 받기
  5. 카카오 디벨로퍼스 앱 만들고 우리를 초대
  6. 좌석 번호표, CCTV용 폰·태블릿 4대, 지금 쓰는 지문 인식·결제기의 계약 조건
  7. 가격·할인율·환불 기준 정하기

9. 오픈 일정 (우리가 잡은 안)

기간내용
11/16 ~ 11/22사장님 준비물, 실제 폰 점검
11/23 ~ 11/29사장님 계정·전용 주소로 옮기기, 좌석 QR 과 CCTV 4대 설치, 100원 결제 시험, 사장님 시험
11/30 ~ 12/6시범 운영 (단골 10~20명). 끝나면 KPI 기준값으로 첫 목표 정하기
12/7 ~ 12/13오픈 준비 (고치기, 기존 회원 옮기기, 안내 붙이기)
12/14 (월)정식 오픈, 옛 장치와 2주 같이 운영
12/28 ~옛 장치 정리, 매달 숫자 보며 조정, 마케팅

10. 남은 일

오픈 전 필수

권장

11. 조심할 것

12. 11/16 하루 작업 정리

11월 16일 하루 동안 정한 것과 만든 것을 따로 모았습니다. 모두 개발 주소에 올라가 있어 바로 써 볼 수 있습니다.

정한 것

정한 것내용
웹으로 갑니다12/14 오픈까지 웹으로 갑니다. 앱은 심사가 오래 걸리고 바로 고치기 어렵습니다. 앱과 새 기능은 오픈 뒤 숫자를 보고 정합니다.
범위 묶기지금 만든 것으로 오픈합니다. 기획서 2판대로 갑니다.
카메라손님이 설정에서 직접 켜는 기능입니다. 기본은 꺼짐이고 강제하지 않습니다.
소리·진동알림도 소리와 진동 없이 보냅니다.

만든 것

순서만든 것내용
1새 도봉이와 디자인웃는 얼굴의 새 그림으로 바꿨습니다. 누르면 춤과 웃긴 동작을 합니다. 화면 디자인은 파스텔·다크·크림 세 가지입니다.
2손님 폰 알림손님이 "알림 받기"를 켜면 화면을 닫아 둬도 알림이 갑니다. 총무 답, 도봉이 독려, 이용권 끝나기 10분쯤 전은 자동으로 가고, 사장님은 AI 관리 화면에서 직접 보냅니다. 안드로이드는 바로 되고 아이폰은 홈 화면에 추가한 뒤에 됩니다.
3카메라로 집중 지키기켠 손님만 자리를 3분 넘게 비우면 순공을 멈췄다가 돌아오면 이어 갑니다. 영상은 손님 폰 안에서만 씁니다.
4매장 CCTV 스위치AI 관리 화면의 "기능 켜고 끄기"에서 한 번에 켜고 끕니다. 지금은 꺼 뒀습니다.
5기획서 2판안심하셔도 되는 것들, 웹으로 가는 이유, 손님의 하루, 알림 쓰는 법, 정해 주실 것, 위험과 대비, 지금 숫자를 넣었습니다.
6대시보드 전체 갱신운영 기획, 상세 설계서, 오픈 계획, 진행 문서, 목표 관리(지표 "알림을 켠 손님" 추가로 열 개), 진행 상황을 바뀐 내용으로 맞췄습니다.
7크루 알림크루원이 그날 처음 자리에 앉거나 "같이 시작"을 누르면 다른 크루원 폰에 알림이 갑니다. 한 사람이 하루 2번까지 받습니다.
8연속 출석 보상크루가 3일, 7일(그 뒤 7일마다) 연속으로 모이면 그날 온 크루원 모두 돌멩이를 받습니다.
9친구 초대 보상초대 링크로 온 친구가 첫 결제를 하면 둘 다 돌멩이를 받습니다.
10전체 채팅방같은 매장 손님끼리 대화합니다. 방 맨 위에 오늘 1~3등, 내 등수, 지금 공부 중인 사람 수가 보입니다. AI 검사, 신고 3번이면 가림, 하루 뒤 삭제. 손님은 설정에서 끄거나 한 사람 글을 가리고, 사장님은 AI 관리 화면에서 전체를 끕니다. 지금은 켜 뒀습니다.
11총무 도봉이채팅방에 같이 있습니다. 순위를 물으면 알려 주고, 부르면 답하고, 한 시간마다 순위를 올립니다.

확인한 것과 못 한 것

항목상태
알림 켜기·받기·끄기, 이용권 끝 알림실제 주소에서 크롬으로 확인
카메라 켜기, 자리 비움, 돌아옴, 졸음시험용 카메라로 확인
채팅 보내기, AI 차단, 도봉이 답, 순위 답실제 주소에서 확인
연속 3일 보상, 초대 뒤 첫 결제 보상개발 컴퓨터에서 확인
아이폰 실제 폰 알림아직
실제 폰에서 카메라 판정아직
크루 알림이 실제 폰에 도착아직
한 시간마다 순위 올리기정각에 올라오는 것은 아직 못 봄
실제 결제, 실제 매장 CCTV꺼 둠

만들지 않은 것

이날 새로 생긴 임시값 (사장님이 정해 주실 것)

항목임시값
친구 초대 보상돌멩이 3개
연속 출석 보상3일 2개, 7일 5개
전체 채팅방켜짐
매장 CCTV꺼짐

AI 관리 화면에서 바로 바꿀 수 있습니다. 나머지 임시값은 6번에 있습니다.

다음에 할 일

13. 11/17 CCTV 좌석과 손님 연결

CCTV 화면에 미리 찍어 둔 좌석으로 손님과 이어서 부정 사용을 골라냅니다.

14. CCTV 화면 보는 법

사장님이 보는 CCTV 화면입니다. 아래 사진은 시험용 카메라와 시험 손님으로 띄운 것이고 실제 매장 영상이 아닙니다. 회색 네모는 좌석 자리를 흉내 낸 그림입니다.

CCTV 화면: 위에 빨간 알람, 영상 위 좌석 표시, 아래 좌석 현황 표

화면의 세 부분

위치무엇설명
맨 위 빨간 줄알람결제 없이 앉은 사람이 의심되면 뜹니다. 어느 카메라의 어느 좌석인지, 오늘 그 좌석을 마지막으로 쓴 손님이 누구인지 적혀 있습니다. "확인"을 누르면 사라집니다.
가운데 영상카메라와 좌석 표시매장에 세워 둔 폰이 보내는 영상입니다. 영상 위에 좌석 번호가 색으로 떠 있습니다. "좌석 지정"을 누르고 영상 위 자리를 눌러 좌석 번호를 넣습니다. 번호는 다음 번호가 미리 채워져 이어서 찍기 쉽습니다.
아래 표좌석 현황맨 위에 전체 좌석 수와 상태별 수가 한 줄로 나옵니다. 표는 문제 있는 자리가 먼저 나옵니다(결제 없음 → 빈자리인데 공부 중 → 이용 중 → 자리 비움 → 빈자리). 좌석이 100개가 넘어도 볼 것이 위에 모입니다.

좌석 색

색뜻사진에서
초록사람이 있고, 그 좌석으로 이용 중인 손님도 있습니다. 정상입니다.A-1 민지, A-5 서연
노랑손님은 "공부 중"인데 자리에 사람이 없습니다. 잠깐이면 화장실이나 휴식입니다.A-2 준호
빨강사람은 있는데 그 좌석으로 이용 중인 손님이 없습니다. 결제 없이 앉은 것으로 봅니다.A-4
회색사람도 손님도 없는 빈자리입니다.A-3

15. 어떻게 판별하나 (판별 로직)

두 가지 사실을 좌석 번호로 맞대어 봅니다. ① 카메라가 본 것(이 좌석에 사람이 있다/없다)과 ② 손님 폰이 알려 온 것(이 좌석에서 공부 중이다/이용권이 있다)입니다. 얼굴은 알아보지 않습니다.

1단계. 카메라 폰이 "좌석에 사람이 있는지"를 판정

2단계. 손님 폰이 "이 좌석에서 이용 중"을 알림

3단계. 둘을 좌석 번호로 맞대기

카메라손님결과
사람 있음이용 중인 손님 있음초록, 이용 중
사람 있음이용 중인 손님 없음빨강, 결제 없음
사람 없음공부 중인 손님 있음노랑, 자리 비움
사람 없음손님 없음회색, 빈자리
60초 넘게 소식 없음상관없음"카메라 꺼짐"으로 표시하고 판정하지 않습니다

4단계. 부정 사용으로 올리는 기준

종류기준그 뒤
결제 없이 앉음빨강이 두 번 이어서(약 30초) 확인되면 알람그 순간의 사진 한 장을 증거로 남깁니다(7일 보관). 알람에 오늘 그 좌석을 마지막으로 쓴 손님과 이용권이 끝난 시각을 붙입니다. 같은 좌석은 10분에 한 번만 알립니다.
빈자리인데 공부 중노랑이 두 번 이어질 때마다 그 간격(15초쯤)을 그 손님의 오늘 기록에 더합니다. 합이 10분을 넘으면 주의(2점), 30분을 넘으면 경고(4점)좌석 표의 손님 칸에 빨갛게 뜨고, AI 관리 화면의 이상 사용자에 이름과 사유가 올라갑니다.
같은 좌석 겹쳐 쓰기한 좌석 번호로 두 명 이상이 동시에 공부 중이면 2점AI 관리 화면의 이상 사용자
이용권 없이 이용"이용권 필수"가 켜져 있는데 이용권 없이 공부 중이면 5점AI 관리 화면의 이상 사용자, 손님 화면의 결제 알람

점수는 다른 규칙(폰 딴짓, 시간 조작 등)과 더해서 2점 이상이면 주의, 4점 이상이면 경고입니다. 판단은 정해진 규칙이 하고, AI 는 그 결과를 읽어 사장님 보고서를 쓰기만 합니다.

좌석이 100개가 넘을 때

틀릴 수 있는 경우와 대비

경우어떻게 되나대비
화장실, 휴식노랑이 되고 빈 시간이 쌓입니다10분까지는 넘어갑니다
엎드려 자거나 칸막이에 가려 어깨가 안 보임빈자리로 잘못 볼 수 있습니다카메라를 높은 곳에서 비스듬히 내려다보게 둡니다. 경고가 떠도 사장님이 영상을 보고 판단합니다
다른 자리로 옮겨 앉음원래 좌석은 노랑, 새 좌석은 빨강이 됩니다알람에 마지막으로 쓴 손님이 나오므로 누구인지 좁혀집니다. 새 좌석 QR 을 찍으면 풀립니다
통로를 지나가는 사람좌석 한도 밖이면 붙지 않고, 붙더라도 두 번 이어져야 알람입니다-
카메라 폰이 꺼짐그 카메라 좌석은 판정을 멈추고 "카메라 꺼짐" 알림이 옵니다-

자동으로 내보내거나 벌을 주지 않습니다. 알람과 표시까지만 하고, 조치는 사장님이 정합니다. 10분·30분 같은 값은 임시값이라 실제 매장에서 써 보고 맞추겠습니다. 실제 매장 카메라로는 아직 확인하지 못했습니다.

의견