4.5 KiB
4.5 KiB
제출 · 발표
1. 팀 저장소 구조
팀마다 저장소 하나 (과정 GitLab 또는 강사가 안내한 곳). 비공개로 만들고 강사를 초대합니다.
<팀 저장소>/
├── 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 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일차~) 팀 구성의 참고 자료로도 씁니다.