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.