# 뿌까에

> 휴대폰 하나로 한국어·크메르어·영어를 마주 보고 통역해요

- 앱 쪽: https://lastai.org/apps/pukae
- 만든 사람: Holytaks
- 쓸 수 있는 곳: Android
- 출처: LastAI 모두의 앱. 관리자가 확인한 뒤 공개한 설계도입니다.

## 무엇을 하나요

두 사람이 휴대폰 하나를 사이에 두고 마주 앉아 말하면, 말한 언어를 알아듣고 상대 언어로 들려주며 양쪽에 자막으로도 보여 줘요. 한국어·크메르어(캄보디아어)·영어 세 언어를 써요. 통역 말고도 번역·학습·사전 메뉴가 있어요.

## 처음 쓰는 법
- 앱을 열고 내 언어와 상대 언어를 고르세요.
- 설정에서 '선택한 모델 설치'를 누르면 기기 안에서 통역하는 무료 모델(약 1.5GB)을 받아요. 와이파이에서 받는 것을 권해요.
- 아래쪽 동그란 버튼을 누른 채 말하고 손을 떼면 통역해 줘요.

## 무료와 고급
- 무료: 모델을 설치하면 인터넷 없이 기기 안에서 통역해요. 횟수 제한이 없어요.
- 고급: 인터넷으로 더 자연스럽게 통역해요. 설치하면 5번 써 볼 수 있고, LastAI 계정을 연결하면 10번을 더 써 볼 수 있어요.

## 이 앱이 쓰는 권한
- 마이크: 말을 듣고 통역하려고 써요.
- 인터넷: 모델을 받거나 고급 통역을 쓸 때 써요.

## 알아 두기
- 지금은 Android 시험판이에요(Android 9 이상, 64비트 ARM 휴대폰).
- 아이폰판은 등록한 시험 기기에서만 쓰고 있어요.
- 통역은 틀릴 수 있어요. 돈·약·계약처럼 중요한 내용은 꼭 다시 확인하세요.

## 1. 기획

## 누구를 위해
캄보디아에서 함께 일하고 생활하는 한국인과 캄보디아 사람, 그리고 영어로 말하는 사람. 통역사 없이 마주 앉아 바로 이야기하고 싶을 때 쓴다.

## 풀고 싶은 불편
- 번역 앱에 글을 입력하고 화면을 돌려 보여 주는 일이 번거롭다.
- 크메르어를 제대로 지원하는 통역 앱이 적다.
- 인터넷이 약한 현장에서도 써야 한다.

## 꼭 있어야 하는 기능
- 버튼을 누른 채 말하면 상대 언어 음성과 양쪽 자막
- 말한 언어 자동 판별(한국어·크메르어·영어)
- 인터넷 없이 쓰는 무료 모드와 더 자연스러운 고급 모드
- 대화 기록 공유, 번역·학습·사전

## 2. 설계도

## 화면
- 통역: 위쪽은 맞은편 사람의 자막, 아래쪽은 내 자막. 아래쪽 오브를 누른 채 말한다.
- 번역: 말하거나 입력한 글을 번역하고 .txt로 저장·공유한다.
- 학습·사전: 생활 장면 단어 미션과 세 언어 사전
- 설정: 내 언어·상대 언어, 무료 모델 설치, 고급 모드

## 무료 통역 흐름
말소리 → 언어 판별 → 받아쓰기(Whisper, 크메르어는 전용 모델) → 번역(Hy-MT2 1.8B) → 음성(크메르어는 VITS, 한국어·영어는 기기 음성)

## 고급 통역 흐름
말소리를 서버를 거쳐 Gemini Live로 보내 번역 음성과 자막을 받는다. 숫자·돈·시간처럼 중요한 표현은 Claude가 원문 자막과 번역 자막을 한 번 더 대조하고, 다르면 '검토 번역'을 따로 보여 준다.

## 저장하는 자료
- 언어·모델 설정과 설치 자격만 기기에 저장한다.
- 녹음과 자막은 메모리에만 두고, 새 대화를 시작하거나 앱을 닫으면 지운다.

## 3. 구현

## 만든 도구
- 화면과 기능 모두 Rust. 아이폰은 UIKit, Android는 기본 컨트롤로 그린다.
- 받아쓰기 whisper.cpp, 번역 llama.cpp(Hy-MT2), 크메르어 음성 ONNX Runtime(VITS)
- 고급 모드 서버: Rust, Gemini Live API, Claude API

## 만든 순서
1. 통역 한 번(말하기 → 자막 → 음성)이 되는 화면부터 만든다.
2. 무료 모델을 기기에서 돌리고, 모델 설치(이어받기와 크기·SHA-256 확인)를 붙인다.
3. 언어 자동 판별과 두 사람 대화 흐름을 다듬는다.
4. 고급 모드 서버와 체험 횟수·지갑을 붙인다.
5. 번역·학습·사전을 더한다.

## 따라 만들 때 조심할 점
- 크메르어 받아쓰기·음성 모델은 따로 고르고, 원어민에게 꼭 들려서 확인한다.
- 앱 안에 AI 서비스 키를 넣지 않는다. 고급 모드는 서버를 거친다.
- 내려받는 모델 파일은 크기와 SHA-256을 확인한 뒤에 설치한다.

## 이 설계도로 만들기

이 문서를 AI에게 주고 "이 설계도대로 같은 앱을 만들어 줘"라고 요청하세요. AI는 먼저 기획과 설계도를 짧게 정리해 확인을 받은 뒤, 구현 순서대로 하나씩 만들면 됩니다.