35 lines
2.1 KiB
Markdown
35 lines
2.1 KiB
Markdown
# ADR — Local catalogue, không cloud sync
|
||
|
||
Trạng thái: chấp nhận · 2026-09-28 · nhánh `recipes-web`
|
||
|
||
## Bối cảnh
|
||
|
||
Studio PWA (`docker/frontend`) đọc thư mục trên máy người dùng qua File System Access API.
|
||
Bản nháp thiết kế `lightroom_web_app.md` giả định endpoint `/v1/sync/edits` và auth
|
||
`Authorization: Bearer localStorage['pro_user_token']`. Backend thật (Fastify + SQLite) chỉ biết
|
||
ảnh upload qua `/api/photos` (cap 12/tài khoản) và recipe qua `/api/recipes`; auth bằng cookie
|
||
`SESSION_COOKIE` HttpOnly. Không có `photoId` phía server để gắn edit vào — endpoint đó không
|
||
thể tồn tại. Tính năng được yêu cầu là *quản lý local*, nên phần sync là YAGNI.
|
||
|
||
## Quyết định
|
||
|
||
1. **Freeze scope:** catalog và edit chỉ nằm trên máy người dùng. Không thêm bảng, không endpoint sync.
|
||
2. **IndexedDB `recipescam-library`** (version 1), ba store — theo đúng `src/engine/library.ts`:
|
||
- `folders` — keyPath `name`
|
||
- `photos` — keyPath `id` = `${folder}/${name}`, index `folder`, `taken`
|
||
- `edits` — keyPath `photoId`, `{ recipe, updatedAt }`
|
||
3. **API cùng origin** qua nginx proxy `/api/` → `fetch(..., { credentials: 'same-origin' })`
|
||
(`src/api.ts`). Không `'include'`, không Bearer.
|
||
4. **Nhận diện ảnh:** trước mắt chỉ `folder/name`. Khi cần sync thật: partial hash
|
||
(first + last 64 KiB + size), và chỉ hash những frame *thực sự có edit*. Lưu ý `scanFolder`
|
||
vốn đã đọc trọn bytes mỗi RAW cho `rawThumbnail`, nên "hash đắt vì phải đọc 30–50 MB" không
|
||
phải lập luận đúng; cái làm `filename+size+mtime` mất map recipe là rename và copy từ card
|
||
(mtime đổi, bytes y hệt).
|
||
|
||
## Hệ quả
|
||
|
||
- Không có gì để "cắt Cloud Sync": trong repo chưa từng có code sync.
|
||
- Nếu sau này cần: thêm `library_edits (user_id, key, recipe, updated_at)` + `GET/POST
|
||
/api/library/edits` (upsert theo batch, LWW theo `updated_at`), client flush khi `online`,
|
||
xác thực bằng cookie session, key = partial hash. Ước ~60–80 dòng.
|