🚀 ALPACO 사용자 매뉴얼

ALPACO (AI Learning PAth COmpanion)에 오신 것을 환영합니다! ALPACO는 클라우드 기반 LLM을 활용하여 개인 맞춤형 코딩 문제를 생성하고, 풀이 과정을 돕는 AI 헬퍼와 함께 개발자로서 성장할 수 있는 환경을 제공하는 플랫폼입니다.

이 매뉴얼은 ALPACO 플랫폼의 주요 기능을 사용하는 방법을 안내합니다.

목차

1. 시작하기
   • 1.1. ALPACO 접속하기
   • 1.2. 구글 계정으로 로그인
   • 1.3. 닉네임 설정 (최초 로그인 시)
2. 주요 기능 사용법
   • 2.1. AI로 코딩 문제 생성하기
   • 2.2. 코딩 테스트 풀기
     • 2.2.1. 문제 선택 페이지에서 문제 고르기
     • 2.2.2. 문제 풀이 화면 구성
     • 2.2.3. 코드 작성 및 실행
     • 2.2.4. AI 헬퍼 (챗봇) 사용하기
     • 2.2.5. 코드 제출 및 채점
   • 2.3. 채점 결과 확인하기
   • 2.4. 커뮤니티 활용하기
     • 2.4.1. 게시글 목록 보기 및 검색
     • 2.4.2. 게시글 상세 보기 및 댓글 작성/좋아요
     • 2.4.3. 새 게시글 작성 (풀이 공유 포함)
     • 2.4.4. 게시글 수정 및 삭제
   • 2.5. 내 저장소 (내가 생성한 문제)
   • 2.6. 제출 현황 보기
3. 계정 설정

---

1. 시작하기

1.1. ALPACO 접속하기

웹 브라우저를 열고 ALPACO 플랫폼 URL [애플리케이션 URL 입력, 예: https://alpaco.us]로 접속합니다. (참고: 실제 URL은 관리자로부터 제공받거나, 프로젝트 배포 시 확인된 주소를 사용합니다.)

1.2. 구글 계정으로 로그인

1. ALPACO 홈페이지 우측 상단의 “로그인” 버튼을 클릭합니다.

   

2. 로그인 페이지로 이동하면 “Sign In with Google” 버튼을 클릭합니다.

   

3. Google 계정 선택 및 로그인 절차를 진행합니다.

   • 최초 로그인 시, ALPACO가 Google 계정의 기본 정보(이메일, 프로필)에 접근하는 것을 허용해야 할 수 있습니다.

1.3. 닉네임 설정 (최초 로그인 시)

Google 계정으로 처음 로그인하면, ALPACO 플랫폼에서 사용할 닉네임을 설정하는 페이지로 이동될 수 있습니다.

1. “사용자 설정” 페이지가 나타나면, “닉네임” 입력란에 원하는 닉네임을 입력합니다.
   • 닉네임은 다른 사용자에게 표시되며, 최대 20자까지 입력 가능합니다.

2. “저장하기” 버튼을 클릭합니다.

   

3. 닉네임이 성공적으로 설정되면, 이후 플랫폼 활동 시 해당 닉네임이 사용됩니다.

---

2. 주요 기능 사용법

2.1. AI로 코딩 문제 생성하기

ALPACO는 사용자의 요구사항에 맞춰 LLM(대규모 언어 모델)을 통해 새로운 코딩 문제를 즉석에서 생성할 수 있습니다.

1. 헤더 메뉴에서 “코딩 테스트”를 클릭하거나, 메인 페이지의 관련 링크를 통해 코딩 테스트 페이지로 이동합니다.

2. 코딩 테스트 페이지에서 “AI로 문제 생성하기 🤖” 버튼을 클릭합니다.
3. “문제 생성” 페이지가 나타납니다.
   • 입력창: “생성하고 싶은 문제 유형을 입력하세요…” 부분에 원하는 문제의 주제, 알고리즘 유형, 내용 등을 자유롭게 입력합니다. (예: “다이나믹 프로그래밍 기초 문제”, “DFS와 BFS를 활용한 그래프 경로 찾기 문제”)
   • 난이도 선택: “쉬움”, “중간”, “어려움” 중 원하는 난이도를 선택합니다.
   • 프리셋 버튼: “DP 문제”, “그래프 문제” 등 미리 정의된 유형을 클릭하여 빠르게 프롬프트를 채울 수도 있습니다.

4. 입력 후 전송(종이비행기 모양) 아이콘 버튼을 클릭하거나 Enter 키를 누릅니다.

5. AI가 문제 생성을 시작하며, “생성 상태 및 결과” 창에 진행 상황이 단계별 메시지로 표시됩니다. (Server-Sent Events 스트리밍)
   • 생성에는 몇 분 정도 소요될 수 있습니다.

6. 생성이 완료되면, 문제 제목, 설명, 난이도, 제약 조건 등이 포함된 “생성된 문제 상세 정보”가 나타납니다.

7. “풀러가기” 버튼을 클릭하면 해당 문제를 바로 풀 수 있는 코딩 테스트 화면으로 이동합니다.

2.2. 코딩 테스트 풀기

2.2.1. 문제 선택 페이지에서 문제 고르기

1. 헤더 메뉴에서 “코딩 테스트”를 클릭합니다.
2. 코딩 테스트 페이지에서 “테스트 선택하기” 버튼을 클릭합니다.
3. “코딩 테스트 선택” 페이지로 이동하면, 미리 준비된 다양한 문제 목록이 표시됩니다.
   • 각 문제는 제목, 간략한 설명, 난이도 태그와 함께 카드 형태로 제공됩니다.
4. 원하는 문제 카드의 “시작하기” 버튼을 클릭하여 문제 풀이 화면으로 이동합니다.
5. 전체 문제 목록에서도 원하는 문제를 검색하거나 클릭하여 풀 수 있습니다.

2.2.2. 문제 풀이 화면 구성

문제 풀이 화면은 일반적으로 세 개의 주요 패널로 구성됩니다 (화면 크기에 따라 레이아웃이 다를 수 있음):

• 문제 패널 (좌측): 문제 제목, 난이도, 상세 설명(입력/출력 형식, 제약 조건, 예제 포함)이 표시됩니다.
• 에디터 및 결과 패널 (중앙):
  • 코드 에디터 (상단): 코드를 작성하는 영역입니다.
    • 언어 선택: 드롭다운 메뉴에서 Python, JavaScript, Java, C++ 등 지원하는 프로그래밍 언어를 선택할 수 있습니다.
    • Reset 버튼: 코드를 해당 언어의 기본 템플릿으로 초기화합니다.
  • 결과 창 (하단): “코드 실행” 또는 “제출” 후 결과가 표시됩니다. “예제”, “실행 결과”, “채점 결과” 탭으로 구성됩니다.
• AI 헬퍼 (챗봇) 패널 (우측): 문제 풀이 중 도움을 받을 수 있는 AI 챗봇입니다.

각 패널은 크기 조절이 가능하며, 접거나 펼칠 수 있는 버튼이 제공될 수 있습니다.

2.2.3. 코드 작성 및 실행

1. 중앙 패널의 코드 에디터에서 선택한 언어로 코드를 작성합니다.
2. 작성한 코드를 문제의 예제 테스트 케이스에 대해 실행해보고 싶다면, 에디터 상단의 “코드 실행” 버튼을 클릭합니다.
   • 실행이 완료되면 하단 결과 창의 “실행 결과” 탭에 각 예제 입력에 대한 실제 출력, 예상 출력, 실행 시간 등이 표시됩니다.
   • 오류가 발생하면 오류 메시지가 표시됩니다.

2.2.4. AI 헬퍼 (챗봇) 사용하기

문제 풀이 중 막히거나 힌트가 필요할 때 우측의 AI 헬퍼 (알파코 챗봇)를 사용하세요.

1. 챗봇 하단의 입력창에 질문을 입력합니다. (예: “이 문제에 어떤 알고리즘을 사용해야 할까요?”, “제 코드에서 시간 초과가 발생하는데, 어떻게 개선할 수 있을까요?”)
2. 전송 버튼을 누르거나 Enter 키를 치면 AI가 답변을 제공합니다.
   • AI는 현재 문제 내용과 사용자가 작성한 코드를 참고하여 답변을 생성하려고 시도합니다.
   • 직접적인 정답 코드보다는 문제 해결 전략, 개념 설명, 디버깅 방향 등을 제공하는 것을 목표로 합니다.
3. 챗봇과의 대화 기록은 해당 문제에 대해 저장되어 나중에 다시 볼 수 있습니다. (브라우저 로컬 스토리지 기반)
4. 실행 결과 창에서 “AI 챗봇으로 내보내기” 아이콘(화살표 위로 향하는 트레이 모양)을 클릭하면 해당 실행 결과가 챗봇 입력창에 자동으로 복사되어 질문의 맥락으로 활용할 수 있습니다.

2.2.5. 코드 제출 및 채점

1. 코드 작성을 완료하고 모든 테스트 케이스에 대해 검증받고 싶다면, 에디터 상단의 “제출” 버튼을 클릭합니다.
2. 코드가 서버로 전송되어 숨겨진 테스트 케이스를 포함한 전체 채점이 진행됩니다.

3. 채점이 완료되면 하단 결과 창의 “채점 결과” 탭에 상세 결과가 표시됩니다.

   • 각 테스트 케이스별 통과 여부 (성공, 오답, 시간 초과, 런타임 오류 등)
   • 전체 점수
   • 총 실행 시간
   • 오류가 있는 경우 해당 메시지
4. 모든 테스트 케이스를 통과하면 “정답입니다!” 모달 창이 나타납니다.
   • “계속 풀기”: 모달을 닫고 현재 문제 풀이 화면에 머무릅니다.
   • “결과 확인 및 공유”: 해당 제출에 대한 상세 결과 페이지로 이동합니다.

2.3. 채점 결과 확인하기

코딩 테스트 문제 풀이 후 “제출”을 하면, 또는 제출 현황 페이지에서 특정 제출 건을 클릭하면 상세 채점 결과 페이지로 이동합니다.

1. 문제 제목, 점수, 상태 (정답, 오답 등) 가 표시됩니다.
2. 실행 시간, 사용 언어, (지원되는 경우) 메모리 사용량 등의 요약 정보가 제공됩니다.
3. 오류가 발생한 경우, 오류 정보 섹션에서 상세 내용을 확인할 수 있습니다.
4. “문제로 돌아가기” 버튼을 통해 다시 문제 풀이 화면으로 갈 수 있습니다.
5. “이 문제의 모든 제출 보기” 버튼을 클릭하면 해당 문제에 대한 모든 사용자의 제출 기록 페이지로 이동합니다. (필터링된 상태)
6. 본인이 제출한 코드이고 성공적으로 채점된 경우, “커뮤니티에 풀이 공유” 버튼이 활성화됩니다. 이를 클릭하면 해당 제출 코드가 포함된 새 게시글 작성 페이지로 이동합니다. (2.4.3. 참고)

2.4. 커뮤니티 활용하기

커뮤니티에서는 사용자들이 생성하거나 푼 문제에 대해 토론하고, 풀이를 공유하며, 코딩 지식을 나눌 수 있습니다.

2.4.1. 게시글 목록 보기 및 검색

1. 헤더 메뉴에서 “커뮤니티”를 클릭합니다.
2. 게시글 목록이 최신순으로 표시됩니다.
   • 각 게시글은 제목, 작성자, 작성일, 좋아요 수, 댓글 수를 간략하게 보여줍니다.
   • 문제와 연관된 게시글인지(“문제연관”), 자유 게시글인지 태그로 구분됩니다.
3. 페이지 하단의 “더 보기” 버튼으로 이전 게시글을 추가로 불러올 수 있습니다.

2.4.2. 게시글 상세 보기 및 댓글 작성/좋아요

1. 커뮤니티 목록에서 원하는 게시글 제목을 클릭하면 상세 페이지로 이동합니다.
2. 게시글 내용 (Markdown 형식 지원, 코드 블록 포함)을 확인할 수 있습니다.

1. 좋아요:
   • 게시글 하단의 하트 아이콘을 클릭하여 ‘좋아요’를 누르거나 취소할 수 있습니다. (로그인 필요)
2. 댓글:
   • 게시글 하단에 댓글 목록이 표시됩니다. “댓글 더 보기”로 이전 댓글을 불러올 수 있습니다.
   • 로그인한 경우, 댓글 입력창에 내용을 작성하고 “댓글 등록” 버튼을 눌러 댓글을 남길 수 있습니다.
   • 자신이 작성한 댓글은 “삭제” 버튼으로 삭제할 수 있습니다.

2.4.3. 새 게시글 작성 (풀이 공유 포함)

1. 커뮤니티 페이지 우측 상단의 “글 작성하기” 버튼을 클릭합니다.
2. “게시글 작성” 페이지에서 다음 정보를 입력합니다:
   • 제목: 게시글의 제목을 입력합니다.
   • 내용: Markdown 형식으로 내용을 작성합니다. 코드 블록은 다음과 같이 작성할 수 있습니다:

```언어이름 (예: python, javascript)
// 여기에 코드 작성

``` 또는 <details> 태그를 사용하여 접고 펼 수 있는 코드 블록을 만들 수 있습니다.

1. 풀이 공유 시: 코딩 테스트 결과 페이지에서 “커뮤니티에 풀이 공유” 버튼을 통해 이 페이지로 왔다면, 게시글 제목과 내용(제출 코드 포함)이 자동으로 채워집니다. 내용을 자유롭게 수정하고 설명을 추가할 수 있습니다.
   • 이 경우, 게시글은 자동으로 해당 문제와 연결됩니다.

1. “게시글 등록” 버튼을 누르면 게시글이 등록되고, 해당 게시글의 상세 페이지로 이동합니다.

2.4.4. 게시글 수정 및 삭제

• 자신이 작성한 게시글의 상세 페이지에서는 “수정” 및 “삭제” 버튼이 표시됩니다.
• 수정: 게시글 수정 페이지로 이동하여 제목과 내용을 변경할 수 있습니다.
• 삭제: 확인 창이 나타나며, 확인 시 게시글과 관련된 모든 댓글이 함께 삭제됩니다.

2.5. 내 저장소 (내가 생성한 문제)

“내 저장소”는 사용자가 AI를 통해 직접 생성한 문제들을 모아보는 공간입니다.

1. 헤더 메뉴에서 “내 저장소”를 클릭합니다. (로그인 필요)
2. 내가 생성한 문제 목록이 표시됩니다.
   • 문제 제목, 알고리즘 유형(있는 경우), 난이도, 생성 날짜 등을 기준으로 정렬하거나 검색할 수 있습니다.
3. 문제 제목을 클릭하면 해당 문제 풀이 화면으로 이동하여 다시 풀어보거나 내용을 확인할 수 있습니다.
4. 페이지 하단의 “더 보기” 버튼으로 이전 생성 문제들을 불러올 수 있습니다.

2.6. 제출 현황 보기

플랫폼에서 이루어진 모든 코드 제출 기록을 보거나 필터링할 수 있는 페이지입니다.

1. 헤더 메뉴에서 “제출 현황”을 클릭합니다.
2. 제출 목록이 최신순으로 표시됩니다. 각 항목은 제출 ID, 문제, 결과, 실행 시간, 언어, 제출자, 제출 시각 정보를 포함합니다.

1. 필터링:
   • 페이지 상단의 필터 입력란을 사용하여 문제 제목 (한글) 또는 작성자 (닉네임) 로 검색할 수 있습니다.
   • URL 파라미터(userId, problemId)를 통해 특정 사용자 또는 특정 문제의 제출만 보도록 초기 필터링 될 수 있습니다. (예: 코딩 테스트 결과 페이지에서 “이 문제의 모든 제출 보기” 클릭 시)
   • 정렬: “최신순” 또는 “오래된순”으로 정렬 순서를 변경할 수 있습니다.

1. 제출 ID를 클릭하면 해당 제출의 상세 결과 페이지로 이동합니다.
2. 문제 제목을 클릭하면 해당 문제 풀이 페이지로 이동합니다.
3. 페이지 하단의 “더 보기” 버튼으로 이전 제출 기록을 불러올 수 있습니다.

---

3. 계정 설정

사용자 닉네임 등 개인 설정을 변경할 수 있습니다.

1. 로그인된 상태에서 헤더의 사용자 닉네임 옆 설정 아이콘(사람 모양)을 클릭합니다.
   • 또는, 모바일 메뉴 등에서 “설정” 링크를 클릭합니다.
2. “사용자 설정” 페이지로 이동합니다.
3. 현재 닉네임을 확인하고, 필요한 경우 새 닉네임을 입력한 후 “저장하기” 버튼을 클릭합니다.

ALPACO 플랫폼과 함께 즐거운 코딩 학습 여정이 되시기를 바랍니다!