aio-01d4-stu/Lecture/80-82-Project/student/08-SUBMISSION.md

# 제출 · 발표

## 1. 팀 저장소 구조

팀마다 저장소 하나 (과정 GitLab 또는 강사가 안내한 곳). **비공개**로 만들고 강사를 초대합니다.

```text
<팀 저장소>/
├── README.md                    # 팀 · 역할 · 실행 방법 · 웹훅 경로 · 시연 순서
├── AGENTS.md                    # CLI 코딩 에이전트 규칙 (09 문서)
├── docs/
│   ├── TOPIC.md                 # 주제 제안서 (80일차, 강사 승인)
│   ├── TEAM-CHARTER.md          # 팀 헌장 (80일차)
│   ├── WORKFLOW-DESIGN.md       # 산출물 1 · 노코드 워크플로우 설계서
│   ├── RAG-ARCHITECTURE.md      # 산출물 2 · RAG 아키텍처 설계서
│   ├── EXECUTION-RESULT.md      # 산출물 3 · 워크플로우 실행 결과서
│   ├── daily/                   # 데일리 기록 3장 (80 · 81 · 82)
│   └── images/                  # 실행 화면 캡처 (개인정보 · 키를 가린 것)
├── workflows/                   # n8n 워크플로우 JSON (키 없음)
│   ├── team1-support.json
│   ├── team1-index.json
│   └── team1-errors.json
├── knowledge/                   # 팀이 쓴 지식 문서 (다른 주제는 6개 이상)
├── data/                        # 다른 주제: users.json · records.json (가짜 데이터)
├── cases/common.json            # 다른 주제: 공통 시나리오를 옮긴 것
├── cases/team.json              # 팀 시나리오
├── requests/                    # 시연 · bench용 요청 파일
└── runs/                        # 시험 보고서 (flow.py test · bench의 JSON)
```

## 2. 제출 마감과 확인

| 항목 | 기준 |
| --- | --- |
| 마감 | **82일차(11/09 월) 14:50**, 기본 브랜치의 마지막 커밋 시각 |
| 마감 뒤 | 고치지 않음 (발표는 마감 시점의 저장소로) |
| 필수 파일 | `README.md`, `docs/` 세 산출물 + 헌장 + 데일리 3장, `workflows/`, `cases/team.json`, `runs/` |
| 비밀 검사 | 제출 전 `tscan scan .` (73일차) → 키 · 실제 연락처 0건. 가짜 데이터의 연락처도 **문서 · 로그에서는 가림** |
| 실행 가능 | 강사가 팀 VM이나 강사 n8n에서 `README.md`대로 `flow.py push workflows/*.json` → `flow.py test cases/team.json`을 돌려 같은 결과가 나와야 함 |

### 제출 전 점검 (원본 요구 6절과 같음)

원본 [KSM-REQ.md](../Req/KSM-REQ.md) 6절 체크리스트 15개를 `docs/EXECUTION-RESULT.md` 끝에 그대로 붙여 체크합니다. 특히 공통 셋:

- [ ] 세 설계서 · 결과서의 내용이 실제 구현과 일치한다 (설계서의 노드 이름 = 워크플로우의 노드 이름).
- [ ] 예시 수치를 팀의 실제 측정값으로 교체했다 (`runs/` 보고서에서).
- [ ] 인증정보와 개인정보가 문서 · 로그 · 저장소에 노출되지 않았다.

## 3. 최종 발표 (82일차 6~7교시, 4팀)

80 · 81일차 8교시의 산출물 발표 ① · ②(팀별 10분)는 그날까지의 산출물과 VM 동작을 보이는 중간 발표입니다. 아래는 82일차 최종 발표입니다.

| 항목 | 기준 |
| --- | --- |
| 시간 | 팀당 20분 (산출물 3종 + 시연) + 질의 5분. 6교시 1 · 2팀, 7교시 3 · 4팀 |
| 순서 | 따로 정해 알림 |
| 리허설 | 82일차 3교시(1 · 2팀) · 4교시(3 · 4팀), VM에서 시연 순서 그대로 |
| 시연 기계 | **팀 VM**, 시작 전 `doctor` `ready` · `fault all ok` · `llm up` |

**20분 구성 (권장)**

| 분 | 내용 | 산출물 |
| --- | --- | --- |
| 3 | 업무 시나리오 · 범위 · 팀 역할 | 설계서 1절, 헌장 |
| 5 | 흐름도 · 에이전트 역할 · 분기 · 병렬 · 루프 · 페이로드 한 연결선 | 설계서 2~6절 |
| 4 | RAG: 청킹 비교 숫자 · 임베딩 · 권한 필터 · 재색인 | RAG 설계서 |
| 5 | 시연 (팀 VM): 원본 요구 시연 순서 (정상 → 보완 질문 → 장애 → 이관 · 로그) | 실행 결과서 5절 |
| 3 | 결과 숫자 · 실패 사례 하나 · 남은 위험 | 실행 결과서 3 · 4절 |

## 4. 평가 시험 (82일차 8교시)

최종 발표 뒤 17:00~17:50에 **25문항 평가 시험**을 봅니다. 통과하지 못한 사람은 따로 **재시험 15문항**을 봅니다. 총평은 시험과 함께 8교시에 합니다.

## 5. 동료 평가

발표마다 다른 팀이 짧게 적습니다 (강사가 양식 배포): 가장 좋았던 점 하나, 우리 팀이 가져가고 싶은 것 하나, 질문 하나. 최종 프로젝트(83일차~) 팀 구성의 참고 자료로도 씁니다.