cowork 글로벌 협업 서비스 — 체크포인트 (중학생도 이해하는 버전)
개요
cowork(cowork.crowny.org, 포트 9720)를 전 세계 누구나 쉽게 쓰는 협업 서비스로 만들기 위한 점검표다. 2026-06-27 감사 3건(UX / 백엔드 / 한선씨·셀코어)을 바탕으로, "무엇을 고쳐야 하는지"를 어려운 말 없이 정리했다. 총 44개 항목, P0(지금 당장)부터 P2(나중에) 순서로 정렬했다.
- 됨 = 이미 잘 작동함
- 부분 = 일부만 되고 빠진 게 있음
- 안됨 = 아직 없음
- P0 = 이게 막히면 외국/윈도우 사용자가 아예 못 씀 (먼저 고쳐라)
- P1 = 있으면 크게 좋아지는 핵심 기능
- P2 = 더 멋지게 다듬는 단계
체크포인트 표
| # | 영역 | 무엇을 (쉬운 말) | 현재상태 | 우선 | 간단 검증법 |
|---|---|---|---|---|---|
| 1 | 접속 | 윈도우PC에서 설치 명령이 http://로 안 깨지게 (보안 차단 회피) | 안됨 | P0 | portal.html 263~266줄 명령이 https://cowork.crowny.org/setup으로 나오는지 본다 |
| 2 | 런처·설치 | 내려받는 cowork-cli.sh가 :9720 포트 없이 https://호스트로 접속하게 | 안됨 | P0 | /cli로 받은 스크립트 안에 :9720이 없는지 grep으로 확인 |
| 3 | 접속 | index.html CLI 안내의 cowork.crowny.org:9720 하드코딩 제거 | 안됨 | P0 | index.html 199·202줄이 https://cowork.crowny.org/cli인지 본다 |
| 4 | 디자인·UX | 복사 버튼이 윈도우(HTTP)에서도 동작 (옛 방식 폴백 추가) | 안됨 | P0 | HTTP로 접속해 복사 버튼 누른 뒤 메모장에 붙여넣기 된다 |
| 5 | 로그인 | 일반 사람이 스스로 가입하는 회원가입 만들기 (지금은 관리자만 계정 생성) | 안됨 | P0 | /api/register로 새 계정이 만들어지고 바로 로그인 되는지 |
| 6 | 게시판 | 누구나 글을 읽을 수 있는 공개 게시판 만들기 (지금 게시판 자체가 없음) | 안됨 | P0 | 로그인 안 한 상태에서 게시판 글 목록이 보이는지 |
| 7 | 디자인·UX | 크라우니 표준 색(초콜릿+골드)으로 통일 (지금은 보라색이라 따로 놂) | 안됨 | P0 | portal/index의 색이 kps.crowny.org와 같은 계열인지 눈으로 확인 |
| 8 | 디자인·UX | 글꼴(Pretendard) CDN 연결 — 윈도우에서 글꼴 깨짐 방지 | 안됨 | P0 | HTML <head>에 pretendard CDN <link>가 있는지 |
| 9 | 디자인·UX | 어려운 말 쉬운 말로 바꾸기 (예: "티어드 블록체인 세팅 이관"→"등급별 설정 동기화") | 부분 | P0 | portal.html에 "부트스트랩"·"블록체인 노드" 같은 미설명 용어가 남았는지 |
| 10 | 한선씨·셀코어 | 한선씨 비율 70% 넘기기 (지금 12.5%로 헌법 위반) | 안됨 | P0 | .한선 줄 수 ÷ (한선+JS 줄 수) 가 0.7 이상인지 |
| 11 | 게시판 | 결과물 공유 게시판 (collab.js works를 공개 읽기로 노출) | 부분 | P1 | /api/works 공개 읽기 라우트로 남의 결과물도 보이는지 |
| 12 | 게시판 | 질문·답변(Q&A) 게시판 (support.js에 type=board 추가) | 부분 | P1 | support 스레드에 게시판 글이 보이고 댓글이 달리는지 |
| 13 | 티어권한 | 패키지 다운로드에 등급 차등 넣기 (지금은 로그인만 하면 다 받음) | 부분 | P1 | 게스트(9등급)가 상위 패키지 다운로드 시 막히는지 |
| 14 | 티어권한 | 패키지 목록에 게스트 차단 추가 (/api/packages) | 안됨 | P1 | 게스트 계정으로 /api/packages 호출 시 제한되는지 |
| 15 | 업로드·다운로드 | 브라우저에서 파일 끌어다 올리기(multipart) 지원 | 안됨 | P1 | <input type=file>로 5MB 파일 업로드가 되는지 |
| 16 | 업로드·다운로드 | 50MB 한계 늘리기/안내 (base64라 실제 37MB까지만 됨) | 부분 | P1 | 40MB 파일 업로드 시 친절한 오류 메시지가 뜨는지 |
| 17 | 업로드·다운로드 | 한글 파일명 제대로 받기 (지금 ____.zip로 깨짐) | 안됨 | P1 | 한글 이름 zip 받았을 때 이름이 그대로인지 |
| 18 | 업로드·다운로드 | 다운로드 후 메모리 누수 막기 (revokeObjectURL 호출) | 안됨 | P1 | pull/dlPkg/dlCommit에 revokeObjectURL 있는지 |
| 19 | 로그·보고·공유 | 활동 보고서 만들기 (기간·계정별 집계 API) | 안됨 | P1 | /api/report?from=..&to=..로 집계가 나오는지 |
| 20 | 로그·보고·공유 | 활동 로그 조회에 로그인 검사 넣기 (지금 누구나 봄) | 안됨 | P1 | 로그인 없이 /api/activity 호출 시 401인지 |
| 21 | 한선씨·셀코어 | 셀코어 로직DB 도입 (가져오기 "셀코어") — 지금 0곳 | 안됨 | P1 | .한선 파일에 셀코어 import가 들어갔는지 |
| 22 | 한선씨·셀코어 | 4상 결정 7곳을 셀코어 룰로 전환 (지금 전부 if-else) | 안됨 | P1 | 규칙저장소.dat에 cowork 룰이 누적되는지 |
| 23 | 한선씨·셀코어 | 코워크서버.한선이 주요 라우트 더 많이 덮게 (지금 4/40개) | 부분 | P1 | 인증·번들·다운로드 라우트가 .한선에 생겼는지 |
| 24 | 한선씨·셀코어 | 코워크서버.한선 57줄 설정() 오용 고치기 (읽기는 키목록[i]) | 안됨 | P1 | 해당 줄이 배열 인덱스 읽기로 바뀌었는지 |
| 25 | 한선씨·셀코어 | JS 3파일에 동반 .한선 만들기 (bundle-build/admin-init/admin-server) | 안됨 | P1 | 번들빌드.한선·관리자초기화.한선·관리자서버.한선 존재 확인 |
| 26 | 디자인·UX | 사이트 첫 화면(히어로) — "여기서 뭘 하는 곳인지" 한눈에 | 안됨 | P1 | 처음 방문자가 5초 안에 용도를 아는지 |
| 27 | 디자인·UX | 밝게/어둡게 테마 토글 버튼 | 안됨 | P1 | 버튼 눌러 라이트/다크 전환되는지 |
| 28 | 문서·도움말 | "처음 시작하기" 가이드 (3단계 그림 설명) | 부분 | P1 | /guide에 그림 포함 단계별 안내가 있는지 |
| 29 | 국제화 | 영어 번역 추가 (글로벌 사용자용) | 안됨 | P1 | 언어 토글로 영어 화면이 뜨는지 |
| 30 | 로그인 | 비밀번호 해시(SHA256) 양쪽(JS·한선씨) 동작 일치 확인 | 부분 | P1 | 같은 비번이 auth-tier.js와 인증.한선에서 같은 해시인지 |
| 31 | 접속 | 게이트웨이 통해 HTTPS로만 외부 접속되게 정리 (직접 포트 X) | 부분 | P1 | 외부에서 :9720 직접 접속은 막히고 도메인은 되는지 |
| 32 | 로그·보고·공유 | 알림 구독(webhook) — 새 글·새 업로드 시 외부 통지 | 안됨 | P2 | 업로드 시 등록된 webhook으로 신호가 가는지 |
| 33 | 게시판 | 게시판 글 검색·태그·정렬 | 안됨 | P2 | 키워드로 게시글 검색이 되는지 |
| 34 | 게시판 | 좋아요·댓글 알림 등 상호작용 | 안됨 | P2 | 댓글 달면 작성자에게 알림 가는지 |
| 35 | 로그인 | 이메일 인증·비밀번호 찾기 | 안됨 | P2 | 가입 시 이메일 확인 절차가 있는지 |
| 36 | 티어권한 | 등급별로 보이는 메뉴/기능 다르게 (UI 차등) | 부분 | P2 | 게스트 화면에 관리자 메뉴가 안 보이는지 |
| 37 | 업로드·다운로드 | 큰 파일 분할 업로드(이어받기) | 안됨 | P2 | 100MB 파일을 나눠 올릴 수 있는지 |
| 38 | 로그·보고·공유 | 보고서 PDF/CSV 내보내기 | 안됨 | P2 | 활동 보고서를 파일로 저장하는지 |
| 39 | 런처·설치 | 윈도우 원클릭 설치 프로그램(.exe/.msi) | 안됨 | P2 | 더블클릭으로 설치 완료되는지 |
| 40 | 런처·설치 | 맥/리눅스 설치 스크립트도 같은 방식으로 정리 | 부분 | P2 | 세 OS 모두 한 줄 명령으로 설치되는지 |
| 41 | 문서·도움말 | 자주 묻는 질문(FAQ) 페이지 | 안됨 | P2 | /faq에 질문·답이 정리됐는지 |
| 42 | 국제화 | 날짜·숫자·통화 현지 형식 | 안됨 | P2 | 영어 화면에서 날짜가 현지식으로 보이는지 |
| 43 | 디자인·UX | 스크롤 등장 애니메이션(reveal) 다듬기 | 안됨 | P2 | 스크롤 시 카드가 부드럽게 나타나는지 |
| 44 | 문서·도움말 | 용어 사전(쉬운 말 풀이) 페이지 | 안됨 | P2 | "맘", "티어" 같은 단어 뜻이 정리됐는지 |
관련 파일 경로
- 프론트엔드:
/Users/ef/crowny-cowork/public/portal.html,/Users/ef/crowny-cowork/public/index.html - 백엔드:
/Users/ef/crowny-cowork/server.js,support.js,collab.js,auth-tier.js - 한선씨 동반:
/Users/ef/crowny-cowork/코워크서버.한선외 9개.한선 - 감사 원문:
/Users/ef/CrownyDoc/projects/2026-06-27-cowork-감사-UX.md,
2026-06-27-cowork-감사-백엔드.md, 2026-06-27-cowork-감사-한선씨셀코어.md잔여 이슈 / 다음 순서
P0 10개(접속·설치 깨짐 4건, 자유가입·공개게시판 2건, 디자인 통일 3건, 한선씨 비율 1건)를 먼저 해결하면 외국·윈도우 사용자가 "들어와서 가입하고 둘러보는" 기본 경험이 완성된다. 그 다음 P1(게시판 기능화·티어 차등·업로드 개선·셀코어 도입)으로 협업 본기능을 채운다.