아키텍처 문서: 왜 필요한가?

README는 "이 프로젝트가 뭔지" 알려준다. 아키텍처 문서는 "이 시스템이 어떻게 돌아가는지" 알려준다.

---

아키텍처 문서 구조 (C4 Model 기반)

레벨	이름	독자	내용
L1	System Context	비개발자	시스템과 외부 연동
L2	Container	아키텍트	서비스/DB/큐 구성
L3	Component	개발자	모듈/클래스 수준
L4	Code	유지보수자	핵심 클래스 UML

제조 AI 프로젝트에서는 L2 (Container) + 데이터 흐름도가 핵심

---

제조 AI 시스템의 데이터 흐름도

---

Mermaid로 다이어그램 그리기

GitHub README에서 바로 렌더링되는 Mermaid:

장애 대응 런북 (Runbook) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━

증상: Neo4j 연결 실패 원인: 1) Neo4j 컨테이너 다운 2) 메모리 부족 3) 볼륨 마운트 이상

대응:

1. docker ps | grep neo4j 로 상태 확인
2. docker logs neo4j --tail 50 로 로그 확인
3. 컨테이너 재시작: docker-compose restart neo4j
4. 메모리 부족 시: NEO4J_HEAP_SIZE 조정 후 재시작

에스컬레이션:

• 30분 내 해결 안 되면 → 인프라팀 연락