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

97 lines
7.8 KiB
Markdown

# 일정 · 팀 · 역할
- 하루 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일에 나눴습니다. 날마다 **끝났다는 표시**가 있고, 8교시에 강사가 그것을 확인합니다.
```mermaid
gantt
title 단위 프로젝트 3일 (교시 기준)
dateFormat YYYY-MM-DD HH:mm
axisFormat %m/%d %H시
section 80일차 (목) 설계 · 골격
킥오프 · 팀 · 헌장 :a1, 2026-11-05 09:00, 2h
범위 · 시나리오 · 설계 초안 :a2, after a1, 2h
골격 워크플로우 · RAG 색인 :a3, 2026-11-05 14:00, 3h
설계 리뷰 :crit, a4, after a3, 1h
section 81일차 (금) 구현 · 예외
RAG 검색 · 도구 · 에이전트 :b1, 2026-11-06 09:00, 4h
예외 처리 · 보안 :b2, 2026-11-06 14:00, 3h
중간 점검 :crit, b3, after b2, 1h
section 82일차 (월) 시나리오 시험 · 제출 · 발표 · 평가 시험
시험 · 고치기 · 결과서 :c1, 2026-11-09 09:00, 4h
제출 마감 13:50 :milestone, c2, 2026-11-09 13:50, 0h
발표 · 동료 평가 · 총평 :c3, 2026-11-09 14:00, 3h
평가 시험 40문제 :crit, c4, 2026-11-09 17:00, 50m
```
## 1. 80일차 (11/05 목) · 설계와 골격
| 교시 | 할 일 | 원본 단계 | 끝났다는 표시 |
| --- | --- | --- | --- |
| 1 | 킥오프: 안내서 · 평가 기준 · 공통 계약 설명 (강사), 팀 발표, 후반 15분 **주제 후보** 고르기 | — | 팀 명단, 주제 후보 2~3개 |
| 2 | **주제 제안서 → 강사 승인 (10:30까지)**, 팀 헌장 (역할 · 규칙 · 저장소), 저장소 만들기, 환경 점검 (`flow.py doctor`) | — | `docs/TOPIC.md` · `docs/TEAM-CHARTER.md`, 팀원 모두 `ready` |
| 3 | 범위 정하기: 처리할 문의 유형 · 지식 문서 · 권한 · 우리 팀 시나리오 5개. 다른 주제 팀은 데이터 · 문서 만들기 시작 | 1단계 | [03-SCENARIOS-AND-DATA](03-SCENARIOS-AND-DATA.md)의 표를 채움 |
| 4 | 워크플로우 설계서 초안: 업무 시나리오 · 전체 흐름 · 흐름도 · 역할 표 | 1 · 2단계 | 설계서 1~3절 |
| 5 | 골격 워크플로우: Webhook → 입력 검사 → (가짜) 분류 → Respond, 계약 모양만 맞추기 | 1단계 | 공통 시나리오 중 400 · 차단이 통과 |
| 6 | RAG 색인 워크플로우: 문서 가져오기 · 청킹 · 임베딩 · 저장, 청크 길이 분포 재기 | 1단계 | 색인 개수, RAG 설계서 1~2절 초안 |
| 7 | 도구 노드 연결: 접수 조회 · 티켓 생성 · 알림, 노드마다 입력 · 출력 · 인증 확인 | 1단계 | 도구 노드를 한 번씩 `call`로 확인 |
| 8 | **설계 리뷰** (팀별 5분, 강사): 다른 주제 팀은 옮긴 `cases/common.json` 확인, 데일리 기록 | — | 강사 피드백 칸 |
## 2. 81일차 (11/06 금) · 구현과 예외 처리
| 교시 | 할 일 | 원본 단계 | 끝났다는 표시 |
| --- | --- | --- | --- |
| 1 | 데일리 점검 (어제 피드백 · 오늘 목표 숫자), 공통 시나리오 한 번 돌려 출발점 기록 | — | 공통 시나리오 통과 수 (출발점) |
| 2 | 분류 Agent · 검색 · 답변 Agent: 정상 FAQ 답 + 근거 | 2단계 | WF-01 통과 |
| 3 | 검증 Agent · 신뢰도 분기 · 이관 (티켓 생성) | 2단계 | WF-03 통과 |
| 4 | 루프(보완 질문) · 병렬(두 검색) · 복합 문의 | 2단계 | WF-02 · WF-11 통과 |
| 5 | 입력 · 출력 보안: 주입 차단 · 본인 건 · 개인정보 가림 | 3단계 | WF-05 · WF-06 · WF-07 |
| 6 | 외부 장애: timeout · 재시도 · DLQ · 알림, 중복 요청 | 3단계 | WF-04 · WF-08 · WF-09 · WF-10 |
| 7 | Error Workflow 게시, 실행 기록 남기기, 설계서 페이로드 표 채우기 | 3단계 | 설계서 5~7절 |
| 8 | **중간 점검** (강사, 팀별 7분: 공통 시나리오 실행 화면 + 남은 것), 데일리 기록 | — | 중간 점검표 |
## 3. 82일차 (11/09 월) · 시나리오 시험 · 제출 · 발표 · 평가 시험
| 교시 | 할 일 | 원본 단계 | 끝났다는 표시 |
| --- | --- | --- | --- |
| 1 | 데일리 점검, 동결 기준 정하기 (11시 뒤로는 고치지 않고 시험 · 문서만) | — | |
| 2 | 공통 · 장애 · 팀 시나리오 전부, LLM이 들어간 것 3회 반복 | 4단계 | `runs/` 보고서 |
| 3 | 실패 원인 · 조치 · 재시험, 결과서 숫자 채우기 | 4단계 | 결과서 1~4절 |
| 4 | 문서 마무리 (설계서 둘 · 결과서 · README), 비밀 검사(`tscan`), **13:50 제출** | — | 마지막 커밋 시각 |
| 5~6 | **팀 발표** (4팀, 팀당 15분 발표 · 시연 + 5분 질문), 동료 평가 | — | 동료 평가지 |
| 7 | 발표 보충 · 강사 재실행 확인 (공통 시나리오를 팀 저장소대로 다시 돌림), **총평** · 최종 프로젝트(83일차~) 안내 | — | |
| 8 | **평가 시험 (40문제, 17:00~17:50)** | — | 답안 제출 |
> **82일차 8교시는 평가 시험(40문제)입니다.** 프로젝트 일은 7교시까지 끝냅니다. 발표 · 시연을 하며 팀원 모두가 워크플로우 · RAG · 예외 처리를 설명할 수 있게 준비하면 시험 준비도 됩니다.
> 81일차 8교시 중간 점검에서 공통 시나리오가 절반도 통과하지 않으면, 82일차에는 **가산 기능을 멈추고 필수만** 끝냅니다. 늦게 붙인 기능이 앞의 것을 깨뜨리는 일이 3일 프로젝트에서 가장 흔한 실패입니다.
## 4. 팀과 역할 (4팀 · 5~6명)
21명을 4팀(5 · 5 · 5 · 6명)으로 나눕니다 (팀 명단은 첫날 강사 안내). 아래 역할 다섯에 한 사람씩 **주 담당**을 두고, 다른 역할을 함께 봅니다. 6명 팀은 일이 가장 많은 역할(보통 오케스트레이션 또는 연동 · 안정성)에 두 사람을 두고, 둘이 다른 워크플로우 파일을 맡습니다.
| 역할 | 주로 하는 일 | 주로 쓰는 산출물 절 | 64~79일차 |
| --- | --- | --- | --- |
| 리드 · 통합 | 범위 · 계약 지키기, 하루 목표 숫자, 병합 · 동결, 발표 | 헌장, 데일리, 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일차처럼 **모듈(하위 워크플로우)**로 나눠 사람마다 맡습니다.
- 공통 계약(요청 · 응답 칸)은 리드의 허락 없이 바꾸지 않습니다.
- 고칠 때마다 공통 시나리오를 다시 돌립니다 (회귀). 깨뜨린 사람이 고칩니다.
- 하루 끝에 데일리 기록 한 장: 한 일 · 숫자 · 막힌 것 · 내일.
## 5. 매일 점검
| 언제 | 누가 | 무엇을 보나 |
| --- | --- | --- |
| 매일 1교시 | 팀 (10분 스탠드업) | 어제 한 일 · 오늘 목표 숫자 · 막힌 것 |
| 80일차 8교시 | 강사 · 설계 리뷰 | 범위가 3일에 맞나, 흐름도 · 역할 · 계약, 시나리오 기대값 |
| 81일차 8교시 | 강사 · 중간 점검 | 공통 시나리오 통과 수, 예외 처리 동작, 남은 것과 버릴 것 |
| 82일차 13:50 | 강사 · 제출 확인 | 마지막 커밋, 필수 파일, 비밀 검사 |
| 82일차 8교시 | 평가 시험 | 40문제 |