SSCC 시스템
사용 설명서

이 문서 자체의 변경 기록

어디로 가야 하는지부터 — v0.2.0에서 앱이 셋으로 나뉘었습니다

v0.1까지 SSCC 시스템은 운영관리 어드민 하나였습니다. v0.2.0에서 앱이 셋으로 갈라졌습니다. 나눈 기준은 로그인입니다 — 로그인 없이 누구나 봐야 하는 화면과, 회원만 쓰는 화면과, 운영진만 쓰는 화면이 서로 다른 주소에 있습니다.

내 역할이면 어디를 읽어야 하나

/login

운영관리시스템은 별도의 아이디·비밀번호를 만들지 않습니다. 소속 Google 계정으로 로그인하면 그 계정이 그대로 회원 식별에 쓰입니다. 처음 로그인하는 사람은 자동으로 임시회원 등급으로 시작하고, 이후 운영진이 등급을 조정합니다.

로그인하는 순서

1. 1
   Google로 계속하기 버튼을 누른다Google 로그인 창으로 이동합니다.
2. 2
   소속 Google 계정을 선택한다개인 계정이 아니라 동아리 활동에 쓰는 계정으로 로그인해야 회원 정보와 연결됩니다.
3. 3
   권한 동의 후 자동으로 운영관리시스템으로 돌아온다처음 로그인이면 임시회원으로 등록되고, 이미 등록된 사람이면 바로 대시보드로 이동합니다.

/dashboard 로그인 후 처음 보는 화면

대시보드는 세 가지만 보여줍니다 — 내가 승인해야 할 것, 곧 마감인 것, 내가 지금 하고 있는 것. 매일 아침 이 화면 하나로 오늘 무엇을 해야 하는지 확인하도록 설계돼 있습니다.

/operations /operations/new

업무(work)·하위 업무(sub_work)·회의(mtg)는 모두 하나의 운영(oper)이라는 뿌리에서 갈라져 나옵니다. 운영 통합 화면은 이 세 가지를 한 화면에서 조망하고, 등록 화면은 그중 무엇을 새로 만들지에 따라 입력창 구성이 달라집니다.

운영 통합 — 전체를 한눈에

새로 등록하기

+ 등록 버튼을 누르면 무엇을 만들지부터 고릅니다 — 업무는 처음부터 새로 만드는 큰 단위이고, 회의도 마찬가지입니다. 하위 업무는 반드시 어떤 업무에 딸려야 하므로, 업무 상세 화면의 + 하위 업무 버튼으로만 만들 수 있습니다 — 등록 화면에 하위 업무를 독립적으로 고르는 선택지가 없는 것은 의도된 제약입니다.

/operations/works /operations/works/{id} /operations/works/{id}/edit

업무는 하위 업무를 담는 큰 그릇입니다 — "2026 동아리 박람회" 같은 행사 하나, 또는 "회계 정산" 같은 상시 운영 하나가 업무 한 건입니다. 목록에서 카드 형태로 전체를 훑어보고, 카드를 누르면 그 업무에 속한 하위 업무들을 확인합니다.

업무 목록

업무 상세 — 하위 업무 진행 현황

업무 수정에서 바꿀 수 있는 것

/operations/sub-works /operations/sub-works/{id} /operations/sub-works/{id}/edit

실제로 손을 움직여 처리하는 최소 단위입니다. 기획 → 진행 → 검토 → 완료 네 단계를 순서대로 밟으며, 유형에 따라 완료 전에 승인이 필요할 수 있습니다.

목록에서 상태 훑어보기

상세 — 지금 할 수 있는 전이 하나만 보인다

하위 업무 상세 화면의 버튼은 언제나 지금 단계에서 다음으로 넘어가는 동작 하나만 보여줍니다. 두 단계를 한 번에 건너뛰는 버튼은 없습니다 — 중간에 요청이 끊기면 누른 적 없는 상태로 남는 것을 막기 위한 설계입니다.

단계별 버튼

하위 업무 수정에서 바꿀 수 없는 것

담당자·하위 업무 유형·상위 업무는 등록 시점에 고정됩니다. 유형이 바뀌면 승인 필요 여부·승인자·정족수·완료 점검 항목이 통째로 달라지는데, 이미 등록 시점에 복사된 값이라 되돌릴 방법이 없기 때문입니다. 유형을 잘못 골랐다면 해당 하위 업무를 마감하고 새로 등록해야 합니다.

/approvals

승인이 필요한 하위 업무를 대기 · 승인 · 반려 탭으로 나눠 모아 봅니다. 정족수가 필요한 유형은 카드 안에서 바로 찬반 투표를 던질 수 있습니다 — 투표와 최종 완료 승인은 별개입니다.

/members /members/{id} /members/{id}/edit

전체 회원을 이름·학번으로 검색하고, 등급·상태로 걸러 봅니다. 새 회원을 운영진이 직접 만드는 기능은 없습니다 — 신규 회원은 본인이 Google 계정으로 로그인해 가입하거나, 과거 명단을 CSV로 이관해 들어옵니다.

회원 상세

동아리 가입 시기 · 기수 자동 채움 v0.2

회원 등록·편집에 동아리 가입 시기 칸이 있습니다. 가입 연도를 넣으면 기수가 자동으로 채워집니다 — «가입 연도에 맞춰 기수를 채웠습니다. 실제 기수가 다르면 직접 고쳐주세요»가 뜨고, 값은 언제든 손으로 바꿀 수 있습니다.

학번 수정 · 변경 이력 v0.2

/members/{id}/histories v0.2부터 학번을 고칠 수 있고, 바꾼 내역은 변경 이력 화면에 남습니다 — 누가 언제 무엇을 바꿨는지 확인할 수 있습니다.

/members/csv-import

과거 명단(엑셀·구글 시트를 CSV로 내보낸 파일)을 한 번에 등록하는 4단계 마법사입니다. 중복으로 보이는 행은 자동으로 병합하지 않고 건너뜁니다 — 실행 결과는 되돌릴 수 없으므로 3단계 검증에서 반드시 내용을 확인하세요.

1. 1
   양식 CSV를 먼저 내려받아 형식을 맞춘다필수·조건부·선택 컬럼이 표로 안내됩니다.
2. 2
   내 파일의 헤더를 시스템 필드에 연결한다헤더명이 정확히 일치하지 않아도 직접 매핑할 수 있습니다.
3. 3
   오류·중복 행을 확인한다이 행들은 이관되지 않고 건너뜁니다 — 실행 전 사유를 꼭 읽어보세요.
4. 4
   "되돌릴 수 없다는 것을 확인했습니다"에 체크 후 실행한다실행하면 정상 후보만 새 회원으로 등록됩니다.

/members/roles /members/roles/{id}/authorities /members/authorities

"회장", "국장", "박람회 총괄" 같은 역할을 만들고, 역할마다 어떤 권한을 줄지 정하는 화면입니다. 화면에 뜨는 모든 버튼·메뉴는 결국 이 권한 배열로 결정됩니다.

/forms /forms/{id} /forms/{id}/edit

신입회원 모집, 행사 참가 신청 같은 외부 공개 설문을 만듭니다. 여러 페이지로 나눌 수 있고, 선택지에 따라 다음 페이지를 다르게 보여주는 분기도 지원합니다. 작성 중인 내용은 자동으로 저장됩니다.

편집기 — 페이지와 문항 구성

접수 상태 바꾸기

폼 상세 화면 하단에서 접수를 시작하거나 마감할 수 있습니다. 접수를 마감하면 공개 링크에 들어온 응답자는 더 이상 새 응답을 제출할 수 없고, 이미 제출된 응답은 그대로 남습니다.

다중 응답 허용 v0.2

편집기에서 다중 응답 허용을 켜면 «한 사람이 여러 건을 낼 수 있습니다» — 지원서·설문처럼 한 사람이 한 번만 내야 하는 폼은 꺼 둡니다.

템플릿 관리 v0.2

/forms/templates 자주 쓰는 문항 구성을 템플릿으로 저장해 두고, 새 폼을 만들 때 골라 씁니다 (예: «신규 부원 모집 표준 문항»). 어떤 폼에 쓰는 구성인지 설명을 적어 두면 고를 때 도움이 됩니다.

/forms/{id}/responses /forms/{id}/responses/{rid}

제출된 응답을 훑어보고, 필요하면 승인·반려로 상태를 매깁니다.

응답 상세 화면 하단의 이전 · 다음 버튼으로 목록을 다시 열지 않고도 연속으로 검토할 수 있습니다.

/f/{formId} 로그인 없이 접근 가능

운영진이 만든 폼의 공개 링크를 응답자에게 공유하면, 응답자는 이 화면에서 어드민 로그인 없이 작성합니다. 다만 회원 식별이 필요한 폼은 응답자에게도 Google 로그인을 요구할 수 있습니다.

마지막 페이지까지 마치고 제출하면 완료 화면으로 넘어가며, 이후에는 같은 링크로 다시 들어가도 재작성할 수 없습니다(폼이 재제출을 허용하지 않는 한).

admin /events 작성 · 게시 · 보관과 분류 관리

운영진이 여는 행사를 만들고 공개하는 화면입니다. 여기서 게시한 행사가 공개 웹사이트(20절)에 그대로 올라가고, 참가 신청은 폼으로 받습니다. 행사 목록·편집·상태 전이·분류 관리가 모두 이 묶음에 있습니다.

행사를 여는 순서

1. 1
   + 새 행사로 기본 정보를 채운다행사명 · 분류 · 일시 · 장소 · 정원 · 본문. 본문은 마크다운으로 쓰고 이미지도 붙일 수 있습니다.
2. 2
   신청서(폼)를 연결한다참가 신청을 받으려면 폼이 필요합니다. 폼 관리(9절)에서 만든 폼을 고르거나 새로 만듭니다.
3. 3
   게시로 상태를 바꾼다게시한 순간부터 공개 웹사이트 행사 목록에 나타납니다. 작성 중일 때는 외부에 보이지 않습니다.
4. 4
   모집이 끝나면 보관한다보관하면 목록에서 내려가지만 참가자 명단과 신청 기록은 그대로 남습니다.

본문 이미지 붙이기

본문 편집기에 이미지를 올리면 업로드된 뒤 본문에 삽입됩니다. 올린 이미지는 공개 웹사이트의 행사 상세와 공유 카드(카카오톡·슬랙 미리보기)에 함께 쓰입니다.

분류 관리

/events/categories 행사 분류(세미나 · 모집 · 프로젝트 등)를 만들고 관리합니다. 분류는 공개 웹사이트의 필터 칩으로 그대로 쓰이므로, 이름을 바꾸면 방문자가 보는 필터 이름도 함께 바뀝니다.

admin /events/{eventId}/participants

들어온 신청을 확인하고 참가를 확정하는 화면입니다. 신청은 폼 응답으로 들어오므로, 응답 내용(지원 동기 등)을 보고 확정·대기·취소를 정합니다.

신청 내용은 어디서 보나

신청자가 폼에 적은 답(지원 동기 등)은 응답 확인(10절)에서 읽습니다. 참가자 관리 화면은 확정·대기·취소만 다루고, 답 본문은 연결된 폼의 응답 목록에 있습니다.

admin /forms 학술 회차를 시작할 때 가장 먼저 하는 일

시스템 폼이란

보통 폼은 운영진이 필요할 때 만들지만, 시스템이 코드로 찾아 쓰는 폼이 따로 있습니다. 기획안 폼(PROPOSAL)이 그것입니다 — 학술 앱의 «기획안 제출» 메뉴는 이 폼 하나를 가리키고 있어서, 운영진이 그 폼의 접수를 열어야 회원 화면이 열립니다. 폼 목록에서 시스템 배지가 붙은 것이 이런 폼입니다.

기획안 접수를 여는 순서

1. 1
   폼 목록에서 기획안 폼을 찾는다/forms «시스템» 배지가 붙은 폼입니다. 이름은 운영진이 바꿀 수 있으니 배지로 찾으세요.
2. 2
   문항이 회차에 맞는지 확인한다시스템이 쓰는 문항은 지울 수 없지만 문구 수정과 문항 추가는 됩니다. 커리큘럼 문항의 형식 안내는 문항 설명에 이미 들어 있습니다.
3. 3
   접수 기간을 정한다기간을 비워 두면 수동으로 열고 닫습니다. 기간을 넣으면 그 사이에만 자동으로 열립니다.
4. 4
   접수 시작을 누른다이때부터 회원의 학술 앱 «기획안 제출» 화면이 열립니다. 여기까지 해야 기획안이 들어옵니다.
5. 5
   회차가 끝나면 마감시스템 폼은 지울 수 없으므로, 그만 받을 때는 삭제가 아니라 마감을 씁니다. 마감한 뒤에도 다시 접수를 시작할 수 있습니다.

회원 화면에서는 이렇게 보입니다

학술 회차를 여는 전체 순서

기획안 접수는 학술 운영의 출발점입니다. 이 절에서 접수를 연 뒤 아래 순서로 이어집니다.

admin /proposals/review 제출된 기획안을 확인하고 처리합니다

회원이 학술 앱에서 낸 스터디·프로젝트 기획안을 검토하는 화면입니다. 승인이 곧 학술 활동의 개설이라, 학술 묶음의 첫 메뉴에 있습니다 — 여기서 승인한 기획안이 모집 관리로 넘어가고, 그 뒤 회차·출석 승인으로 이어집니다.

세 가지 처리

admin /academic-programs/recruitment 승인된 활동의 모집을 시작하고 신청자를 선발합니다

기획안이 승인되면 활동은 승인 상태로 대기합니다. 이 화면에서 모집을 시작하고, 들어온 신청자 중 함께할 사람을 고릅니다. 왼쪽에서 활동을 고르면 오른쪽에 그 활동의 모집 현황이 나옵니다.

모집을 시작하는 순서

1. 1
   왼쪽 목록에서 활동을 고른다승인·모집 중 활동만 나옵니다. 수료한 활동은 목록에 없습니다.
2. 2
   신청서 문항 편집으로 문항을 채운다기획안 승인이 만들어 준 폼은 문항이 비어 있습니다. 문항이 하나도 없으면 모집을 시작할 수 없습니다.
3. 3
   모집 시작을 누른다활동이 «진행 중»이 되고 신청서가 열립니다. 이때부터 회원이 신청할 수 있습니다.
4. 4
   신청자마다 확정 · 대기 · 미선택을 고르고 선발 저장확정한 사람이 팀원 명단에 들어갑니다. 언제든 다시 고쳐 저장할 수 있습니다.

admin /academic-programs 전체 활동 목록과 활동 상세

학술국장이 전체 스터디·프로젝트를 감독하는 화면입니다. 스터디장이 자기 활동 하나만 보는 학술 앱(22절)과 달리, 여기서는 모든 활동의 진행률과 상태를 한 화면에서 훑습니다.

활동 상세에서 보는 것

활동 카드를 누르면 그 활동의 커리큘럼 대비 진행 · 회차 이력 · 팀원 명단 · 평균 출석률을 봅니다. 회차 기록을 고치지는 않습니다 — 기록은 스터디장이 쓰고, 국장은 회차·출석 승인에서 처리합니다.

admin /academic-programs/reviews/sessions

스터디장들이 올린 회차 기록을 승인하는 화면입니다. 여러 활동의 제출을 한 화면에 모아 보여주므로, 활동을 하나씩 들어가지 않고 밀린 것부터 처리할 수 있습니다.

admin /academic-programs/dashboard /academic-programs/sessions /academic-programs/attendance

학술국장이 전체를 훑는 화면 셋입니다. 대시보드는 지금 무엇이 밀렸는지, 회차 이력은 활동을 가로질러 회차가 어떻게 진행됐는지, 출석 통계는 누가 얼마나 나왔는지를 봅니다.

출석 통계

/academic-programs/attendance 활동별·팀원별 출석률을 봅니다. 출석률 70% 미만은 눈에 띄게 표시됩니다 — 수료 기준(2/3)에서 온 값이라, 이 아래로 내려간 팀원은 수료가 어려워집니다.

www / /events/{eventId} 로그인 없이 열립니다

공개 웹사이트의 본체입니다. 로그인하지 않아도 누구나 행사 목록과 상세를 볼 수 있습니다 — 검색과 공유에 걸려야 하는 화면이기 때문입니다. 링크를 카카오톡이나 슬랙에 붙이면 제목·설명·대표 이미지가 담긴 카드로 펼쳐집니다.

배지 두 줄의 뜻

카드와 상세에는 배지가 최대 둘 붙습니다. 앞은 모집 상태(신청을 받는가), 뒤는 행사 진행(행사 자체가 언제인가)입니다. 둘은 따로 움직입니다 — 행사가 아직 «예정»인데 모집은 이미 «마감»일 수 있습니다.

상세 화면 — 본문과 신청 패널

www /events/{eventId}/apply /my-applications 로그인 필요

신청은 회원만 할 수 있지만, 아직 회원이 아니어도 이 화면을 떠나지 않고 가입까지 마칠 수 있습니다. 가입이 끝나면 화면이 바뀌지 않고 같은 자리에서 신청서가 이어 그려집니다 — 어드민으로 튕겨 나갔다 돌아오지 않아도 됩니다.

신청하는 순서

1. 1
   행사 상세에서 신청하기로그인하지 않았다면 먼저 Google 로그인을 거칩니다.
2. 2
   회원이 아니면 간편 가입을 먼저 마친다이미 회원이면 이 단계는 나오지 않고 곧바로 신청서가 열립니다.
3. 3
   신청서를 작성한다쓰는 도중 자동으로 임시저장되므로 창을 닫았다 다시 와도 이어서 쓸 수 있습니다.
4. 4
   제출하면 완료 화면이 나온다이후 운영진이 확정·대기를 정하고, 결과는 «내 신청»에서 확인합니다.

내 신청

lms / /studio 전 화면 로그인 필수

학술 앱은 들어온 사람이 누구냐에 따라 첫 화면이 갈립니다. 스터디장·프로젝트장이면 바로 대시보드로 가고, 아직 활동을 맡지 않은 회원이면 기획안 카드 두 장이 나옵니다. 상단 바 메뉴도 함께 갈립니다.

lms /studio/record /studio/roster

스터디장이 매 회차 끝나고 하는 일입니다. 진행 내용을 적고 누가 나왔는지 체크해 제출하면, 학술국장이 회차·출석 승인에서 확인합니다.

회차 상태 넷

출석부 — 회차별 참석 현황

/studio/roster 가로가 회차, 세로가 팀원인 표입니다. 이미 제출한 회차의 출석을 칸을 눌러 고칠 수 있습니다 — 회차 기록을 다시 내지 않고 출석만 정정하는 자리입니다.

lms /studio/programs /studio/members

내 활동은 내가 맡은 활동의 커리큘럼·회차 이력·출석 통계를 모아 봅니다. 팀원 관리는 확정된 팀원 명단을 확인하는 자리입니다.

lms /proposals/new /my/applications 일반 회원의 화면

스터디나 프로젝트를 열고 싶은 회원이 기획안을 내는 화면입니다. 승인되면 그 활동의 스터디장이 되고, 학술 앱의 메뉴가 늘어납니다.

제출하고 결과를 보는 흐름

1. 1
   기획안 제출에서 양식을 채운다활동명 · 유형(스터디/프로젝트) · 모집 정원 · 운영 계획 · 커리큘럼을 적습니다.
2. 2
   기획안 제출 현황에서 처리 상태를 본다제출 → 승인 · 수정요청 · 반려. 학술국장이 처리하면 여기에 반영됩니다.
3. 3
   수정요청을 받으면 고쳐서 다시 낸다요청 사유가 화면 위에 먼저 나오고, 지난번에 쓴 답이 그대로 채워진 상태에서 시작합니다.
4. 4
   승인되면 스터디장이 된다다음에 학술 앱에 들어오면 첫 화면이 대시보드로 바뀝니다.

/my

본인이 직접 고칠 수 있는 정보와, 운영진만 바꿀 수 있는 정보가 한 화면에서 분리돼 보입니다.

학번·이메일·기수·등급·상태·역할은 본인이 직접 바꿀 수 없습니다. 잘못 등록됐다면 운영진(회원 관리 권한자)에게 요청하세요.

화면 전반에서 반복되는 시각 표기

상태 배지 톤

마감 표기

목록 스크롤 — "더 보기"

목록은 페이지 번호가 아니라 더 보기 버튼으로 다음 묶음을 이어 받습니다. 전체 개수는 알 수 있지만 "3페이지로 바로 이동" 같은 기능은 없습니다.

버튼이 안 눌리거나 메뉴가 안 보일 때