SSCC · 숭실컴퓨팅클럽
SSCC 시스템
사용 설명서
업무 등록과 승인, 회원·폼·행사 관리, 스터디 운영과 기획안 제출까지 SSCC의 세 앱에서 하는 일을 역할별로 안내합니다. 화면 이미지는 실제 소스의 배치를 그대로 옮긴 참고용 스케치이며, 세부 문구는 실제 화면과 다를 수 있습니다.
개정 이력
이 문서 자체의 변경 기록
| 일자 | 버전 | 내용 |
|---|---|---|
| 2026-09-18 | v2.4 |
AI 클라이언트 연결 절 신설 — 기능 자체는
v0.2.9에 들어왔고(서버 /mcp · 도구 9종 ·
외부 앱 접근 승인 화면) v0.2.10부터 실서비스에서
붙을 수 있게 됐는데 설명이 어디에도 없어 이제 적었습니다. Claude · Codex ·
Antigravity 클라이언트별 연결 방법과, 권한 · 기록 · 개인정보에 대해 알아 둘 것입니다.
27절의 배지를 v0.2.8 → v0.2.9로 바로잡았습니다 — 그 화면이 나간 것은
ssccops-web v0.2.9입니다.
|
| 2026-09-18 | v2.3 | 제품 v0.2.10 기준으로 갱신. 공개 폼 링크의 공유 카드 그림을 공개 폼(11)에 더했습니다(#510) — 메신저에 붙이면 제목·안내·동아리 마크가 담긴 그림으로 보이고, 접수 상태와 마감일은 일부러 넣지 않습니다(한 번 만든 카드는 메신저가 다시 그리지 않아 마감 뒤에도 «모집 중»이 남기 때문입니다). 사이드바 문서 버전이 v2.0에 멈춰 있던 것도 바로잡았습니다. |
| 2026-09-18 | v2.2 | 제품 v0.2.9 기준으로 갱신(v0.2.3~v0.2.9 일곱 번의 배포를 한 번에 반영). 새 절 셋 — 규정 도우미(28) · RAG 설정(29) · 외부 앱 접근 승인(27). 고친 곳: 담당자를 바꿀 수 없다던 설명을 업무·하위 업무 양쪽에서 담당자 넘기기로 바로잡았고(#435), 목록이 전부 «더 보기»라던 범례에 회원 목록의 이전·다음 방식을 더했습니다(#374). 더한 것: 회원 일괄 변경·삭제 구역(#382·#411) · 지운 폼과 지운 행사 되살리기(#359·#391) · 폼·행사 목록의 기본 필터 변경(#369·#370) · 행사 본문 미리보기·정사각형 대표 이미지·폼 연결 변경 경고(#376·#378) · 참가자 확정·대기 규칙(#423) · 신청 버튼의 제출 상태 표시와 제출 내용 보기(#384·#358) · 공개 폼 주소 키(#508) · 같은 자리에서 끝내는 가입·기존 회원 연결(#451·#364·#453) · 권한 오류 문구 형식 통일(#490~#507) · 실서비스와 테스트 구분 표식(#413·#449). |
| 2026-09-09 | v2.1 | 제품 v0.2.2 기준으로 갱신. 사용자 피드백("대시보드의 승인 정체가 무엇이고 기준이 무엇인지 가이드에 설명이 없다")에 따라 상태 변화 기준 절을 새로 넣었습니다 — 정체 배지 둘(요청 전 · 승인 정체)의 판정 기준을 비롯해 마감 · 업무 단계 · 승인 · 폼 · 응답 · 학술 활동 · 회차 · 출석 · 행사 · 참가자의 모든 상태 변화 기준을 정리했습니다. 그 밖에 공유 링크(공유 버튼 절 신설 · 6개 대상) · 완료 점검 항목 편집(04) · 학술 앱 다크 모드와 날짜 표기 통일을 반영했습니다. 근거: ssccops-web v0.2.2 (25 커밋). |
| 2026-09-04 | v2.0 |
제품 v0.2.0 기준으로 전면 개정. 앱이 셋으로 늘어(admin ·
www · lms) 문서 제목을 «SSCC 시스템 사용 설명서»로 바꾸고,
행사(12·13) · 학술(14~18) · 공개 웹사이트(19·20) ·
학술 앱(21~24) 절을 새로 넣었습니다. 화면 스케치는 각 앱 소스의 실제 배치를
옮긴 것입니다. 근거:
ssccops-web v0.2.0
(58 커밋).
|
| 2026-08-19 | v1.1 |
대시보드 목업의 "내 업무 목록" 예시를 서버 판정 수정 결과에 맞게 갱신
(마감 당일 건이 지연 → 마감임박). 근거:
ssccops-server
#121
— 지연 판정 경계를 초 단위(ddln_dt < now)에서 날짜 단위
(ddln_dt < 오늘 0시)로 변경. 웹 코드는 변경되지 않았고
서버가 내려주는 isDelayed 값만 바뀌었다.
|
| 2026-08-19 | v1.0 | 최초 작성 — 전체 도메인(로그인 · 대시보드 · 운영 · 회원 · 역할 · 폼) 통합 가이드 |
세 개의 앱
역할에 맞는 앱 찾기 — v0.2.0부터 세 앱으로 운영합니다
v0.1까지 SSCC 시스템은 운영관리 어드민 하나였습니다. v0.2.0부터 공개 웹사이트, 학술 앱, 운영관리 앱을 따로 운영합니다. 로그인 없이 보는 화면, 회원용 화면, 운영진용 화면의 주소가 각각 다릅니다.
admin운영관리
운영진 · 국장 이상 — 전 화면 로그인 필수
- 업무 · 하위 업무 · 승인
- 회원 명부 · 역할 · 권한
- 폼 제작 · 응답 검토
- 행사 관리 · 참가자 심사
- 학술 감독 · 기획안 검토
www공개 웹사이트
누구나 — 목록·상세는 로그인 없이 열립니다
- 동아리 행사 목록 · 상세
- 참가 신청 (회원만)
- 내 신청 내역
- 신청 화면 안에서 가입까지
lms학술
스터디장 · 일반 회원 — 전 화면 로그인 필수
- 스터디장 대시보드
- 회차 기록 · 출석부
- 내 활동 · 팀원 관리
- 기획안 제출 · 재제출
계정은 하나입니다. 세 앱 모두 같은 Google 계정으로 로그인하고 같은 회원으로 식별됩니다. 앱마다 따로 가입할 필요가 없습니다.
내 역할이면 어디를 읽어야 하나
| 나는 | 쓰는 앱 | 읽을 절 |
|---|---|---|
| 운영진 | admin | 01~11 (업무 · 회원 · 폼) + 12·13 (행사) + 14 (기획안 접수) |
| 학술국장 | admin | 14~19 — 기획안 접수를 여는 것부터 회차 승인까지 |
| 스터디장 · 프로젝트장 | lms | 22~24 — 대시보드 · 회차 기록 · 출석부 · 팀원 |
| 일반 회원 | lms www | 25 (기획안 제출) · 20·21 (행사 신청) |
| 아직 회원이 아닌 사람 | www | 20 — 행사 목록은 로그인 없이 볼 수 있고, 신청하려 할 때 가입을 함께 안내합니다 |
학술국장이면서 스터디장이기도 하다면 두 앱을 사용합니다. 전체 활동을 감독할 때는 운영관리 앱을, 본인 스터디를 운영할 때는 학술 앱을 이용하세요.
로그인
/login
운영관리시스템은 별도의 아이디·비밀번호를 만들지 않습니다. 소속 Google 계정으로 로그인하면 그 계정이 그대로 회원 식별에 쓰입니다. 처음 로그인하는 사람은 자동으로 임시회원 등급으로 시작하고, 이후 운영진이 등급을 조정합니다.
운영관리시스템
Google 계정으로 로그인합니다. 로그인한 계정은
등록된 회원 정보와 연결됩니다.
처음 가입하면 임시회원 등급으로 바로 시작할 수 있습니다. 졸업생도 동일하게 가입할 수 있습니다.
로그인 화면 — /login
로그인하는 순서
- 1Google로 계속하기 버튼을 누른다Google 로그인 창으로 이동합니다.
- 2소속 Google 계정을 선택한다개인 계정이 아니라 동아리 활동에 쓰는 계정으로 로그인해야 회원 정보와 연결됩니다.
- 3권한 동의 후 자동으로 운영관리시스템으로 돌아온다처음 로그인이면 임시회원으로 등록되고, 이미 등록된 사람이면 바로 대시보드로 이동합니다.
로그인이 계속 풀린다면 다시 로그인해보세요. 같은 문제가 반복되면 운영진에게 등급·권한 확인을 요청하세요.
지금 어느 쪽에 들어와 있나 — 실서비스와 테스트 v0.2.6
같은 화면을 실서비스와 테스트(dev)에서 각각 운영합니다. 주소를 잘못 눌러 테스트 쪽에서 작업하면 실제 운영 자료에는 아무것도 남지 않으므로, 헷갈릴 때는 아래 표식을 보세요.
| 볼 곳 | 실서비스 / 테스트 |
|---|---|
| 브라우저 탭 제목 | SSCC 운영관리 / 앞에 [DEV]가 붙어 [DEV] SSCC 운영관리 |
| 탭 아이콘 · 화면 속 마크 | 앱 색 그대로 / 오른쪽 아래 모서리에 주황색 D 표식이 붙습니다 |
세 앱은 아이콘 색도 다릅니다. 운영관리(admin)는 보라·빨강·주황 그라데이션, 공개 웹사이트(www)는 진회색, 학술 앱(lms)은 남색·청록입니다. 탭을 여럿 띄워 두고 오갈 때 이 색으로 구분하면 빠릅니다.
운영 대시보드
/dashboard 로그인 후 처음 보는 화면
대시보드에는 내가 승인할 업무, 곧 마감되는 업무, 내가 담당한 업무가 표시됩니다. 여기서 오늘 처리할 일을 확인할 수 있습니다.
운영 대시보드 — /dashboard
| 영역 | 보여주는 것 |
|---|---|
| 승인 대기 목록 | 지금 나에게 승인 요청이 와 있는 하위 업무 미리보기. 행을 누르면 승인함으로 이동합니다. 이 카드는 WORK_MANAGE 권한이 있어야 보입니다. |
| 다가오는 마감 | 마감이 임박한 순서대로 나열됩니다. 배지는 D-DAY·D-1 식으로 남은 일수를 보여주며, 이미 지난 것은 빨간 테두리로 구분됩니다. |
| 내 업무 목록 | 담당자가 나인 하위 업무 전체. 상단 칩으로 전체·마감임박·지연만 골라볼 수 있습니다. |
배지의 뜻 — 지연 · 마감임박 · 승인 정체 v0.2.2
대시보드의 각 행에는 마감 상태와 승인 상태를 나타내는 배지가 표시됩니다. 마감임박·지연은 날짜를, 요청 전·승인 정체는 승인 절차를 나타냅니다.
| 배지 | 붙는 기준 | 다음에 누가 |
|---|---|---|
| 마감임박 | 마감까지 3일 이내(오늘 포함) · 미완료 | 담당자가 마무리합니다. |
| 지연 | 마감일이 이미 지남 · 미완료 | 담당자가 마무리합니다. |
| 요청 전 | 완료 점검을 전부 체크했지만 완료 승인 요청을 아직 누르지 않음 | 담당자가 완료 승인 요청을 누릅니다. |
| 승인 정체 | 완료 승인 요청 후 3일이 지나도록 승인·반려되지 않음 | 승인자가 승인 또는 반려를 누릅니다. |
승인 대기 목록에는 「승인 정체」만 표시됩니다. 「요청 전」 상태는 아직 승인 요청을 하지 않았으므로 이 목록에 나오지 않습니다. 각 배지의 자세한 기준과 나머지 모든 상태 변화 규칙은 상태 변화 기준에 모여 있습니다.
업무를 새로 만들 권한이 있으면 화면 오른쪽 위 + 등록 버튼이 활성 상태로 보입니다. 권한이 없으면 버튼은 그대로 있지만 눌러도 반응하지 않고, 위에 마우스를 올리면 이유가 말풍선으로 뜹니다.
운영 통합 · 등록
/operations /operations/new
업무(work)·하위 업무(sub_work)·회의(mtg)는 공통 운영 정보(oper)를 사용합니다. 운영 통합 화면에서 세 유형을 함께 확인할 수 있으며, 등록할 유형에 따라 입력 항목이 달라집니다.
운영 통합 — 전체 현황
운영 통합 — /operations
새로 등록하기
+ 등록 버튼을 누르면 무엇을 만들지부터 고릅니다 — 업무는 처음부터 새로 만드는 큰 단위이고, 회의도 마찬가지입니다. 하위 업무는 반드시 어떤 업무에 딸려야 하므로, 업무 상세 화면의 + 하위 업무 버튼으로만 만들 수 있습니다. 통합 등록 화면에서는 하위 업무를 선택할 수 없습니다.
하위 업무 등록 — 업무 상세의 [+ 하위 업무]에서만 진입
하위 업무 유형을 고르면 아래에 규칙 요약이 뜹니다. 승인이 필요한지, 누가 승인하는지, 완료 전 체크해야 할 항목이 몇 개인지는 이 시점에 유형에서 그대로 복사됩니다 — 등록 후에는 유형을 바꿀 수 없으니 신중하게 고르세요.
업무
/operations/works /operations/works/{id} /operations/works/{id}/edit
업무는 여러 하위 업무를 묶는 상위 단위입니다. "2026 동아리 박람회" 같은 행사나 "회계 정산" 같은 상시 운영을 업무 한 건으로 등록합니다. 카드를 누르면 해당 업무의 하위 업무를 확인할 수 있습니다.
업무 목록
업무 목록 — /operations/works
업무 상세 — 하위 업무 진행 현황
- 유형
- 행사
- 담당자
- 이지원
- 기간
- 08.10 ~ 08.22
- 업무상태
- 진행
- 진행률
- 64%
업무 상세 — /operations/works/{id}
업무 수정에서 바꿀 수 있는 것
| 항목 | 비고 |
|---|---|
| 운영 제목 · 우선순위 · 기간 | 자유롭게 수정 |
| 업무 유형 · 총평 | 자유롭게 수정 |
| 담당자 v0.2.8 | 이제 바꿀 수 있습니다. 목록에서 골라 저장하면 그 회원이 담당자가 됩니다 — 아래 «담당자 넘기기» 참고 |
담당자 넘기기 v0.2.8
예전에는 등록한 사람이 곧 담당자로 고정돼 바꿀 방법이 없었지만, 이제 업무 수정·하위 업무 수정 화면에서 담당자를 다른 회원에게 넘길 수 있습니다. 검색창이 아니라 펼쳐 고르는 목록이고, 이름 옆에 기수와 역할이 함께 적혀 있어 동명이인을 가릅니다.
담당자 선택 — 업무·하위 업무 수정 화면
| 목록 아래 안내 | 뜻 |
|---|---|
| 비우면 현재 담당자 그대로입니다 | 새 담당자를 선택하지 않았습니다. 저장해도 담당자는 바뀌지 않습니다. |
| 선택한 회원이 담당자로 저장됩니다 | 다른 사람을 골랐습니다. 저장하면 그 회원이 담당자가 됩니다. |
| 현재 담당자는 이제 지정할 수 없는 회원입니다 — 다른 회원으로 바꿔주세요 | 지금 담당자가 탈퇴·제명 등으로 후보에서 빠졌습니다. 목록 맨 위에 현재: 이름으로 남아 누구였는지는 알 수 있지만, 다른 회원으로 바꿔야 저장됩니다. |
담당자로 지정할 수 있는 범위가 다릅니다. 업무는 업무 관리 권한이 있는 사람(국장 이상)만 담당자로 지정할 수 있습니다. 하위 업무는 활동 중인 국원도 담당자로 지정할 수 있습니다.
수정 화면은 선택 입력란도 비워 두면 지워진 것으로 저장됩니다. 부분 수정이 아니라 전체 교체이므로, 저장 전 화면에 채워진 값이 맞는지 한 번 더 확인하세요.
하위 업무
/operations/sub-works /operations/sub-works/{id} /operations/sub-works/{id}/edit
하위 업무는 담당자가 직접 처리하는 업무 단위입니다. 기획 → 진행 → 검토 → 완료 순서로 진행하며, 유형에 따라 완료 전에 승인이 필요합니다.
목록에서 상태 훑어보기
하위 업무 목록 — /operations/sub-works
상세 — 다음 단계 버튼만 표시
하위 업무 상세에는 현재 단계에서 할 수 있는 다음 동작만 표시됩니다. 두 단계를 한 번에 건너뛸 수는 없습니다.
- 유형
- 예산지출
- 마감_일시
- 08.18 D-DAY
- 업무_상태
- 검토
- 승인_상태
- 대기
하위 업무 상세 — /operations/sub-works/{id} (검토 단계 · 정족수 대기 예시)
단계별 버튼
| 현재 단계 | 보이는 버튼 | 다음 단계 |
|---|---|---|
| 기획 | 착수 | 진행 |
| 진행 | 완료 승인 요청 | 검토 |
| 검토 | 완료 승인 / 반려 | 완료 / 진행(반려 시) |
승인 버튼과 완료 점검은 서로 다른 조건입니다. 승인 버튼이 보이는 것은 "권한이 있다"는 뜻일 뿐이고, 실제로 눌러 완료 처리하려면 오른쪽 완료 점검 목록이 전부 체크돼 있어야 합니다(정족수가 있는 유형은 정족수도 함께 채워야 합니다). 체크가 덜 됐는데 버튼이 잠겨 있다면 권한 문제가 아니라 점검 미완료입니다.
완료 점검 항목 편집 v0.2.2
완료 점검 목록은 유형에 따라 등록 시점에 자동으로 만들어지지만, 이제 그 자리에서 항목을 더하고 문구를 고치고 지울 수 있습니다. 목록 오른쪽 위 항목 편집 버튼을 누르면 편집 모드가 열립니다.
| 잠겨 있다면 | 이유 | 푸는 방법 |
|---|---|---|
| 항목 편집 버튼이 잠김 | 권한이 없습니다 | 담당자 본인이거나 업무 관리(WORK_MANAGE) 권한이 있어야 합니다. |
| 항목 편집 버튼이 잠김 | 지금 단계에서는 항목을 바꿀 수 없습니다 | 상태를 되돌릴 수 있는 사람이 이전 단계로 돌려야 합니다. |
| 특정 항목만 삭제 버튼이 없음 | 이미 체크된 항목입니다 | 체크를 해제하면 삭제 버튼이 나타납니다 — 본인이 바로 풀 수 있습니다. |
체크된 항목에는 삭제 버튼이 표시되지 않습니다. 삭제하려면 먼저 체크를 해제하세요. 버튼이 표시되지 않는 이유는 목록 아래에서 확인할 수 있습니다.
하위 업무 수정에서 바꿀 수 없는 것
하위 업무 유형과 상위 업무는 등록 시점에 고정됩니다. 유형에는 승인 필요 여부·승인자·정족수·완료 점검 항목이 연결돼 있어 나중에 바꿀 수 없습니다. 유형을 잘못 골랐다면 해당 하위 업무를 마감하고 새로 등록해야 합니다.
담당자는 v0.2.8부터 바꿀 수 있습니다 — 하위 업무 수정 화면에서 다른 회원을 고르면 됩니다. 업무와 달리 활동 중인 회원이면 국원도 후보에 오릅니다 (03 업무의 «담당자 넘기기» 참고).
승인함
/approvals
승인이 필요한 하위 업무를 대기 · 승인 · 반려 탭으로 나눠 모아 봅니다. 정족수가 필요한 유형은 카드 안에서 바로 찬반 투표를 할 수 있습니다. 투표와 최종 완료 승인은 별개입니다.
승인함 — /approvals (대기 탭)
대시보드의 승인 대기 목록에서 행을 누르면 이 화면으로 넘어오면서 해당 카드가 파란 테두리로 강조되고 자동으로 스크롤됩니다. 카드를 못 찾겠으면 대시보드를 거쳐 들어오는 것이 가장 빠릅니다.
회원 명부 · 상세
/members /members/{id} /members/{id}/edit
전체 회원을 이름·학번으로 검색하고, 등급·상태로 걸러 봅니다. 운영진이 새 회원을 직접 등록할 수는 없습니다. 본인이 Google 계정으로 가입하거나, 과거 명단을 CSV로 이관해야 합니다.
회원 명부 — /members
회원 상세
- 학번
- 20231234
- 기수
- 15기
- 학과
- 컴퓨터학부
- 학년
- 3학년
회원 상세 — /members/{id}
| 화면 | 바꿀 수 있는 것 |
|---|---|
| 정보 수정 | 회원명 · 학번 · 기수 · 학과 · 학년 · 전화번호 · 이메일 · 동아리 가입 시기. v0.2부터 학번도 고칠 수 있습니다 — 바꾼 내역은 변경 이력에 남습니다. |
| 등급 · 상태 변경 | 상세 화면의 별도 버튼으로만 — 정보 수정 화면에 섞여 있지 않습니다. |
| 역할 부여 · 종료 | 역할 권한이 있어야 보입니다. |
동아리 가입 시기 · 기수 자동 채움 v0.2
회원 등록·편집에 동아리 가입 시기 칸이 있습니다. 가입 연도를 넣으면 기수가 자동으로 채워집니다 — «가입 연도에 맞춰 기수를 채웠습니다. 실제 기수가 다르면 직접 고쳐주세요»가 뜨고, 값은 언제든 손으로 바꿀 수 있습니다.
이미 배정된 기수는 자동으로 바뀌지 않습니다. 자동 채움은 비어 있을 때만 동작합니다. 자동으로 못 채우면 «기수를 직접 입력해주세요»가 뜨니 그때는 손으로 넣으면 됩니다.
학번 수정 · 변경 이력 v0.2
/members/{id}/histories v0.2부터 학번을 고칠 수 있고, 바꾼 내역은 변경 이력 화면에 남습니다 — 누가 언제 무엇을 바꿨는지 확인할 수 있습니다.
아직 계정을 연결하지 않은 회원의 학번을 바꿀 때는 주의하세요. 계정 연결은 학번 · 회원명 · 연락처가 모두 맞아야 되므로, 학번을 바꾸면 예전 학번으로는 연결할 수 없습니다. 화면도 같은 내용을 미리 안내합니다.
여러 명의 등급·상태를 한 번에 v0.2.4
개강총회 승급처럼 여러 명을 같은 값으로 바꿀 때 씁니다. 목록에서 회원을 체크하면 위에 동작 막대가 나타나고, 등급 변경·상태 변경으로 이어집니다. 한 번에 100명까지이며, 쪽을 넘겨도 선택은 유지됩니다 — 1쪽에서 5명, 2쪽에서 10명을 고른 뒤 한 번에 저장할 수 있습니다. 다만 검색어나 필터를 바꾸면 선택이 풀립니다.
일괄 변경 — 선택 막대와 결과 단계
| 단계 | 하는 일 |
|---|---|
| 1 · 입력 | 바꿀 등급(또는 상태)을 고르고, 적용 일자·변경 사유를 적습니다. 적용 일자를 비우면 오늘 날짜로 기록되고, 대상 전원에게 같은 날짜가 들어갑니다. 휴학·군휴학을 고르면 종료 예정일 칸이 함께 나타납니다. |
| 2 · 미리보기 | 바꿀 값과 대상 전원의 이름을 펼쳐 보여줍니다. 여기서 «{N}명 변경»을 눌러야 실제로 저장됩니다. |
| 3 · 결과 | 전체 · 변경 · 건너뜀 · 실패를 세어 보여주고, 회원마다 어떻게 됐는지 배지로 표시합니다. |
«건너뜀»은 실패가 아닙니다. 이미 그 값인 회원은 바꿀 것이 없어 지나가며, 이력도 남기지 않습니다. 화면도 «건너뛴 회원은 이미 같은 값입니다. 실패가 아닙니다.»라고 밝힙니다.
되돌리는 일괄 기능은 없습니다. 잘못 눌렀다면 한 명씩 다시 바꿔야 하므로, 2단계 미리보기에서 대상 이름을 반드시 확인하세요.
회원 삭제 — 중복 계정 정리용 임시 기능 v0.2.6
회원 상세 맨 아래, 붉은 테두리 구역에 있습니다. 연동이 잘못돼 생긴 중복 계정을 지우는 임시 기능이고 되돌릴 수 없습니다. 배포 설정에 따라 구역 자체가 안 보이기도 합니다. 그때는 이 기능을 꺼 둔 배포입니다.
- 1회원 삭제를 누른다함께 지워질 항목을 먼저 확인합니다.
- 2함께 지워질 것을 확인한다«응답 N건 · 행사 참가 M건 · 이력 K건이 함께 지워집니다»가 뜹니다.
- 3회원명을 그대로 입력한다이름이 정확히 맞아야 «지우기» 버튼이 열립니다.
지울 수 없는 회원이 있습니다. 폼 작성자·승인자처럼 다른 기록에 남아 있으면 «지울 수 없습니다 — 이 회원이 …(으)로 남아 있습니다»가 뜨고 확인 버튼이 아예 없습니다. 구글 로그인 자체는 남습니다 — 그 사람이 다시 로그인하면 가입 화면이 뜨고, 거기서 기존 회원 정보와 연결할 수 있습니다.
CSV 회원 이관
/members/csv-import
과거 명단(엑셀·구글 시트를 CSV로 내보낸 파일)을 한 번에 등록하는 4단계 절차입니다. 중복으로 보이는 행은 자동으로 병합하지 않고 건너뜁니다. 실행 결과는 되돌릴 수 없으므로 3단계 검증에서 반드시 내용을 확인하세요.
CSV 회원 이관 — 1단계 파일 선택
3단계 사전 검증 — 이 숫자를 반드시 확인하고 다음으로
- 1양식 CSV를 먼저 내려받아 형식을 맞춘다필수·조건부·선택 컬럼이 표로 안내됩니다.
- 2내 파일의 헤더를 시스템 필드에 연결한다헤더명이 정확히 일치하지 않아도 직접 매핑할 수 있습니다.
- 3오류·중복 행을 확인한다이 행들은 이관되지 않고 건너뜁니다 — 실행 전 사유를 꼭 읽어보세요.
- 4"되돌릴 수 없다는 것을 확인했습니다"에 체크 후 실행한다실행하면 정상 후보만 새 회원으로 등록됩니다.
명부의 «가입일»은 «동아리 가입 시기» 열에 넣으세요 (v0.2 · 양식 CSV도 함께 바뀌었습니다). «전산 가입일»은 이관을 실행한 날로 시스템이 적는 값이라 여기에 과거 날짜를 넣는 자리가 아닙니다 — 두 열을 바꿔 넣으면 모든 회원의 동아리 가입 시기가 이관일로 들어갑니다. 기수는 자동으로 채워지지 않습니다 («학번으로도 동아리 가입 시기로도 자동 채우지 않습니다») — CSV에 기수 열을 직접 넣거나, 이관 뒤 회원 편집에서 채웁니다.
이관된 회원은 아직 로그인 계정과 연결되지 않은 상태입니다(이름 옆에 "이관" 표시). 본인이 Google로 가입하면 그때 실제 계정과 연결됩니다 — 이관만으로 로그인이 가능해지는 것은 아닙니다.
역할 · 권한
/members/roles /members/roles/{id}/authorities /members/authorities
"회장", "국장", "박람회 총괄" 같은 역할을 만들고, 역할마다 어떤 권한을 줄지 정하는 화면입니다. 버튼과 메뉴는 회원에게 부여된 권한에 따라 표시됩니다.
WORK_MANAGE
MEMBER_MANAGE
상위에서 부여
FORM_LABEL_MANAGE
역할별 권한 부여 — 체크는 직접 부여, 파란 배지는 상위 권한에서 상속됨
| 개념 | 의미 |
|---|---|
| 역할 | 회원에게 붙는 이름표. 한 회원이 역할을 여러 개 가질 수 있고, 그중 하나를 "대표" 역할로 지정할 수 있습니다. |
| 권한 | 화면 기능 하나하나에 매달린 코드(예: WORK_MANAGE). 역할에 권한을 체크해야 그 역할을 가진 회원이 해당 기능을 씁니다. |
| 상속 | 권한 트리에서 상위 권한을 가지면 하위 권한도 자동으로 포함됩니다. "상위에서 부여" 배지가 붙은 항목은 체크를 해제할 수 없습니다. |
묶음 권한만으로는 세부 권한이 열리지 않습니다. 예를 들어 어떤 역할에 "업무 쓰기" 권한만 주면 "업무 관리" 묶음 권한은 자동으로 따라오지 않습니다 — 화면은 정확히 그 회원이 가진 권한 코드만 보고 버튼을 그립니다.
폼 관리 · 편집기
/forms /forms/{id} /forms/{id}/edit
신입회원 모집, 행사 참가 신청 같은 외부 공개 설문을 만듭니다. 여러 페이지로 나눌 수 있고, 선택지에 따라 다음 페이지를 다르게 보여주는 분기도 지원합니다. 작성 중인 내용은 자동으로 저장됩니다.
폼 목록 — /forms
편집기 — 페이지와 문항 구성
폼 편집기 — /forms/{id}/edit
| 문항 유형 | 비고 |
|---|---|
| 단답형 · 장문형 | 텍스트 입력. 정규식으로 입력 형식을 검증할 수 있습니다(고급 설정). |
| 단일 선택 · 다중 선택 | 선택지별로 다음에 어느 페이지로 보낼지 분기를 지정할 수 있습니다. |
| 날짜 | 날짜 선택 입력. |
화면 상단의 저장 상태 표시줄에서 저장 여부를 확인할 수 있습니다. 입력을 멈추면 자동으로 저장됩니다. 다른 화면으로 이동하기 전에는 표시줄이 "저장됨"으로 바뀌었는지 확인하세요.
접수 상태 바꾸기
폼 상세 화면 하단에서 접수를 시작하거나 마감할 수 있습니다. 접수를 마감하면 공개 링크에 들어온 응답자는 더 이상 새 응답을 제출할 수 없고, 이미 제출된 응답은 그대로 남습니다.
«접수 상태 변경»은 폼 편집과 다른 권한입니다(FORM_STATUS_CHANGE). 문항은 고칠 수 있는데 접수 시작·마감만 잠겨 있다면 필요한 권한이 다른 것입니다. 학술 모집 폼은 여기서 접수를 시작할 수 없고 모집 관리 화면에서 시작합니다 (16절) — 다만 마감은 이 화면에서 합니다. 기획안 시스템 폼은 14절을 보세요.
다중 응답 허용 v0.2
편집기에서 다중 응답 허용을 켜면 «한 사람이 여러 건을 낼 수 있습니다» — 지원서·설문처럼 한 사람이 한 번만 내야 하는 폼은 꺼 둡니다.
이미 응답이 들어온 뒤에도 바꿀 수 있습니다. 끄면 «지금부터» 새 응답만 받지 않고, 이미 들어온 응답은 지워지지 않고 그대로 남습니다.
템플릿 관리 v0.2
/forms/templates 자주 쓰는 문항 구성을 템플릿으로 저장해 두고, 새 폼을 만들 때 골라 씁니다 (예: «신규 부원 모집 표준 문항»). 어떤 폼에 쓰는 구성인지 설명을 적어 두면 고를 때 도움이 됩니다.
사용 여부를 끈 템플릿은 폼을 만들 때 고를 수 없습니다 — 목록에는 남지만 «사용하지 않는 템플릿입니다»로 표시됩니다. 다시 쓰려면 사용 여부를 켜세요.
목록 필터가 «접수 상태» 기준으로 바뀌었습니다 v0.2.3
필터 칩과 카드 배지는 같은 상태명을 사용합니다. 칩은 전체 · 작성중 · 접수 예정 · 접수중 · 기간 종료 · 마감 순입니다.
처음 들어가면 «접수중»인 폼만 보입니다. 이전에 만든 폼을 찾으려면 전체 칩을 누르세요.
폼 삭제 · 지운 폼 되살리기 v0.2.3
/forms/deleted 폼 카드의 삭제로 지우고, 사이드바 폼 › 지운 폼(또는 목록 위 «지운 폼» 버튼)에서 되살립니다. 응답이 있는 폼도 삭제할 수 있으며, 삭제된 동안에는 응답도 신청자 화면에 표시되지 않습니다.
| 동작 | 일어나는 일 |
|---|---|
| 삭제 | 목록에서 빠지고, 그 폼에 낸 응답은 신청자의 «내 신청»에서도 보이지 않게 됩니다. 확인 창이 응답 건수를 먼저 알려줍니다. |
| 되살리기 | 접수 상태·라벨·응답이 지우기 전 그대로 돌아옵니다. 되살릴 때는 확인 없이 바로 실행됩니다. |
응답 확인
/forms/{id}/responses /forms/{id}/responses/{rid}
제출된 응답을 확인하고, 필요하면 승인하거나 반려합니다.
응답 목록 — /forms/{id}/responses (상태 클릭 시 변경 창)
응답 상세 화면 하단의 이전 · 다음 버튼으로 목록을 다시 열지 않고도 연속으로 검토할 수 있습니다.
공개 폼 — 응답자가 보는 화면
/f/{키} 로그인 없이 접근 가능
운영진이 만든 폼의 공개 링크를 응답자에게 공유하면, 응답자는 이 화면에서 어드민 로그인 없이 작성합니다. 다만 회원 식별이 필요한 폼은 응답자에게도 Google 로그인을 요구할 수 있습니다.
공개 폼 작성 화면 — /f/{키}
마지막 페이지까지 마치고 제출하면 완료 화면으로 넘어가며, 이후에는 같은 링크로 다시 들어가도 재작성할 수 없습니다(폼이 재제출을 허용하지 않는 한).
공개 링크 주소가 바뀌었습니다 v0.2.9
폼 상세의 링크 복사로 만들어지는 주소가 숫자에서 임의의 키로 바뀌었습니다
— /f/12 대신 /f/3f9a… 모양입니다. 주소만 보고 다른 폼을
찾아 들어갈 수 없게 한 것입니다.
예전에 공유한 숫자 주소도 그대로 열립니다. 이미 공지나 메신저로 보낸 링크를 다시 보내지 않아도 됩니다 — 새로 복사하는 링크만 새 모양으로 나갑니다.
메신저에 붙이면 그림 카드로 보입니다 v0.2.10
공개 폼 링크를 카카오톡·디스코드에 붙여 넣으면 글자만 있던 미리보기가 제목과 안내가 적힌 큰 그림으로 바뀝니다. 운영진이 따로 만들 것은 없습니다 — 링크를 붙이는 순간 그 폼의 제목으로 그려집니다.
메신저에 뜨는 공유 카드 — 링크를 붙이는 순간 그려집니다
| 카드에 담기는 것 | 어디서 오나 |
|---|---|
| 제목 | 폼 제목입니다. 너무 길면 뒤가 «…»로 잘립니다. |
| 안내 문구 | 폼 편집기의 안내 문구 앞부분입니다. 비어 있으면 «숭실컴퓨팅클럽(SSCC) 신청서입니다»가 대신 들어갑니다. |
| 동아리 마크 | 탭·홈 화면 아이콘과 같은 그림입니다. |
접수 상태와 마감일은 카드에 넣지 않습니다. 메신저는 한 번 만든 카드 그림을 다시 그리지 않습니다 — 넣어 두면 접수가 끝난 뒤에도 «모집 중»이라고 적힌 그림이 대화방에 그대로 남습니다. 마감을 알리려면 카드가 아니라 공지로 알려주세요.
카드 모양이 예전 그대로라면 메신저가 옛 미리보기를 기억하고 있는 것입니다. 대화방에 이미 뿌린 링크는 바뀌지 않습니다 — 새로 붙이는 링크부터 그림 카드로 보입니다.
낸 사람은 자기 응답을 다시 볼 수 있습니다 v0.2.3
예전에는 운영진이 수정 요청을 보내야만 신청자가 자기 응답을 열 수 있었지만, 이제 제출·승인·반려 어느 상태든 열립니다. «내 신청»의 제출 내용 보기로 들어가며, 반려된 응답도 사유를 확인할 수 있습니다. 다시 낼 수 있는 것은 여전히 수정 요청을 받은 응답뿐입니다 — 나머지는 읽기만 됩니다.
행사 관리
admin /events 작성 · 게시 · 보관과 분류 관리
운영진이 행사를 만들고 공개하는 화면입니다. 게시한 행사는 공개 웹사이트 (20절)에 표시되며, 참가 신청은 폼으로 받습니다. 행사 목록·편집·상태 변경·분류 관리를 여기서 처리합니다.
행사 메뉴는 행사 관리(EVENT_MANAGE) 권한이 있어야 보입니다. 행사 목록과 분류 관리 둘 다 이 권한을 요구합니다.
처음 들어가면 «보관 제외»가 걸려 있습니다v0.2.3 — 보관한 행사는 기본으로 보이지 않습니다. 옛 행사를 찾을 때는 전체 또는 보관 칩을 누르세요.
행사 목록 — /events
행사를 여는 순서
- 1+ 새 행사로 기본 정보를 채운다행사명 · 분류 · 일시 · 장소 · 정원 · 본문. 본문은 마크다운으로 쓰고 이미지도 붙일 수 있습니다.
- 2신청서(폼)를 연결한다참가 신청을 받으려면 폼이 필요합니다. 폼 관리(9절)에서 만든 폼을 고르거나 새로 만듭니다.
- 3게시로 상태를 바꾼다게시한 순간부터 공개 웹사이트 행사 목록에 나타납니다. 작성 중일 때는 외부에 보이지 않습니다.
- 4모집이 끝나면 보관한다보관하면 목록에서 내려가지만 참가자 명단과 신청 기록은 그대로 남습니다.
본문 이미지 붙이기
본문 편집기에 이미지를 올리면 업로드된 뒤 본문에 삽입됩니다. 올린 이미지는 공개 웹사이트의 행사 상세와 공유 카드(카카오톡·슬랙 미리보기)에 함께 쓰입니다.
대표 이미지가 없으면 목록 카드에 이미지 영역이 표시되지 않습니다. 카드는 글자만 표시되며, 일시·장소도 값이 없으면 해당 줄이 생략됩니다.
본문은 «편집 / 미리보기»로 오갑니다 v0.2.4
본문 칸 위에 편집·미리보기 두 칸짜리 전환 단추가 있습니다. 나란히 보이는 것이 아니라 한 번에 한 쪽만 보이고, 미리보기로 옮겨도 쓰던 자리와 커서는 그대로 남습니다. 이미지 첨부 버튼은 편집 화면에서만 표시됩니다.
대표 이미지는 정사각형입니다 v0.2.3
미리보기 틀이 1:1 정사각형입니다 — 공개 화면 카드와 같은 틀이라, 여기서 잘리는 모양이 실제로 보이는 모양입니다. 다른 비율이면 좌우가 잘리므로 정사각형 이미지를 권합니다. 이 이미지는 공유 링크 미리보기에도 함께 쓰입니다.
새 행사를 만드는 중에는 파일을 올릴 수 없습니다 — «이미지는 등록한 뒤 수정 화면에서 올립니다»가 뜹니다. 먼저 등록하고 수정 화면에서 올리세요.
연결한 신청서를 바꾸면 미리 경고합니다 v0.2.3
이미 연결된 폼을 다른 폼으로 바꾸고 저장하면, 저장 직전에 무엇이 끊기는지 확인 창이 뜹니다. «바꾸고 저장»을 눌러야 실제로 바뀝니다.
| 확인 창이 알려주는 것 | 뜻 |
|---|---|
| 받은 응답은 지워지지 않습니다 | 옛 신청서에 그대로 남습니다. 다만 신청자 화면에서 «내 신청»이 아니라 «내 폼 응답»으로 옮겨 보입니다. |
| 확정된 참가자는 그대로 남습니다 | 이미 명단에 올린 사람은 빠지지 않습니다. |
| 옛 응답으로는 더 이상 등록할 수 없습니다 | 심사 중이던 응답을 나중에 승인해도 이 행사 명단에는 올릴 수 없습니다. |
행사 삭제 · 지운 행사 되살리기 v0.2.5
/events/deleted 행사 카드의 삭제로 지우고, 행사 목록 위의 «지운 행사» 버튼으로 들어가 되살립니다 — 사이드바에는 없습니다(폼과 다른 점입니다).
«보관»과 «삭제»는 다릅니다. 끝난 행사를 목록에서 숨기려면 보관하고, 잘못 만든 행사는 삭제합니다. 지우면 확정 참가자의 «내 신청»에서도 그 행사가 사라지며, 되살리면 게시 상태·참가자·연결 폼이 지우기 전 그대로 돌아옵니다.
학술 활동이 연결된 행사는 지울 수 없습니다 — «학술 활동에서 먼저 정리해주세요»가 뜹니다. 삭제 확인 창은 확정 참가자 수를 먼저 보여주고, 되살릴 때는 확인 없이 바로 실행됩니다.
분류 관리
/events/categories 행사 분류(세미나 · 모집 · 프로젝트 등)를 만들고 관리합니다. 분류는 공개 웹사이트의 필터 칩으로 그대로 쓰이므로, 이름을 바꾸면 방문자가 보는 필터 이름도 함께 바뀝니다.
신청 심사 · 참가자 관리
admin /events/{eventId}/participants
신청 내용을 확인하고 참가 여부를 정하는 화면입니다. 지원 동기 등의 응답을 보고 확정·대기·취소 상태를 지정합니다.
참가자 관리 — /events/{eventId}/participants
정원을 넘어도 확정할 수 있습니다. 확정 인원이 정원을 넘으면
31 / 30처럼 표시되지만 확정 버튼은 잠기지 않습니다.
확정과 대기의 차이 v0.2.8
요약 카드 아래에 한 줄로 적혀 있습니다 — «확정은 참가 인원으로 집계됩니다 · 대기는 정원을 넘겼을 때 순번을 기다리는 상태입니다». 즉 참가 인원에 세어지는 것은 확정뿐입니다.
정원이 «제한 없음»이면 «대기» 버튼이 표시되지 않습니다. 회원을 직접 추가할 때도 확정/대기를 고르는 칸 대신 «정원이 없어 확정으로 올라갑니다.»가 표시됩니다. 대기자를 «확정으로 올리기»는 그대로 있습니다.
이미 명단에 올린 신청은 «명단에서 보기»로 v0.2.8
신청 목록의 명단 등록 칸은 셋 중 하나를 보여줍니다 — 아직 심사 전이면 «심사 후 등록», 승인됐으면 확정·대기 버튼, 이미 올렸으면 참가 상태 배지 + «명단에서 보기»입니다. 그 버튼을 누르면 참가자 명단 탭으로 넘어가면서 그 상태 필터가 자동으로 걸립니다 — 방금 올린 사람을 명단에서 다시 찾지 않아도 됩니다.
신청 내용은 어디서 보나
신청자가 폼에 적은 답(지원 동기 등)은 응답 확인(10절)에서 읽습니다. 참가자 관리 화면은 확정·대기·취소만 다루고, 답 본문은 연결된 폼의 응답 목록에 있습니다.
시스템 폼 — 기획안 접수 열기
admin /forms 학술 회차를 시작할 때 가장 먼저 하는 일
기획안 접수를 시작하지 않으면 회원은 기획안을 낼 수 없습니다. 학술 앱에는 «지금은 기획안을 받지 않습니다»가 표시됩니다. 접수를 시작해야 기획안 검토 목록에 제출된 기획안이 표시됩니다.
시스템 폼이란
보통 폼은 운영진이 필요할 때 만들지만, 시스템이 코드로 찾아 쓰는 폼이 따로
있습니다. 기획안 폼(PROPOSAL)이 그것입니다 — 학술 앱의 «기획안 제출»
메뉴는 이 폼 하나를 가리키고 있어서, 운영진이 그 폼의 접수를 열어야 회원 화면이
열립니다. 폼 목록에서 시스템 배지가 붙은 것이 이런 폼입니다.
기획안 시스템 폼 상세 — /forms/{formId}
기획안 접수를 여는 순서
- 1폼 목록에서 기획안 폼을 찾는다/forms «시스템» 배지가 붙은 폼입니다. 이름은 운영진이 바꿀 수 있으니 배지로 찾으세요.
- 2문항이 회차에 맞는지 확인한다시스템이 쓰는 문항은 지울 수 없지만 문구 수정과 문항 추가는 됩니다. 커리큘럼 문항의 형식 안내는 문항 설명에 이미 들어 있습니다.
- 3접수 기간을 정한다기간을 비워 두면 수동으로 열고 닫습니다. 기간을 넣으면 그 사이에만 자동으로 열립니다.
- 4접수 시작을 누른다회원이 학술 앱의 «기획안 제출» 화면에서 기획안을 낼 수 있습니다.
- 5회차가 끝나면 마감시스템 폼은 지울 수 없으므로, 그만 받을 때는 삭제가 아니라 마감을 씁니다. 마감한 뒤에도 다시 접수를 시작할 수 있습니다.
시스템 폼은 «전체가 잠긴 폼»이 아닙니다. 실제로 막히는 것은 삭제와 시스템이 쓰는 문항의 삭제 둘뿐입니다. 제목 · 접수 기간 · 라벨 · 접수 상태는 평소처럼 바꿀 수 있고, 문항 문구를 수정하거나 문항을 추가할 수도 있습니다.
«접수 상태 변경»은 폼 편집과 다른 권한입니다. 문항을 고치는 것은 폼 편집 (FORM_WRITE), 접수를 열고 닫는 것은 접수 상태 변경(FORM_STATUS_CHANGE) 권한입니다. 폼은 고칠 수 있는데 «접수 시작»만 잠겨 있다면 접수 상태 변경 권한이 없는 것입니다. 버튼에 마우스를 올리면 필요한 권한을 확인할 수 있습니다.
학술 모집 폼은 여기서 접수를 시작할 수 없습니다. 활동에 연결된 모집 폼은 «이 폼은 학술 활동에 연결돼 있어 여기서 접수를 시작할 수 없습니다 — 모집 관리 화면에서 시작하세요»로 잠깁니다. 모집 시작은 폼을 여는 것 말고도 접수 기간 반영·활동 상태 변경을 함께 하기 때문입니다(16절). 기획안 폼은 활동에 딸린 폼이 아니므로 이 잠금과 무관합니다 — 이 절의 순서대로 여기서 엽니다. 다만 마감은 두 종류 모두 이 화면에서 합니다(모집 관리에는 마감 버튼이 없습니다).
복제하면 일반 폼이 됩니다. 시스템 폼도 복제는 열려 있는데, 사본은 코드가 가리키지 않는 보통 폼입니다 — 사본의 접수를 열어도 학술 앱의 기획안 화면은 열리지 않습니다. 접수는 반드시 «시스템» 배지가 붙은 원본에서 시작하세요.
회원 화면에서는 이렇게 보입니다
운영진이 기획안 접수를 시작하면 이 화면에서 작성해 제출할 수 있습니다 — 접수가 열리면 다시 열어주세요
이미 낸 기획안 보기접수가 닫혀 있을 때의 학술 앱 — /proposals/new
«기획안을 낼 수 없다»는 문의가 들어오면 여기부터 확인하세요. 회원 화면이 위처럼 보인다면 권한 문제가 아니라 접수가 닫혀 있는 것입니다. 폼 목록에서 기획안 폼의 접수 상태를 보고 «접수 시작»을 누르면 곧바로 풀립니다.
학술 회차를 여는 전체 순서
학술 운영을 시작하려면 먼저 기획안 접수를 열어야 합니다. 이후 순서는 다음과 같습니다.
| 순서 | 하는 일 | 누가 | 어디서 |
|---|---|---|---|
| 1 | 기획안 접수 시작 | 운영진 | 이 절 — 폼 목록 |
| 2 | 기획안 제출 | 회원 | 25절 — 학술 앱 |
| 3 | 기획안 검토 · 승인 | 학술국장 | 15절 |
| 4 | 모집 시작 · 팀원 선발 | 학술국장 | 16절 |
| 5 | 회차 기록 · 출석 | 스터디장 | 23절 — 학술 앱 |
| 6 | 회차 승인 | 학술국장 | 18절 |
«모집 시작»과 헷갈리지 마세요. 이 절의 접수 시작은 기획안을 받기 시작하는 것(회차의 시작)이고, 16절의 모집 시작은 승인된 활동이 팀원을 모으기 시작하는 것입니다. 둘은 다른 단계이고 폼도 다릅니다 — 전자는 기획안 시스템 폼 하나, 후자는 활동마다 따로 생기는 모집 폼입니다.
기획안 검토
admin /proposals/review 제출된 기획안을 확인하고 처리합니다
회원이 학술 앱에서 낸 스터디·프로젝트 기획안을 검토하는 화면입니다. 기획안을 승인하면 학술 활동이 만들어집니다. 승인된 활동은 모집 관리에서 모집을 시작할 수 있습니다.
승인을 누르면 되돌릴 수 없습니다. 승인하면 이 기획안이 학술 활동으로 만들어지고, 제출자에게 유형에 맞는 리더 역할(스터디장 · 프로젝트장)이 부여되며, 비어 있는 모집 폼이 함께 생깁니다. 승인 전에 화면이 생성될 항목을 표로 보여줍니다. 무엇이 만들어질지 확인하고 누르세요.
- 제출자
- 김민서
- 유형
- 스터디
- 모집 정원
- 6 ~ 10명
- 운영 계획
- 매주 화 19:00, 백준 골드 난이도
· 김민서에게 스터디장 역할 부여
· 커리큘럼 8회차 등록
· 비어 있는 모집 폼 생성 (문항은 직접 채워야 합니다)
기획안 검토 — /proposals/review
세 가지 처리
| 처리 | 그 뒤 어떻게 되나 | 언제 쓰나 |
|---|---|---|
| 승인 | 학술 활동 생성 · 되돌릴 수 없음 | 그대로 개설해도 되는 기획안. 승인과 동시에 제출자가 스터디장이 되고 모집 폼이 생깁니다. |
| 수정요청 | 제출자가 고쳐서 다시 냄 | 내용이 부족하거나 커리큘럼을 손봐야 할 때. 사유가 필수이고, 제출자는 그 사유를 먼저 보고 이전 답이 채워진 상태에서 고칩니다. |
| 반려 | 끝 · 되돌릴 수 없음 | 개설하지 않기로 한 기획안. 제출자는 다시 낼 수 없습니다. |
재제출된 기획안은 «제출 회차»가 2 이상입니다. 그런 기획안에는 «수정요청을 받아 다시 낸 기획안입니다»라는 안내가 붙습니다. 처리 이력에서 이전 요청 내용을 확인한 뒤 처리하세요.
커리큘럼을 못 읽으면 승인이 잠깁니다. 기획안에 적힌 커리큘럼 형식이 어긋나면 «이 기획안은 지금 학술 활동으로 옮길 수 없습니다»가 뜨고 승인 버튼이 잠깁니다 — 사유가 함께 표시되며, 제출자에게 수정요청을 보내 형식을 맞추게 해야 합니다.
모집 관리
admin /academic-programs/recruitment 승인된 활동의 모집을 시작하고 신청자를 선발합니다
기획안이 승인되면 활동은 승인 상태로 대기합니다. 이 화면에서 모집을 시작하고, 들어온 신청자 중 함께할 사람을 고릅니다. 왼쪽에서 활동을 고르면 오른쪽에 그 활동의 모집 현황이 나옵니다.
모집 관리 — /academic-programs/recruitment
모집을 시작하는 순서
- 1왼쪽 목록에서 활동을 고른다승인·모집 중 활동만 나옵니다. 수료한 활동은 목록에 없습니다.
- 2신청서 문항 편집으로 문항을 채운다기획안 승인이 만들어 준 폼은 문항이 비어 있습니다. 문항이 하나도 없으면 모집을 시작할 수 없습니다.
- 3모집 시작을 누른다활동이 «진행 중»이 되고 신청서가 열립니다. 이때부터 회원이 신청할 수 있습니다.
- 4신청자마다 확정 · 대기 · 미선택을 고르고 선발 저장확정한 사람이 팀원 명단에 들어갑니다. 언제든 다시 고쳐 저장할 수 있습니다.
문항이 없는 신청서로는 모집을 시작할 수 없습니다. 기획안을 승인하면 빈 폼이 만들어지므로 «폼 편집 화면에서 문항을 먼저 등록하세요»가 표시됩니다. 카드의 신청서 문항 편집 링크로 가서 문항을 채운 뒤 다시 시작하세요.
정원을 넘겨도 «선발 저장»은 잠기지 않습니다. 확정 인원이 모집 정원 상한을 넘으면 경고 문구만 뜹니다. 접수 기간은 이 화면에서만 설정합니다. 폼 편집 화면에는 학술 모집 폼의 접수 기간 입력란이 표시되지 않습니다.
스터디 · 프로젝트
admin /academic-programs 전체 활동 목록과 활동 상세
학술국장이 전체 스터디·프로젝트를 감독하는 화면입니다. 스터디장이 자기 활동 하나만 보는 학술 앱(22절)과 달리, 여기서는 모든 활동의 진행률과 상태를 한 화면에서 확인합니다.
스터디 · 프로젝트 목록 — /academic-programs
활동 상태는 셋뿐입니다 — 승인 · 진행 중 · 수료. «모집 중»은 별도 상태가 아니라 연결된 신청서가 열려 있는가로 표시됩니다. 모집을 시작하면 활동 상태가 «승인»에서 «진행 중»으로 바뀝니다.
활동 상세에서 보는 것
활동 카드를 누르면 그 활동의 커리큘럼 대비 진행 · 회차 이력 · 팀원 명단 · 평균 출석률을 봅니다. 회차 기록을 고치지는 않습니다 — 기록은 스터디장이 쓰고, 국장은 회차·출석 승인에서 처리합니다.
회차 · 출석 승인
admin /academic-programs/reviews/sessions
스터디장들이 올린 회차 기록을 승인하는 화면입니다. 여러 활동의 제출을 한 화면에 모아 보여주므로, 활동을 하나씩 들어가지 않고 밀린 것부터 처리할 수 있습니다.
백준 1926, 2178 풀이 후 코드 리뷰. 다음 주까지 4문제 과제로 냈습니다.
회차 · 출석 승인 — /academic-programs/reviews/sessions
| 처리 | 결과 |
|---|---|
| 승인 | 회차가 «승인»으로 확정됩니다. 되돌릴 수 없고, 승인된 회차는 출석도 고칠 수 없습니다. |
| 수정요청 | 회차가 «수정요청»이 되고 스터디장이 고쳐서 다시 냅니다. 사유가 필수입니다. |
일괄 승인은 없습니다. 회차마다 진행 내용과 출석을 확인하고 하나씩 처리합니다. 이미 처리된 회차를 다시 처리하려 하면 «이미 처리됨» 안내가 뜨니 목록을 새로고침하세요.
학술 대시보드 · 회차 이력 · 출석 통계
admin /academic-programs/dashboard /academic-programs/sessions /academic-programs/attendance
학술국장이 전체 활동을 확인하는 세 화면입니다. 대시보드에서는 지연된 업무를, 회차 이력에서는 활동별 회차 진행 상황을, 출석 통계에서는 회원별 출석률을 확인합니다.
학술 대시보드 — /academic-programs/dashboard
«이번 주 회차»는 진행일 기준입니다. 아직 진행하지 않은 예정 회차는 여기 들어오지 않습니다 — 목록이 진행일만 주기 때문입니다. «진행 더딘 활동»도 정확한 지연 판정이 아니라 진행 중이면서 진행률 40% 미만인 활동을 세어 보여주는 근사치입니다.
출석 통계
/academic-programs/attendance 활동별·팀원별 출석률을 봅니다. 출석률 70% 미만은 눈에 띄게 표시됩니다 — 수료 기준(2/3)에서 온 값이라, 이 아래로 내려간 팀원은 수료가 어려워집니다.
행사 목록 · 상세
www / /events/{eventId} 로그인 없이 열립니다
공개 웹사이트에서는 로그인하지 않아도 누구나 행사 목록과 상세를 볼 수 있습니다. 링크를 카카오톡이나 슬랙에 붙이면 제목·설명·대표 이미지가 담긴 카드로 펼쳐집니다.
행사 목록 — 공개 웹사이트 첫 화면
대표 이미지가 없는 행사는 카드가 글자만으로 짧아집니다. 위 스케치의 오른쪽 카드처럼 이미지 영역 자체가 그려지지 않습니다. 장소가 없으면 일시만, 일시가 없으면 장소만 나옵니다 — 없는 값을 «미정» 같은 문구로 채우지 않습니다.
배지 두 줄의 뜻
카드와 상세에는 배지가 최대 둘 표시됩니다. 앞은 모집 상태(신청을 받는가), 뒤는 행사 진행(행사 자체가 언제인가)입니다. 두 상태는 각각 계산되므로 행사가 아직 «예정»인데 모집은 이미 «마감»일 수 있습니다.
| 모집 상태 | 뜻 |
|---|---|
| 모집 준비 중 | 운영진이 아직 신청서를 열지 않았습니다 |
| 모집 예정 | 모집 시작일이 아직 오지 않았습니다 |
| 모집 중 | 지금 신청할 수 있습니다 — 이때만 «신청하기»가 눌립니다 |
| 모집 기간 종료 | 모집 기간이 지났습니다 |
| 모집 마감 | 운영진이 모집을 닫았습니다 |
| 행사 진행 | 뜻 |
|---|---|
| 예정 | 행사일이 아직 오지 않았습니다 |
| 진행 중 | 행사 기간 안입니다 |
| 종료 | 행사가 끝났습니다 |
상세 화면 — 본문과 신청 패널
숭실컴퓨팅클럽이 어떤 동아리인지, 한 학기 동안 무엇을 하는지 소개하는 자리입니다. 스터디·프로젝트 운영 방식과 지원 절차를 안내합니다.
- 일시
- 3월 4일 18:00
- 장소
- 학생회관 302호
- 참가
- 확정 24 / 40
- 모집
- 모집 중
신청은 회원만 할 수 있습니다 — 아직 회원이 아니어도
신청 화면에서 가입까지 마칠 수 있습니다
행사 상세 — /events/{eventId}
모집 중이 아니면 «신청하기»가 흐리게 잠깁니다. 버튼이 사라지지 않고 남아 사유를 알려줍니다 — 모집 전이면 «아직 모집이 시작되지 않았습니다», 그 밖에는 «지금은 신청을 받지 않습니다»가 버튼 아래에 나옵니다.
참가 신청 · 내 신청
www /events/{eventId}/apply /my-applications 로그인 필요
신청은 회원만 할 수 있지만, 아직 회원이 아니어도 이 화면에서 가입까지 마칠 수 있습니다. 가입을 마치면 같은 화면에 신청서가 표시됩니다.
신청하려면 회원 정보가 필요합니다. 아래 정보만 채우면 바로 이어서 신청할 수 있습니다.
참가 신청 1단계 — 가입 (이미 회원이면 건너뜁니다)
신청하는 순서
- 1행사 상세에서 신청하기로그인하지 않았다면 먼저 Google 로그인을 거칩니다.
- 2회원이 아니면 간편 가입을 먼저 마친다이미 회원이면 이 단계는 나오지 않고 곧바로 신청서가 열립니다.
- 3신청서를 작성한다쓰는 도중 자동으로 임시저장되므로 창을 닫았다 다시 와도 이어서 쓸 수 있습니다.
- 4제출하면 완료 화면이 나온다이후 운영진이 확정·대기를 정하고, 결과는 «내 신청»에서 확인합니다.
버튼이 내 신청 상태를 알려줍니다 v0.2.4
행사 상세의 신청 버튼은 내가 이미 냈는지에 따라 글자가 달라지고, 그 아래 한 줄로 지금 할 수 있는 일을 알려줍니다.
| 버튼 | 뜻 |
|---|---|
| 확인 중… | 신청 여부를 확인하는 중입니다. 잠깐 기다리면 아래 중 하나로 바뀝니다. |
| 신청하기 | 아직 내지 않았습니다. 회원이 아니어도 누를 수 있고, 신청 화면에서 가입까지 이어집니다. |
| 제출 완료 | 이미 냈습니다. 누르면 그때 낸 내용을 그대로 볼 수 있습니다. 모집이 끝난 뒤에도 계속 열립니다. |
| 수정하기 | 운영진이 수정을 요청했습니다. 내용을 고쳐 다시 제출하면 됩니다. |
| 추가 제출 | 여러 번 낼 수 있는 폼에서만 «제출 완료» 옆에 함께 나옵니다. |
임시저장만 해 둔 것은 낸 것으로 치지 않습니다 — 그 경우 버튼은 «신청하기» 그대로입니다.
내 신청
내 신청 — /my-applications
제출 내용 보기 v0.2.4
각 카드 아래에 제출 내용 보기 링크가 생겼습니다 — 내가 그때 무엇을 적어 냈는지 그대로 다시 볼 수 있습니다. 카드 본문을 누르면 예전처럼 행사 상세로 갑니다.
가입은 이 화면을 떠나지 않고 끝납니다 v0.2.9
아직 가입 전인 계정으로 열면 «회원 가입을 마쳐야 신청 현황을 볼 수 있습니다» 안내가 뜨고, 지금 바로 가입하기를 누르면 그 자리에서 가입 항목이 펼쳐집니다. 가입을 마치면 같은 화면에 신청 목록이 표시됩니다.
이미 명부에 있는 학번이면 «연결»로 이어집니다. 가입을 누른 뒤 «이 학번은 이미 명부에 등록돼 있습니다»가 뜨면 오류가 아니라, 기존 회원 정보에 지금 계정을 잇는 단계입니다 — 학번·이름·전화번호 셋이 모두 명부와 같아야 연결되며, 어느 항목이 달랐는지는 알려주지 않습니다(명부를 떠보는 수단이 되지 않게 한 것입니다). 연결되면 기수·등급·역할이 그대로 남습니다.
학술 앱(lms)도 같은 방식입니다 — 미가입 상태로 학술 화면을 열면 그 자리에서 가입 항목이 펼쳐집니다.
첫 화면 · 스터디장 대시보드
lms / /studio 전 화면 로그인 필수
학술 앱의 첫 화면은 회원의 역할에 따라 다릅니다. 스터디장·프로젝트장이면 바로 대시보드로 가고, 아직 활동을 맡지 않은 회원이면 기획안 카드 두 장이 나옵니다. 상단 메뉴도 역할에 맞게 표시됩니다.
| 나는 | 첫 화면 | 상단 바에 보이는 것 |
|---|---|---|
| 스터디장 · 프로젝트장 | 학술 대시보드 | 학술 대시보드 · 내 활동 · 회차 기록 · 출석부 · 팀원 관리 + 기획안 메뉴 둘 |
| 일반 회원 | 기획안 카드 두 장 | 기획안 제출 · 기획안 제출 현황 둘뿐 |
기획안이 승인되면 그때부터 스터디장이 됩니다. 승인과 동시에 리더 역할이 부여되므로, 다음에 학술 앱에 들어오면 첫 화면이 대시보드로 바뀌고 메뉴가 늘어나 있습니다. 따로 설정할 것은 없습니다.
회색 승인 · 파랑 제출(검토 중) · 주황 미제출 · 테두리 수정요청. 지금 쓸 수 있는 회차를 누르면 기록 작성으로 갑니다.
스터디장 대시보드 — /studio
활동을 여럿 맡고 있다면 위쪽 드롭다운으로 바꿉니다. 고른 활동은 주소에 남으므로, 그 주소를 북마크하면 다음에도 같은 활동으로 열립니다.
«미기록 회차»는 계획일이 지났지만 아직 기록하지 않은 회차입니다. 숫자가 주황색이면 미기록 회차가 있으며, 아래에 회차와 예정일이 표시됩니다.
회차 기록 · 출석부
lms /studio/record /studio/roster
스터디장이 매 회차 끝나고 하는 일입니다. 진행 내용을 적고 누가 나왔는지 체크해 제출하면, 학술국장이 회차·출석 승인에서 확인합니다.
회차 기록 작성 — /studio/record
임시저장이 없습니다. 제출 전에 창을 닫으면 작성한 내용이 사라집니다. 긴 내용은 다른 곳에 먼저 작성한 뒤 옮기세요.
새 회차는 전원 출석으로 시작합니다. 안 나온 사람만 체크를 풀면 됩니다. 수정요청을 받아 다시 낼 때는 지난번에 체크한 출석이 그대로 채워집니다.
회차 상태 넷
| 상태 | 쓸 수 있나 | 뜻 |
|---|---|---|
| 미제출 | 쓸 수 있습니다 | 아직 기록을 내지 않은 회차입니다 |
| 제출 | 못 씁니다 | 국장이 검토 중입니다 — 결과를 기다립니다 |
| 수정요청 | 고쳐서 다시 냅니다 | 국장이 사유를 달아 돌려보냈습니다. 그 사유가 화면 위에 먼저 보입니다 |
| 승인 | 못 씁니다 | 확정됐습니다. 출석도 더는 고칠 수 없습니다 |
출석부 — 회차별 참석 현황
/studio/roster 가로가 회차, 세로가 팀원인 표입니다. 이미 제출한 회차의 출석을 칸을 눌러 고칠 수 있습니다. 회차 기록을 다시 제출하지 않고 출석만 정정할 수 있습니다.
● 출석 · ○ 결석 · · 이 회차 출석부에 없음. 출석률이 70% 미만이면 빨간색으로 표시됩니다.
출석부 — /studio/roster
승인된 회차의 칸은 잠깁니다. 눌러도 바뀌지 않고 «승인 완료 — 출석을 고칠 수 없습니다»가 뜹니다. 승인 전에 정정하세요. 회차가 많으면 표를 가로로 스크롤할 수 있으며, 팀원 이름과 출석률 열은 고정됩니다.
내 활동 · 팀원 관리
lms /studio/programs /studio/members
내 활동은 내가 맡은 활동의 커리큘럼·회차 이력·출석 통계를 모아 봅니다. 팀원 관리에서는 확정된 팀원 명단을 확인합니다.
팀원 관리 — /studio/members
팀원을 여기서 더하거나 빼지 않습니다. 팀원은 학술국장이 모집 관리에서 선발합니다 — 이 화면은 확정된 명단을 확인하는 곳입니다. 명단을 바꿔야 하면 학술국장에게 요청하세요.
기획안 제출 · 재제출
lms /proposals/new /my/applications 일반 회원의 화면
스터디나 프로젝트를 열고 싶은 회원이 기획안을 내는 화면입니다. 승인되면 그 활동의 스터디장이 되고, 학술 앱의 메뉴가 늘어납니다.
제출부터 결과 확인까지
- 1기획안 제출에서 양식을 채운다활동명 · 유형(스터디/프로젝트) · 모집 정원 · 운영 계획 · 커리큘럼을 적습니다.
- 2기획안 제출 현황에서 처리 상태를 본다제출 → 승인 · 수정요청 · 반려. 학술국장이 처리하면 여기에 반영됩니다.
- 3수정요청을 받으면 고쳐서 다시 낸다요청 사유가 화면 위에 먼저 나오고, 지난번에 쓴 답이 그대로 채워진 상태에서 시작합니다.
- 4승인되면 스터디장이 된다다음에 학술 앱에 들어오면 첫 화면이 대시보드로 바뀝니다.
기획안 상세 — /my/applications/{formRspnsId}
| 상태 | 내가 할 수 있는 일 |
|---|---|
| 작성 중(미제출) | 이어서 쓰고 제출합니다 |
| 제출 | 기다립니다 — 국장이 검토 중입니다 |
| 수정요청 | 사유를 읽고 고쳐서 다시 냅니다 |
| 승인 | 끝났습니다 — 활동이 만들어지고 내가 스터디장이 됩니다 |
| 반려 | 끝났습니다 — 이 기획안은 다시 낼 수 없습니다 |
재제출에는 임시저장이 없습니다. 고쳐 쓰는 도중 창을 닫으면 고친 내용이 사라집니다 — 한 번에 마치세요. 처음 작성할 때는 임시저장이 되지만, 수정요청을 받아 다시 낼 때는 전체를 한 번에 보냅니다.
내 계정
/my
본인이 직접 고칠 수 있는 정보와, 운영진만 바꿀 수 있는 정보가 한 화면에서 분리돼 보입니다.
- 이름
- 이지원
- 학번
- 20231234
- 학과
- 컴퓨터학부
- 학년
- 3학년
- 전화번호
- 010-****-5678
- 기수
- 15기
- 등급
- 정회원
- 상태
- 활동
- 현재역할
- 회장 대표
내 계정 — /my
학번·이메일·기수·등급·상태·역할은 본인이 직접 바꿀 수 없습니다. 잘못 등록됐다면 운영진(회원 관리 권한자)에게 요청하세요.
외부 앱 접근 승인 v0.2.9
/oauth/consent
외부 앱이 내 SSCC 계정으로 운영 시스템을 쓰려고 할 때 뜨는 화면입니다. 직접 찾아 들어가는 메뉴가 아니라, 그 앱이 연결을 요청하는 순간에만 열립니다. 허용해도 그 앱은 내가 가진 권한 범위에서만 접근할 수 있습니다. 새로운 권한이 생기지는 않습니다.
접근 요청
이 앱이 내 SSCC 계정으로 운영 시스템을 쓰려고 합니다. 허용해도 현재 권한 안에서만 접근할 수 있습니다.
- 앱 이름
- Claude
- 돌아갈 곳
- claude.ai
- 요청 범위
-
openid로그인한 계정을 식별합니다email계정의 이메일 주소를 봅니다profile계정의 이름·프로필 사진을 봅니다offline_access로그인하지 않아도 연결을 유지합니다
앱 이름과 돌아갈 곳이 기대한 것과 다르면 거절해주세요. 거절해도 계정에는 아무 변화가 없습니다.
접근 요청 확인 — /oauth/consent
화면이 보여주는 세 가지
| 항목 | 확인할 것 |
|---|---|
| 앱 이름 | 연결을 요청한 앱의 이름입니다. 등록된 주소가 따로 있으면 이름 아래 함께 표시됩니다. |
| 돌아갈 곳 | 허용한 뒤 돌아갈 주소입니다. 모르는 주소라면 거절하세요. |
| 요청 범위 | 앱이 요구한 권한을 원문 그대로 보여주고, 아는 값에만 설명을 덧붙입니다. 설명이 없는 항목이 있어도 숨기지 않습니다. |
기대한 앱이 아니면 거절하세요. 거절해도 계정에는 아무 변화가 없고, 나중에 그 앱에서 다시 요청하면 이 화면이 또 열립니다. 반대로 허용하면 그 앱은 내 계정으로 시스템을 쓰기 시작하므로, 앱 이름과 돌아갈 곳을 먼저 확인하세요.
아직 가입 전이면 허용할 수 없습니다. 화면에 «회원 가입 뒤에 사용할 수 있습니다»가 뜹니다 — 먼저 가입을 마치고 다시 시도하세요.
규정 도우미 v0.2.9
화면 오른쪽 아래 동그란 버튼 — 로그인한 사람은 누구나
동아리 규정을 찾아 출처와 함께 답해주는 도우미입니다. 운영관리 어드민의 모든 화면 오른쪽 아래에 동그란 버튼으로 표시됩니다. 버튼을 눌러 질문할 수 있습니다. 사이드바 메뉴에는 없고 이 버튼으로만 엽니다. 화면을 옮겨 다녀도 주고받던 대화는 그대로 남습니다.
질문에는 별도 권한이 필요하지 않습니다. 로그인한 회원은 누구나 사용할 수 있습니다. 뒤에 나오는 RAG 설정(문서를 올리고 관리하는 화면)만 별도 권한이 필요합니다.
규정 도우미 — 오른쪽 아래 버튼으로 열립니다
답을 읽는 법 — 근거가 함께 옵니다
답변 본문의 [제7조] 같은 표시는 그 문장이 어느 조항에서 나왔는지를
가리킵니다. 바로 아래 답변 근거 보기를 펼치면 같은 표시가 붙은 카드가 나오고,
거기에 조항 제목과 원문 발췌가 표시됩니다. 답변과 근거 카드에는 같은 조항
표시를 사용합니다.
| 화면 요소 | 뜻 |
|---|---|
| 답변 위의 작은 배지 | 무엇을 근거로 답했는지 — 예: 2026-03-24부터 쓰이는 회칙 기준. 아직 답변에 쓰이지 않는 문서로 답했다면 그 사실도 여기 적힙니다. |
| 답변 근거 보기 (n) | 펼치면 인용 카드가 나옵니다. 괄호 안 숫자가 인용 개수입니다. |
| 카드 왼쪽 표시 | 제7조·부칙 제3조처럼 조항이거나, PDF 문서면 p.12처럼 쪽수입니다. |
| ▍ 깜빡이는 막대 | 답변을 작성 중이라는 표시입니다. 답변이 끝나면 사라집니다. |
도우미는 규정 조회만 합니다. 승인·반려 같은 처리는 화면에서 직접 해야 합니다. 도우미에게 요청해도 업무 상태는 바뀌지 않습니다.
근거를 못 찾으면 답하지 않습니다
규정에 없는 것을 물으면 지어내지 않고 «질문에 답할 근거를 찾지 못했습니다»로 끝냅니다. 이때는 인용 카드도 붙지 않습니다 — 근거가 없다는 뜻이므로, 그대로 운영진에게 문의하시면 됩니다.
처음 열었을 때 뜨는 안내
문서가 준비되지 않았으면 현재 상태에 맞는 안내가 표시됩니다. 문서가 없는 경우와 문서는 있지만 답변에 사용하지 않는 경우의 안내가 다릅니다. 문서를 관리하는 권한이 있으면 같은 자리에 다른 문장이 뜹니다 — 그 사람은 직접 고칠 수 있으므로 안내가 RAG › 설정으로 데려갑니다.
| 상황 | 보통 회원에게 | 문서 관리 권한자에게 |
|---|---|---|
| 올라온 문서가 없다 | 아직 규정 문서가 없어 답할 수 없습니다 운영진이 먼저 문서를 올려야 합니다. |
아직 등록된 규정 문서가 없습니다 — RAG › 설정에서 올려주세요 링크를 누르면 문서를 올리는 화면으로 갑니다. |
| 문서는 있지만 «답변에 사용»이 켜지지 않았다 | 아직 답변에 쓰이는 규정 문서가 없습니다 — 운영진에게 문의해주세요 | 올린 문서가 아직 답변에 쓰이지 않습니다 — RAG › 설정에서 «답변에 사용»을 눌러야 답변에 쓰입니다 링크가 «미사용» 문서만 걸러 보여줍니다. |
| 물어봐도 되는 상태다 | 이런 것을 물어볼 수 있어요 — 아래 예시 질문을 누르면 바로 물어봅니다. | |
대화 지우기 ↺
도우미는 앞선 질문을 기억하고 이어서 답합니다. 화제를 완전히 바꾸고 싶으면 머리말의 ↺(대화 지우기)를 누릅니다 — 확인을 한 번 받고 지웁니다. 되살릴 수 없으니 남겨야 할 조항은 먼저 옮겨 적어두세요. 주고받은 것이 없으면 이 버튼은 보이지 않습니다.
너무 자주 물으면 잠시 막힙니다. «질문이 너무 많습니다 — 잠시 후 다시 시도해주세요»가 뜨면 잠깐 기다렸다 다시 물어보세요. 질문은 한 번에 1,000자까지입니다.
RAG 설정 — 도우미가 읽을 문서 v0.2.9
/ragsettings 사이드바 RAG › 설정
앞 절의 도우미가 무엇을 근거로 답할지를 정하는 화면입니다. 규정 문서를 올리고, 색인이 끝났는지 보고, 어느 문서를 실제 답변에 쓸지 켜고 끕니다.
이 메뉴는 규정 문서 관리 권한자에게만 보입니다(RAG_DOCUMENT_MANAGE). 목록을 여는 것까지 이 권한이 필요해서, 권한이 없으면 사이드바에 RAG 묶음 자체가 보이지 않습니다. 도우미에게 묻는 것은 권한이 필요 없다는 점과 다릅니다.
회칙 82 KB64개 청크2026-03-24 색인 완료 답변에 사용 중 답변에서 영구 제외 · 재색인 · 삭제
일반 문서 1.2 MB—2026-09-16 색인 중 미사용 답변에 사용 · 재색인 · 삭제
올린 문서는 «미사용»으로 등록됩니다. «답변에 사용»을 눌러야 도우미가 그 문서로 답합니다. 개정된 규정을 올릴 때는 옛 문서를 지워주세요. 남겨 두면 옛 조항과 새 조항이 섞여 답합니다.
RAG 설정 — /ragsettings
색인 상태와 적용 상태
상태는 문서 색인 진행 상황을, 적용은 답변에 사용하는지를 나타냅니다. 색인 완료 + 미사용은 색인은 끝났지만 답변에는 사용하지 않는 문서입니다.
| 상태 (색인) | 뜻 |
|---|---|
| 대기 | 차례를 기다립니다. 곧 읽기 시작합니다. |
| 색인 중 | 문서를 색인 중입니다. 화면이 몇 초마다 상태를 자동으로 확인합니다. |
| 색인 완료 | 다 읽었습니다. 이제 «답변에 사용»을 누를 수 있습니다. |
| 실패 ⓘ | 읽지 못했습니다. ⓘ에 마우스를 올리면 이유가 나옵니다 — 대개 파일이 깨졌거나 형식이 맞지 않습니다. |
| 적용 | 뜻 |
|---|---|
| 미사용 | 올라와 있지만 답변에 쓰이지 않습니다. 올린 직후가 이 상태입니다. |
| 답변에 사용 중 | 도우미가 이 문서로 답합니다. |
| 제외됨 | 답변에서 영구 제외한 문서입니다. 되돌릴 수 없습니다. 다시 쓰려면 같은 파일을 새로 올려야 합니다. |
문서를 올리는 순서
- 1오른쪽 위 + 문서 업로드«규정 문서 올리기» 창이 열립니다.
- 2파일을 끌어다 놓거나 눌러서 고른다.md · .pdf · .docx, 최대 10MB. 그 밖의 파일은 고르는 순간 막힙니다.
- 3표시명을 적는다(선택)비우면 파일 이름을 그대로 씁니다.
- 4올리기«미사용 · 대기»로 들어오고, 잠시 뒤 색인이 시작됩니다.
- 5색인 완료를 기다렸다가 답변에 사용이걸 눌러야 도우미가 그 문서로 답하기 시작합니다.
색인 중에 화면을 계속 보고 있을 필요는 없습니다. 진행 중인 문서가 있으면 화면이 몇 초마다 상태를 자동으로 확인합니다. 색인이 끝나면 확인도 중지됩니다.
개정판을 올릴 때 — 옛 문서를 꼭 지웁니다
새 규정을 올리기만 하고 옛 문서를 두면 둘이 섞여 답합니다. 도우미는 답변에 쓰이는 문서를 전부 근거로 삼기 때문에, 폐지된 조항과 새 조항이 한 답변에 함께 나올 수 있습니다. 개정판을 올렸다면 옛 문서를 지우거나 «답변에서 영구 제외»하세요.
세 가지 조작
| 버튼 | 하는 일 |
|---|---|
| 답변에 사용 | 이 문서로 답하기 시작합니다. 색인이 끝나야 누를 수 있습니다. 확인을 한 번 받습니다. |
| 답변에서 영구 제외 | 답변 근거에서 빼고 색인된 내용도 지웁니다. 되돌릴 수 없습니다 — 확인을 받습니다. |
| 재색인 | 문서를 다시 읽습니다. 되돌릴 것이 없어 확인 없이 바로 실행됩니다. |
| 삭제 | 문서·색인·원본 파일이 함께 사라집니다. 지금 답변에 쓰이는 문서면 경고 문구가 달라집니다. 되살리려면 같은 파일을 다시 올려야 합니다. |
위 카드 셋과 표의 숫자가 다를 때
맨 위 등록 문서 · 색인 완료 · 총 청크는 언제나 전체 문서를 셉니다. 검색어를 넣거나 «미사용만 보는 중» 같은 필터를 걸면 표의 행 수만 줄고 카드 숫자는 그대로입니다. 잘못 센 것이 아닙니다.
AI 클라이언트 연결 v0.2.9
Claude · Codex · Antigravity에서 운영 업무를 대화로 — 운영진용
쓰던 AI 클라이언트에 운영 시스템을 연결하면, 화면을 열지 않고 대화로 물어보고 처리할 수 있습니다. "이번 주 마감인 하위 업무 뭐 있어?", "부스 배치도 확정 완료 승인 요청해 줘"처럼 말하면 클라이언트가 시스템을 직접 부릅니다.
운영진을 위한 기능입니다. 연결한 사람의 권한 그대로 동작하므로, 화면에서 못 하는 일은 여기서도 안 됩니다. 부원에게 안내할 기능이 아닙니다.
무엇을 시킬 수 있나
| 묶음 | 할 수 있는 것 | 추가 |
|---|---|---|
| 읽기 | 운영 통합 현황 · 업무 상세 · 하위 업무 목록과 상세 · 회의 목록과 상세 · 내 계정(내 권한 확인) | v0.2.9 |
| 하위 업무 | 상태 넘기기(착수 · 완료 승인 요청 · 승인 · 반려) · 완료 점검 항목 체크 | v0.2.9 |
지금 할 수 있는 것은 이 둘입니다. 업무·회의 등록과 수정, 정족수 투표, 승인함·대시보드 조회는 다음 배포에 열립니다. 회원 · 폼 · 행사 · 학술은 그 뒤 차례로 넣습니다. 지우는 것은 어느 것도 대화로 되지 않습니다 — 삭제는 화면에서만 합니다.
연결하는 법
붙일 주소는 어디서나 같습니다 — https://api.sscc-ssu.com/mcp.
처음 붙일 때 브라우저가 열리고 구글 로그인과 허용 화면을 지납니다(아래).
기능은 v0.2.9에 들어왔고 실서비스에서 실제로 붙을 수 있게 된 것은 v0.2.10부터입니다.
| 클라이언트 | 하는 법 |
|---|---|
| Claude (claude.ai · 데스크톱 앱) |
설정 → 커넥터 → 사용자 지정 커넥터 추가에 위 주소를 넣습니다. 요금제에 따라 이 메뉴가 없을 수 있습니다 — 그때는 Claude Code를 쓰세요. |
| Claude Code | claude mcp add --transport http ssccops https://api.sscc-ssu.com/mcp
→ 세션에서 /mcp → Authenticate. |
| Codex CLI | codex mcp add ssccops --url https://api.sscc-ssu.com/mcp
→ codex mcp login ssccops. |
| Antigravity | 에이전트 패널 → MCP Servers → 서버 추가에 위 주소를 넣고 로그인을 누릅니다.
설정 파일을 직접 고친다면 ~/.gemini/antigravity/mcp_config.json의
mcpServers에
{"ssccops": {"serverUrl": "https://api.sscc-ssu.com/mcp"}}. |
| Gemini CLI | gemini mcp add -t http ssccops https://api.sscc-ssu.com/mcp
→ 세션에서 /mcp auth ssccops. |
처음 한 번 — 허용 화면
연결을 시작하면 브라우저에 운영 시스템 로그인이 뜨고, 로그인하면 그 앱이 무엇을 요청하는지 보여 주는 화면이 나옵니다. 여기서 허용을 눌러야 연결이 끝납니다 — 그 화면을 읽는 법은 외부 앱 접근 승인(27)에 있습니다. 앱 이름과 돌아갈 곳이 기대한 것과 다르면 거절하세요.
알아 둘 것
| 항목 | 내용 |
|---|---|
| 권한 | 연결한 본인의 권한 그대로입니다. 권한이 없으면 "권한이 없습니다"로 끝나며, 대화로 조른다고 열리지 않습니다. |
| 기록 | 상태 변경 같은 조작은 화면에서 한 것과 똑같이 기록에 남습니다. 기록에는 그 일을 화면에서 했는지 AI에서 했는지도 함께 남습니다. |
| 확인 | 바꾸는 일은 클라이언트가 실행 전에 물어봅니다. 무엇을 바꾸는지 읽고 누르세요 — 습관적으로 넘기면 원치 않은 변경이 들어갑니다. |
| 개인정보 | 회원 이름은 오가지만 연락처·이메일·학번은 나가지 않습니다. 대화 내용은 각 AI 업체 서버에 남으므로, 대화를 외부에 공유할 때는 명단이 섞여 있지 않은지 보세요. |
| 연결 끊기 | 클라이언트의 커넥터·MCP 목록에서 지우면 됩니다. |
잘 안 될 때
| 증상 | 보는 곳 |
|---|---|
| "가입이 필요합니다" | 운영 시스템에 아직 가입하지 않은 계정입니다. 웹에서 먼저 가입하세요. |
| "권한이 없습니다" | 내 권한으로 막힌 것입니다. 내 계정에게 물어 어떤 권한이 있는지 확인하고, 필요하면 운영진에게 권한을 요청하세요. |
| 도구 목록이 옛날 그대로 | 도구 목록은 연결할 때 한 번 가져옵니다. 기능이 늘었는데 안 보이면 연결을 끊었다 다시 붙이세요. |
| 로그인 창이 안 뜬다 | 브라우저가 기본 브라우저로 열리는지 확인하고, 그래도 안 되면 클라이언트를 껐다 켜고 다시 시도하세요. |
상태 변화 기준
배지와 칩이 표시되는 기준
화면의 배지와 칩은 정해진 기준에 따라 자동으로 표시됩니다. 표시된 배지의 의미와 처리 방법을 아래 표에서 확인할 수 있습니다.
같은 업무에는 대시보드·목록·상세 어디에서나 같은 배지가 표시됩니다. 기준일은 한국 시간(Asia/Seoul) 기준 오늘 0시이며, 날짜 단위로 비교합니다 — 시·분은 판정에 쓰이지 않습니다.
절차 정체 — 요청 전 · 승인 정체
요청 전과 승인 정체는 마감이 아니라 승인 절차가 멈춘 상태를 나타냅니다. 마감 배지(마감임박·지연)와 함께 표시될 수 있으며, 각 배지의 처리 담당자가 다릅니다.
| 배지 | 붙는 기준 | 다음에 누가 무엇을 하나 |
|---|---|---|
| 요청 전 | 완료 점검 목록을 전부 체크했는데 아직 완료 승인 요청을 누르지 않은 하위 업무 | 담당자가 완료 승인 요청을 누릅니다. 이후 승인자가 처리합니다. |
| 승인 정체 | 완료 승인 요청 후 3일이 지났는데 아직 승인도 반려도 되지 않은 하위 업무 | 승인자가 완료 승인 또는 반려를 누릅니다. 정족수가 있는 유형이면 정족수부터 채웁니다. |
승인 정체는 승인 요청이 3일 넘게 처리되지 않았다는 뜻입니다. 마감일과 관계없이 표시되며, 승인하거나 반려하면 사라집니다.
두 배지는 대시보드(승인 대기 목록 · 내 업무 목록)와 하위 업무 목록에 함께 나타나며, 하위 업무 목록에서는 같은 이름의 필터 칩으로 그것만 모아 볼 수 있습니다. 대시보드의 승인 대기 목록에는 승인 요청을 마친 업무만 나오므로 승인 정체만 표시됩니다.
마감 — 마감임박 · 지연 · D-표기
| 배지 | 붙는 기준 | 같이 알아둘 것 |
|---|---|---|
| 마감임박 | 마감일까지 3일 이내(오늘 포함)이고 아직 완료되지 않은 건 | "3일"은 화면이 정한 기준입니다. |
| 지연 | 마감일이 오늘 0시보다 이전이고 아직 완료되지 않은 건 | 마감 당일은 지연이 아닙니다 — 그날 자정까지는 D-DAY입니다. |
| D-3 · D-1 | 마감까지 남은 일수 | 날짜 단위로 셉니다. |
| D-DAY | 오늘이 마감일 | 아직 지연이 아닙니다. |
| D+2 | 마감일을 2일 넘긴 상태 | 지연 배지와 함께 붙습니다. |
완료된 건에는 마감 배지가 하나도 붙지 않습니다. 마감일이 지난 뒤에 완료했더라도 지연으로 남지 않습니다 — 끝난 일에 "3일 남음"도 "지연"도 의미가 없기 때문입니다. 마감일을 넣지 않은 건도 마찬가지로 어떤 마감 배지도 붙지 않습니다.
업무 · 하위 업무 — 단계와 승인
업무_상태는 네 단계를 순서대로 진행합니다. 단계를 건너뛸 수 없으며, 화면에는 현재 단계에서 할 수 있는 버튼만 표시됩니다.
| 상태 | 이 상태가 되는 조건 | 다음 동작 |
|---|---|---|
| 기획 | 등록하면 여기서 시작합니다 | 착수 → 진행 |
| 진행 | 담당자가 착수를 눌렀을 때 | 완료 승인 요청 → 검토. 완료 점검을 전부 체크해야 누를 수 있습니다. |
| 검토 | 담당자가 완료 승인 요청을 눌렀을 때 | 완료 승인 → 완료 · 반려 → 진행 |
| 완료 | 승인자가 완료 승인을 눌렀을 때 | 마지막 단계입니다. |
반려하면 진행으로 돌아갑니다 — 기획이 아닙니다. 담당자가 지적된 부분만 고쳐 다시 완료 승인 요청을 하면 됩니다. 완료 점검이 덜 끝난 업무도 반려할 수 있습니다.
승인_상태는 업무_상태와 별도로 관리되며, 승인이 필요한 유형에만 적용됩니다.
| 승인_상태 | 뜻과 기준 |
|---|---|
| 불필요 | 이 하위 업무 유형이 승인을 요구하지 않습니다 — 승인 없이 완료됩니다. |
| 대기 | 승인 요청이 올라가 승인자의 처리를 기다리는 중입니다. 이 상태로 3일이 지나면 승인 정체가 붙습니다. |
| 승인 | 승인자가 완료 승인했습니다. |
| 반려 | 승인자가 반려했습니다 — 업무_상태는 진행으로 돌아가 있습니다. |
| 재승인필요 | 승인 뒤 내용이 바뀌어 다시 승인을 받아야 합니다. |
완료 승인 버튼이 잠기는 이유는 셋이고 서로 다릅니다. ① 권한이 없다 — 버튼에 마우스를 올리면 필요한 권한 이름이 뜹니다. ② 완료 점검이 덜 됐다 — 목록을 전부 체크해야 합니다. ③ 정족수가 모자란다 — 필요한 찬성 수를 채워야 누를 수 있습니다. 정족수를 채워도 완료는 승인자가 누릅니다 — 표는 승인자를 대신하지 않고, 승인자라도 정족수 전에는 누를 수 없습니다.
폼과 응답
| 상태 | 이 상태가 되는 조건 |
|---|---|
| 작성 중 | 폼을 만들었지만 아직 접수를 열지 않았습니다 — 응답자에게 링크를 줘도 열리지 않습니다. |
| 접수 중 | 접수를 열었고 접수 기간 안입니다 — 응답자가 제출할 수 있습니다. |
| 마감 | 접수를 닫았거나 접수 종료 일시가 지났습니다. |
문항이 하나도 없는 폼은 접수를 열 수 없습니다 — 열려고 하면 문항을 먼저 등록하라는 안내가 뜹니다. 기획안 승인으로 자동 생성된 모집 폼이 그렇습니다.
| 응답 상태 | 이 상태가 되는 조건 |
|---|---|
| 작성 중(미제출) | 응답자가 쓰다 말고 아직 제출하지 않았습니다 — 심사 대상이 아닙니다. |
| 제출 | 응답자가 제출했고 아직 처리되지 않았습니다. |
| 수정요청 | 검토자가 보완을 요청했습니다 — 응답자가 고쳐서 다시 낼 수 있습니다. |
| 승인 | 검토자가 승인했습니다. 되돌릴 수 없습니다. |
| 반려 | 검토자가 반려했습니다. 되돌릴 수 없고 응답자는 다시 낼 수 없습니다. |
승인·반려 뒤에는 검토 패널이 잠깁니다. 응답자가 내용을 고칠 수 있게 하려면 수정요청을 사용하세요. 반려된 응답은 다시 제출할 수 없습니다.
학술 — 활동 · 회차 · 출석
| 활동 상태 | 이 상태가 되는 조건 |
|---|---|
| 승인 | 기획안이 승인돼 활동이 만들어졌습니다 — 아직 모집 전입니다. |
| 진행 중 | 국장이 모집 시작을 눌렀을 때. 모집과 운영이 같은 상태입니다 — "모집 중"이라는 별도 상태는 없습니다. |
| 수료 | 활동이 끝나 수료 처리됐습니다. |
| 회차 상태 | 이 상태가 되는 조건 | 다음에 누가 |
|---|---|---|
| 미제출 | 커리큘럼에는 있지만 스터디장이 아직 기록을 내지 않았습니다 | 스터디장이 회차 기록을 제출합니다. |
| 제출 | 스터디장이 제출했고 국장의 처리를 기다립니다 | 국장이 승인 또는 수정요청을 누릅니다. |
| 수정요청 | 국장이 보완을 요청했습니다 | 스터디장이 고쳐서 다시 제출합니다. |
| 승인 | 국장이 승인했습니다 | 끝입니다 — 되돌릴 수 없고 출석도 더는 고칠 수 없습니다. |
출석 정정은 승인 전까지만 됩니다. 출석부에서 칸이 잠겨 눌리지 않는다면 그 회차가 이미 승인된 것입니다. 출석률이 70% 미만인 팀원은 목록에서 눈에 띄게 표시됩니다 — 수료 기준(전체 회차의 3분의 2 이상 출석)에 미치지 못할 수 있다는 신호입니다.
행사와 참가자
| 상태 | 이 상태가 되는 조건 |
|---|---|
| 작성 중 | 행사를 만들었지만 아직 공개하지 않았습니다 — 공개 웹사이트에 보이지 않습니다. |
| 게시 | 공개했습니다 — 누구나 공개 웹사이트에서 볼 수 있습니다. |
| 보관 | 끝난 행사를 기본 목록에서 숨긴 상태입니다. |
| 확정 | 참가가 확정된 신청자입니다. |
| 대기 | 정원이 찼거나 심사 중이라 대기로 둔 신청자입니다. |
| 취소 | 신청이 취소됐습니다 — 등록할 때 처음부터 이 상태로 둘 수는 없습니다. |
정원을 넘겨도 확정을 막지 않습니다. 정원은 참고치라 넘으면 경고 문구만 뜨고 버튼은 잠기지 않습니다 — 실제로 몇 명을 받을지는 운영진이 정합니다.
배지 · 표기 범례
화면 전반에서 반복되는 시각 표기
상태 배지 톤
마감 표기
| 배지 | 의미 |
|---|---|
| D-3, D-1 … | 마감까지 남은 일수 |
| D-DAY | 오늘이 마감일 — 아직 지연은 아닙니다 |
| D+2 · 지연 | 마감을 넘긴 상태. 빨간 글자·배지로 표시됩니다 |
| 마감임박 | 마감 3일 이내 |
목록을 넘기는 두 가지 방식
목록에는 페이지 번호로 바로 이동하는 기능이 없습니다. 화면에 따라 둘 중 하나입니다. 업무·하위 업무·승인함처럼 더 보기 버튼으로 다음 항목을 아래에 추가하는 곳과, 회원 목록처럼 한 번에 한 쪽씩 이전·다음으로 옮기는 곳입니다.
| 방식 | 쓰는 곳과 특징 |
|---|---|
| 더 보기 | 누를 때마다 다음 항목이 아래에 추가됩니다. 업무·하위 업무·승인함·폼·행사 등 대부분의 목록에서 사용합니다. |
| ◀ 이전 · 다음 ▶ v0.2.3 | 회원 목록입니다. 한 번에 한 쪽만 보이고 가운데에 21–40 / 전체 137명처럼 지금 위치가 적힙니다. 검색어·등급·상태·정렬과 현재 쪽이 주소에 담겨 있어, 상세에 다녀오거나 새로고침해도 보던 자리로 돌아옵니다. 페이지 번호를 눌러 뛰는 기능은 없습니다. |
권한 안내
버튼이 안 눌리거나 메뉴가 안 보일 때
권한이 없는 메뉴는 숨기고, 사용할 수 없는 버튼은 잠긴 상태로 표시합니다. 잠긴 버튼에 마우스를 올리면 필요한 권한을 확인할 수 있습니다.
권한 안내 문구는 한 가지 모양입니다 v0.2.9
권한이 없어 막혔을 때 화면은 언제나 «무엇이 안 되나 — 어떤 권한이 필요한가» 한 줄로 말합니다. 권한 이름과 괄호 안 코드를 함께 표시하므로, 문구를 운영진에게 전달하면 필요한 권한을 확인할 수 있습니다.
라벨을 관리할 권한이 없습니다 — 폼 라벨 관리(FORM_LABEL_MANAGE) 권한이 필요합니다
규정 문서를 관리할 권한이 없습니다 — 규정 문서 관리(RAG_DOCUMENT_MANAGE) 권한이 필요합니다
권한 오류 문구 — 화면이 쓰는 한 가지 형식
예전처럼 «운영진 권한이 필요합니다»·«회장·부회장만»처럼 역할 서열로 설명하지 않습니다 — 막힌 사람도, 권한을 주려는 사람도 무엇이 필요한지 알 수 없기 때문입니다.
| 증상 | 의미 |
|---|---|
| 버튼이 흐리게 잠겨 있다 | 그 동작에 필요한 권한이 없습니다. 마우스를 올리면 어떤 권한이 필요한지 나옵니다. |
| 멀쩡하던 화면에서 갑자기 403 | 권한이 방금 바뀐 것입니다. 화면이 자동으로 최신 상태로 다시 맞춥니다 — 그래도 안 되면 새로고침하세요. |
| 조회는 되는데 저장만 안 된다 | 조회 권한과 쓰기 권한이 분리된 화면입니다(하위 업무 유형 관리 등). 정상 동작입니다. |