docs: finalize HMDesign v2 guidelines and remove stale references
This commit is contained in:
shkim4 committed
1 parent
3ebc84e32c
commit
e9144348e5
10 files changed
+46
-29
No files matched your search
@@ -1,12 +1,14 @@
|
||||
# HMDesignSystem Storybook LAN Preview
|
||||
|
||||
> HISTORICAL_RECORD — observations from the 2026-10-07 Track B QA session, including ports, processes and validation status. These are not current server availability or general execution instructions. The current Storybook default is **6024**; follow the [official execution guide](../../docs/guidelines/publisher-distribution-guide.md). Optional LAN QA is described in [LAN-PREVIEW.md](LAN-PREVIEW.md). The private address and old worktree path are neutral placeholders; historical results remain unchanged.
|
||||
|
||||
Result: **PARTIAL** — same-host LAN Preview is READY. A second physical PC was unavailable, so cross-PC access and cross-PC HMR remain NOT_VERIFIED.
|
||||
|
||||
TEMP_STORYBOOK_URL: http://10.13.37.164:6008/
|
||||
TEMP_STORYBOOK_URL: http://<QA_HOST_IPV4>:6008/
|
||||
|
||||
## 1. Worktree
|
||||
|
||||
- Path: `D:\디자인시스템\HMDesignSystem-storybook`
|
||||
- Path: `<TRACK_B_WORKTREE>`
|
||||
- Branch: `chore/storybook-cleanup`
|
||||
- HEAD: `6b4a39e4e9fef7cd706630ffc72b5e97e8696823`
|
||||
- Remote: `https://gitea.hmac.kr/b25027/HMDesign.git`
|
||||
@@ -20,8 +22,8 @@ TEMP_STORYBOOK_URL: http://10.13.37.164:6008/
|
||||
- LAN listener PID at verification: **23804**
|
||||
- Command: `node node_modules/storybook/dist/bin/dispatcher.js dev -p 6008 --host 0.0.0.0 --no-open --disable-telemetry --exact-port`
|
||||
- Local: http://localhost:6008/
|
||||
- LAN: http://10.13.37.164:6008/
|
||||
- Verified current IPv4: **10.13.37.164** (Ethernet 3); this is a temporary LAN address, not a permanent URL.
|
||||
- LAN: http://<QA_HOST_IPV4>:6008/
|
||||
- Verified current IPv4: **<QA_HOST_IPV4>** (Ethernet 3); this is a temporary LAN address, not a permanent URL.
|
||||
- The old LAN process was started on 6007 and had fallen back to 6008. Only that confirmed Track B LAN process was replaced with explicit 6008/exact-port operation. The existing localhost-only Track B process (PID 33604) was preserved; both addresses use the same worktree and matched 289 Story IDs.
|
||||
- package.json's official **6007** script was unchanged. Track A and other ports/processes were not stopped.
|
||||
- Server stdout/stderr are in ignored `.storybook/qa/lan-preview.*.log` files. PIDs are session observations, not durable shutdown instructions.
|
||||
@@ -149,7 +151,7 @@ Pre-existing or concurrent changes were preserved: `.storybook/main.ts`, `.story
|
||||
2. Execution on main: **NO**.
|
||||
3. 6008 bound to 0.0.0.0: **YES**.
|
||||
4. localhost:6008 opens: **YES**.
|
||||
5. 10.13.37.164:6008 opens on the same PC: **YES**.
|
||||
5. <QA_HOST_IPV4>:6008 opens on the same PC: **YES**.
|
||||
6. Opens from another physical PC: **NOT_VERIFIED**.
|
||||
7. Missing cross-PC verification explicitly marked: **YES**.
|
||||
8. Top Bar #266651 maintained: **YES**.
|
||||
|
||||
@@ -1,20 +1,21 @@
|
||||
# Track B temporary Storybook LAN preview
|
||||
|
||||
> Historical scope: the Track B session below was verified on 2026-10-07. Ordinary users should follow the [official source installation guide](../../docs/guidelines/publisher-distribution-guide.md) and use `npm run storybook` or `start-storybook.bat` at the repository root; the current default port is **6024**. LAN Preview is optional internal QA. The old 6007 package port and the temporary 6008 session are historical observations. No server binding, network profile or firewall configuration is changed by this documentation update.
|
||||
|
||||
Purpose: **TEMPORARY INTERNAL LAN PREVIEW / LAN TEMP PREVIEW** for Storybook cleanup. This is a development server with HMR, not official static hosting or a permanent URL.
|
||||
|
||||
- Worktree: `D:\디자인시스템\HMDesignSystem-storybook`
|
||||
- Worktree: `<TRACK_B_WORKTREE>`
|
||||
- Branch: `chore/storybook-cleanup`
|
||||
- Port: `6008`; bind: `0.0.0.0`
|
||||
- TEMP_STORYBOOK_URL: http://10.13.37.164:6008/
|
||||
- TEMP_STORYBOOK_URL: http://<QA_HOST_IPV4>:6008/
|
||||
- Local: http://localhost:6008/
|
||||
- IPv4 `10.13.37.164` was verified on 2026-10-07. Recheck it before later sharing; do not assume a fixed address.
|
||||
- IPv4 `<QA_HOST_IPV4>` was verified on 2026-10-07. Recheck it before later sharing; do not assume a fixed address.
|
||||
|
||||
## Start and inspect
|
||||
|
||||
Run from Track B in PowerShell:
|
||||
For optional QA, first install/build dependencies using the official guide. Run from the current repository root in PowerShell; `6008` below is an example QA port, not the current default. Confirm it is available and the existing network policy permits LAN QA before starting. Replace `<QA_HOST_IPV4>` with the address observed for that session. The old worktree placeholder records provenance and is not a command path:
|
||||
|
||||
```powershell
|
||||
Set-Location -LiteralPath 'D:\디자인시스템\HMDesignSystem-storybook'
|
||||
git status -sb
|
||||
git branch --show-current
|
||||
git rev-parse HEAD
|
||||
@@ -23,7 +24,7 @@ git rev-parse HEAD
|
||||
.\node_modules\.bin\storybook.cmd dev -p 6008 --host 0.0.0.0 --no-open --disable-telemetry --exact-port
|
||||
```
|
||||
|
||||
The installed Storybook binary is version 10.6.1. `--exact-port` prevents silent fallback to another port. The official package.json script stays on 6007. Do not use that script without overriding the port for Track B. If 6008 is occupied, identify its process before stopping or replacing it.
|
||||
The installed Storybook binary is version 10.6.1. `--exact-port` prevents silent fallback to another port. The package.json script used 6007 during that session; the current official script uses 6024. The direct command above selects a separate QA port explicitly. If 6008 is occupied, identify its process before stopping or replacing it.
|
||||
|
||||
```powershell
|
||||
Get-NetIPAddress -AddressFamily IPv4
|
||||
@@ -55,7 +56,7 @@ The Codex in-app browser showed a fractional-width boundary anomaly at 1023: `in
|
||||
|
||||
The sidebar order remains Foundation → Components → Patterns → Center Graphic → Theme. Existing `verification` filtering hides QA/tool stories by default while preserving direct URLs and tag-filter access.
|
||||
|
||||
Refresh the full inventory from Track B:
|
||||
When Storybook cleanup requires an inventory, refresh it from the repository root:
|
||||
|
||||
```powershell
|
||||
node .storybook/qa/generate-inventory.mjs
|
||||
@@ -75,4 +76,4 @@ For each completed cleanup batch, run typecheck, build-storybook, and git diff -
|
||||
|
||||
Same-host LAN IP success does not prove access from another physical PC. On a second physical PC, check manager/sidebar/preview, fonts/themes/assets, navigation and HMR. Until then record **SECOND_PHYSICAL_PC: NOT_VERIFIED**.
|
||||
|
||||
The current network profile was Public, with firewall profiles enabled and pre-existing inbound Node allow rules. No firewall rule or network profile was changed. If a second PC cannot connect, diagnose routing, client isolation and existing firewall policy; do not automatically add rules or change profiles.
|
||||
The 2026-10-07 network profile was Public, with firewall profiles enabled and pre-existing inbound Node allow rules. No firewall rule or network profile was changed. If a second PC cannot connect, diagnose routing, client isolation and existing firewall policy; do not automatically add rules or change profiles.
|
||||
Reference in new issue
Block a user