🏆45분
Challenge: 제조 AI 어시스턴트 설계 문서 작성
시스템 아키텍처 설계
Challenge: 제조 AI 어시스턴트 설계 문서 작성
통합 프로젝트 > 시스템 아키텍처 설계
Challenge: 전체 설계 문서
요구사항
내일부터 코딩을 시작할 수 있도록 완전한 설계 문서를 작성하세요.
설계 문서 구조
1. 개요
- 시스템 목적
- 핵심 기능 3가지
- 기술 스택
2. 아키텍처
- 4-Layer 다이어그램
- 컴포넌트 목록과 역할
- 의존성 방향
3. 유스케이스 & 시퀀스
- UC1: 설비 트러블슈팅
- UC2: 안전 규정 조회
- UC3: 설비 영향도 분석
- (추가) UC4: 문서 업로드 & 검색
4. 인터페이스 정의
- RAGService.search(query, k) -> list[Document]
- KGService.find_related(entity_id, depth) -> dict
- AgentOrchestrator.process(input, history) -> Response
- (각 메서드의 파라미터 타입과 반환 타입)
5. 에러 핸들링
- Neo4j 연결 실패 시 -> RAG만으로 폴백
- OpenAI API 실패 시 -> 에러 메시지 표시
- ChromaDB 비어있을 때 -> 문서 업로드 안내
6. 배포 계획
- Docker Compose 구성
- 필요한 포트 및 볼륨보너스
- 성능 요구사항 (응답 시간 목표)
- 향후 확장 계획 (마이크로서비스 전환 시 분리 지점)
- 테스트 전략 (단위/통합/E2E)
요구사항
4-Layer 아키텍처 다이어그램 (Mermaid)
주요 유스케이스 3개 이상의 시퀀스 다이어그램
컴포넌트별 인터페이스 정의 (메서드 시그니처)
디렉토리 구조와 각 파일의 역할 설명
외부 의존성 목록과 버전
에러 핸들링 전략 (폴백 시나리오)
평가 기준
- • 아키텍처의 계층 구조가 명확한가
- • 컴포넌트 간 의존성 방향이 올바른가
- • 유스케이스별 데이터 흐름이 논리적인가
- • 에러 상황에 대한 폴백이 정의되어 있는가
- • 설계만 보고 구현을 시작할 수 있는 수준인가
보너스
- • 성능 요구사항을 수치로 정의 (예: 응답 5초 이내)
- • 마이크로서비스 전환 시 분리 포인트 명시
- • CI/CD 파이프라인 설계
AI로 학습하기 — 꿀팁
제조 AI 어시스턴트 설계 문서 검토AI 학습 팁
AI에게 설계 문서의 아키텍처 결정 근거, 컴포넌트 인터페이스, 비기능 요구사항 누락을 검토받으세요.
제조 AI 어시스턴트 아키텍처 설계 문서를 작성 중이다. 다음 항목을 검토하고 미비한 부분을 지적해줘: (1) RAG·KG·Agent 컴포넌트 선택 근거가 요구사항과 연결되어 있는가, (2) 컴포넌트 간 API 인터페이스 명세가 완전한가, (3) 제조 환경 특수 요구사항(OT/IT 분리, 실시간성, 가용성 SLA)이 반영되어 있는가, (4) 확장성·보안·운영 모니터링 요구사항이 누락되었는가.
이 팁이 도움이 됐나요?