KB-41E4

Branch B — Directory / URL / Version Convention

2 min read Revision 1
ai-workspaceui-previewconventionurlversioning2026-05-29

Branch B — Directory / URL / Version Convention

Canonical patterns

host dir : /opt/incomex/docker/nginx/static/ui-preview/<project>/<surface>/<version>/
URL      : https://vps.incomexsaigoncorp.vn/ui-preview/<project>/<surface>/<version>/
KB spec  : knowledge/dev/ui/<project>/<surface>/spec.md
KB log   : knowledge/dev/ui/<project>/<surface>/review-log.md
  • <project> — product/domain (e.g. mow, mot, moit, mout).
  • <surface> — a screen/surface (e.g. unified-canvas, task-card, design-registry, governance-cockpit).
  • <version>v1, v2, … immutable once shared. New iteration ⇒ new version dir (never overwrite a reviewed version).

Required files per preview version

File Purpose
index.html the preview (data-driven; no business logic)
styles.css styles (tokens from spec Component 5)
mock-data.json fixture matching the data contract
preview.meta.json machine-readable status/links (see 07)
*.html (optional) extracted source prototypes (e.g. phu-luc-a.html)

This deployment

Field Value
project mow
surface unified-canvas
version v1
URL https://vps.incomexsaigoncorp.vn/ui-preview/mow/unified-canvas/v1/

Reserved demo namespace

/ui-preview/_demo/health/<version>/   → pipeline health page (no project semantics)

Live: https://vps.incomexsaigoncorp.vn/ui-preview/_demo/health/v1/

Rules

  • Versioned only — no unversioned previews (mission Forbidden).
  • _-prefixed top segments (_demo) are infrastructure, not projects.
  • KB folder mirrors <project>/<surface> so spec/log are findable from the URL and vice-versa.
Back to Knowledge Hub knowledge/dev/reports/architecture/ai-shared-ui-workspace-preview-pipeline-2026-05-29/03-directory-url-convention.md