📗 말씀동행 – 상세 설계 명세서 (Detailed Design Specification)

0. 설계 원칙 요약

1. 성경 본문은 DB 정본(SoT), 앱은 캐시(읽기 최적화)
2. LLM은 대화 생성자, 성경 인용은 검색 기반(grounded)
3. AI는 “설교/강론”이 아니라 대화(공감-질문-정리-선택적 인용)
4. 인용 구절은 DB에 존재하는 본문만 가능(임의 생성 금지)
5. 개인정보/상담 내용은 최소 수집·최소 전달·선택 삭제

참고(법적 근거 확인): 대한성서공회 FAQ에 따르면 개역한글판은 저작재산권 보호기간 경과로 저작권료 없이 사용 가능하나, **성명표시권/동일성유지권 등 인격권 준수(출처 명시·무단 변경 금지)**가 필요합니다. 대한성서공회+1

1. 시스템 구성(논리/물리 아키텍처)

1.1 논리 아키텍처(핵심 컴포넌트)

• Mobile App (Flutter / RN)
  • Bible Reader UI, Search UI, Chat UI
  • 로컬 캐시(장 단위), 북마크/메모 로컬 저장
• Backend API (FastAPI 권장)
  • Bible API(조회/검색)
  • Chat Orchestrator(세션, 메모리, 안전/정책)
  • Verse Retrieval(구절 검색/선정)
• Bible DB (PostgreSQL + FTS)
  • verse 단위 저장, 장 단위 해시
  • 검색 인덱스(FTS + 부분일치)
• Conversation Store
  • 기본: 서버 저장 최소화(옵션화)
  • 운영/품질 개선용으로 익명화 로그 최소 저장(옵션)
• LLM Gateway
  • 외부 LLM API 호출, 프롬프트 템플릿/정책 적용
  • 장애 시 degrade 모드(인용 없이 대화, 혹은 상담 제한)

1.2 물리 배포(권장)

• 단일 VPC/클라우드 또는 온프레미스
  • api (FastAPI) + postgres + redis(선택) + observability(선택)
• 확장:
  • 검색 부하 증가 시: OpenSearch 교체 가능 구조(비기능 요구사항 반영)