# 프로젝트 회의록

## 회의 정보
- **회의명**: 프로젝트 회의
- **일시**: 2025.11.25
- **장소**: 강의실 372
- **회의 유형**: 기획회의

## 참석자
- **진행자**: 팀장 최대현
- **참석자**: 
  - 국영규
  - 김세희
  - 모인지
  - 윤종윤
  - 이유진
  - 임성현
  - 이상호
- **불참자**:
  - 강소현

## 회의 안건
1. Docker 환경에서 한글 파일/슬라이드 변환 문제
2. 인터넷 문제 및 에이전트 실행 방식
3. 에이전트–데이터셋 연결 및 번역 문제
4. AI 구현 진행 상황 및 방향 전환
5. 인터넷 게이트웨이·ALB·VPC 구조 이해
6. 서버 망 분리와 백엔드 프라이빗 구성
7. Llama 3 & Hugging Face Hub 403 이슈

## 회의 내용

### 안건 1: Docker 환경에서 한글 파일/슬라이드 변환 문제
- **논의 내용**:
  - 한글 파일을 변환해서 넣거나 슬라이드형 자료를 넣었을 때, 실행은 되지만 레이아웃이 제대로 나오지 않는 문제가 있음
  - “도커에서 실행이 됐다”는 것은 컨테이너 내에서 프로세스는 돌지만, 출력 형식(폰트/줄바꿈/레이아웃 등)이 기대한 수준이 아니라는 의미로 파악됨
  - 파일 포맷 변환 과정(한글→PDF/텍스트 등)과 Docker 컨테이너 내 폰트/렌더링 환경을 점검할 필요가 있음

### 안건 2: 인터넷 문제 및 에이전트 실행 방식
- **논의 내용**: 
  - 현재 이슈는 인터넷 연결 문제 가능성이 크다는 언급
  - 정상 동작 시: 파일이 생성되고, 그 결과가 화면에 표시되는 구조
  - 직접 코드를 처음부터 짜기보다는, 제공되는 에이전트 기능을 만들어서 실행해보는 방식을 우선 사용해볼 것
  - 에이전트 기반 실행 구조(워크플로우)를 정확히 이해하고, 어디까지를 ‘코드 구현’으로 보고 어디부터는 ‘툴 설정’으로 처리할지 팀 내 정의가 필요
  
### 안건 3: 에이전트–데이터셋 연결 및 번역 문제
- **논의 내용**:
  - 번역이 안 되는 문제를 해결하기 위해, 데이터셋에 텍스트 파일을 직접 넣는 방식으로 테스트했고, 번역 자체는 성공했으나 분류(카테고리/태깅 등)가 되지 않는 문제가 있음
  - 기타 데이터셋도 에이전트 내부에서 일괄 관리·연결되도록 구성하는 것을 의미하는 것으로 이해됨
  - 팀 내에서 ‘에이전트에서 데이터셋을 연결하는 별도 설정/기능’이 있을 것이라고 보고, 그 방법을 더 찾아볼 필요가 있음
  - 현재는 ‘데이터셋에 파일을 던져 넣는 수준’에 머물러 있고,에이전트 레벨에서 데이터셋을 어떻게 참조·연결·분류할지에 대한 구조 이해가 부족한 상태

### 안건 4: AI 구현 진행 상황 및 방향 전환
- **논의 내용**:
  - 기존에 사용하려던 RagFlow 기반 플로우가 잘 맞지 않아 포기하고 현재 AI 쪽은 실제 코드를 작성하며 구현 진행 중
  - RagFlow는 ‘툴로 사용’ vs ‘직접 구현’ 중, 현재는 직접 구현 방향으로 무게가 실린 상태

### 안건 5: 인터넷 게이트웨이·ALB·VPC 구조 이해
- **논의 내용**:
  - 웹 브라우저에서 회사/서비스 서버로 요청이 갈 때, 실제로는 여러 네트워크 요소를 거치게 되는데, 개발자 입장에서는 이를 잘 모르는 경우가 많음
  - 강사님이 알아보라고 한 세 가지 키워드: 인터넷 게이트웨이(Internet Gateway, IGW), ALB (Application Load Balancer), NAT Gateway (넷 게이트웨이로 표현된 부분)
  - 예시: S3로 웹사이트를 호스팅하면, 인터넷 → AWS → Internet Gateway를 통해 들어온 뒤, 내부(Kubernetes, VPC 안쪽)의 서비스에 붙으려면 ALB를 통해 라우팅해야 함
  - ‘프론트는 퍼블릭, 백은 프라이빗’ 구조에서 IGW–ALB–VPC/서브넷의 관계를 이해하는 것이 중요

### 안건 6: 서버 망 분리와 백엔드 프라이빗 구성
- **논의 내용**:
  - 로컬 개발 환경에서는 이런 망/서브넷 개념을 신경 쓰지 않아도 잘 동작하지만, 실제 서버를 망 분리·서브넷 분리해서 올리면 기본적으로 여러 접근이 차단되는 구조가 됨
  - 보안 관점에서 “백엔드를 프라이빗 서브넷에 두는 것”이 정석
  - 인프라 설계 시 이 부분까지 고민 후 아키텍처 구성
  - 추후 인프라 다이어그램 작성 시, 프런트 → 퍼블릭 서브넷 → ALB → 프라이빗 서브넷(백엔드) 구조를 반영할 필요가 있음

### 안건 7: Llama 3 & Hugging Face Hub 403 이슈
- **논의 내용**:
  - Llama 3 모델을 Hugging Face Hub를 통해 다운로드하려고 했으나, 계속 다운로드 거부(에러)가 발생
  - Hugging Face Hub에서 ‘권한 승인(토큰/권한 설정)’을 받지 못해 발생한 문제로 보임
  - 403 클라이언트 에러를 검색해 보고, 어떤 문제인지(인증/권한/네트워크) 확인해볼 예정
  - 토큰 발급/권한 설정, 네트워크(프록시/방화벽), 라이선스 승인 여부 등을 점검해야 할 필요가 있음

- **결정 사항**: 
  - Docker 출력 품질: Docker 환경에서 한글/슬라이드 파일 변환 시 레이아웃 깨지는 문제를 재현하고, 폰트·포맷·변환 방식 설정을 조정해 출력 품질 개선 방안을 도출한다. (FE / BE) (2025-11-25~2025-11-28)
  - 에이전트–데이터셋 연동: 에이전트에서 데이터셋을 어떻게 연결·참조·분류하는지 공식 문서/설정 화면을 기준으로 확인하고, 번역 + 분류가 동시에 가능하도록 구조를 재설계한다. (AI / BE) (2025-11-25~2025-11-29)
  - AI 코드 구현: RagFlow 의존을 줄이고 현재 진행 중인 AI 코드 구현(2번 방향)을 계속 진행하며, 기본 기능 완성 후 코드 리뷰를 진행한다. (AI) (2025-11-25~2025-12-02)
  - 네트워크 구조 학습: Internet Gateway, ALB, NAT Gateway, VPC/서브넷 구조를 학습하고, 우리 서비스 기준으로 프론트(퍼블릭)–백엔드(프라이빗) 구조 초안을 그려본다. (Infra / BE) (2025-11-25~2025-11-30)
  - 백엔드 프라이빗 구성: 보안 상 “백엔드는 프라이빗 서브넷” 원칙을 기준으로, 현재 구상 중인 아키텍처에 이를 반영하여 수정안(다이어그램)을 작성한다. (Infra) (2025-11-26~2025-12-02)
  - Llama3 403 해결: Hugging Face Hub 403 에러 원인을 확인하기 위해, 토큰/권한 설정, 라이선스 동의 여부, 네트워크(프록시/방화벽) 설정을 점검하고 재시도한다. (AI) (2025-11-25~2025-11-29)

## 다음 회의
- **일시**: 2025-11-26

## 기타 사항
- 모든 회의록은 GitHub의 docs/meeting-notes/ 디렉토리에 저장
- 회의록은 회의 종료 후 24시간 내에 공유

---
**작성자**: 이유진  
**작성일**: 2025-11-25