@shanyucoder/flowgrid 0.1.0

package/templates/project-skeleton/surfaces/common/yaml/breadcrumb-flow/ir/design.yaml

@@ -0,0 +1,13 @@
+# Generated from common-breadcrumb-flow.bundle.yaml — pnpm spec:split
+id: common-breadcrumb-flow
+inherits: admin-crud
+shell:
+  tag: "#shell: DataPage"
+  overrideCommonPattern: false
+patterns:
+  - "#pattern: CRUD"
+zones:
+  - id: main
+    label: Nội dung chính
+behavior: {}
+actions: []

package/templates/project-skeleton/surfaces/common/yaml/breadcrumb-flow/ir/legacy.yaml

@@ -0,0 +1,11 @@
+# Generated from common-breadcrumb-flow.bundle.yaml — pnpm spec:split
+id: common-breadcrumb-flow
+legacyRef:
+  module: common/common
+  function: common-breadcrumb-flow
+  slice: slices.common-breadcrumb-flow
+behaviors: []
+fields: []
+ui: []
+evidence: []
+refs: {}

package/templates/project-skeleton/surfaces/common/yaml/breadcrumb-flow/ir/spec.yaml

@@ -0,0 +1,31 @@
+# Generated from common-breadcrumb-flow.bundle.yaml — pnpm spec:split
+id: common-breadcrumb-flow
+title: Common breadcrumb flow
+status: draft
+owner: portal-team
+summary: Mọi dashboard page có breadcrumb khớp menu cha-con và action chain; breadcrumb trên page title.
+specOrigin: legacy
+grillStatus:
+  bqaFacts: draft
+  bqaOpen: draft
+  dev: draft
+  full: not_required
+principles:
+  - Breadcrumb bắt buộc trên list, detail, edit, create khi có sidebar parent.
+  - Thứ tự header — breadcrumb rồi page title rồi content.
+  - Create không phải menu con — trail đi qua list (toolbar create).
+references:
+  - .cursor/extracts/common-breadcrumb-flow.md
+  - docs/features/common/common-list-page.spec.yaml
+hierarchy:
+  - sidebarParent
+  - sidebarChildOrList
+  - actionPages
+examples:
+  hotelList: ホテル管理 > ホテル一覧
+  hotelDetail: ホテル管理 > ホテル一覧 > {name}
+  hotelEdit: ホテル管理 > ホテル一覧 > {name} > 編集
+  hotelCreate: ホテル管理 > ホテル一覧 > 新規作成
+grill:
+  bqa: labels, entity display field, create label
+  dev: ui.routes chain, route meta, wire-only menu API

package/templates/project-skeleton/surfaces/common/yaml/buttons/common-buttons.bundle.yaml

@@ -0,0 +1,147 @@
+schema: portal-feature-bundle/v1
+id: common-buttons
+title: Common buttons
+status: draft
+owner: portal-team
+summary: Chuẩn button toàn admin portal để tránh chỗ chỉ text, chỗ icon + text không nhất quán.
+specOrigin: legacy
+grillStatus:
+  bqaFacts: draft
+  bqaOpen: draft
+  dev: draft
+  full: not_required
+spec:
+  principles:
+    - Button nghiệp vụ mặc định dùng icon + text.
+    - Nếu legacy thiếu icon, prototype chọn icon lucide hợp lý theo ý nghĩa action.
+    - Icon không được là placeholder; phải phản ánh action/status.
+    - Thiết kế phẳng: border/background rõ, không gradient, không shadow nặng.
+    - Tránh button chỉ màu mà không có text/icon đủ nghĩa.
+  defaultPattern:
+    businessAction:
+      content: icon + text
+      iconPosition: left
+      gap: 2
+      examples:
+        search:
+          text: 検索
+          icon: Search
+        clear:
+          text: クリア
+          icon: RotateCcw hoặc X
+        create:
+          text: 新規作成
+          icon: Plus
+        save:
+          text: 保存
+          icon: Save
+        update:
+          text: 更新
+          icon: Save
+        edit:
+          text: 編集
+          icon: Edit
+        duplicate:
+          text: 複製
+          icon: Copy
+        import:
+          text: インポート
+          icon: Upload
+        upload:
+          text: アップロード
+          icon: Upload
+        download:
+          text: ダウンロード
+          icon: Download
+        export:
+          text: エクスポート
+          icon: Download
+        backToList:
+          text: 一覧へ
+          icon: List
+        delete:
+          text: 削除
+          icon: Trash2
+          variant: destructive
+  exceptions:
+    tableAction:
+      rule: icon-only
+      reason: Cột action trong table cần compact và đã có aria-label/title theo `common-table-action-column`.
+    paginationPrevNext:
+      rule: icon + text
+      icons:
+        previous: ChevronLeft
+        next: ChevronRight
+      text:
+        previous: 前へ
+        next: 次へ
+      reason: Pagination cần dễ hiểu hơn cho admin user, giữ icon để nhận diện nhanh và text tiếng Nhật để rõ hành động.
+    iconUtility:
+      rule: icon-only
+      appliesTo:
+        - close dialog
+        - collapse sidebar
+        - clear single chip
+      requirement: bắt buộc có aria-label/title.
+    readonlyMetric:
+      rule: text-only allowed
+      examples:
+        - 合計 {count}
+      reason: Đây là indicator dạng button-style nhưng không phải action clickable.
+  variants:
+    complete:
+      useFor: primary/complete action
+      background: "#48b0f7"
+      text: "#ffffff"
+    outlinePrimary:
+      useFor: search/secondary positive action
+      border: "#4EAAFF"
+      text: "#4EAAFF"
+      background: "#FFFFFF"
+    outlineSecondary:
+      useFor: clear/cancel/back neutral action
+      border: "#C2C2C2"
+      text: "#6B7280"
+      background: "#FFFFFF"
+    destructive:
+      useFor: delete/destructive action
+      icon: Trash2
+  accessibility:
+    - Button icon + text không cần aria-label riêng nếu text đủ rõ.
+    - Button icon-only bắt buộc có `aria-label` và `title`.
+    - Loading button giữ icon hoặc spinner bên trái, text vẫn mô tả action.
+  testIds:
+    button: "{module}-{action}-btn"
+  acceptance:
+    - Các button nghiệp vụ ngoài table/pagination không còn text-only.
+    - Nếu page dùng legacy button text-only thì prototype phải bổ sung icon hợp lý.
+    - Pagination previous/next dùng icon + text, page number vẫn là số.
+    - Table action tiếp tục icon-only và không thêm text label.
+legacy:
+  legacyRef:
+    module: common/common
+    function: common-buttons
+    slice: slices.common-buttons
+  behaviors: []
+  fields: []
+  ui: []
+  evidence: []
+  refs: {}
+design:
+  inherits: admin-crud
+  shell:
+    tag: "#shell: DataPage"
+    overrideCommonPattern: false
+  patterns:
+    - "#pattern: CRUD"
+  zones:
+    - id: main
+      label: Nội dung chính
+  behavior: {}
+  actions: []
+review:
+  summary: Chuẩn button toàn admin portal để tránh chỗ chỉ text, chỗ icon + text không nhất quán.
+  layoutNotes: []
+_meta:
+  generatedBy: archived-legacy-converter
+  sourceRevision: null

package/templates/project-skeleton/surfaces/common/yaml/buttons/ir/design.yaml

@@ -0,0 +1,13 @@
+# Generated from common-buttons.bundle.yaml — pnpm spec:split
+id: common-buttons
+inherits: admin-crud
+shell:
+  tag: "#shell: DataPage"
+  overrideCommonPattern: false
+patterns:
+  - "#pattern: CRUD"
+zones:
+  - id: main
+    label: Nội dung chính
+behavior: {}
+actions: []

package/templates/project-skeleton/surfaces/common/yaml/buttons/ir/legacy.yaml

@@ -0,0 +1,11 @@
+# Generated from common-buttons.bundle.yaml — pnpm spec:split
+id: common-buttons
+legacyRef:
+  module: common/common
+  function: common-buttons
+  slice: slices.common-buttons
+behaviors: []
+fields: []
+ui: []
+evidence: []
+refs: {}

package/templates/project-skeleton/surfaces/common/yaml/buttons/ir/spec.yaml

@@ -0,0 +1,118 @@
+# Generated from common-buttons.bundle.yaml — pnpm spec:split
+id: common-buttons
+title: Common buttons
+status: draft
+owner: portal-team
+summary: Chuẩn button toàn admin portal để tránh chỗ chỉ text, chỗ icon + text không nhất quán.
+specOrigin: legacy
+grillStatus:
+  bqaFacts: draft
+  bqaOpen: draft
+  dev: draft
+  full: not_required
+principles:
+  - Button nghiệp vụ mặc định dùng icon + text.
+  - Nếu legacy thiếu icon, prototype chọn icon lucide hợp lý theo ý nghĩa action.
+  - Icon không được là placeholder; phải phản ánh action/status.
+  - Thiết kế phẳng: border/background rõ, không gradient, không shadow nặng.
+  - Tránh button chỉ màu mà không có text/icon đủ nghĩa.
+defaultPattern:
+  businessAction:
+    content: icon + text
+    iconPosition: left
+    gap: 2
+    examples:
+      search:
+        text: 検索
+        icon: Search
+      clear:
+        text: クリア
+        icon: RotateCcw hoặc X
+      create:
+        text: 新規作成
+        icon: Plus
+      save:
+        text: 保存
+        icon: Save
+      update:
+        text: 更新
+        icon: Save
+      edit:
+        text: 編集
+        icon: Edit
+      duplicate:
+        text: 複製
+        icon: Copy
+      import:
+        text: インポート
+        icon: Upload
+      upload:
+        text: アップロード
+        icon: Upload
+      download:
+        text: ダウンロード
+        icon: Download
+      export:
+        text: エクスポート
+        icon: Download
+      backToList:
+        text: 一覧へ
+        icon: List
+      delete:
+        text: 削除
+        icon: Trash2
+        variant: destructive
+exceptions:
+  tableAction:
+    rule: icon-only
+    reason: Cột action trong table cần compact và đã có aria-label/title theo `common-table-action-column`.
+  paginationPrevNext:
+    rule: icon + text
+    icons:
+      previous: ChevronLeft
+      next: ChevronRight
+    text:
+      previous: 前へ
+      next: 次へ
+    reason: Pagination cần dễ hiểu hơn cho admin user, giữ icon để nhận diện nhanh và text tiếng Nhật để rõ hành động.
+  iconUtility:
+    rule: icon-only
+    appliesTo:
+      - close dialog
+      - collapse sidebar
+      - clear single chip
+    requirement: bắt buộc có aria-label/title.
+  readonlyMetric:
+    rule: text-only allowed
+    examples:
+      - 合計 {count}
+    reason: Đây là indicator dạng button-style nhưng không phải action clickable.
+variants:
+  complete:
+    useFor: primary/complete action
+    background: "#48b0f7"
+    text: "#ffffff"
+  outlinePrimary:
+    useFor: search/secondary positive action
+    border: "#4EAAFF"
+    text: "#4EAAFF"
+    background: "#FFFFFF"
+  outlineSecondary:
+    useFor: clear/cancel/back neutral action
+    border: "#C2C2C2"
+    text: "#6B7280"
+    background: "#FFFFFF"
+  destructive:
+    useFor: delete/destructive action
+    icon: Trash2
+accessibility:
+  - Button icon + text không cần aria-label riêng nếu text đủ rõ.
+  - Button icon-only bắt buộc có `aria-label` và `title`.
+  - Loading button giữ icon hoặc spinner bên trái, text vẫn mô tả action.
+testIds:
+  button: "{module}-{action}-btn"
+acceptance:
+  - Các button nghiệp vụ ngoài table/pagination không còn text-only.
+  - Nếu page dùng legacy button text-only thì prototype phải bổ sung icon hợp lý.
+  - Pagination previous/next dùng icon + text, page number vẫn là số.
+  - Table action tiếp tục icon-only và không thêm text label.

package/templates/project-skeleton/surfaces/common/yaml/confirm-dialog/common-confirm-dialog.bundle.yaml

@@ -0,0 +1,89 @@
+schema: portal-feature-bundle/v1
+id: common-confirm-dialog
+title: Common confirm dialog
+status: draft
+owner: portal-team
+summary: Chuẩn confirm dialog cho destructive/overwrite action, thay thế `window.confirm` trong prototype lâu dài.
+specOrigin: legacy
+grillStatus:
+  bqaFacts: draft
+  bqaOpen: draft
+  dev: draft
+  full: not_required
+spec:
+  principles:
+    - Không lạm dụng modal; chỉ dùng khi action destructive, irreversible, overwrite hoặc có side effect lớn.
+    - Dialog phẳng, border rõ, không gradient/shadow nặng.
+    - Non-destructive confirmation nên dùng inline confirmation hoặc disabled state nếu đủ rõ.
+    - Tránh tuyệt đối modal chồng modal; nếu modal đang mở thì action con phải xử lý trong cùng modal hoặc đóng modal hiện tại trước khi mở flow mới.
+  terminology:
+    actionModal:
+      definition: Dialog có button action hoặc close, chặn tương tác background.
+      dismissal: Chỉ đóng khi user bấm confirm, cancel, close, hoặc flow kết thúc theo spec.
+      interaction: User chỉ thao tác được trong modal trong lúc modal mở.
+    alertToast:
+      definition: Thông báo nổi tự mất, không có confirm/cancel action.
+      ownerSpec: common-feedback
+  layout:
+    placement:
+      default: center
+      reason: Dialog có button hành động cần focus và xác nhận rõ, nên hiển thị modal giữa màn hình.
+      topRightNotAllowedFor:
+        - confirm delete
+        - confirm overwrite
+        - cancel/confirm action flow
+      topRightBelongsTo: alert dialog không có action confirm/cancel trong `common-feedback`.
+    content:
+      maxWidth: sm
+      title: ngắn, rõ action
+      description: mô tả object/impact
+    footer:
+      alignment: right
+      order:
+        - cancel secondary/outline gray
+        - confirm primary hoặc destructive
+  copy:
+    deleteSingle: この要素を削除してよろしいですか？
+    deleteMultiple: これらのレコードを削除しますか？
+    overwriteImport: 重複するデータが存在し、それは上書きされます。続行しますか？
+  testIds:
+    dialog: "{module}-{action}-dialog"
+    title: "{module}-{action}-dialog-title"
+    content: "{module}-{action}-dialog-content"
+    confirm: "{module}-{action}-confirm-btn"
+    cancel: "{module}-{action}-cancel-btn"
+  acceptance:
+    - Row delete, bulk delete và import overwrite không dùng `window.confirm` khi đã có common dialog.
+    - Confirm button disabled/loading khi action đang pending.
+    - Cancel đóng dialog và không gọi service.
+    - Confirm dialog có button action mặc định đặt giữa màn hình, không dùng top-right.
+    - Top-right chỉ áp dụng cho alert dialog không có confirm/cancel action.
+    - Không mở modal thứ hai trên modal hiện tại.
+legacy:
+  legacyRef:
+    module: common/common
+    function: common-confirm-dialog
+    slice: slices.common-confirm-dialog
+  behaviors: []
+  fields: []
+  ui: []
+  evidence: []
+  refs: {}
+design:
+  inherits: admin-crud
+  shell:
+    tag: "#shell: DataPage"
+    overrideCommonPattern: false
+  patterns:
+    - "#pattern: CRUD"
+  zones:
+    - id: main
+      label: Nội dung chính
+  behavior: {}
+  actions: []
+review:
+  summary: Chuẩn confirm dialog cho destructive/overwrite action, thay thế `window.confirm` trong prototype lâu dài.
+  layoutNotes: []
+_meta:
+  generatedBy: archived-legacy-converter
+  sourceRevision: null

package/templates/project-skeleton/surfaces/common/yaml/confirm-dialog/ir/design.yaml

@@ -0,0 +1,13 @@
+# Generated from common-confirm-dialog.bundle.yaml — pnpm spec:split
+id: common-confirm-dialog
+inherits: admin-crud
+shell:
+  tag: "#shell: DataPage"
+  overrideCommonPattern: false
+patterns:
+  - "#pattern: CRUD"
+zones:
+  - id: main
+    label: Nội dung chính
+behavior: {}
+actions: []

package/templates/project-skeleton/surfaces/common/yaml/confirm-dialog/ir/legacy.yaml

@@ -0,0 +1,11 @@
+# Generated from common-confirm-dialog.bundle.yaml — pnpm spec:split
+id: common-confirm-dialog
+legacyRef:
+  module: common/common
+  function: common-confirm-dialog
+  slice: slices.common-confirm-dialog
+behaviors: []
+fields: []
+ui: []
+evidence: []
+refs: {}

package/templates/project-skeleton/surfaces/common/yaml/confirm-dialog/ir/spec.yaml

@@ -0,0 +1,60 @@
+# Generated from common-confirm-dialog.bundle.yaml — pnpm spec:split
+id: common-confirm-dialog
+title: Common confirm dialog
+status: draft
+owner: portal-team
+summary: Chuẩn confirm dialog cho destructive/overwrite action, thay thế `window.confirm` trong prototype lâu dài.
+specOrigin: legacy
+grillStatus:
+  bqaFacts: draft
+  bqaOpen: draft
+  dev: draft
+  full: not_required
+principles:
+  - Không lạm dụng modal; chỉ dùng khi action destructive, irreversible, overwrite hoặc có side effect lớn.
+  - Dialog phẳng, border rõ, không gradient/shadow nặng.
+  - Non-destructive confirmation nên dùng inline confirmation hoặc disabled state nếu đủ rõ.
+  - Tránh tuyệt đối modal chồng modal; nếu modal đang mở thì action con phải xử lý trong cùng modal hoặc đóng modal hiện tại trước khi mở flow mới.
+terminology:
+  actionModal:
+    definition: Dialog có button action hoặc close, chặn tương tác background.
+    dismissal: Chỉ đóng khi user bấm confirm, cancel, close, hoặc flow kết thúc theo spec.
+    interaction: User chỉ thao tác được trong modal trong lúc modal mở.
+  alertToast:
+    definition: Thông báo nổi tự mất, không có confirm/cancel action.
+    ownerSpec: common-feedback
+layout:
+  placement:
+    default: center
+    reason: Dialog có button hành động cần focus và xác nhận rõ, nên hiển thị modal giữa màn hình.
+    topRightNotAllowedFor:
+      - confirm delete
+      - confirm overwrite
+      - cancel/confirm action flow
+    topRightBelongsTo: alert dialog không có action confirm/cancel trong `common-feedback`.
+  content:
+    maxWidth: sm
+    title: ngắn, rõ action
+    description: mô tả object/impact
+  footer:
+    alignment: right
+    order:
+      - cancel secondary/outline gray
+      - confirm primary hoặc destructive
+copy:
+  deleteSingle: この要素を削除してよろしいですか？
+  deleteMultiple: これらのレコードを削除しますか？
+  overwriteImport: 重複するデータが存在し、それは上書きされます。続行しますか？
+testIds:
+  dialog: "{module}-{action}-dialog"
+  title: "{module}-{action}-dialog-title"
+  content: "{module}-{action}-dialog-content"
+  confirm: "{module}-{action}-confirm-btn"
+  cancel: "{module}-{action}-cancel-btn"
+acceptance:
+  - Row delete, bulk delete và import overwrite không dùng `window.confirm` khi đã có common dialog.
+  - Confirm button disabled/loading khi action đang pending.
+  - Cancel đóng dialog và không gọi service.
+  - Confirm dialog có button action mặc định đặt giữa màn hình, không dùng top-right.
+  - Top-right chỉ áp dụng cho alert dialog không có confirm/cancel action.
+  - Không mở modal thứ hai trên modal hiện tại.

package/templates/project-skeleton/surfaces/common/yaml/data-table/common-data-table.bundle.yaml

@@ -0,0 +1,85 @@
+schema: portal-feature-bundle/v1
+id: common-data-table
+title: Common data table
+status: draft
+owner: portal-team
+summary: Chuẩn table dữ liệu cho admin portal, tối ưu màn nhiều cột, giữ row cân bằng và action dễ thao tác.
+specOrigin: legacy
+grillStatus:
+  bqaFacts: draft
+  bqaOpen: draft
+  dev: draft
+  full: not_required
+spec:
+  layout:
+    container:
+      - Table phải nằm trong container có horizontal overflow khi nhiều cột.
+      - Không ép table co cột quá nhỏ khiến text wrap tự do.
+    table:
+      density: compact
+      minWidth: page hoặc component quyết định theo số cột
+      header: background muted nhẹ, text semibold
+      row:
+        height: 40-48px mặc định
+        hover: background muted/nhẹ
+        striped: optional, chỉ dùng khi page spec yêu cầu hoặc table nhiều dòng dễ đọc hơn
+    cell:
+      padding: px-3 py-2
+      defaultOverflow: truncate-tooltip
+      defaultAlign: left
+  columns:
+    reserved:
+      action:
+        width: fixed
+        overflow: nowrap
+        sticky: optional khi table rất rộng
+      status:
+        width: compact
+        renderer: status-chip
+      id:
+        overflow: nowrap
+      date:
+        overflow: nowrap
+      numeric:
+        align: right
+  overflowModes:
+    nowrap: Không xuống dòng, dùng cho ID/code/date/status/action.
+    truncate-tooltip: Một dòng, ellipsis, hover/focus xem full text; default cho name/email/url/title ngắn.
+    wrap-2-lines: Tối đa 2 dòng, dùng cho subject/title cần đọc thêm nhưng không phá row.
+    wrap-free: Chỉ dùng cho nội dung dài thật sự như message body/note/report detail, không dùng mặc định trong list.
+  testIds:
+    table: "{module}-table"
+    row: "{module}-row"
+    cell: optional "{module}-{column}-cell"
+  acceptance:
+    - Text dài không làm row cao bất thường nếu column không khai báo wrap.
+    - Cell bị truncate có title/tooltip hoặc cơ chế xem full text khi hover/focus.
+    - Table nhiều cột ưu tiên horizontal scroll hơn wrap làm vỡ layout.
+legacy:
+  legacyRef:
+    module: common/common
+    function: common-data-table
+    slice: slices.common-data-table
+  behaviors: []
+  fields: []
+  ui: []
+  evidence: []
+  refs: {}
+design:
+  inherits: admin-crud
+  shell:
+    tag: "#shell: DataPage"
+    overrideCommonPattern: false
+  patterns:
+    - "#pattern: CRUD"
+  zones:
+    - id: main
+      label: Nội dung chính
+  behavior: {}
+  actions: []
+review:
+  summary: Chuẩn table dữ liệu cho admin portal, tối ưu màn nhiều cột, giữ row cân bằng và action dễ thao tác.
+  layoutNotes: []
+_meta:
+  generatedBy: archived-legacy-converter
+  sourceRevision: null

package/templates/project-skeleton/surfaces/common/yaml/data-table/ir/design.yaml

@@ -0,0 +1,13 @@
+# Generated from common-data-table.bundle.yaml — pnpm spec:split
+id: common-data-table
+inherits: admin-crud
+shell:
+  tag: "#shell: DataPage"
+  overrideCommonPattern: false
+patterns:
+  - "#pattern: CRUD"
+zones:
+  - id: main
+    label: Nội dung chính
+behavior: {}
+actions: []

package/templates/project-skeleton/surfaces/common/yaml/data-table/ir/legacy.yaml

@@ -0,0 +1,11 @@
+# Generated from common-data-table.bundle.yaml — pnpm spec:split
+id: common-data-table
+legacyRef:
+  module: common/common
+  function: common-data-table
+  slice: slices.common-data-table
+behaviors: []
+fields: []
+ui: []
+evidence: []
+refs: {}