Appearance
Store bên ngoài / không phải DB nghiệp vụ
Version: 0.2
Date: 2026-11-16
Status: Working baseline (skeleton)
Các store này không thiết kế như schema Application MINAP. Ghi lại để Owner thấy ranh giới và mapping ID.
1. Keycloak
| Chủ đề | Ghi chú |
|---|---|
| Sở hữu | Login, mật khẩu, OIDC token, SoT email auth; mọi federated IdP (Google MVP; sau này Apple / Microsoft / GitHub / …) |
| Federated reference ids | Apple sub, GitHub user id, Microsoft oid, … — Keycloak quản lý (Federated Identity / broker link trên user IdP). Platform Core không nhân bản từng provider id |
| List / revoke linked IdPs | Có — qua Keycloak Account Console hoặc Account/Admin API (xem journey J2 §5.6). Timestamp “lúc link” phụ thuộc API Keycloak |
| Phiên đa thiết bị / logout từng máy | Keycloak user sessions = SoT; list + delete session qua Account Console hoặc API (journey J2 §5.7). Hủy session = gọi IdP, không bảng session trên Core |
| Lịch sử login dài hạn | Keycloak Events và/hoặc Core audit_events — OPEN retention; không nhầm với session store đang active |
| MINAP lưu | Chỉ accounts.keycloak_subject (+ mirror email, optional last_login_at); không password; không bảng IdP đã link; không SoT danh sách phiên thiết bị |
| Thêm provider mới | Cấu hình Identity Provider trên Keycloak + client secrets trong Infisical — không migration bảng Core cho từng mạng xã hội |
| Schema | Vendor/IdP — ngoài phạm vi thiết kế bảng MINAP |
| Journey | J1 / J1b / J2 — /architecture/database/20-user-journey-data-ownership |
2. Object store S3-compatible (bytes)
| Chủ đề | Ghi chú |
|---|---|
| Sở hữu | Bytes file (object key mờ) |
| SoT tên / authz / đăng ký kết nối | File Service DB (storage_connections + files) — không listing object |
| Credential per connection | Trong DB (secret ciphertext); Infisical chỉ KEK — xem 02 |
| MinIO Community | Không dùng triển khai mới (archived) — xem 92 |
| Ứng viên | Mọi store S3-compatible đăng ký như một connection: RustFS / Garage / SeaweedFS / S3 / R2 |
| Tài liệu | /architecture/05-storage-and-file-service · 02 · 92 |
3. Matrix / Synapse (Chat)
| Chủ đề | Ghi chú |
|---|---|
| Sở hữu | Room, message, map Matrix account |
| MINAP | Một MINAP Account ↔ một Matrix Account (D-010) |
| Business Chat | DEFERRED cluster DB riêng (D-013) |
| Tài liệu | /architecture/06-minap-chat-architecture |
4. Infisical
| Chủ đề | Ghi chú |
|---|---|
| Sở hữu | Secrets và ENV (D-016) |
| Không phải | Dữ liệu giao dịch nghiệp vụ |
5. Variant local disk
| Chủ đề | Ghi chú |
|---|---|
| Sở hữu | Cache WebP multi-size trên disk (FS_VARIANT_ROOT/…); first-frame video; tái tạo được |
| Metadata GC | Bảng variant_cache trong File Service DB + job variant.cleanup_cron |
| Config | Root = ENV/Infisical; TTL/allowlist = config.variant.* |
| Không phải | SoT của bản gốc; không dựa systemd-tmpfiles làm GC chính |