docs/reference/FEATURE_INVENTORY.md

Feature Inventory

Quy ước

Nguồn audit: AutoCode Video codex/hf-prod-sync tại 595ccdfaf45ff83473f2da8fd2c71d491828e5f5. Tổng cộng xác định 56 feature/subsystem. Cột Implementation status chỉ mô tả mức hoàn thiện nhìn thấy trong source: FULL, PARTIAL, MOCK, LEGACY, UNREACHABLE hoặc UNCLEAR; nó độc lập với verification status. Mọi dòng có file evidence đều là SOURCE_VERIFIED và NOT_RUNTIME_VERIFIED, trừ khi ghi rõ khác. Phase 0 không có feature nào được nâng lên RUNTIME_VERIFIED hoặc PARTIAL_RUNTIME_EVIDENCE; test file chỉ là source evidence vì 66 test file của repository tham khảo không được chạy. Không suy completeness từ tên route/file. Xem taxonomy chuẩn và ma trận các integration chính tại CURRENT_SYSTEM_MAP.md.

Access và shell

ID	Feature	Người dùng	Entry point	Đầu vào → đầu ra	Dependency	Implementation status	Bằng chứng	Vấn đề quan sát	Đề xuất Oloka
F-01	Public landing	Visitor	/	Nội dung → CTA/login/waitlist	Express static	Đầy đủ cho presentation	public/index.html, public/landing.js, server.js	Gắn chặt auth gate/animation	Giữ behavior, xây component mới
F-02	Hosted entry policy	Visitor/member	/, /dashboard	Session/status → landing/dashboard/blocked	Auth DB	Đầy đủ	services/hostedEntryPolicy.js, server.js, tests hosted entry	Auth có thể tắt bằng env	Deny-by-default hosted
F-03	Google OAuth	Member	Landing login	OAuth code → active/pending user + session	Google, SQLite	Đầy đủ có điều kiện config	auth.js, services/oauthGoogleParams.js, public/index.html	Không timeout/retry thống nhất	KEEP BEHAVIOR
F-04	GitHub OAuth	Member	API route, không thấy CTA chính	OAuth code → user/session	GitHub, SQLite	Không xác định consumer	auth.js, public/index.html	Redirect khác Google, email private	Hậu MVP/undecided
F-05	Password auth local	Local user	API routes	Email/password → session	SQLite/scrypt	Legacy/local	auth.js	Hosted thường disabled; UI chính không có form	Remove khỏi hosted MVP
F-06	Waitlist	Visitor	Landing modal	Name/email → pending User	SQLite	Đầy đủ tối thiểu	public/landing.js, auth.js	Waitlist dùng chung User entity	Giữ value, tách lifecycle
F-07	Session/logout	Member	Cookie, account menu	Session token → user context/logout	SQLite/cache	Đầy đủ	auth.js, services/sessionLookupCache.js, public/app.js	Cookie policy theo env; token plaintext DB	Thiết kế lại session store
F-08	User approval/roles	Admin	Admin users	Patch/delete → role/status/user	SQLite	Đầy đủ cơ bản	auth.js, services/adminAccessPolicy.js, public/app.js	Không organization/permission model	Giữ behavior tối thiểu
F-09	Dashboard navigation	Member	/dashboard, /create, /studio/:id	URL/action → view	Browser history/state	Đầy đủ	private/dashboard-shell.html, public/app.js	Một JS/HTML monolith	Replace implementation
F-10	Settings shell	Admin/local user	Settings modal	Provider/forms → shared/local config	AppSetting/localStorage	Một phần	private/dashboard-shell.html, public/app.js, routes/settings.js	Secret/config phân tán	Replace bằng server credential refs

Projects và workspace

ID	Feature	Người dùng	Entry point	Đầu vào → đầu ra	Dependency	Implementation status	Bằng chứng	Vấn đề quan sát	Đề xuất Oloka
F-11	Project list/search/filter/page	Member	Projects view	Query/filter → cards/page	SQLite + disk fallback	Một phần	public/app.js, routes/projects.js, services/projectDiskSnapshot.js	Nhiều nguồn sự thật	KEEP BEHAVIOR, replace data path
F-12	Project creation	Member	Forge start; POST project alternate	Prompt/name → folder + DB record	Filesystem/SQLite	Một phần	routes/forge.js, routes/projects.js	Hai contract tạo project	Một command canonical
F-13	Per-user workspace	Member	workspace alias	User → auto workspace	Filesystem/SQLite	Một phần	server.js, routes/projects.js	Alias/ID khó hiểu	UNDECIDED: cấm alias; Phase 1 chọn entity độc lập hoặc chỉ project list
F-14	Select/open project	Member	Project card/Studio URL	ID → scoped project/status	Auth + filesystem	Đầy đủ	public/app.js, routes/projects.js, server.js	Nhiều dạng ID	Opaque UUID
F-15	Favorite/legacy posted flags	Member	Project quick menu	ID → toggled metadata	JSON + SQLite sync	Một phần	public/app.js, routes/projects.js, services/projectService.js	posted không đồng nghĩa platform publish	Giữ favorite; bỏ posted khỏi MVP; sau này dùng Publication/PublishJob
F-16	Clone project	Member	Project quick menu	Source ID → copied project	Filesystem/SQLite	Một phần	public/app.js, routes/projects.js	Copy toàn tree, reset history; không snapshot transaction	Object manifest clone
F-17	Delete/bulk delete	Member/admin	Manage projects	IDs → permanent removal	Filesystem/SQLite	Nguy hiểm	public/app.js, routes/projects.js	Không trash, path containment thiếu	Replace soft-delete
F-18	Thumbnail	Member	Project card	Project ID → PNG/SVG	ffmpeg/files	Một phần	routes/projects.js, public/app.js	Generate-on-request/process fallback	Async thumbnail artifact
F-19	Diagnostics/report	Member/admin	Report/error modal	Project ID/section → logs, scan, stats	Files/logs/linter	Một phần	routes/projects.js, routes/forge.js, services/projectReportService.js	Expensive/heterogeneous	Keep diagnostic value, normalize events

Assets và media

ID	Feature	Người dùng	Entry point	Đầu vào → đầu ra	Dependency	Implementation status	Bằng chứng	Vấn đề quan sát	Đề xuất Oloka
F-20	Shared asset catalog	Member	Assets/DAM, asset lock	Files/sidecars → catalog	Shared filesystem/cache	Một phần	services/assetCatalogService.js, routes/assets.js, public/app.js	Global, filename identity	Tenant-aware Asset entity
F-21	Asset upload	Admin hosted	DAM upload/drop	Raw media → file + sidecar	Filesystem, metadata tools	Một phần	public/app.js, routes/assets.js	Regular member không upload private; RAM/size limits	Direct-to-object-storage private upload
F-22	Asset technical metadata	Admin/system	Upload	File → size/hash/media info	ffmpeg/image inspection	Đầy đủ cơ bản	routes/assets.js, services/mediaMetadata.js, services/imageFormat.js	Sidecar only	Keep behavior in ingestion job
F-23	AI asset analysis	Admin/system	Upload/re-analyze	Media + guidance → tags/description/embedding	Recognition provider	Một phần/mock fallback	services/assetAnalysisService.js, services/mockAssetAnalysis.js, routes/assets.js	Success may mean fallback; RAM queue	Hậu MVP
F-24	Asset search/filter	Member	DAM/asset lock	Query/filters → client-filtered assets	Catalog metadata	Một phần	public/app.js, services/assetSearch.js	Client-heavy; semantic quality uncertain	MVP chỉ original filename, media type, upload time, project, optional ingestion status
F-25	Exact duplicate scan	Admin	DAM scanner	Hash/size → duplicate groups	Files/sidecars	Đầy đủ cơ bản	routes/assets.js, public/app.js	Cleanup permanent	Hậu MVP: workflow exact-duplicate cleanup
F-26	Semantic duplicate scan	Admin	DAM scanner	Embedding threshold → groups	Embeddings	Một phần	routes/assets.js, public/app.js	Missing embedding reduces coverage	Hậu MVP
F-27	Asset metadata/collection edit	Admin	Detail/bulk UI	Patch → sidecar update	Filesystem	Một phần	public/app.js, routes/assets.js	Collection là string, không entity	Simple tags first
F-28	Use/lock asset in project	Member	Prompt asset lock/detail	Asset selection → copied file + linked contract	Shared/project filesystem	Một phần	public/app.js, routes/assets.js, services/forgePipelineService.js	Copy/filename matching/fuzzy repair	Keep value, immutable asset refs
F-29	DAM advanced views	Member	Collections/favorites/recent/shared/trash	Navigation → filtered UI	Client state	Chỉ UI	private/dashboard-shell.html, public/app.js	Không backend entity/lifecycle tương ứng	Remove khỏi MVP
F-30	AI background removal	Member	Asset detail	Button → timer/alert	Không	Mock	public/app.js	Báo tạo file nhưng không có side effect	Remove đến khi có provider thật
F-31	Similar/individual duplicate tools	Member	Asset detail	Tags/heuristic → client filter/alert	Client catalog	Mock/heuristic	public/app.js	Gắn nhãn AI nhưng không gọi AI	Remove khỏi MVP
F-32	BGM library/upload/delete	Member/admin	BGM modal/DAM	Audio → shared track/metadata	Shared filesystem	Một phần	routes/bgm.js, public/app.js	Mutation permission không nhất quán	Admin catalog riêng sau MVP
F-33	Select BGM	Member	Create/Studio settings	Track/none → project bgm.*	Project filesystem	Đầy đủ cơ bản	routes/bgm.js, public/app.js	Copy file, không stable asset ID	Keep behavior via asset refs

Generation, Studio và preview

ID	Feature	Người dùng	Entry point	Đầu vào → đầu ra	Dependency	Implementation status	Bằng chứng	Vấn đề quan sát	Đề xuất Oloka
F-34	Prompt composer/config	Member	Create view	Prompt, ratio, caption, BGM, assets → Forge request	Browser/settings	Đầy đủ	private/dashboard-shell.html, public/app.js	Nhiều config/advanced controls	Keep simplified MVP
F-35	Prompt/URL media ingestion	Member	Prompt	URL/queries → capture/downloaded assets/brand context	Web/media tools	Một phần	services/promptAssetService.js, routes/generate.js	SSRF/licensing/anti-bot risk	Remove mặc định MVP
F-36	Forge composition generation	Member	/api/forge/start	Prompt/context → narration + HyperFrames HTML	LLM/assets	Một phần nhưng là core	routes/forge.js, services/forgePipelineService.js, services/forgePlanningService.js	Huge prompt/repair chain, invalid JSON	Replace orchestration, keep outcome
F-37	Legacy direct generation	Integrator	/api/generate	Prompt/URL → JSON/HTML	LLM/prompt asset service	Legacy/duplicate	routes/generate.js; không có consumer trong public/app.js	Khác Forge/checkpoints	Remove
F-38	HyperFrames contract/registry	System	Generation/save/render	HTML refs → materialized renderable project	HyperFrames/registry	Một phần, heavily tested	services/templateRegistryService.js, services/forgeQualityService.js, tests registry	Version/path/materialization complexity	Keep contract, redesign dependency manifest
F-39	Studio document editor	Member	Edit tab	Document + revision → saved composition	HyperFrames editor/API	Một phần	src/studio-editor.jsx, routes/composition.js, tests studio	Generated bundle lớn; no DB versions	Hậu MVP hoặc basic source editor
F-40	Quick scene edit	Member	Scene panel	Scene ID/HTML/narration → updated composition	Composition API	Một phần	public/app.js, routes/composition.js	Regex/HTML mutation and conflict risk	Replace bằng structured scene model
F-41	AI edit/render-only	Member	Studio edit prompt	Instruction/config → modified composition/new render	Forge/LLM	Một phần	public/app.js, routes/forge.js, services/forgePipelineService.js	Duplicate large edit pipeline	Hậu MVP after core stability
F-42	Live preview/safe zones	Member	Live Preview tab	Composition → playable iframe	Static/HyperFrames runtime	Một phần	public/app.js, private/dashboard-shell.html, server.js	Preview/runtime parity	KEEP BEHAVIOR
F-43	HyperFrames preview server	System/editor	__hyperframes_config/Studio tooling	Project dir → child server/proxy	HyperFrames CLI	Một phần	server.js	Per-project process/port in RAM; stale logic	Replace with bounded preview service

Audio, render, jobs và output

ID	Feature	Người dùng	Entry point	Đầu vào → đầu ra	Dependency	Implementation status	Bằng chứng	Vấn đề quan sát	Đề xuất Oloka
F-44	Omnivoice TTS	System	Forge TTS step	Narration scenes → audio + alignment	Omnivoice	Đầy đủ với retry	services/omnivoiceSceneTts.js, tests TTS	Long retry/cold start, provider coupling	Adapter + durable scene jobs
F-45	Transcription/alignment fallback	System	Compile step	Narration audio → timed words	Local/OpenAI	Một phần	services/ttsMediaService.js, routes/compile.js, Forge	Multiple fallback paths	Prefer TTS alignment; keep one fallback
F-46	Caption engine	Member/system	Create/Studio/compile	Timed words/style/mode → composition captions	Templates/fonts	Một phần mạnh	services/captionTemplates.js, services/captionSegmenter.js, quality tests	Legacy subtitle detection remains	KEEP BEHAVIOR, structured config
F-47	Smart BGM direction	System	Forge	Script + catalog → track/offset	LLM/BGM library	Một phần	services/forgeLlmService.js, services/forgePipelineService.js	Extra LLM cost/non-determinism	Hậu MVP; manual BGM first
F-48	Durable-looking job lifecycle UI	Member	Render dock/Studio	Start/SSE/poll → progress/cancel/pause/resume	RAM queue + DB/meta	Một phần	services/jobRuntimeService.js, services/jobStore.js, routes/forge.js, public/app.js	Không durable thật	Replace hoàn toàn
F-49	Local render provider	System	Forge/direct render	Project → MP4	HyperFrames CLI/Chromium	Đầy đủ local cơ bản	services/renderProviders.js, routes/render.js	No clear provider deadline	Keep dev-only
F-50	Modal render provider	System	Forge	Bundle → remote call → MP4	Modal	Đầy đủ với retry	services/renderProviders.js, deploy/modal-renderer/app.py, tests Modal	Base64/timeout/version drift	Keep goal, versioned protocol
F-51	Render history/output download	Member	Output/history	Completed job → snapshot/play/download	Filesystem/HF delivery	Một phần	services/projectService.js, services/forgeStatusPayload.js, public/app.js	Current overwrite; JSON/file drift	Immutable RenderOutput entity
F-52	Pre/post render quality	System/member	Forge + quality report	Composition/video → gates/report/feedback	HyperFrames/ffmpeg/vision	Một phần	services/forgeQualityService.js, services/videoQualityService.js, routes/quality.js	Optional vision and complex repair	Keep technical gates; human review state

Publish, admin và operations

ID	Feature	Người dùng	Entry point	Đầu vào → đầu ra	Dependency	Implementation status	Bằng chứng	Vấn đề quan sát	Đề xuất Oloka
F-53	Social publishing	Member	Publish modal	MP4 + platform config → per-platform result	TikTok/YouTube/Facebook	Một phần	routes/socialPublish.js, public/app.js	Direct request, no durable status/token refresh	Hậu MVP
F-54	Admin analytics/jobs/cost	Admin	Admin view	DB/disk/activity/pricing → dashboards/export/detail	Multiple stores	Một phần	routes/admin.js, auth.js, services/admin*.js, public/app.js	Freshness/source drift	MVP: simple job/user operations only
F-55	Provider discovery/health	Admin	Settings/Admin	Config → models/test/Modal health	Providers	Một phần	routes/settings.js, routes/status.js, public/app.js	Admin-only, inconsistent deadlines	Keep server-side health checks
F-56	Tests and operational scripts	Developer/operator	npm/scripts/CI	Source/config → tests/checks/deploy/smoke	Node/GitHub/HF/Cloudflare	Một phần	package.json, tests/** (66 files), scripts/**, workflow	Strong unit contracts but no single hosted E2E proof; stale CF scripts	Keep discipline; rebuild around Oloka topology

Tổng hợp theo mức hoàn chỉnh

Nhóm	Số lượng	Ghi chú
Đầy đủ hoặc đầy đủ có điều kiện	15	Chủ yếu shell/auth cơ bản, selection, metadata kỹ thuật, TTS/local render primitives
Hoạt động một phần	31	Gồm hầu hết core pipeline vì durability/data/permission còn thiếu
Chỉ UI/mock/heuristic	3	DAM advanced/background removal/similar tools
Legacy/duplicate/local-only	4	Password, direct generation và các đường tương tự
Không xác định/nguy hiểm	3	GitHub consumer, destructive deletion và một số operational reachability

Số liệu là phân loại audit tại snapshot, không phải KPI chất lượng production.