feat: add group recipe sharing and translation

README.md

@@ -5,11 +5,12 @@ Instagram 게시물과 YouTube 영상의 텍스트를 레시피로 구조화해
 ## 현재 구현 범위
 
 - Google Authorization Code/OIDC 로그인, PKCE `S256`, 이메일 allowlist
-- HttpOnly 자체 인증 cookie와 소유자별 API 접근 제어
+- HttpOnly 자체 인증 cookie와 그룹 멤버 간 recipe 공유
 - Instagram caption 추출 및 YouTube 설명·자막·timestamp 추출
 - MiniMax OpenAI 호환 Chat Completions API를 이용한 레시피 구조화
+- 영어 등 외국어 원문의 recipe 필드를 자연스러운 한국어로 번역
 - AI 결과 미리보기/편집 후 저장
-- Recipe CRUD, 소유자·원본별 중복 방지
+- Recipe CRUD, 그룹 멤버 조회와 소유자·원본별 중복 방지
 - 외부 이미지를 최대 1280px WebP로 변환해 `IMAGE_ROOT`에 저장
 - 반응형 Recipe 목록/상세 화면과 YouTube timestamp 링크
 - nginx, systemd 운영 예제
@@ -158,12 +159,22 @@ ID와 비밀번호로 서버에서 자동 로그인하지 않습니다. cookie
 MongoDB는 `our_recipe_atlas` 하나만 사용하고 collection으로 환경을 분리합니다.
 
 - 공통: `allowed_google_emails`
-- 개발: `users_dev`, `recipes_dev`
-- 운영: `users`, `recipes`
+- 개발: `users_dev`, `groups_dev`, `recipes_dev`
+- 운영: `users`, `groups`, `recipes`
 - 각 `users*.googleSub`: unique index
+- 각 `groups*.memberGoogleSubs`: 조회 index
 - 각 `recipes*`: `ownerGoogleSub + source.platform + source.sourceId` unique index
 - 원본 text와 YouTube transcript를 recipe source에 보존해 재분석에 사용할 수 있습니다.
 
+그룹 문서는 recipe를 함께 볼 Google 계정의 `sub`를 보관합니다. 그룹이 없는 사용자는 자기 recipe만 볼 수 있고, 같은 그룹의 recipe는 함께 조회하되 수정과 삭제는 작성자만 할 수 있습니다.
+
+```json
+{
+  "name": "우리 가족",
+  "memberGoogleSubs": ["google-sub-1", "google-sub-2"]
+}
+```
+
 이미지의 DB 값은 다음과 같은 상대 경로뿐입니다.
 
 ```text
@@ -174,13 +185,13 @@ recipes/<recipe-id>/cover.webp
 
 ## API
 
-모든 `/api/**` endpoint는 인증 cookie가 필요하며 로그인한 사용자의 데이터만 반환합니다.
+모든 `/api/**` endpoint는 인증 cookie가 필요합니다. Recipe 목록과 상세는 같은 그룹 멤버에게 공유되고, 생성·수정·삭제 권한은 작성자에게 유지됩니다.
 
 | Method | Path | 역할 |
 | --- | --- | --- |
 | `POST` | `/api/import/preview` | URL 추출 및 AI recipe 미리보기 |
-| `GET` | `/api/recipes` | 내 recipe 목록 |
-| `GET` | `/api/recipes/:id` | 내 recipe 상세 |
+| `GET` | `/api/recipes` | 내 그룹의 recipe 목록 |
+| `GET` | `/api/recipes/:id` | 내 그룹의 recipe 상세 |
 | `POST` | `/api/recipes` | 미리보기 확인 후 저장 |
 | `PATCH` | `/api/recipes/:id` | recipe 필드 수정 |
 | `DELETE` | `/api/recipes/:id` | recipe와 로컬 이미지 삭제 |
@@ -199,7 +210,7 @@ npm test
 npm run lint
 ```
 
-테스트 범위에는 URL/ID 판별, AI schema, timestamp 정규화, allowlist, 인증 middleware, 소유자 격리, CRUD, 중복 source 처리, 이미지 상대경로와 SSRF 차단이 포함됩니다.
+테스트 범위에는 URL/ID 판별, AI schema, timestamp 정규화, allowlist, 인증 middleware, 그룹 공유와 소유자 쓰기 권한, CRUD, 중복 source 처리, 이미지 상대경로와 SSRF 차단이 포함됩니다.
 
 실제 계정과 네트워크가 준비된 뒤에는 별도 smoke test로 다음을 확인합니다.