투니버스

README excerpt

# 🧵 Memory Thread

> **어르신의 기억을 되살리는 AI 말벗 서비스**  
> 가족이 입력한 인생 맥락을 AI가 통째로 기억하고, 먼저 말을 건네며 기억과 감정을 자극하는 비의료적 인지 자극 플랫폼

<br/>

## 📖 서비스 소개

Memory Thread는 고령 어르신을 위한 AI 기반 대화형 기억 복원 서비스입니다. 단순한 챗봇이 아닌, **가족이 등록한 어르신의 인생 맥락(고향, 가족, 직업, 취미, 추억, 건강)과 가족 사진을 AI가 모두 기억**하고, 이를 바탕으로 어르신에게 먼저 질문을 건네며 자연스러운 대화를 이끌어냅니다.

### 🎯 핵심 가치

1. **맥락 기반 대화**: Gemini 1.5 Pro의 1M 토큰 컨텍스트 윈도우를 활용해 RAG 없이 어르신의 인생 전체를 이해
2. **AI 주도 대화**: 어르신이 먼저 말하지 않아도 AI가 맥락 기반으로 질문을 시작
3. **기억 이미지 복원**: 가족 사진과 대화 내용을 결합해 Gemini 3.1 Flash Image로 새로운 기억 이미지 생성
4. **간편한 접근성**: 스마트폰에 익숙하지 않은 어르신을 위한 4자리 PIN 로그인과 큰 글씨 UI
5. **게이미피케이션**: 대화 3회마다 포인트 지급, 뱃지 획득으로 지속적 참여 동기 부여

### 🌟 주요 기능

#### 👵 어르신 기능
- **AI 기억 대화**: AI가 먼저 질문을 건네며 자연스러운 대화 시작
- **기억 이미지 복원**: 가족 사진을 보며 대화 → AI가 기억을 반영한 새 이미지 생성
- **음성 대화**: 텍스트 입력 대신 음성으로 편하게 대화 (STT/TTS)
- **포인트 & 뱃지**: 대화 3회마다 +10점, 100점마다 뱃지 획득

#### 👨‍👩‍👧 가족 기능
- **어르신 등록**: 이름과 4자리 PIN으로 간편 등록
- **텍스트 컨텍스트 관리**: 고향/가족/직업/취미/추억/건강 6가지 카테고리 정보 입력
- **이미지 컨텍스트 관리**: 가족 사진 업로드 및 캡션 등록
- **로그인 설정**: 어르신 PIN 변경 관리

<br/>

## 🏗️ 기술 아키텍처

### 시스템 구조도

```

graph TB
    subgraph "Frontend - Next.js 15"
        A[홈 페이지]
        B[어르신 로그인<br/>4자리 PIN]
        C[가족 로그인<br/>ID/PW]
        D[채팅 페이지<br/>AI 대화]
        E[기억복원 페이지<br/>이미지 생성]
        F[뱃지 페이지<br/>포인트/뱃지]
        G[관리 대시보드<br/>어르신 목록]
        H[어르신 관리<br/>컨텍스트 입력]
    end

    subgraph "API Routes"
        API1[/api/auth/elder<br/>PIN 인증]
        API2[/api/auth/family<br/>가족 로그인]
        API3[/api/chat<br/>AI 대화]
        API4[/a