Skip to content

Thuật ngữ ​

Version: 1.6
Date: 2026-11-19
Status: Working baseline

Thuật ngữ (English)Hiểu nhanh
MINAP (Min-Áp)Minimum Applications — nền tảng nhiều app nhỏ, dùng chung một tài khoản
Platform CorePhần nền tảng chung (đăng nhập, workspace, catalog…)
IdP (Identity Provider)Hệ thống xác thực đăng nhập (MINAP dùng Keycloak); cấp OIDC token / sub — không phải SoT Account acc_…
Federated identityLiên kết login social (Google, Apple, Microsoft, GitHub, …) trên Keycloak; reference id từng nhà cung cấp không lưu trên Platform Core — chỉ map qua Keycloak sub → acc_…
User session (IdP)Phiên đăng nhập trên một client/thiết bị do Keycloak giữ; đăng xuất từng máy / tất cả = xóa session trên IdP — không SoT session table trên Platform Core
Application A/B/CTên gọi các ứng dụng nghiệp vụ (không gọi “Product”)
MINAP AccountMột người = một tài khoản trên toàn MINAP
Personal WorkspaceKhông gian làm việc cá nhân
Organization WorkspaceKhông gian làm việc của tổ chức / cửa hàng
Workspace MembershipAi thuộc workspace nào, với vai trò gì
Platform SDKBộ công cụ/hợp đồng để App gắn vào nền tảng; thao tác data ưu tiên qua Platform API có token
Platform UI (platform-ui)shadcn-like web kit (Next.js), Mobile-First; browser + RN WebView shell (D-020); không nhầm với Platform SDK
shadcn-likeDX compose kiểu shadcn/ui (Tailwind + primitive); kit web DOM — không phải component native RN
app_id / app_{nanoid}ID Application đã đăng ký trên Platform Core (D-017/D-018)
Platform API credentialCặp app_id + token/secret do Core cấp; chỉ backend (Infisical); tách biệt user session OIDC
File ServiceDịch vụ lưu/tải file dùng chung; metadata trong DB File Service; bytes temp/local/cloud theo storage_name + storage_key
InfisicalOpen-source (ưu tiên self-hosted) lưu secrets và ENV — SoT theo D-016; không commit secrets vào git
Variant cacheBản WebP multi-size on-demand: disk FS_VARIANT_ROOT/{file_id}/{size}.webp + bảng variant_cache; GC = created_at + variant.ttl (parse vercel/ms; xóa vật lý); size ∈ allowlist; video = frame đầu tĩnh
ms (vercel/ms)Parse duration string (30m, 7d, …) → milliseconds — dùng cho temp.ttl / local.retain / variant.ttl trong File Service config
node-cronScheduler cron Node.js (node-cron/node-cron) — File Service job (*_cron); SoT dùng timezone: 'UTC' + noOverlap: true
NanoIDThư viện sinh ID string ngắn; phần sau prefix trong D-017
UTC (tz=0)Quy ước lưu/so sánh timestamp nền tảng; Postgres TIMESTAMPTZ + TimeZone=UTC; client format local TZ khi hiển thị (database/00 §2)
{prefix}_{nanoid}Format ID nghiệp vụ ổn định lộ API/SDK (vd. file_…, tmp_…, acc_…, ws_…, app_…); không auto-increment; sort theo created_at. ID thuần nội bộ service không bắt buộc prefix — vd. storage_connections.id (D-017)
file_idID ổn định do File Service cấp dạng file_{nanoid}; Application chỉ lưu tham chiếu này — không dùng làm tên object trên disk
storage_nameBasename vật lý {uuidv7}.{ext} trên temp + files; tách khỏi file_id / tmp_… (ops / version / quarantine sau này)
storage_keyRelative path chung local + cloud: {acc}/{source_id hoặc _}/{YYYY}/{MM}/{DD}/{storage_name}; kết thúc bằng storage_name
Display name / aliasTên file người dùng thấy — khác storage_name / storage_key trên disk
Spec KitTool SDD của GitHub — artifact engine (constitution → tasks + converge); không phải Orchestrator
SuperpowersMethodology/skills (obra) — engine implement ưa thích sau Gate 1C (TDD, subagent, review); không thay Spec Kit SoT hay Gate (D-019)
OrchestratorChat Cursor Agent chính — điều phối specialist + Spec Kit + Superpowers; không phải subagent
BA Discovery / Product DiscoveryMode BA trước SDD (ba-discovery); chat riêng; gói .minap/discovery/ + handoff prompt; không gọi BA Requirements / Spec Kit
BA RequirementsMode BA trong pipeline Orchestrator (ba-requirements); Specify/Clarify → spec.md; Gate 1A SoT
platform-aiRepo shared AI kit (.cursor/ agents/rules/skills + templates); không phải nơi chứa work-item/spec của từng product repo
Target repoRepo đích của feature/bug (vd. platform-ui) — sở hữu specs/, .specify/, .minap/work-items/, discovery fills, .specify/bugs/<slug>/
Spec Kit bug extensionOpt-in Spec Kit: /speckit-bug-assess → fix → test; báo cáo dưới .specify/bugs/<slug>/; hybrid với Superpowers debugging
Gate 1ARequirements approval — duyệt spec.md (yêu cầu)
Gate 1BArchitecture approval — duyệt plan.md / ADR
Gate 1CImplementation authorization — ủy quyền bắt đầu code theo tasks.md; trước đó không code feature
Gate 4QA verification — QA PASS/FAIL; Owner acceptance delivery là bước tách
Gate 5Production release approval — duyệt / hoãn phát hành production
D-0xxDecision ID trong sổ 11-decisions-and-open-questions (vd. D-016 Infisical, D-017 NanoID, D-018 API credentials, D-019 Superpowers sau 1C, D-022 PostgreSQL gói DB) — không phải viết tắt Gate
PostgreSQL / schemaRDBMS mặc định gói database platform (D-022); tên vật lý = schema (platform_core, file_service, payment, invoice)
ConstitutionNguyên tắc bắt buộc của nền tảng (không dịch tên thành “Hiến pháp” trên hub)
AC (Acceptance Criteria)Tiêu chí chấp nhận — phải kiểm chứng được
HubRepo trung tâm (docs, governance, agents)
Nested repoRepo con (platform-core, application-a…) nằm trong thư mục hub trên máy bạn
Version / Date / StatusNhãn metadata chuẩn (English) ngay sau H1; Date = ISO YYYY-MM-DD
Owner Gate/QA chatOrchestrator hỏi Owner bằng tiếng Việt, một câu mỗi lượt, rồi cập nhật SoT dưới docs/ / specs/ (D-015)
Working baselineStatus: baseline gói đang dùng (docs package Version 1.0)
DECIDEDĐã chốt (cũng dùng làm Status meta)
PROPOSEDMới đề xuất — cần bạn duyệt
OPENCòn bỏ ngỏ
DEFERREDCố ý hoãn (thường sau MVP) — đã biết hướng nhưng chưa thiết kế/implement sâu; khác OPEN (chưa quyết) và PROPOSED (đề xuất chờ duyệt)

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