> For the complete documentation index, see [llms.txt](https://guides.reallivesworld.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides.reallivesworld.com/school-home/school-dbg-admin-and-teacher-ko/getting-started/publish-your-docs.md).
# 학생 및 교사 관리
**이 섹션이 중요한 이유**
학생과 교사를 올바르게 설정하는 것은 플랫폼의 나머지 모든 기능의 기초입니다. 수업, 과제, 진행 상황 추적, 라이선스는 모두 여기의 정확하고 최신 기록에 달려 있습니다. 사람을 추가하는 방법은 두 가지가 있습니다:
* **한 명씩** — 새로운 가입자가 드물게 생겼을 때나 몇 명만 추가하면 될 때 유용합니다
* **한 번에 모두** — 스프레드시트 업로드를 사용하며, 전체 학년 그룹이나 교직원 명단을 등록할 때 훨씬 더 빠릅니다
***
**시작하기 전에 — 몇 가지 중요한 확인 사항**
누군가를 추가하거나 가져오기 전에 잠시 멈추고 몇 가지를 확인해 두는 것이 좋습니다:
* School Admin 계정으로 로그인되어 있습니다
* 학급 또는 학년 구조가 이미 설정되어 있거나 최소한 종이 위에라도 정리되어 있습니다
* 대시보드에서 최신 가져오기 템플릿을 다운로드했습니다(오래된 템플릿은 사용하지 마세요)
* 필수 입력 항목이 무엇인지, 각 항목의 이름을 어떻게 써야 하는지 알고 있습니다
* 예를 들어, 학교에서 학년명을 어떤 형식으로 표기하는지 분명히 알고 있습니다 *9학년*, *10학년*등으로 표기하며, 그 형식을 일관되게 사용할 것입니다
시작하기 전에 이 부분들을 제대로 해두면 나중에 번거롭게 수정할 일을 크게 줄일 수 있습니다.
***
### 학생
***
#### **1. 학생 한 명 추가하기**
학생 한 명만 추가하면 되거나, 한 번에 몇 명씩만 추가하면 될 때 가장 적합한 방법입니다.
**단계**
1. 클릭하세요 **학생** 왼쪽 메뉴에서
2. 클릭 **학생 추가** 또는 **학생 초대**
3. 단일 학생 추가를 클릭하세요
4. 학생 정보를 입력하세요 — 일반적으로 이름, 이메일 주소, 학년, 학급 또는 반입니다
5. 목록에서 올바른 학년을 선택했는지 확인하세요
6. 양식에서 요청하면 학생을 학급에 배정하세요(일부 설정에서는 나중에 할 수도 있습니다)
7. 다음으로 넘어가기 전에 잠시 철자와 세부 정보를 다시 확인하세요
8. 클릭 **제출** 또는 **초대 보내기** 만족스러울 때
***
**정확하게 하는 데 도움이 되는 몇 가지 팁**
* 가능하면 학생의 공식 학교 이메일 주소를 사용하세요
* 선택한 학년이 학교의 승인된 학년 목록과 정확히 일치하는지 확인하세요
* 학교 보고서에 별명이나 약칭이 아니라 법적 이름이 필요하다면 전체 이름으로 작성하세요
* 가능하면 학생을 바로 학급에 배정하세요. 나중에 배정하면 어떤 과제를 볼 수 있는지에 문제가 생길 수 있습니다
***
#### **2. 여러 학생을 한 번에 가져오기**
전체 학급, 학년 그룹을 등록하거나 학기 시작 시 대규모 업데이트를 할 때 학생을 추가하는 가장 빠른 방법입니다.
**1단계: 학생 가져오기 열기**
사이드바에서 **학생** 로 이동한 뒤 학생 초대 옵션을 찾으세요. 거기서 여러 학생 추가를 클릭하고 학생을 가져올 학년을 선택한 다음, 시작점으로 사용할 최신 템플릿을 다운로드할 수 있습니다.
***
**2단계: 스프레드시트 작성**
템플릿을 따라 학생 정보를 입력하세요. 열 구조가 정확히 맞아야 하므로, 직접 새로 만들지 말고 다운로드한 템플릿을 그대로 사용하세요.
스프레드시트에는 일반적으로 다음 열이 있습니다:
* 이름
* 성
* 이메일
***
**3단계: 학년을 올바르게 입력하기**
이 부분이 다른 어떤 것보다도 가장 헷갈리기 쉽기 때문에, 특히 주의할 가치가 있습니다.
학교의 학년 목록은 초기 등록 과정에서 설정되지만, 변경이 필요하면 플랫폼 관리자가 수정할 수 있습니다. 스프레드시트를 작성하기 전에 현재 승인된 학년 목록이 어떻게 되어 있는지 반드시 확인하세요.
* 학교에 설정된 학년 값만 사용하세요
* 전체 문서에서 형식을 일관되게 유지하세요 — 예를 들어 항상 *6학년*으로 쓰고, *6*, *grade6*또는 *G6*
* 와 혼용하지 마세요
* 플랫폼 관리자가 먼저 학년 목록을 업데이트하지 않았다면 새 학년 이름을 만들지 마세요
학년이 올바르게 입력되지 않으면 가져오기가 실패하거나 학생이 잘못된 학년 그룹에 들어갈 수 있으며, 나중에 수정하는 데 추가 작업이 필요합니다.
***
**4단계: 업로드하기 전에 파일 확인**
업로드하기 전에 몇 분만 투자해서 파일에 다음이 있는지 확인하세요:
* 같은 이메일 주소가 두 번 이상 나타나는 경우
* 비워 둔 필수 입력 항목
* 형식이 이상해 보이는 이메일 주소
* 승인된 목록과 일치하지 않는 학년 이름
* 셀 시작이나 끝에 있는 불필요한 공백(놓치기 쉽습니다)
* 복사 및 붙여넣기 과정에서 생긴 이상한 오류
지금 간단히 확인해 두면 나중에 번거로움을 크게 줄일 수 있습니다.
***
**5단계: 파일 업로드**
완성한 스프레드시트를 업로드하고 플랫폼의 유효성 검사에서 처리될 때까지 잠시 기다리세요.
***
**6단계: 결과 검토**
플랫폼에 다음이 표시됩니다:
* 성공적으로 가져온 행
* 실패한 행과 그 이유
* 주의해야 할 경고
일부 행이 실패했다면 스프레드시트에서 그 부분만 수정한 뒤 수정된 항목만 다시 업로드하세요. 전체 파일을 다시 업로드할 필요는 없습니다.
***
**7단계: 가져오기 확인**
모든 것이 좋아 보이면 가져오기를 확인하고 완료 메시지가 뜰 때까지 기다린 후 다음으로 넘어가세요.
***
**8단계: 이후 간단히 점검하기**
가져오기가 끝나면 잠시 다음을 확인하세요:
* 학생 수가 올바른 만큼 늘었는지
* 학년이 올바르게 배정되었는지
* 학급 배정이 맞는지(가져오기에서 포함했다면)
* 초대 또는 활성화 상태가 예상대로 표시되는지
무언가 이상하다면, 교사가 데이터를 사용하기 시작한 뒤보다 지금 고치는 것이 훨씬 쉽습니다.
***
#### **가져오기에서 문제가 생겼을 때**
첫 업로드가 완벽하게 되지 않아도 걱정하지 마세요 — 흔한 일이며, 플랫폼이 보통 무엇을 수정해야 하는지 정확히 알려줍니다. 가장 흔한 문제와 해결 방법은 다음과 같습니다:
| 무엇이 잘못되었는지 | 해결 방법 |
| -------------------- | ---------------------------------------------------------- |
| **이메일 주소가 유효하지 않음** | 형식을 확인하세요 — 다음과 같아야 합니다 — 그런 다음 다시 시도하세요 |
| **중복 이메일 주소** | 각 학생에게는 고유한 이메일 주소가 필요합니다. 중복된 항목은 제거하거나 수정하세요 |
| **학년이 비어 있음** | 학교에서 승인한 학년 값 중 하나를 사용해 학년 칸을 채우세요 |
| **학년 이름이 인식되지 않음** | 학교에서 사용하는 올바른 학년 레이블로 바꾸세요. 예를 들어 *6학년* |
| **필수 입력 항목이 비어 있음** | 돌아가서 필수로 표시된 모든 열을 채우세요 |
| **파일이 템플릿과 일치하지 않음** | 대시보드에서 최신 템플릿을 다시 다운로드한 뒤 데이터를 새로 복사해 넣으세요 |
한 번에 오류가 많이 보인다면, 하나씩 왔다 갔다 하기보다 스프레드시트에서 먼저 모두 수정한 뒤 한 번에 깔끔하게 다시 업로드하는 것이 보통 더 좋습니다.
***
### 교사
***
#### **교사 한 명 추가하기**
새 교사를 추가하거나, 대체 교사를 투입하거나, 한두 명만 설정하면 될 때 가장 적합합니다.
**단계**
1. 클릭하세요 **교사** 왼쪽 메뉴에서
2. 클릭 **교사 한 명 추가**
3. 세부 정보를 입력하세요 — 일반적으로 이름, 이메일 주소, 역할입니다
4. 양식에서 해당 옵션을 제공하면 교사를 하나 이상의 학급에 배정하세요
5. 학교 설정에서 허용한다면 여기에서 권한도 설정하세요
6. 클릭 **제출** 또는 **초대 보내기** 완료되면
***
**정확하게 하는 데 도움이 되는 몇 가지 팁**
* 교사의 공식 학교 또는 기관 이메일 주소를 사용하세요
* 교사를 학급에 배정하기 전에, 그 학급이 담당 과목 또는 학년과 맞는지 다시 확인하세요
* 승급된 권한은 교사가 정말로 필요로 할 때만 활성화하세요 — 나중에 추가하는 것이 되돌리는 것보다 쉽습니다
* 각 학급에는 책임자가 분명한 한 명의 담임 교사가 있도록 하여, 누가 담당자인지 혼동이 없게 하세요
***
### 여러 교사를 한 번에 가져오기
학기 시작 시 교직원을 설정하거나 교직원 구성을 크게 변경할 때 가장 쉬운 방법입니다.
**1단계: 교사 가져오기 열기**
사이드바에서 **교사** 사이드바에서
***
**2단계: 템플릿 다운로드**
대시보드에서 제공되는 템플릿을 다운로드하세요. 이전 학기에 저장해 둔 것이 아니라 현재 버전을 사용하고 있는지 확인하세요. 업데이트 사이에 내용이 바뀔 수 있습니다.
***
**3단계: 스프레드시트 작성**
템플릿을 따라 교사 정보를 입력하세요. 학교 설정에 따라 다음과 같은 열이 보일 수 있습니다:
* 이름
* 성
* 이메일
템플릿의 구조를 그대로 따르고, 어떤 열도 추가·삭제·이름 변경하지 마세요.
***
**4단계: 업로드하기 전에 파일 확인**
업로드하기 전에 다음을 확인하세요:
* 모든 교사에게 고유한 이메일 주소가 있음
* 모든 이메일 주소가 올바른 형식임
* 모든 필수 입력 항목이 채워져 있음
* 역할 값이 플랫폼에서 기대하는 값과 일치함
* 포함했다면 학급 참조가 올바르게 보임
***
**5단계: 업로드 및 검토**
파일을 업로드하고 유효성 검사 보고서를 기다리세요. 여기에는 어떤 행이 성공했고 어떤 행을 확인해야 하는지가 표시됩니다.
***
**6단계: 오류 수정 후 다시 업로드**
일부 행이 실패했다면, 스프레드시트에서 해당 기록만 수정한 뒤 다시 업로드하세요. 전체 파일을 다시 제출할 필요는 없습니다.
***
**7단계: 모든 것이 올바른지 확인**
가져오기가 완료되면 잠시 다음을 확인하세요:
* 모든 교사 기록이 생성되었는지
* 초대 또는 계정 상태가 올바르게 표시되는지
* 학급 배정이 예상대로 반영되었는지
* 권한 설정이 학교 정책과 일치하는지
지금 이상한 점을 발견하는 것이, 교사들이 이미 플랫폼을 사용하기 시작한 뒤에 처리하는 것보다 훨씬 쉽습니다.
***
#### **교사 가져오기에 문제가 생겼을 때**
학생 가져오기와 같은 규칙이 적용됩니다. 가장 흔한 문제는 역할 값 불일치, 중복 이메일, 필수 입력 항목 누락입니다. 처음부터 다시 시작하기보다 스프레드시트에서 문제 있는 행만 수정한 뒤 다시 업로드하세요.
***
#### **학년 이름을 일관되게 유지하는 것에 대한 참고**
학년 이름 입력 오류는 가져오기 실패의 가장 흔한 원인 중 하나이므로, 팀 전체에서 이 부분을 제대로 맞추는 것이 중요합니다.
* 합의된 학년 이름 목록 하나를 정해 가져오기를 하는 사람들과 공유하세요
* 항상 전체에서 같은 형식을 사용하세요 — 예를 들어:
*1학년, 2학년, 3학년 ... 12학년*
* 다음과 같은 형식을 절대 섞지 마세요 *G6*, *6학년*와 *6학년* 를 같은 파일 안에서
* 바쁜 등록 기간에는 며칠에 한 번씩 가져온 학년 값을 간단히 점검해서, 더 큰 문제가 되기 전에 미리 발견하는 것이 좋습니다
***
#### **단일 추가 또는 대량 가져오기 — 무엇을 사용해야 하나요?**
**다음과 같은 경우에는 한 번에 한 명씩 추가하세요:**
* 10명 미만을 추가할 때
* 개별 기록을 수정할 때
* 중도 편입자나 대체 인원을 등록할 때
**다음과 같은 경우에는 대량 가져오기를 사용하세요:**
* 새 학기나 새 학년 시작 시 설정할 때
* 다른 시스템에서 옮겨올 때
* 큰 그룹을 한 번에 일관되게 추가해야 할 때
***
#### **어떤 등록이든 끝난 뒤 — 간단한 체크리스트**
학생이나 교사를 한 차례 추가하거나 가져오기를 마친 뒤에는, 완료했다고 생각하기 전에 다음 사항을 확인하세요:
* 총 기록 수가 예상한 수와 일치함
* 몇 개의 무작위 기록을 표본 확인하여 세부 정보가 올바른지 봄
* 학생 학년이 올바르게 배정됨
* 교사들이 올바른 학급과 연결되어 있으며, 필요하면 학급 책임자로 표시됨
* 실패한 가져오기 행이 수정되어 다시 업로드됨
* 교직원에게 등록이 완료되었고 로그인할 수 있다고 알렸음
***
#### **자주 묻는 질문에 대한 빠른 답변**
**학년을 채우지 않고 학생을 가져올 수 있나요?** 보통은 아닙니다. 구조화된 학교 설정에서는 학년이 필수이거나 강력히 권장됩니다.
**가져온 뒤 학생이 잘못된 학년에 들어가면 어떻게 하나요?** 즉시 기록을 수정하고 필요하면 학급 배정도 업데이트하세요.
**같은 파일에 교사와 학생을 함께 가져올 수 있나요?** 아니요 — 각각 별도의 템플릿과 별도의 가져오기 흐름을 사용합니다.
**잘못 가져온 사용자를 삭제해야 하나요?** 대부분의 경우에는 계정을 완전히 삭제하기보다 기록을 수정하거나 비활성화하는 것이 더 좋습니다. 학교 정책에서 명시적으로 요구하는 경우에만 삭제하세요.
***
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://guides.reallivesworld.com/school-home/school-dbg-admin-and-teacher-ko/getting-started/publish-your-docs.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
