
지금까지 한 것을 한곳에 모은 문서 · 2026-11-16 정리
마지막 정리: 2026-11-16. 도봉구 무인 스터디카페(첫 고객)를 위한 서비스 "도봉이"의 지금까지 진행을 한곳에 모은 문서다.
| 날짜 | 바뀐 것 |
|---|---|
| 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/), 모든 손님을 카메라로 보는 기능(지금은 손님이 직접 켠 경우에만), 근처 대화, 소리·진동 알림, 앱스토어 계획.
지금은 우리 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 오픈 계획 | 공유 코드(주소의 # 뒤) 또는 총무 열쇠 |
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시간 저장. 사람 수와 좌석별 사람 유무를 서버에 알린다. |
| 항목 | 지금 값 |
|---|---|
| 시간당 가격 | 비어 있음 |
| 회원 할인 | 5% |
| 1등 연장 할인 | 10% |
| 같이 공부 할인 | 같은 크루 3명 이상, 10% |
| 돌멩이 | 1,000원마다 1개, 10개로 1시간 무료 |
| 자동 환불 | 결제 후 10분 안 |
| 목표 인증 보상 | 무료 30분 |
| 이용권 필수 | 꺼짐 (지금은 누구나 무료 입실) |
| 테스트 입실 버튼 | 켜짐 (오픈 전에 끈다) |
확인한 것
못 한 것
안내는 대시보드 "오픈 계획"에 있다. 모두 사장님 명의로 한다.
| 기간 | 내용 |
|---|---|
| 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 ~ | 옛 장치 정리, 매달 숫자 보며 조정, 마케팅 |
오픈 전 필수
권장
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번에 있습니다.
CCTV 화면에 미리 찍어 둔 좌석으로 손님과 이어서 부정 사용을 골라냅니다.
사장님이 보는 CCTV 화면입니다. 아래 사진은 시험용 카메라와 시험 손님으로 띄운 것이고 실제 매장 영상이 아닙니다. 회색 네모는 좌석 자리를 흉내 낸 그림입니다.
| 위치 | 무엇 | 설명 |
|---|---|---|
| 맨 위 빨간 줄 | 알람 | 결제 없이 앉은 사람이 의심되면 뜹니다. 어느 카메라의 어느 좌석인지, 오늘 그 좌석을 마지막으로 쓴 손님이 누구인지 적혀 있습니다. "확인"을 누르면 사라집니다. |
| 가운데 영상 | 카메라와 좌석 표시 | 매장에 세워 둔 폰이 보내는 영상입니다. 영상 위에 좌석 번호가 색으로 떠 있습니다. "좌석 지정"을 누르고 영상 위 자리를 눌러 좌석 번호를 넣습니다. 번호는 다음 번호가 미리 채워져 이어서 찍기 쉽습니다. |
| 아래 표 | 좌석 현황 | 맨 위에 전체 좌석 수와 상태별 수가 한 줄로 나옵니다. 표는 문제 있는 자리가 먼저 나옵니다(결제 없음 → 빈자리인데 공부 중 → 이용 중 → 자리 비움 → 빈자리). 좌석이 100개가 넘어도 볼 것이 위에 모입니다. |
| 색 | 뜻 | 사진에서 |
|---|---|---|
| 초록 | 사람이 있고, 그 좌석으로 이용 중인 손님도 있습니다. 정상입니다. | A-1 민지, A-5 서연 |
| 노랑 | 손님은 "공부 중"인데 자리에 사람이 없습니다. 잠깐이면 화장실이나 휴식입니다. | A-2 준호 |
| 빨강 | 사람은 있는데 그 좌석으로 이용 중인 손님이 없습니다. 결제 없이 앉은 것으로 봅니다. | A-4 |
| 회색 | 사람도 손님도 없는 빈자리입니다. | A-3 |
두 가지 사실을 좌석 번호로 맞대어 봅니다. ① 카메라가 본 것(이 좌석에 사람이 있다/없다)과 ② 손님 폰이 알려 온 것(이 좌석에서 공부 중이다/이용권이 있다)입니다. 얼굴은 알아보지 않습니다.
| 카메라 | 손님 | 결과 |
|---|---|---|
| 사람 있음 | 이용 중인 손님 있음 | 초록, 이용 중 |
| 사람 있음 | 이용 중인 손님 없음 | 빨강, 결제 없음 |
| 사람 없음 | 공부 중인 손님 있음 | 노랑, 자리 비움 |
| 사람 없음 | 손님 없음 | 회색, 빈자리 |
| 60초 넘게 소식 없음 | 상관없음 | "카메라 꺼짐"으로 표시하고 판정하지 않습니다 |
| 종류 | 기준 | 그 뒤 |
|---|---|---|
| 결제 없이 앉음 | 빨강이 두 번 이어서(약 30초) 확인되면 알람 | 그 순간의 사진 한 장을 증거로 남깁니다(7일 보관). 알람에 오늘 그 좌석을 마지막으로 쓴 손님과 이용권이 끝난 시각을 붙입니다. 같은 좌석은 10분에 한 번만 알립니다. |
| 빈자리인데 공부 중 | 노랑이 두 번 이어질 때마다 그 간격(15초쯤)을 그 손님의 오늘 기록에 더합니다. 합이 10분을 넘으면 주의(2점), 30분을 넘으면 경고(4점) | 좌석 표의 손님 칸에 빨갛게 뜨고, AI 관리 화면의 이상 사용자에 이름과 사유가 올라갑니다. |
| 같은 좌석 겹쳐 쓰기 | 한 좌석 번호로 두 명 이상이 동시에 공부 중이면 2점 | AI 관리 화면의 이상 사용자 |
| 이용권 없이 이용 | "이용권 필수"가 켜져 있는데 이용권 없이 공부 중이면 5점 | AI 관리 화면의 이상 사용자, 손님 화면의 결제 알람 |
점수는 다른 규칙(폰 딴짓, 시간 조작 등)과 더해서 2점 이상이면 주의, 4점 이상이면 경고입니다. 판단은 정해진 규칙이 하고, AI 는 그 결과를 읽어 사장님 보고서를 쓰기만 합니다.
| 경우 | 어떻게 되나 | 대비 |
|---|---|---|
| 화장실, 휴식 | 노랑이 되고 빈 시간이 쌓입니다 | 10분까지는 넘어갑니다 |
| 엎드려 자거나 칸막이에 가려 어깨가 안 보임 | 빈자리로 잘못 볼 수 있습니다 | 카메라를 높은 곳에서 비스듬히 내려다보게 둡니다. 경고가 떠도 사장님이 영상을 보고 판단합니다 |
| 다른 자리로 옮겨 앉음 | 원래 좌석은 노랑, 새 좌석은 빨강이 됩니다 | 알람에 마지막으로 쓴 손님이 나오므로 누구인지 좁혀집니다. 새 좌석 QR 을 찍으면 풀립니다 |
| 통로를 지나가는 사람 | 좌석 한도 밖이면 붙지 않고, 붙더라도 두 번 이어져야 알람입니다 | - |
| 카메라 폰이 꺼짐 | 그 카메라 좌석은 판정을 멈추고 "카메라 꺼짐" 알림이 옵니다 | - |
자동으로 내보내거나 벌을 주지 않습니다. 알람과 표시까지만 하고, 조치는 사장님이 정합니다. 10분·30분 같은 값은 임시값이라 실제 매장에서 써 보고 맞추겠습니다. 실제 매장 카메라로는 아직 확인하지 못했습니다.