aio-01d4-stu/Lecture/80-82-Project/student/01-SCHEDULE-AND-TEAMS.md

# 일정 · 팀 · 역할

- 하루 8교시: 1교시 09:00 · 2교시 10:00 · 3교시 11:00 · 4교시 12:00~12:50 · 점심 13:00~14:00 · 5교시 14:00 · 6교시 15:00 · 7교시 16:00 · 8교시 17:00~17:50
- 원본 요구의 권장 진행 순서(1~4단계)를 3일에 나눴습니다. 교시마다 **완료 기준**이 있습니다.
- 팀마다 인터넷으로 접속할 수 있는 **팀 VM**이 하나 있습니다. 개발은 각자 노트북에서 하고, 팀장이 VM에 배포합니다. 산출물 발표 · 리허설 · 최종 시연은 VM에서 합니다 ([02-ENVIRONMENT-AND-SERVICES](02-ENVIRONMENT-AND-SERVICES.md) 1절).

```mermaid
gantt
  title 단위 프로젝트 3일 (교시 기준)
  dateFormat  YYYY-MM-DD HH:mm
  axisFormat  %m/%d %H시
  section 80일차 (목) 설계 · 골격
  킥오프 · 주제 · 범위 · 설계     :a1, 2026-11-05 09:00, 4h
  산출물 1차 점검 · 골격          :crit, a2, 2026-11-05 14:00, 1h
  RAG 색인 · 도구 · VM 첫 배포    :a3, after a2, 2h
  산출물 발표 ①                  :crit, a4, after a3, 1h
  section 81일차 (금) 구현 · 예외
  에이전트 · 검증 · 이관          :b1, 2026-11-06 09:00, 3h
  산출물 중간점검 · VM 배포 1     :crit, b2, 2026-11-06 12:00, 1h
  보안 · 장애 · VM 배포 2         :b3, 2026-11-06 14:00, 3h
  산출물 발표 ② · 기능 동결       :crit, b4, after b3, 1h
  section 82일차 (월) 시연 · 제출 · 발표 · 평가 시험
  점검 · 발표 자료 · 리허설       :c1, 2026-11-09 09:00, 4h
  산출물 마무리 · 제출            :c2, 2026-11-09 14:00, 1h
  제출 마감 14:50                 :milestone, c3, 2026-11-09 14:50, 0h
  최종 발표 (1·2팀 → 3·4팀)       :c4, 2026-11-09 15:00, 2h
  평가 시험 25문항                :crit, c5, 2026-11-09 17:00, 50m
```

## 1. 80일차 (11/05 목) · 설계와 골격

| 교시 | 할 일 | 강사 | 완료 기준 |
| --- | --- | --- | --- |
| 1 (09:00) | 팀 발표 · 역할 정하기, 팀 VM 접속 확인, 후반 15분 **주제 후보** 고르기 | 킥오프 (안내서 · 평가 기준 · 공통 계약 · VM 배정 안내) | 팀 명단 · VM 접속 |
| 2 (10:00) | 주제 · 입구 · 뒷단 조합(A/B/C, [11-TOPIC-GUIDE](11-TOPIC-GUIDE.md) 7절) 정하기, [주제 제안서](templates/TOPIC-PROPOSAL-TEMPLATE.md) · [팀 헌장](templates/TEAM-CHARTER-TEMPLATE.md) · 저장소, 각자 환경 점검 (`flow.py doctor`) | **주제 제안서 승인 (10:50까지)** | `docs/TOPIC.md` · `docs/TEAM-CHARTER.md` 커밋 |
| 3 (11:00) | 범위 정하기: 문의 유형 · 지식 문서 · 권한 · 팀 시나리오 5개 (1단계). 팀장은 VM에 n8n · 데이터 API · Credential 준비. 다른 주제 팀은 데이터 · 문서 만들기 시작 | 팀 순회 | `cases/team.json` 초안, [03-SCENARIOS-AND-DATA](03-SCENARIOS-AND-DATA.md)의 표 |
| 4 (12:00) | 워크플로우 설계서 1~4절: 업무 시나리오 · 흐름도 · 역할 카드 · 분기 기준 (1 · 2단계) | 팀 순회 | 설계서 1~4절 초안 |
| 5 (14:00) | **산출물 1차 점검** (팀별 10분). 점검받는 팀 외에는 골격 워크플로우: Webhook → 입력 검사 → (가짜) 분류 → Respond, 계약 모양만 맞추기 | 1차 점검 (설계서 1~4절 · 공통 계약, 다른 주제 팀은 옮긴 `cases/common.json`) | 점검 피드백, 공통 시나리오 중 400 · 차단 통과 |
| 6 (15:00) | 피드백 반영 + RAG 색인 워크플로우: 문서 가져오기 · 청킹 · 임베딩 · 저장, 청크 길이 분포 재기 | 팀 순회 | 색인 개수, RAG 설계서 1~2절 |
| 7 (16:00) | 도구 노드 연결 (접수 조회 · 티켓 생성 · 알림, 노드마다 입력 · 출력 · 인증 확인) → 팀장이 **VM에 첫 배포** | 팀 순회 | VM에서 WF-08 · WF-13 통과 |
| 8 (17:00) | **산출물 발표 ①** (팀별 10분), 데일리 기록 | 발표 진행 · 피드백 (설계서 2종 초안 · VM 동작) | 발표 피드백 · `docs/daily/DAY80.md` |

## 2. 81일차 (11/06 금) · 구현과 예외 처리

| 교시 | 할 일 | 강사 | 완료 기준 |
| --- | --- | --- | --- |
| 1 (09:00) | 스탠드업 · 어제 피드백 반영 계획, VM에서 공통 시나리오를 돌려 출발점 기록 | 팀별 VM 상태 · 출발점 확인 | 공통 시나리오 통과 수 (출발점) |
| 2 (10:00) | 분류 Agent · 검색 · 답변 Agent: 정상 FAQ 답 + 근거 (2단계) | 팀 순회 | WF-01 통과 |
| 3 (11:00) | 검증 Agent · 신뢰도 분기 · 담당자 이관 (티켓 생성) (2단계) | 팀 순회 | WF-03 통과 |
| 4 (12:00) | 루프(보완 질문) · 병렬(두 검색) · 복합 문의, B · C 팀은 입구 · 뒷단 어댑터 (A 팀은 루프 · 병렬 · 복합만), 팀장은 **VM 배포 1회** | **산출물 중간점검** (팀별 10분, 페이로드 표 · RAG 3~5절 · 연동 표) | WF-02 · WF-11 · WF-12 |
| 5 (14:00) | 보안: 주입 차단 · 본인 건만 · 개인정보 가림 (3단계) | 팀 순회 | WF-05 ~ WF-08 |
| 6 (15:00) | 외부 장애: 시간 제한 · 재시도 · DLQ · 알림 · 중복 방지 (3단계) | 팀 순회 | WF-04 · WF-09 · WF-10 |
| 7 (16:00) | Error Workflow 게시 · 설계서 5~7절 · 실행 결과서 1절 시작, 팀장은 **VM 배포 2회 + 전체 회귀** | 팀 순회 | 설계서 2종 완성 |
| 8 (17:00) | **산출물 발표 ②** (팀별 10분), 데일리 기록 | 발표 진행 후 **기능 동결** (설계서 2종 완성 · 결과서 초안) | 통과 수 · 동결 선언 · `docs/daily/DAY81.md` |

> **81일차 8교시에 기능을 동결합니다.** 82일차에는 새 기능을 붙이지 않고 시험 · 고치기 · 문서 · 발표 준비만 합니다. 늦게 붙인 기능이 앞의 것을 깨뜨리는 일이 3일 프로젝트에서 가장 흔한 실패입니다. 발표 ②에서 공통 시나리오가 절반도 통과하지 않으면, 가산 기능은 버리고 필수만 고칩니다.

## 3. 82일차 (11/09 월) · 시연 · 제출 · 발표

| 교시 | 할 일 | 강사 | 완료 기준 |
| --- | --- | --- | --- |
| 1 (09:00) | 데일리 점검, VM에서 시연 순서를 한 번 돌려 보기 | 전체 시연 · 발표 상황 점검 | 팀별 남은 일 목록 |
| 2 (10:00) | 발표 자료 만들기 + 산출물 3종의 숫자를 `runs/`에서 맞추기 (4단계) | 발표 자료 · 산출물 3종 점검 | 발표 자료 초안 |
| 3 (11:00) | 1 · 2팀은 VM 시연 리허설, 3 · 4팀은 결과서 숫자 · LLM 3회 반복 | 1 · 2팀 시연 · 발표 상황 확인 | 리허설 통과 |
| 4 (12:00) | 3 · 4팀은 VM 시연 리허설, 1 · 2팀은 결과서 · 실패 사례 정리 | 3 · 4팀 시연 · 발표 상황 확인 | 리허설 통과 |
| 5 (14:00) | 산출물 3종 마무리 · 데일리 기록 · `tscan` 비밀 검사 · 저장소 제출 | 산출물 3종 제출 확인 | **마지막 커밋 (14:50)** |
| 6 (15:00) | 1 · 2팀 최종 발표 (산출물 3종 + 시연, 팀당 20분 + 질의 5분), 동료 평가 | 발표 진행 · 질의 | 동료 평가지 |
| 7 (16:00) | 3 · 4팀 최종 발표 (산출물 3종 + 시연, 팀당 20분 + 질의 5분), 동료 평가 | 발표 진행 · 질의 | 동료 평가지 |
| 8 (17:00) | **평가 시험 (25문항, 17:00~17:50)** | 시험 진행 · 총평 | 답안 제출 |

- 위 표의 1 · 2 · 3 · 4팀은 **발표 순서**입니다. 순서는 따로 정해 알립니다.
- 82일차 데일리 기록(`docs/daily/DAY82.md`)은 5교시 제출 전에 씁니다.

> **82일차 8교시는 평가 시험(25문항)입니다.** 통과하지 못하면 재시험(15문항)을 봅니다. 프로젝트 일은 5교시 제출로 끝납니다. 발표 · 시연을 하며 팀원 모두가 워크플로우 · RAG · 예외 처리를 설명할 수 있게 준비하면 시험 준비도 됩니다.

## 4. 팀과 역할 (4팀 · 5~6명)

21명을 4팀(5 · 5 · 5 · 6명)으로 나눕니다 (팀 명단은 첫날 강사 안내). 아래 역할 다섯에 한 사람씩 **주 담당**을 두고, 다른 역할을 함께 봅니다. 6명 팀은 일이 가장 많은 역할(보통 오케스트레이션 또는 연동 · 안정성)에 두 사람을 두고, 둘이 다른 워크플로우 파일을 맡습니다.

| 역할 | 주로 하는 일 | 주로 쓰는 산출물 절 | 64~79일차 |
| --- | --- | --- | --- |
| 팀장 (리드 · 통합) | 범위 · 계약 지키기, 하루 목표 숫자, 병합 · 동결, **팀 VM 준비 · 배포**, 발표 | 헌장, 데일리, README | 70 모듈 · 74 버전 |
| 오케스트레이션 | 분류 · 답변 · 검증 Agent, 분기 · 병렬 · 루프 | 워크플로우 설계서 2~4절 | 68 · 69 |
| RAG | 문서 · 청킹 · 임베딩 · 검색 품질 | RAG 설계서 전부 | 71 |
| 연동 · 안정성 | 도구 노드 · 인증 · 오류 처리 · DLQ · 알림 · 보안 | 워크플로우 설계서 5~7절 | 67 · 72 · 73 · 76 |
| 시험 · 품질 | 시나리오 파일 · 반복 · 장애 시험 · 실행 로그 · 결과서 | 실행 결과서 전부 | 72 · 74 · 77 |

**팀 규칙 (헌장에 적을 것)**

- 워크플로우 JSON은 **한 사람이 한 파일**을 맡습니다. 같은 파일을 둘이 동시에 고치면 n8n import에서 한쪽이 사라집니다. 큰 워크플로우는 70일차처럼 **모듈(하위 워크플로우)**로 나눠 사람마다 맡습니다.
- 공통 계약(요청 · 응답 칸)은 팀장의 허락 없이 바꾸지 않습니다.
- 고칠 때마다 공통 시나리오를 다시 돌립니다 (회귀). 깨뜨린 사람이 고칩니다.
- VM에는 팀장만 배포합니다. 배포는 저장소의 기본 브랜치에서 하고, 배포 뒤 VM에서 공통 시나리오를 돌립니다.
- 하루 끝에 데일리 기록 한 장: 한 일 · 숫자 · 막힌 것 · 내일.

## 5. 매일 점검

| 언제 | 누가 | 무엇을 보나 |
| --- | --- | --- |
| 매일 1교시 | 팀 (10분 스탠드업) | 어제 한 일 · 오늘 목표 숫자 · 막힌 것 |
| 80일차 5교시 | 강사 · 산출물 1차 점검 (팀별 10분) | 범위가 3일에 맞나, 설계서 1~4절 · 공통 계약, 시나리오 기대값 |
| 80일차 8교시 | 강사 · 산출물 발표 ① (팀별 10분) | 설계서 2종 초안, VM에서 도는가 |
| 81일차 4교시 | 강사 · 산출물 중간점검 (팀별 10분) | 페이로드 표 · RAG 설계서 3~5절 · 연동 표 |
| 81일차 8교시 | 강사 · 산출물 발표 ② (팀별 10분) | 설계서 2종 완성 · 결과서 초안 · 공통 시나리오 통과 수, **기능 동결** |
| 82일차 3 · 4교시 | 강사 · 리허설 확인 | VM 시연 순서, 발표 자료 |
| 82일차 14:50 | 강사 · 제출 확인 | 마지막 커밋, 필수 파일, 비밀 검사 |
| 82일차 8교시 | 평가 시험 | 25문항 (통과하지 못하면 재시험 15문항) |