@shanyucoder/flowgrid 0.1.0

package/templates/shared/integration-adapter.bundle.yaml

@@ -0,0 +1,77 @@
+# SSOT — portal-feature-bundle/v1
+
+schema: portal-feature-bundle/v1
+id: factory-mes-example
+title: OT adapter example
+status: draft
+owner: integration-team
+summary: Adapter fast calls via httpx
+specOrigin: requirement
+
+grillStatus:
+  bqaFacts: pending
+  bqaOpen: pending
+  dev: pending
+  full: not_required
+
+contractRef:
+  fastClient: null # Set an online Git URL when the source repository is published.
+
+spec:
+  feature:
+    id: factory-mes-example
+    title: Adapter title
+    status: draft
+    version: 0.1.0
+  approval:
+    status: draft
+  api:
+    endpoints:
+      - id: mes.downtime
+        module: mes
+        action: getDowntime
+        method: GET
+        path: /plants/{plant_id}/downtime
+        response: PlantDowntimeResponse
+  responses:
+    PlantDowntimeResponse:
+      fields:
+        - name: plant_id
+          type: integer
+        - name: items
+          type: array
+          items:
+            - name: machine_id
+              type: string
+            - name: minutes
+              type: integer
+            - name: reason
+              type: string
+
+gen:
+  codegen:
+    module: mes
+    entity: PlantDowntime
+    profile: mes-downtime
+
+legacy:
+  legacyRef: null
+  behaviors: []
+  fields: []
+  ui: []
+  evidence: []
+  refs: {}
+
+design:
+  inherits: null
+  shell:
+    tag: "#shell: OtAdapter"
+  patterns: []
+  zones: []
+  behavior: {}
+  actions: []
+
+review:
+  summary: ""
+  layoutNotes: []
+

package/templates/shared/integration-spec.yaml

@@ -0,0 +1,37 @@
+feature:
+  id: example-integration-adapter
+  title: OT adapter name
+  status: draft
+  version: 0.1.0
+
+approval:
+  status: draft
+
+codegen:
+  module: mes
+  entity: PlantDowntime
+  profile: mes-downtime
+
+api:
+  endpoints:
+    - id: mes.downtime
+      module: mes
+      action: getDowntime
+      method: GET
+      path: /plants/{plant_id}/downtime
+      response: PlantDowntimeResponse
+
+responses:
+  PlantDowntimeResponse:
+    fields:
+      - name: plant_id
+        type: integer
+      - name: items
+        type: array
+        items:
+          - name: machine_id
+            type: string
+          - name: minutes
+            type: integer
+          - name: reason
+            type: string

package/templates/shared/ir-design.yaml

@@ -0,0 +1,34 @@
+# Tech SSOT after split — bộ code / bộ test đọc file này, không đọc ir/spec.yaml.
+# codegen.profile is REQUIRED for flowgrid (from bundle.gen).
+
+id: role-domain-function
+
+codegen:
+  profile: "" # list | create | admin-crud | …
+  entity: ""
+  module: ""
+
+tags: []
+
+inherits: null
+
+shell:
+  tag: "#shell: DataListPage"
+
+patterns: []
+
+nav:
+  sidebar:
+    enabled: false
+  breadcrumb: []
+
+sections: []
+zones: []
+# Nested sections: visual/interaction/validation/apiRefs/hidden. Codegen đọc file này, không đọc MD.
+
+behavior:
+  create: { enabled: true, surface: page }
+  update: { enabled: true, surface: page }
+  delete: { enabled: true, mode: confirm_dialog }
+
+deviations: []

package/templates/shared/ir-legacy.yaml

@@ -0,0 +1,12 @@
+# Derived from bundle.legacy — grill fact-pass reads this file
+
+id: role-domain-function
+
+legacyRef: null
+
+behaviors: []
+fields: []
+ui: []
+
+evidence: []
+refs: {}

package/templates/shared/ir-spec.yaml

@@ -0,0 +1,18 @@
+# Business prose (requirements, acceptance, page inventory). Not codegen input.
+# Layout here is labels/purpose/validation — no element ids or #needs-component.
+# Tech SSOT is sibling ir/design.yaml.
+
+page-id: role-domain-function
+title: Feature title
+status: draft
+owner: portal-team
+summary: Short summary
+
+specOrigin: requirement
+
+actors: []
+requirements: []
+acceptance: []
+
+# Filled by spec:split from qa/open/QA-<id>-NNNN.yaml (comma-separated). Omit when none.
+# "Q&A": QA-role-domain-function-0001, QA-role-domain-function-0002

package/templates/shared/line-client.bundle.yaml

@@ -0,0 +1,65 @@
+# SSOT — portal-feature-bundle/v1 · Split: pnpm spec:split -- <path>
+# Authoring: templates/bundle-authoring.md
+
+schema: portal-feature-bundle/v1
+id: role-domain-function
+title: Line client feature
+status: draft
+owner: line-team
+summary: Shop-floor screen — clients.line block
+specOrigin: requirement
+
+grillStatus:
+  bqaFacts: pending
+  bqaOpen: pending
+  dev: pending
+  full: not_required
+
+contractRef:
+  portalIrSpec: surfaces/.../CMP-*/<slug>/code/W-*/ir/spec.yaml (or --id)
+
+spec:
+  clients:
+    line:
+      profile: kiosk
+      screens:
+        - id: screen-id
+          route: module/action
+          automationIds:
+            page: module-page
+            submit-btn: module-submit-btn
+      devices:
+        - badgeReader
+      api:
+        endpoints:
+          actionName:
+            method: POST
+            path: /module/action
+
+gen:
+  codegen:
+    profile: kiosk
+    entity: entity-name
+    module: factory
+
+legacy:
+  legacyRef: null
+  behaviors: []
+  fields: []
+  ui: []
+  evidence: []
+  refs: {}
+
+design:
+  inherits: null
+  shell:
+    tag: "#shell: KioskCheckIn"
+  patterns: []
+  zones: []
+  behavior: {}
+  actions: []
+
+review:
+  summary: ""
+  layoutNotes: []
+

package/templates/shared/mock-data.yaml

@@ -0,0 +1,22 @@
+feature: feature-slug
+mocks:
+  feature.search.success:
+    endpoint: feature.search
+    status: 200
+    response:
+      data:
+        - id: 1
+          name: Example
+      meta:
+        current_page: 1
+        per_page: 15
+        total: 1
+
+  feature.create.validation:
+    endpoint: feature.create
+    status: 422
+    response:
+      message: The given data was invalid.
+      errors:
+        name:
+          - The name field is required.

package/templates/shared/openapi.yaml

@@ -0,0 +1,144 @@
+openapi: 3.1.0
+info:
+  title: Feature API
+  version: 0.1.0
+  description: OpenAPI YAML generated from backend phase 3b spec.
+servers:
+  - url: http://localhost
+    description: Local API
+tags:
+  - name: Feature
+  - name: call-external
+    description: Endpoint depends on a third-party integration.
+  - name: cross-entity-service
+    description: Endpoint uses a reviewed internal cross-entity service.
+paths:
+  /admin/features:
+    get:
+      operationId: featureSearch
+      summary: List feature entities
+      tags:
+        - Feature
+      parameters:
+        - in: query
+          name: filter[name]
+          schema:
+            type: string
+      responses:
+        '200':
+          description: Feature entity collection
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/FeatureEntityCollection'
+components:
+  responses:
+    UnauthorizedError:
+      description: Unauthorized - Token missing, expired, or invalid (#err:unauthorized)
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/ErrorResponse'
+          example:
+            code: UNAUTHORIZED
+            message: Unauthenticated or session expired.
+    PermissionError:
+      description: Forbidden - Insufficient permissions (#err:permission-denied)
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/ErrorResponse'
+          example:
+            code: PERMISSION_DENIED
+            message: You do not have permission to perform this action.
+    IdorViolationError:
+      description: Forbidden - Cross-tenant IDOR violation (#err:idor-violation)
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/ErrorResponse'
+          example:
+            code: TENANT_IDOR_VIOLATION
+            message: Cross-tenant resource access forbidden.
+    NotFoundError:
+      description: Resource Not Found (#err:not-found)
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/ErrorResponse'
+          example:
+            code: RESOURCE_NOT_FOUND
+            message: The requested entity was not found.
+    ValidationError:
+      description: Unprocessable Entity - Validation failed (#err:validation)
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/ValidationErrorResponse'
+          example:
+            code: VALIDATION_ERROR
+            message: The given data was invalid.
+            errors:
+              email:
+                - The email must be a valid email address.
+    ServerError:
+      description: Internal System Error (#err:system)
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/ErrorResponse'
+          example:
+            code: INTERNAL_SERVER_ERROR
+            message: An unexpected internal server error occurred.
+  schemas:
+    ErrorResponse:
+      type: object
+      required:
+        - code
+        - message
+      properties:
+        code:
+          type: string
+          example: ERROR_CODE
+        message:
+          type: string
+          example: Human-readable error description.
+    ValidationErrorResponse:
+      type: object
+      required:
+        - code
+        - message
+        - errors
+      properties:
+        code:
+          type: string
+          example: VALIDATION_ERROR
+        message:
+          type: string
+          example: The given data was invalid.
+        errors:
+          type: object
+          additionalProperties:
+            type: array
+            items:
+              type: string
+    FeatureEntity:
+      type: object
+      required:
+        - id
+        - name
+      properties:
+        id:
+          type: integer
+          example: 1
+        name:
+          type: string
+          example: Example
+    FeatureEntityCollection:
+      type: object
+      properties:
+        data:
+          type: array
+          items:
+            $ref: '#/components/schemas/FeatureEntity'
+

package/templates/shared/patterns/admin-crud.pattern.yaml

@@ -0,0 +1,37 @@
+# Admin CRUD archetype (normalized)
+
+schema: portal-crud-pattern/v1
+id: admin-crud
+knowledge:
+  level: normalized
+
+appliesWhen:
+  - admin
+  - entity-metadata
+  - crud
+
+commonSpecs:
+  - yaml/common/list-page/common-list-page
+  - yaml/common/delete-flow/common-delete-flow
+  - yaml/common/search-filter/common-search-filter
+  - yaml/common/table-action-column/common-table-action-column
+  - yaml/common/pagination/common-pagination
+  - yaml/common/breadcrumb-flow/common-breadcrumb-flow
+
+defaultTags:
+  - "#pattern: CRUD"
+  - "#shell: DataListPage"
+  - "#style: shadcn/ui"
+  - "#style: compact"
+  - "#style: flat"
+
+defaultBehavior:
+  create:
+    enabled: true
+    surface: page
+  update:
+    enabled: true
+    surface: page
+  delete:
+    enabled: true
+    mode: confirm_dialog

package/templates/shared/qa-item.yaml

@@ -0,0 +1,15 @@
+# Copy to qa/open/QA-<bundle.id>-NNNN.yaml — do not leave this file in qa/open/.
+id: QA-cmp-adm-002-02-01-02-0001
+kind: customer # customer | choice | tech-debt
+skill: spec # spec | grill-bqa | grill-dev | grill-docs | api-spec | api-update | api-integration
+target:
+  path: surfaces/<surface>/CMP-*/<NN…>/<slug>.bundle.yaml
+  at: design.zones.main.items.title.purpose
+question: |
+  What is still unknown?
+options: []
+# - id: a
+#   text: Option A
+#   recommended: true
+# - id: other
+#   text: Member supplies copy

package/templates/shared/spec.yaml

@@ -0,0 +1,162 @@
+# Portal-gen-ready spec — output of /grill-docs (not round-1 /spec).
+# Design v1 template: docs/templates/design-spec.yaml
+# Enrichment rules: .cursor/extracts/codegen/readiness.md
+
+id: feature-slug
+title: Feature Title
+status: draft
+owner: portal-team
+summary: Short business summary for BA, QA, dev, and AI.
+
+# pnpm portal:gen:dry --spec <this-file>  (must pass before /prototype)
+# Tags: .cursor/extracts/codegen/tags.md
+codegen:
+  profile: list # list | create | edit | auth | change-password | public | not-found | error
+  entity: entitySingular # hotel
+  module: modulePlural # hotels — testId prefix, mock id
+  skip: [] # models | service | composable | page | mock | validation
+
+tags: []
+# Design registry (grill — list default):
+# - "#shell: DataListPage"
+# - "#pattern: CRUD"
+# - "#style: shadcn/ui"
+# - "#needs-component: cell-status:MoStatusChip:label"
+# - "#needs-ui: Repeater"
+# - "#common:export-csv"  # logic — also add marks[] below
+# - "#custom-slot: cell-status"
+# - "#manual-composable: export-csv"
+# - "#skip-codegen: page"
+
+# Member / grill-confirmed marks (/platform-mark) — optional until promote common
+marks: []
+# - id: MK-STATUS-001
+#   kind: needs-component
+#   tag: "#needs-component: cell-status:MoStatusChip:label"
+#   registryId: MoStatusChip
+#   reason: "Cột status render custom"
+#   source: grill-dev
+# - id: MK-EXPORT-001
+#   kind: common
+#   tag: "#common:export-csv"
+#   registryId: export.csv
+#   reason: "Toolbar export lặp list khác"
+#   source: platform-mark
+
+requirements:
+  - id: REQ-FEATURE-001
+    title: Main behavior
+    description: User can complete the main behavior.
+    priority: must
+
+ui:
+  # Canonical page profiles. Keep these as source-of-truth; gen-ready blocks below are derived in grill.
+  validationMessages:
+    required: This field is required
+    email: Email format is invalid
+    phone: Phone number format is invalid
+    minLength: Must be at least {n} characters
+    maxLength: Must be at most {n} characters
+    min: Must be at least {n}
+    max: Must be at most {n}
+    pattern: Invalid format
+  list:
+    # titleField: name
+    # subtitleField: code
+    columns: []
+    filters: []
+    rowActions: []
+    bulkActions: []
+    pagination:
+      defaultPageSize: 20
+      pageSizeOptions: [20, 50, 100]
+    emptyState:
+      title: No data
+      message: No records found.
+  form:
+    layout:
+      mode: single-column # single-column | two-column | custom
+    sections: []
+    fields:
+      # - key: name
+      #   label: Name
+      #   type: string
+      #   widget: text
+      #   required: true
+      #   validation:
+      #     minLength: 1
+      #     maxLength: 255
+      #   messages:
+      #     required: Name is required.
+      #     maxLength: Name must be 255 characters or less.
+      # - key: status
+      #   label: Status
+      #   type: int
+      #   widget: select
+      #   source:
+      #     kind: enum
+      #     ref: status
+      #   required: true
+      #   messages:
+      #     required: Status is required.
+      # - key: chain_id
+      #   label: Chain
+      #   type: int
+      #   widget: select
+      #   source:
+      #     kind: relation
+      #     ref: chains
+      #     valueKey: id
+      #     labelKey: name
+      #   nullable: true
+    submit:
+      label: Save
+      testId: feature-save-btn
+    emptyState:
+      title: No form fields
+      message: This form has not been configured yet.
+  detail:
+    header:
+      # titleField: name
+      # subtitleField: code
+      badges: []
+    sections: []
+    actions: []
+    emptyState:
+      title: No detail sections
+      message: This detail page has not been configured yet.
+  composition:
+    pattern: DataListPage # DataListPage | custom
+    overrideCommonPattern: false
+  routes:
+    - path: /feature
+      pageTestId: feature-page
+  filters: []
+  # - name: name
+  #   label: Name
+  #   type: text_field # text_field | select | number_field | date | ...
+  #   placeholder: Optional
+  columns: []
+  # - key: name
+  #   title: Name
+  #   sortable: true
+  #   render: default # default | custom
+  #   component: MoStatusChip # optional — auto-wires cell slot (Nuxt auto-import)
+  #   componentProp: label # prop bound from slot `value` (default: value)
+  testIds:
+    module: feature # kebab-case prefix — portal:gen emits {module}-page, -table, …
+    required: [] # canonical E2E ids — grill fills; testcase mirrors this list
+    # patterns: # dynamic ids from gen (e.g. cell slot buttons)
+    #   - id: action-login-as
+    #     template: "{module}-cell-managers-login-as-{managerId}"
+  # create profile only:
+  #   fields are declared in ui.form.fields above.
+
+acceptance:
+  - Feature page renders successfully.
+  - Main behavior works end to end.
+
+notes:
+  - YAML is the source of truth. Render Markdown with pnpm docs:render.
+  - Generate code with pnpm portal:gen --spec <path>.
+

package/templates/shared/testcase.yaml

@@ -0,0 +1,2 @@
+# Moved (R3) → https://github.com/raintr91/base_test/tree/main/templates
+# Plans SSOT: base-tests/cases/** — do not author next to Code bundles.

package/templates/tests-skeleton/cases/README.md

@@ -0,0 +1,5 @@
+# cases/
+
+Đặt `TC-*.yaml` mirror path function trên docs-hub (bỏ prefix `surfaces/`).
+
+Ví dụ docs: `surfaces/admin/CMP-ADM-002/02/01/login/` → `cases/admin/CMP-ADM-002/02/01/login/TC-*.yaml`

package/templates/tests-skeleton/catalog/locale.yaml

@@ -0,0 +1,7 @@
+memberLocale: vi
+headings:
+  vi:
+    home: Trang chủ
+    cases: Testcase
+    scenarios: Scenario
+    plans: Kế hoạch kiểm thử

package/templates/tests-skeleton/index.md

@@ -0,0 +1,7 @@
+---
+layout: home
+---
+
+# Tests-docs hub
+
+SSOT testcase (`cases/**/TC-*.yaml`) và scenario (`scenarios/**`). Mirror cấu trúc leaf trên docs-hub.

package/templates/tests-skeleton/scenarios/README.md

@@ -0,0 +1,3 @@
+# scenarios/
+
+Cross-flow `SC-*.yaml` bám `FLOW-*.md` trên docs-hub.