Skip to content

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:

  1. Upload tạm → folder temp FS + bảng tạm
  2. Promote → file thật trên local + xóa tạm
  3. Hết thời gian giữ local → job sync lên R2/S3 (retry / purge local tách bước)
  4. Truy xuất variant → GET /files/{file_id}/{size}: authorize → check disk → miss thì gen → ghi disk + hàng variant_cache (GC giống temp; không dùng systemd-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ạnBytes ở đâuHàng DB
(1) TạmFolder temp (FS_TEMP_ROOT)temp_uploads
(2) Sau promoteFolder local (FS_LOCAL_ROOT)files (storage_tier=local)
(3) Sau syncR2/S3files (storage_tier=cloud); local cleanup qua purge_status
Variant{FS_VARIANT_ROOT}/{file_id}/{size}.webpvariant_cache + config.variant.*; nguồn gốc = files

3. Engine / topology ​

Hạng mụcTrạng thái
EngineDECIDED PostgreSQL (D-022)
Schemafile_service (DECIDED)
Cloud credentialsstorage_connections (secret ciphertext; KEK Infisical)
Temp / local / variant root pathsENV qua Infisical (D-016) — không bảng DB
Thời gianUTC (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ểu TIMESTAMPTZ.
  • 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/DD trong storage_key: cắt từ created_at UTC.
  • So sánh TTL/GC/migrate: dùng now() UTC phía DB/app.
  • Cron (local.migrate_cron, local.purge_cron, …): schedule bằng node-cron với timezone: 'UTC' — off-peak = giờ UTC trong biểu thức (không window_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ảngID / PrefixPublish?Mục đíchStatus
1storage_connectionsnội bộ (NanoID/UUID, không stc_)Không (chỉ trong FS / admin FS)Kết nối R2/S3 (+ OSS) + health/opsPROPOSED
2temp_uploadstmp_…Có (client promote)Upload tạm (receiving → ready)PROPOSED
3filesfile_…Có (App / Core / API)File đã promote + sync/purge (+ trạng thái sync trên hàng)PROPOSED
4variant_cacheUK (file_id, size_px)KhôngIndex GC variant (giống temp)PROPOSED
5configPK = key—TTL / cron (UTC) / allowlist / batch migrate (temp/local/migration/variant)PROPOSED
6migration_jobsnội bộKhôngMỗ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ột workspace_id — FS không gắn Workspace (Owner 2026-11-16).
Không có storage_volumes — root ENV Infisical. Temp flat + storage_name; GC created_at+TTL; xóa vật lý.
Local/cloud: cùng storage_key; basename = storage_name = {uuidv7}.{ext} (không gắn file_id); cột storage_name riêng trên temp + files (Owner 2026-11-17).
Variant: GC created_at+variant.ttl; disk-first. Không sync_attempts / application_id.
audit_events (FS) = DEFERRED phase này (Owner 2026-11-17) — không nhầm với audit_events Platform Core.
Đã rút tên: file_config→config, storage_migration_jobs→migration_jobs.

5. ER ​

6. Bảng: storage_connections ​

CộtKiểuNullGhi chúVí dụ
idTEXT PKNONội bộ — NanoID/UUID không prefix D-0177Kx9mQ2pL0nR4wYv
nameTEXTNOTên opsr2-prod
kindTEXTNOs3 | r2 | rustfs | …r2
endpointTEXTYESURL APIhttps://<accountid>.r2.cloudflarestorage.com
regionTEXTYESauto
default_bucketTEXTYESminap-files-prod
path_styleBOOLEANYESForce path-style (OSS)false
ssl_enabledBOOLEANNOMặc định truetrue
signature_versionTEXTNOMặc định v4v4
public_base_urlTEXTYESCDN / URL công khai nếu cóhttps://cdn.example.com
connection_timeout_msINTNO3000
upload_part_size_bytesBIGINTYESMultipart8388608 (8 MiB)
max_concurrent_syncINTYESGiới hạn worker sync4
default_storage_classTEXTYESSTANDARD
access_key_idTEXTYESAKIA… / R2 access key
secret_ciphertextBYTEA/TEXTYESKhông plaintextv1:kekA:base64…
secret_kek_versionTEXTYESkek-2026-11
is_default_cloudBOOLEANNOĐích migrate mặc định nền tảng (SoT duy nhất — không config.cloud.*)true
statusenumNOactive | readonly | disabledactive
last_health_check_atTIMESTAMPTZYES2026-11-17T01:00:00Z
last_health_check_statusTEXTYESok | errorok
last_health_check_errorTEXTYESnull / timeout
extraJSONBYES{"account_id":"…"}
created_at / updated_atTIMESTAMPTZNO2026-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_ROOTUpload tạm
FS_LOCAL_ROOTBản gốc sau promote (local tier)
FS_VARIANT_ROOTCache 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}
SegmentQuy tắc
uploader_account_idacc_…
source_segsource_id nếu có; không có → _
YYYY/MM/DDTừ 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 đổi storage_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ộtKiểuNullGhi chúVí dụ
idTEXT PKNOtmp_ + NanoID — trả client để promotetmp_V1StGXR8_Z5jdHi6B
uploader_account_idTEXTNOacc_…acc_3f9kQ2LmNpRsTuVw
source_kindTEXTNOapplication | platform | service | unknownapplication
source_idTEXTYESId theo kindapp_chat01 / platform_core / chat_gw
purposeTEXTYESaccount_avatar / chat_attachment
display_nameTEXTYESTên user thấyavatar.png
storage_nameTEXTNOBasename vật lý trên disk = {uuidv7}.{ext} (tách khỏi tmp_…)019a3f2c-8b1e-7c4d-9e0f-1a2b3c4d5e6f.png
content_typeTEXTYESimage/png
size_bytesBIGINTYESBytes đã nhận / khi ready245760
checksumTEXTYESsha256:a3f2…
statusenumNOreceiving | ready | promoted | expired | purgedready
promoted_file_idTEXTYES→ 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_atTIMESTAMPTZNONeo TTL2026-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ộtKiểuNullGhi chúVí dụ
idTEXT PKNOfile_ + NanoID (D-017)file_9xK2mNpQsTuVwXyZ
display_nameTEXTNOTên hiển thịbao-cao-q3.pdf
storage_tierenumNOlocal | cloud — nơi bytes gốc hiện tạilocal → sau migrate cloud
sync_statusenumNOnone | pending | syncing | synced | failedpending
purge_statusenumNOnone | local_cleanup | purgednone
sync_attempt_countINTNOSố lần fail thật (hết retry trong job); chưa kể lần PutObject trung gian0 / 2
last_sync_atTIMESTAMPTZYES2026-11-18T15:02:11Z
last_sync_errorTEXTYESnull / PutObject timeout
last_sync_error_codeTEXTYESnull / S3_TIMEOUT
last_migration_job_idTEXTYES→ migration_jobs.idnull / mjob_a1b2c3d4
storage_connection_idTEXTYES→ storage_connections.id khi cloudnull → 7Kx9mQ2pL0nR4wYv
storage_bucketTEXTYESBucket khi cloudminap-files-prod
storage_nameTEXTNOBasename vật lý {uuidv7}.{ext} (copy từ temp lúc promote)019a3f2c-8b1e-7c4d-9e0f-1a2b3c4d5e6f.pdf
storage_keyTEXTNORelative path chung local+cloud; suffix = storage_nameacc_3f9k…/app_chat01/2026/11/17/019a3f2c-….pdf
local_retain_untilTIMESTAMPTZYESĐến hạn → pending2026-11-24T10:05:00Z
promoted_atTIMESTAMPTZYES2026-11-17T10:05:00Z
size_bytesBIGINTYES1048576
content_typeTEXTYESapplication/pdf
checksumTEXTYESsha256:b1c2…
purposeTEXTNOchat_attachment / account_avatar
source_kindTEXTNOapplication | platform | service | unknownservice
source_idTEXTYESId theo kindchat_gw / app_chat01 / platform_core
uploader_account_idTEXTNOacc_3f9kQ2LmNpRsTuVw
statusenumNOavailable | soft_deleted | heldavailable
deleted_atTIMESTAMPTZYESnull
created_at / updated_atTIMESTAMPTZNO2026-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_uploads

Invariant: 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=purged

Retry 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ĩaVí dụ value
temp.ttlTTL — GC/promote so với created_at (không expires_at)30m / 1d
temp.cleanup_cronJob GC temp (mỗi 10 phút)*/10 * * * *
temp.ext_allowlistExt cho phép trên storage_name["png","jpg","webp","pdf"]

local.* — tier local (giữ / migrate / purge / pin) ​

keyÝ nghĩaVí dụ value
local.retainThời gian giữ local trước khi đủ điều kiện migrate7d
local.migrate_cronLịch start migration_jobs (mỗi 15 phút, giờ UTC 15–21)*/15 15-21 * * *
local.purge_cronPurge local phút 0 mỗi giờ0 * * * *
local.pin_purposespurpose luôn giữ local (không migrate)["account_avatar"]

migration.* — batch local→cloud ​

keyÝ nghĩaVí dụ value
migration.batch_sizeSố file tối đa mỗi batch100
migration.max_attemptsSố lần PutObject tối đa / file trong một lần xử lý (kèm retry)5
migration.retry_delayChờ giữa các lần fail→retry (parse vercel/ms)5s / 30s

variant.* — cache WebP multi-size ​

keyÝ nghĩaVí dụ value
variant.ttlTTL — GC so với created_at7d
variant.sizesAllowlist size (px)[96,128,192,256,384,512,768,1024]
variant.cleanup_cronGC 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.webp

11.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ộtKiểuNullGhi chúVí dụ
file_idTEXTNO→ file_… (PK với size_px)file_9xK2mNpQsTuVwXyZ
size_pxINTNOSize allowlist; path = {file_id}/{size_px}.webp256
created_atTIMESTAMPTZNONeo TTL2026-11-17T12:00:00Z
last_access_atTIMESTAMPTZYESTouch 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ột rel_path.
  • Lỗi gen variant không chặn original.
  • Không systemd-tmpfiles là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ỗng

Reconcile 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ộtKiểuNullGhi chúVí dụ
idTEXT PKNONội bộmjob_a1b2c3d4e5f6
statusenumNOrunning | succeeded | partial | failed | skippedpartial
storage_connection_idTEXTYESĐích batch7Kx9mQ2pL0nR4wYv
batch_limitINTNOSnapshot migration.batch_size100
selected_countINTNOSố file chọn100
success_countINTNOFile sync OK trong batch97
fail_countINTNOFile hết retry vẫn fail (không đếm lần thử trung gian)3
skip_reasonTEXTYESKhi status=skippednull / no_candidates
started_atTIMESTAMPTZNO2026-11-17T15:00:00Z
finished_atTIMESTAMPTZYES2026-11-17T15:12:40Z
created_atTIMESTAMPTZNO2026-11-17T15:00:00Z

13. Mapping flow → bảng/job ​

#FlowDB / diskJob
1Upload tạmtemp_uploads + FS_TEMP_ROOTGC temp.*
2Promotefiles + promoted_at—
3aMigrate cloudmigration_jobs + cập nhật fileslocal.migrate_cron (UTC)
3bXóa localpurge_status trên fileslocal.purge_cron
4Variantdisk + variant_cache; miss → files + genGC 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ên files)
  • 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ằng variant_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 schema file_service
  • Bảng workspace_storage_policies / policy theo Workspace (Owner 2026-11-16: FS không policy theo Workspace)
  • Cột workspace_id trê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_id trên FS (Owner 2026-11-17: thay bằng source_kind + source_id)
  • temp_rel_path / phân cấp ngày trên temp; expires_at trê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_key chung 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_id mộ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ào local.migrate_cron UTC)
  • Key phẳng / *_min/*_days trên TTL (Owner 2026-11-17: nhóm {temp|local|migration|variant}.*; duration = chuỗi ms trên temp.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_cron snapshot (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 Core audit_events)
  • file_quotas / file_usage / billing Cloud Storage — dịch vụ thống kê & tính phí riêng sau (có thể đọc size_bytes qua 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_id không?
  • Sổ source_id chuẩn cho platform / service (vd. platform_core, chat_gw)
  • local.pin_purposes mặ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ết max_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_at không? (GC B1 theo created_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

docs/ = SoT duy nhất · văn xuôi tiếng Việt + thuật ngữ chuyên ngành English