Appearance
Database: File Service (metadata)
Version: 1.30
Date: 2026-11-17
Status: Working baseline (PROPOSED — object name UUIDv7; cột storage_name)
Owner repo: platform-file-service/
DB id: db-file-service
Tên: File Service DB
Tên vật lý: file_service (DECIDED — PostgreSQL schema name; D-022 / R3)
Architecture SoT: /architecture/05-storage-and-file-service
Một file docs = một database. Bytes không nằm Postgres (folder temp / local / object cloud).
1. Mục đích
SoT metadata + đăng ký cloud + cấu hình TTL/job cho vòng đời:
- Upload tạm → folder temp FS + bảng tạm
- Promote → file thật trên local + xóa tạm
- Hết thời gian giữ local → job sync lên R2/S3 (retry / purge local tách bước)
- Truy xuất variant →
GET /files/{file_id}/{size}: authorize → check disk → miss thì gen → ghi disk + hàngvariant_cache(GC giống temp; không dùngsystemd-tmpfiles)
2. Flow Owner → lớp lưu trữ
text
Client
│ (1) upload tạm
▼
[temp folder FS] + bảng temp_uploads
│ (2) promote (temp id còn hạn)
▼
[local folder FS] + bảng files (tier=local, sync_status=pending khi đến hạn)
│ (3a) job sync → cloud (3b) job purge local sau SYNCED
▼
[R2/S3] + files (tier=cloud) ; local bytes xóa khi purge_status xong
│ (4) request (variant theo size hoặc gốc)
▼
Variant folder (cache) ← sinh on-demand nếu miss| Giai đoạn | Bytes ở đâu | Hàng DB |
|---|---|---|
| (1) Tạm | Folder temp (FS_TEMP_ROOT) | temp_uploads |
| (2) Sau promote | Folder local (FS_LOCAL_ROOT) | files (storage_tier=local) |
| (3) Sau sync | R2/S3 | files (storage_tier=cloud); local cleanup qua purge_status |
| Variant | {FS_VARIANT_ROOT}/{file_id}/{size}.webp | variant_cache + config.variant.*; nguồn gốc = files |
3. Engine / topology
| Hạng mục | Trạng thái |
|---|---|
| Engine | DECIDED PostgreSQL (D-022) |
| Schema | file_service (DECIDED) |
| Cloud credentials | storage_connections (secret ciphertext; KEK Infisical) |
| Temp / local / variant root paths | ENV qua Infisical (D-016) — không bảng DB |
| Thời gian | UTC (tz=0) — xem dưới |
3.1 Quy ước thời gian (UTC)
- Mọi cột thời gian (
created_at,promoted_at,local_retain_until, …): lưu UTC, kiểuTIMESTAMPTZ. - PostgreSQL / server / connection:
TimeZone=UTC(hoặc tương đương) khi triển khai — tránh lệch session mặc định máy chủ. - Segment
YYYY/MM/DDtrongstorage_key: cắt từcreated_atUTC. - So sánh TTL/GC/migrate: dùng
now()UTC phía DB/app. - Cron (
local.migrate_cron,local.purge_cron, …): schedule bằngnode-cronvớitimezone: 'UTC'— off-peak = giờ UTC trong biểu thức (khôngwindow_tz). - Client (platform-web, App): nhận ISO UTC từ API → format local TZ khi hiển thị cho user.
Quy ước chung gói DB: /architecture/database/00-overview §2.
4. Danh mục bảng & chính sách ID (D-017)
Prefix {name}_ + NanoID chỉ khi ID ổn định và lộ API/SDK/URL/admin cross-ref.
Nội bộ: string UUID/NanoID không prefix (hoặc PK tự nhiên) — không publish cho service/App khác.
Cột Ví dụ trên các bảng schema bên dưới là minh họa (không phải dữ liệu production / không khóa format NanoID length).
Tên bảng trong schema file_service: không thêm prefix domain thừa (file_ / storage_) cho bảng ops nội bộ — dùng config, variant_cache, migration_jobs (Owner 2026-11-16). Prefix D-017 FS chỉ file_ / tmp_ (publish); ID storage_connections không prefix (Owner 2026-11-16).
| # | Bảng | ID / Prefix | Publish? | Mục đích | Status |
|---|---|---|---|---|---|
| 1 | storage_connections | nội bộ (NanoID/UUID, không stc_) | Không (chỉ trong FS / admin FS) | Kết nối R2/S3 (+ OSS) + health/ops | PROPOSED |
| 2 | temp_uploads | tmp_… | Có (client promote) | Upload tạm (receiving → ready) | PROPOSED |
| 3 | files | file_… | Có (App / Core / API) | File đã promote + sync/purge (+ trạng thái sync trên hàng) | PROPOSED |
| 4 | variant_cache | UK (file_id, size_px) | Không | Index GC variant (giống temp) | PROPOSED |
| 5 | config | PK = key | — | TTL / cron (UTC) / allowlist / batch migrate (temp/local/migration/variant) | PROPOSED |
| 6 | migration_jobs | nội bộ | Không | Mỗi lần chạy batch local→cloud (1 row / run) | PROPOSED |
Không có
upload_sessions. Không cófile_quotas/file_usage— hạn mức/tính phí/thống kê dung lượng thuộc dịch vụ lưu trữ / billing riêng (tương lai).
Không cóworkspace_storage_policies/ cộtworkspace_id— FS không gắn Workspace (Owner 2026-11-16).
Không cóstorage_volumes— root ENV Infisical. Temp flat +storage_name; GCcreated_at+TTL; xóa vật lý.
Local/cloud: cùngstorage_key; basename =storage_name={uuidv7}.{ext}(không gắnfile_id); cộtstorage_nameriêng trên temp + files (Owner 2026-11-17).
Variant: GCcreated_at+variant.ttl; disk-first. Khôngsync_attempts/application_id.audit_events(FS) = DEFERRED phase này (Owner 2026-11-17) — không nhầm vớiaudit_eventsPlatform Core.
Đã rút tên:file_config→config,storage_migration_jobs→migration_jobs.
5. ER
6. Bảng: storage_connections
| Cột | Kiểu | Null | Ghi chú | Ví dụ |
|---|---|---|---|---|
id | TEXT PK | NO | Nội bộ — NanoID/UUID không prefix D-017 | 7Kx9mQ2pL0nR4wYv |
name | TEXT | NO | Tên ops | r2-prod |
kind | TEXT | NO | s3 | r2 | rustfs | … | r2 |
endpoint | TEXT | YES | URL API | https://<accountid>.r2.cloudflarestorage.com |
region | TEXT | YES | auto | |
default_bucket | TEXT | YES | minap-files-prod | |
path_style | BOOLEAN | YES | Force path-style (OSS) | false |
ssl_enabled | BOOLEAN | NO | Mặc định true | true |
signature_version | TEXT | NO | Mặc định v4 | v4 |
public_base_url | TEXT | YES | CDN / URL công khai nếu có | https://cdn.example.com |
connection_timeout_ms | INT | NO | 3000 | |
upload_part_size_bytes | BIGINT | YES | Multipart | 8388608 (8 MiB) |
max_concurrent_sync | INT | YES | Giới hạn worker sync | 4 |
default_storage_class | TEXT | YES | STANDARD | |
access_key_id | TEXT | YES | AKIA… / R2 access key | |
secret_ciphertext | BYTEA/TEXT | YES | Không plaintext | v1:kekA:base64… |
secret_kek_version | TEXT | YES | kek-2026-11 | |
is_default_cloud | BOOLEAN | NO | Đích migrate mặc định nền tảng (SoT duy nhất — không config.cloud.*) | true |
status | enum | NO | active | readonly | disabled | active |
last_health_check_at | TIMESTAMPTZ | YES | 2026-11-17T01:00:00Z | |
last_health_check_status | TEXT | YES | ok | error | ok |
last_health_check_error | TEXT | YES | null / timeout | |
extra | JSONB | YES | {"account_id":"…"} | |
created_at / updated_at | TIMESTAMPTZ | NO | 2026-11-01T00:00:00Z |
7. Disk roots (ENV / Infisical — không bảng)
Root path không lưu Postgres. File Service đọc ENV (Infisical, D-016), ví dụ:
| ENV (minh họa) | Role |
|---|---|
FS_TEMP_ROOT | Upload tạm |
FS_LOCAL_ROOT | Bản gốc sau promote (local tier) |
FS_VARIANT_ROOT | Cache variant WebP theo size (nhiều file trong một {file_id}/) |
Tên file vật lý (basename): {uuidv7}.{ext} — tách khỏi file_id / tmp_… (API id). Ext từ upload (allowlist). Lý do dài hạn: CDN/path lộ, version/quarantine, đổi format D-017 không kéo theo rename object.
Cột storage_name trên temp_uploads và files = basename đó (dễ ops / rename / version sau này).storage_key (chỉ trên files) = relative path đầy đủ, kết thúc bằng storage_name.
Temp (flat): {FS_TEMP_ROOT}/{storage_name} — không chia ngày.
Local / cloud — cùng relative storage_key:
text
{uploader_account_id}/{source_seg}/{YYYY}/{MM}/{DD}/{storage_name}| Segment | Quy tắc |
|---|---|
uploader_account_id | acc_… |
source_seg | source_id nếu có; không có → _ |
YYYY/MM/DD | Từ files.created_at (UTC) |
storage_name | {uuidv7}.{ext} — không file_id, không display_name |
- Local:
{FS_LOCAL_ROOT}/{storage_key} - Cloud:
{storage_bucket}/{storage_key}(cùng key; migrate không đổistorage_name/storage_key) - Variant:
{FS_VARIANT_ROOT}/{file_id}/{size}.webp(cache theo API id — OK)
→ Không storage_rel_path. Promote: giữ nguyên storage_name từ temp → files (move/rename path prefix thôi).
8. Bảng: temp_uploads — bước (1)
| Cột | Kiểu | Null | Ghi chú | Ví dụ |
|---|---|---|---|---|
id | TEXT PK | NO | tmp_ + NanoID — trả client để promote | tmp_V1StGXR8_Z5jdHi6B |
uploader_account_id | TEXT | NO | acc_… | acc_3f9kQ2LmNpRsTuVw |
source_kind | TEXT | NO | application | platform | service | unknown | application |
source_id | TEXT | YES | Id theo kind | app_chat01 / platform_core / chat_gw |
purpose | TEXT | YES | account_avatar / chat_attachment | |
display_name | TEXT | YES | Tên user thấy | avatar.png |
storage_name | TEXT | NO | Basename vật lý trên disk = {uuidv7}.{ext} (tách khỏi tmp_…) | 019a3f2c-8b1e-7c4d-9e0f-1a2b3c4d5e6f.png |
content_type | TEXT | YES | image/png | |
size_bytes | BIGINT | YES | Bytes đã nhận / khi ready | 245760 |
checksum | TEXT | YES | sha256:a3f2… | |
status | enum | NO | receiving | ready | promoted | expired | purged | ready |
promoted_file_id | TEXT | YES | → files.id sau promote (liên kết một chiều; không cột ngược trên files) | null → file_9xK2mN… |
created_at / updated_at | TIMESTAMPTZ | NO | Neo TTL | 2026-11-17T10:00:00Z |
Disk path: {FS_TEMP_ROOT}/{storage_name} (flat).
Lúc tạo temp: mint storage_name = {uuidv7}.{ext} (độc lập tmp_…); ghi bytes vào path đó.
Còn hạn / promote: created_at + parse(temp.ttl) > now() (đọc TTL runtime từ config — không cột expires_at).
Job GC temp (temp.cleanup_cron) — xóa vật lý:
text
WHERE status IN (receiving, ready)
AND created_at < now() - parse(temp.ttl)
→ unlink {FS_TEMP_ROOT}/{storage_name}
→ status=purged (hoặc DELETE row)Đổi temp.ttl → toàn bộ temp apply liền theo created_at (rút ngắn TTL có thể GC hàng loạt — thao tác ops có ý thức).
9. Bảng: files — bước (2)(3)(4)
| Cột | Kiểu | Null | Ghi chú | Ví dụ |
|---|---|---|---|---|
id | TEXT PK | NO | file_ + NanoID (D-017) | file_9xK2mNpQsTuVwXyZ |
display_name | TEXT | NO | Tên hiển thị | bao-cao-q3.pdf |
storage_tier | enum | NO | local | cloud — nơi bytes gốc hiện tại | local → sau migrate cloud |
sync_status | enum | NO | none | pending | syncing | synced | failed | pending |
purge_status | enum | NO | none | local_cleanup | purged | none |
sync_attempt_count | INT | NO | Số lần fail thật (hết retry trong job); chưa kể lần PutObject trung gian | 0 / 2 |
last_sync_at | TIMESTAMPTZ | YES | 2026-11-18T15:02:11Z | |
last_sync_error | TEXT | YES | null / PutObject timeout | |
last_sync_error_code | TEXT | YES | null / S3_TIMEOUT | |
last_migration_job_id | TEXT | YES | → migration_jobs.id | null / mjob_a1b2c3d4 |
storage_connection_id | TEXT | YES | → storage_connections.id khi cloud | null → 7Kx9mQ2pL0nR4wYv |
storage_bucket | TEXT | YES | Bucket khi cloud | minap-files-prod |
storage_name | TEXT | NO | Basename vật lý {uuidv7}.{ext} (copy từ temp lúc promote) | 019a3f2c-8b1e-7c4d-9e0f-1a2b3c4d5e6f.pdf |
storage_key | TEXT | NO | Relative path chung local+cloud; suffix = storage_name | acc_3f9k…/app_chat01/2026/11/17/019a3f2c-….pdf |
local_retain_until | TIMESTAMPTZ | YES | Đến hạn → pending | 2026-11-24T10:05:00Z |
promoted_at | TIMESTAMPTZ | YES | 2026-11-17T10:05:00Z | |
size_bytes | BIGINT | YES | 1048576 | |
content_type | TEXT | YES | application/pdf | |
checksum | TEXT | YES | sha256:b1c2… | |
purpose | TEXT | NO | chat_attachment / account_avatar | |
source_kind | TEXT | NO | application | platform | service | unknown | service |
source_id | TEXT | YES | Id theo kind | chat_gw / app_chat01 / platform_core |
uploader_account_id | TEXT | NO | acc_3f9kQ2LmNpRsTuVw | |
status | enum | NO | available | soft_deleted | held | available |
deleted_at | TIMESTAMPTZ | YES | null | |
created_at / updated_at | TIMESTAMPTZ | NO | 2026-11-17T10:05:00Z |
Index sweep (tham khảo):
(storage_tier, sync_status, local_retain_until, id)— job chọn file đến hạn sync(purge_status, id)— job xóa local sau sync(uploader_account_id, status)(purpose, status)
Promote — bước (2)
text
tmp_… còn hạn (temp.created_at + parse(temp.ttl) > now())
→ sinh file_id, created_at=now()
→ giữ storage_name từ temp (uuidv7.ext) — không đổi basename
→ source_seg = source_id ?? "_"
→ storage_key = {uploader_account_id}/{source_seg}/{YYYY}/{MM}/{DD}/{storage_name}
→ move {FS_TEMP_ROOT}/{storage_name} → {FS_LOCAL_ROOT}/{storage_key}
INSERT files:
storage_tier=local, storage_name=…, storage_key=…, promoted_at=now(), …
Cập nhật/xóa temp_uploadsInvariant: storage_key ends with / + storage_name. Version/quarantine sau này có thể thêm object/storage_name mới và cập nhật con trỏ trên files mà không đổi file_id.
Job migrate + purge — bước (3)
Lịch migrate = một config local.migrate_cron (UTC). Không window_start / window_end / window_tz — muốn chạy đêm (vd. 22:00–05:00 VN) thì ghi giờ UTC tương ứng trong cron.
text
(3a) Mỗi lần local.migrate_cron fire (UTC):
INSERT migration_jobs (status=running, …)
Chọn tối đa migration.batch_size files (bỏ purpose ∈ local.pin_purposes): …
Với từng file:
→ sync_status=syncing; last_migration_job_id=job.id
→ tries = 0
→ LOOP:
PutObject: bucket/default + **cùng** storage_key từ {FS_LOCAL_ROOT}/{storage_key}
success → storage_tier=cloud, sync_status=synced,
set storage_bucket + storage_connection_id,
purge_status=local_cleanup; success_count++; BREAK
fail → tries++
IF tries < migration.max_attempts:
sleep parse(migration.retry_delay); CONTINUE
ELSE:
sync_status=failed; sync_attempt_count++;
last_sync_error…; fail_count++; BREAK
→ (kết thúc file)
(3b) Purge local (local.purge_cron, UTC):
files WHERE purge_status=local_cleanup AND sync_status=synced
→ unlink {FS_LOCAL_ROOT}/{storage_key}
→ purge_status=purgedRetry trong cùng lần xử lý file: chờ migration.retry_delay rồi thử lại; chỉ khi hết migration.max_attempts mới tăng migration_jobs.fail_count và coi file fail thật.
Không xóa local trước khi cloud OK. Không đổi storage_key khi migrate.
10. Bảng: config
Cấu hình toàn File Service (không theo Workspace). PK = key; giá trị TEXT / số / JSON (kiểu chi tiết OPEN).
Quy ước key: {nhóm}.{setting} — nhóm = chức năng / vòng đời (không theo Workspace/App).
Duration (TTL / retain): value chuỗi parse bằng vercel/ms (ms('30m') → milliseconds) — vd. 30m, 1h, 7d. Không gắn đơn vị vào tên key. Số thuần chỉ cho count (batch_size, max_attempts, phần tử sizes). Runtime so sánh: created_at + ms(config_value).
Cron: schedule bằng node-cron — cron.schedule(expr, handler, { timezone: 'UTC', noOverlap: true }). Cú pháp (second optional):
text
# ┌────────────── second (optional)
# │ ┌──────────── minute
# │ │ ┌────────── hour
# │ │ │ ┌──────── day of month
# │ │ │ │ ┌────── month
# │ │ │ │ │ ┌──── day of week
# │ │ │ │ │ │
# * * * * * *Ví dụ value dưới đây = biểu thức 5 field (không second), khớp demo README node-cron. Off-peak: ghi giờ UTC trong field hour (vd. 15-21 ≈ 22:00–05:00 Asia/Ho_Chi_Minh).
temp.* — upload tạm
| key | Ý nghĩa | Ví dụ value |
|---|---|---|
temp.ttl | TTL — GC/promote so với created_at (không expires_at) | 30m / 1d |
temp.cleanup_cron | Job GC temp (mỗi 10 phút) | */10 * * * * |
temp.ext_allowlist | Ext cho phép trên storage_name | ["png","jpg","webp","pdf"] |
local.* — tier local (giữ / migrate / purge / pin)
| key | Ý nghĩa | Ví dụ value |
|---|---|---|
local.retain | Thời gian giữ local trước khi đủ điều kiện migrate | 7d |
local.migrate_cron | Lịch start migration_jobs (mỗi 15 phút, giờ UTC 15–21) | */15 15-21 * * * |
local.purge_cron | Purge local phút 0 mỗi giờ | 0 * * * * |
local.pin_purposes | purpose luôn giữ local (không migrate) | ["account_avatar"] |
migration.* — batch local→cloud
| key | Ý nghĩa | Ví dụ value |
|---|---|---|
migration.batch_size | Số file tối đa mỗi batch | 100 |
migration.max_attempts | Số lần PutObject tối đa / file trong một lần xử lý (kèm retry) | 5 |
migration.retry_delay | Chờ giữa các lần fail→retry (parse vercel/ms) | 5s / 30s |
variant.* — cache WebP multi-size
| key | Ý nghĩa | Ví dụ value |
|---|---|---|
variant.ttl | TTL — GC so với created_at | 7d |
variant.sizes | Allowlist size (px) | [96,128,192,256,384,512,768,1024] |
variant.cleanup_cron | GC variant phút 0 mỗi 6 giờ | 0 */6 * * * |
11. Variant — disk-first + bảng variant_cache
API (minh họa): GET /files/{file_id}/{size} với size ∈ allowlist (config.variant.sizes).
Layout disk (một folder / file_id, nhiều size):{FS_VARIANT_ROOT}/{file_id}/{size}.webp
Ví dụ:
text
{FS_VARIANT_ROOT}/file_xYz…/
96.webp
256.webp
512.webp11.1 Bảng: variant_cache
Index phục vụ GC (cùng mô hình temp: không expires_at); không publish ID; không thay bytes trên disk.
| Cột | Kiểu | Null | Ghi chú | Ví dụ |
|---|---|---|---|---|
file_id | TEXT | NO | → file_… (PK với size_px) | file_9xK2mNpQsTuVwXyZ |
size_px | INT | NO | Size allowlist; path = {file_id}/{size_px}.webp | 256 |
created_at | TIMESTAMPTZ | NO | Neo TTL | 2026-11-17T12:00:00Z |
last_access_at | TIMESTAMPTZ | YES | Touch khi hit (tùy chọn; LRU sau — hoãn implement) | 2026-11-18T08:15:00Z |
Index: (created_at), (file_id).
11.2 Serve + ghi cache
text
Authorize file_id (+ quyền xem variant)
Validate size ∈ allowlist
IF exists({FS_VARIANT_ROOT}/{file_id}/{size}.webp) → trả WebP
(tùy chọn: touch last_access_at)
ELSE
Đọc files → gen WebP → ghi disk
→ UPSERT variant_cache (file_id, size_px, created_at=now())
→ trả- Hot path: disk-first.
- Path disk suy từ
(file_id, size_px)— không cộtrel_path. - Lỗi gen variant không chặn original.
- Không
systemd-tmpfileslàm SoT GC.
11.3 Job GC (variant.cleanup_cron) — xóa vật lý
Giống temp — đổi variant.ttl apply liền theo created_at:
text
WHERE created_at < now() - parse(variant.ttl)
→ unlink {FS_VARIANT_ROOT}/{file_id}/{size_px}.webp
→ DELETE row
→ nếu không còn row cho file_id → rmdir folder rỗngReconcile orphan — hoãn đến implement (§15).
12. Bảng: migration_jobs
Mỗi lần chạy batch local→cloud = một hàng (orchestration). Chi tiết từng file = cột trên files, không bảng sync_attempts.
| Cột | Kiểu | Null | Ghi chú | Ví dụ |
|---|---|---|---|---|
id | TEXT PK | NO | Nội bộ | mjob_a1b2c3d4e5f6 |
status | enum | NO | running | succeeded | partial | failed | skipped | partial |
storage_connection_id | TEXT | YES | Đích batch | 7Kx9mQ2pL0nR4wYv |
batch_limit | INT | NO | Snapshot migration.batch_size | 100 |
selected_count | INT | NO | Số file chọn | 100 |
success_count | INT | NO | File sync OK trong batch | 97 |
fail_count | INT | NO | File hết retry vẫn fail (không đếm lần thử trung gian) | 3 |
skip_reason | TEXT | YES | Khi status=skipped | null / no_candidates |
started_at | TIMESTAMPTZ | NO | 2026-11-17T15:00:00Z | |
finished_at | TIMESTAMPTZ | YES | 2026-11-17T15:12:40Z | |
created_at | TIMESTAMPTZ | NO | 2026-11-17T15:00:00Z |
13. Mapping flow → bảng/job
| # | Flow | DB / disk | Job |
|---|---|---|---|
| 1 | Upload tạm | temp_uploads + FS_TEMP_ROOT | GC temp.* |
| 2 | Promote | files + promoted_at | — |
| 3a | Migrate cloud | migration_jobs + cập nhật files | local.migrate_cron (UTC) |
| 3b | Xóa local | purge_status trên files | local.purge_cron |
| 4 | Variant | disk + variant_cache; miss → files + gen | GC variant.* |
14. Ngoài phạm vi / đã loại hoặc hoãn
- PK integer auto-increment
- Secret plaintext trong DB
- Bảng CMS link /
documentId/locale/publishedAt - Gộp TEMP/VARIANT vào một enum sync trên cùng bảng file
- Prefix D-017 cho ID thuần nội bộ FS (jobs, storage_connections — Owner 2026-11-16: bỏ
stc_) - Bảng
sync_attempts(Owner 2026-11-16: bỏ; state sync trênfiles) - Bảng
upload_sessions(Owner 2026-11-16: bỏ; resume multipart = change control sau) - Bảng
file_quotas/file_usage(Owner 2026-11-16: không thiết kế trong FS; billing/thống kê = dịch vụ lưu trữ riêng) - Bảng tên cũ
thumbnail_cache_entries— thay bằngvariant_cache(Owner 2026-11-16) - Prefix domain thừa trên tên bảng ops (
file_config, …) — dùng tên ngắn trong schemafile_service - Bảng
workspace_storage_policies/ policy theo Workspace (Owner 2026-11-16: FS không policy theo Workspace) - Cột
workspace_idtrên metadata FS (Owner 2026-11-16: bỏ) - Bảng
storage_volumes(Owner 2026-11-16: root path = ENV/Infisical) - GC variant bằng
systemd-tmpfiles(Owner 2026-11-16: dùng job app +variant_cache) - Cột
application_idtrên FS (Owner 2026-11-17: thay bằngsource_kind+source_id) temp_rel_path/ phân cấp ngày trên temp;expires_attrên temp/variant (Owner 2026-11-17: flat +storage_name; GC =created_at+TTL)storage_rel_path; basename =file_id.ext(Owner 2026-11-17:storage_name= UUIDv7.ext;storage_keychung local/cloud)files.source_temp_id(Owner 2026-11-17: bỏ — temp GC hàng ngày → ref dư / đứt; giữtemp_uploads.promoted_file_idmột chiều)files.scan_status(Owner 2026-11-17: không trong lần này; malware scan = change control sau)migration.window_start/window_end/window_tz(Owner 2026-11-17: gộp lịch vàolocal.migrate_cronUTC)- Key phẳng /
*_min/*_daystrên TTL (Owner 2026-11-17: nhóm{temp|local|migration|variant}.*; duration = chuỗimstrêntemp.ttl/local.retain/variant.ttl) config.cloud.*/cloud.default_connection_id(Owner 2026-11-17: bỏ — default =storage_connections.is_default_cloud)variant_cache.rel_path(Owner 2026-11-17: bỏ — path deterministic{file_id}/{size}.webp)migration_jobs.migrate_cronsnapshot (Owner 2026-11-17: bỏ — không cần)- Bảng FS
audit_events(Owner 2026-11-17: DEFERRED phase này; không nhầm Coreaudit_events) file_quotas/file_usage/ billing Cloud Storage — dịch vụ thống kê & tính phí riêng sau (có thể đọcsize_bytesqua API)
15. Câu hỏi mở — hoãn đến lúc bắt đầu implement
Owner 2026-11-17: không chốt ngay. Trước Gate implement / Spec Kit tasks (hoặc kickoff Superpowers sau 1C), Orchestrator + team làm rõ lại toàn bộ danh sách dưới (và mục OPEN liên quan trên 05 / 06).
- Promote có bắt buộc cùng
uploader_account_idkhông? - Sổ
source_idchuẩn choplatform/service(vd.platform_core,chat_gw) local.pin_purposesmặc định (chỉ avatar?)- Ai CRUD
storage_connections/config? - Multi-node: shared disk mount vs regenerate local mỗi node
- Sau khi file
failed(hếtmax_attempts): alert / dead-letter / có được pick lại job sau không? - Default
migration.retry_delay/migration.max_attempts - Biểu thức mặc định
local.migrate_cron(off-peak UTC) - Hit variant: có cập nhật
last_access_atkhông? (GC B1 theocreated_at) - Nội dung mặc định
temp.ext_allowlist - Reconcile orphan disk↔
variant_cache - Authz Chat↔FS (proxy GW vs FS verify membership) — xem 06 §4