scaffold-engine 0.1.0

package/specs/catalogs/object-name-suggestions.yaml

@@ -0,0 +1,30 @@
+suggestions:
+  - keywords: [组织树, 组织架构, 部门树, 组织单元]
+    patternRef: treeEntity
+    domain: hr
+    object: orgUnit
+    label: 组织单元
+
+  - keywords: [供应商, 供应商档案, 供应商管理]
+    patternRef: masterDetail
+    domain: erp
+    object: supplier
+    label: 供应商
+
+  - keywords: [销售订单]
+    patternRef: documentLines
+    domain: ecom
+    object: salesOrder
+    label: 销售订单
+
+  - keywords: [采购订单]
+    patternRef: documentLines
+    domain: erp
+    object: purchaseOrder
+    label: 采购订单
+
+  - keywords: [订单, 申请单, 单据]
+    patternRef: documentLines
+    domain: custom
+    object: orderDocument
+    label: 单据

package/specs/catalogs/object-templates.yaml

@@ -0,0 +1,45 @@
+templates:
+  crmRootCrud:
+    patternRef: statusEntity
+    detailSections: [basicInfo]
+    actionTemplateRef: crudBasic
+    fieldRefs: [ownerName]
+
+  statusFlowObject:
+    patternRef: statusEntity
+    detailSections: [basicInfo]
+    actionTemplateRef: crudWithStatusFlow
+    fieldRefs: [ownerName]
+
+  crmCustomerObject:
+    patternRef: masterDetail
+    detailSections: [basicInfo]
+    actionTemplateRef: crudWithToggle
+    fieldRefs: [ownerName]
+    childTemplateRefs: [customerContacts]
+    fields:
+      - name: source
+        label: 客户来源
+        fragmentRef: sourceCustomer
+
+  erpMasterData:
+    patternRef: singleEntity
+    detailSections: [basicInfo]
+    actionTemplateRef: crudBasic
+
+  documentLinesBasic:
+    patternRef: documentLines
+    detailSections: [basicInfo]
+    actionTemplateRef: crudBasic
+    childTemplateRefs: [documentLineItems]
+
+  documentLinesApproval:
+    patternRef: documentLines
+    detailSections: [basicInfo]
+    actionTemplateRef: crudWithSubmitApprove
+    childTemplateRefs: [documentLineItems]
+
+  treeEntityBasic:
+    patternRef: treeEntity
+    detailSections: [basicInfo]
+    actionTemplateRef: crudBasic

package/specs/catalogs/pattern-catalog.yaml

@@ -0,0 +1,48 @@
+patterns:
+  singleEntity:
+    label: 单实体对象
+    description: 适用于单表对象，常见于台账、档案、基础资料等场景。
+    detectKeywords: [台账, 档案, 主数据, 基础资料, 单实体]
+    seedFieldRefs: [materialCode, materialName, statusErpBase]
+    defaultUi:
+      detailSections: [basicInfo]
+    defaultActionTemplateRef: crudBasic
+
+  masterDetail:
+    label: 主子表对象
+    description: 适用于主表带一张明细或联系人子表的对象。
+    detectKeywords: [主子表, 子表, 联系人, 附件, 地址, 明细]
+    seedFieldRefs: [customerCode, customerName, statusCrmBase]
+    seedChildTemplateRefs: [customerContacts]
+    defaultUi:
+      detailSections: [basicInfo]
+    defaultActionTemplateRef: crudWithToggle
+    defaultChildTemplateRefs: [customerContacts]
+
+  statusEntity:
+    label: 状态对象
+    description: 适用于带阶段、来源、状态流转的过程型对象。
+    detectKeywords: [状态流转, 阶段, 流程状态, 跟进, 转化]
+    seedFieldRefs: [leadCode, leadName, sourceLead, statusCrmFollow]
+    defaultUi:
+      detailSections: [basicInfo]
+    defaultActionTemplateRef: crudBasic
+
+  documentLines:
+    label: 单据明细对象
+    description: 适用于单据头加行项目明细的对象。
+    detectKeywords: [单据, 明细行, 行项目, 头表, 表头, 单据头, 明细表]
+    seedFieldRefs: [documentNo, documentTitle, bizDate, statusErpBase]
+    seedChildTemplateRefs: [documentLineItems]
+    defaultUi:
+      detailSections: [basicInfo]
+    defaultActionTemplateRef: crudBasic
+
+  treeEntity:
+    label: 树形对象
+    description: 适用于带父子层级关系的树形对象。
+    detectKeywords: [树, 树形, 层级, 父子, 上级, 下级, 分类树, 组织树]
+    seedFieldRefs: [categoryCode, categoryName, parentId, parentName, sortOrder, statusErpBase]
+    defaultUi:
+      detailSections: [basicInfo]
+    defaultActionTemplateRef: crudBasic

package/specs/catalogs/status-templates.yaml

@@ -0,0 +1,16 @@
+templates:
+  crmFollow:
+    options: [draft, following, converted, closed]
+    default: draft
+
+  crmBase:
+    options: [draft, active, inactive]
+    default: draft
+
+  crmClosed:
+    options: [draft, active, closed]
+    default: draft
+
+  erpBase:
+    options: [draft, active, inactive, blocked]
+    default: draft

package/specs/projects/crm-pilot/customer.yaml

@@ -0,0 +1,122 @@
+meta:
+  domain: crm
+  object: customer
+  label: 客户
+  version: 0.1.0
+  description: >
+    CRM 试点对象。首期只验证客户主数据 + 联系人子表，
+    用于支撑 AI 输出结构化业务模型、校验、生成骨架与人工补充实现。
+
+data:
+  table: crm_customer
+  fields:
+    - name: customerCode
+      label: 客户编码
+      type: string
+      required: true
+      unique: true
+    - name: customerName
+      label: 客户名称
+      type: string
+      required: true
+    - name: level
+      label: 客户等级
+      type: enum
+      options: [A, B, C]
+      default: B
+    - name: status
+      label: 状态
+      type: enum
+      options: [draft, active, inactive]
+      default: draft
+    - name: ownerName
+      label: 客户负责人
+      type: string
+    - name: source
+      label: 客户来源
+      type: enum
+      options: [manual, import, campaign]
+      default: manual
+  children:
+    - name: contacts
+      label: 联系人
+      table: crm_customer_contact
+      foreignKey: customerId
+      fields:
+        - name: contactName
+          label: 联系人姓名
+          type: string
+          required: true
+        - name: mobile
+          label: 手机号
+          type: string
+        - name: email
+          label: 邮箱
+          type: string
+        - name: isPrimary
+          label: 是否主联系人
+          type: boolean
+          default: false
+
+app:
+  actions: [create, update, detail, list, activate, deactivate]
+  defaultStatus: draft
+  responseContract:
+    envelope: standard
+    listSchema: pagedList
+    detailSchema: object
+    mutationSchema: object
+  permissionProfile:
+    mode: inherit
+    resourceScope: object
+    actionPolicies:
+      - action: create
+        permission: create
+      - action: update
+        permission: update
+      - action: list
+        permission: list
+      - action: detail
+        permission: detail
+      - action: activate
+        permission: activate
+      - action: deactivate
+        permission: deactivate
+  statusFlow:
+    enabled: true
+    states: [draft, active, inactive]
+    transitions:
+      - action: activate
+        from: [draft, inactive]
+        to: active
+      - action: deactivate
+        from: [active]
+        to: inactive
+  validationRules:
+    - name: statusTransition
+      scope: workflow
+      rule: statusTransition
+      fields: [status]
+      message: 状态流转必须符合既定规则
+  errorCodes:
+    - code: VALIDATION_FAILED
+      message: 输入校验失败
+    - code: RECORD_NOT_FOUND
+      message: 客户不存在
+    - code: DUPLICATE_KEY
+      message: 客户编码已存在
+    - code: INVALID_STATUS_TRANSITION
+      message: 当前状态不允许执行该动作
+
+ui:
+  list:
+    columns: [customerCode, customerName, level, status, ownerName, createdAt]
+    filters: [customerCode, customerName, status]
+  form:
+    groups:
+      - title: 基本信息
+        fields: [customerCode, customerName, level, status, ownerName, source]
+      - title: 联系人
+        childTable: contacts
+  detail:
+    sections: [basicInfo, contacts]

package/specs/projects/crm-pilot/lead.from-nl.yaml

@@ -0,0 +1,76 @@
+meta:
+  domain: crm
+  object: lead
+  label: 线索
+  version: 0.1.0
+  description: 由 requirement:analyze 从自然语言需求推导出的候选业务模型。
+data:
+  table: crm_lead
+  fields:
+    - name: leadCode
+      label: 线索编号
+      type: string
+      required: true
+      unique: true
+    - name: leadName
+      label: 线索名称
+      type: string
+      required: true
+    - name: source
+      label: 线索来源
+      type: enum
+      options:
+        - website
+        - referral
+        - campaign
+        - manual
+      default: manual
+    - name: ownerName
+      label: 负责人
+      type: string
+    - name: phone
+      label: 联系电话
+      type: string
+    - name: status
+      label: 状态
+      type: enum
+      options:
+        - draft
+        - following
+        - converted
+        - closed
+      default: draft
+app:
+  actions:
+    - create
+    - update
+    - list
+    - detail
+  defaultStatus: draft
+ui:
+  list:
+    columns:
+      - leadCode
+      - leadName
+      - source
+      - ownerName
+      - status
+      - createdAt
+    filters:
+      - leadCode
+      - leadName
+      - source
+      - status
+  form:
+    groups:
+      - title: 基本信息
+        fields:
+          - leadCode
+          - leadName
+          - source
+          - ownerName
+          - phone
+          - status
+  detail:
+    sections:
+      - basicInfo

package/specs/projects/crm-pilot/lead.yaml

@@ -0,0 +1,82 @@
+meta:
+  domain: crm
+  object: lead
+  label: 线索
+  version: 0.1.0
+  description: >
+    CRM 线索试点对象。用于验证纯主表对象在当前业务模型规范下的
+    自然语言抽取、规则校验与 API/Admin 骨架生成闭环。
+
+data:
+  table: crm_lead
+  fields:
+    - name: leadCode
+      label: 线索编号
+      type: string
+      required: true
+      unique: true
+    - name: leadName
+      label: 线索名称
+      type: string
+      required: true
+    - name: source
+      label: 线索来源
+      type: enum
+      options: [website, referral, campaign, manual]
+      default: manual
+    - name: ownerName
+      label: 负责人
+      type: string
+    - name: phone
+      label: 联系电话
+      type: string
+    - name: status
+      label: 状态
+      type: enum
+      options: [draft, following, converted, closed]
+      default: draft
+
+app:
+  actions: [create, update, detail, list]
+  defaultStatus: draft
+  responseContract:
+    envelope: standard
+    listSchema: pagedList
+    detailSchema: object
+    mutationSchema: object
+  permissionProfile:
+    mode: inherit
+    resourceScope: object
+    actionPolicies:
+      - action: create
+        permission: create
+      - action: update
+        permission: update
+      - action: list
+        permission: list
+      - action: detail
+        permission: detail
+  validationRules:
+    - name: uniqueLeadCode
+      scope: service
+      rule: unique
+      fields: [leadCode]
+      message: 线索编号必须唯一
+  errorCodes:
+    - code: VALIDATION_FAILED
+      message: 输入校验失败
+    - code: RECORD_NOT_FOUND
+      message: 线索不存在
+    - code: DUPLICATE_KEY
+      message: 线索编号已存在
+
+ui:
+  list:
+    columns: [leadCode, leadName, source, ownerName, status, createdAt]
+    filters: [leadCode, leadName, source, status]
+  form:
+    groups:
+      - title: 基本信息
+        fields: [leadCode, leadName, source, ownerName, phone, status]
+  detail:
+    sections: [basicInfo]

package/specs/projects/generated-from-nl/crm-customer.yaml

@@ -0,0 +1,158 @@
+meta:
+  domain: crm
+  object: customer
+  label: 客户
+  pattern: masterDetail
+  version: 0.1.0
+  description: 由 requirement:analyze 从自然语言需求推导出的候选业务模型。
+data:
+  table: crm_customer
+  fields:
+    - name: ownerName
+      label: 负责人
+      type: string
+    - name: customerCode
+      label: 客户编码
+      type: string
+      required: true
+      unique: true
+    - name: customerName
+      label: 客户名称
+      type: string
+      required: true
+    - name: level
+      label: 客户等级
+      type: enum
+      options:
+        - A
+        - B
+        - C
+      default: B
+    - name: status
+      label: 状态
+      type: enum
+      options:
+        - draft
+        - active
+        - inactive
+      default: draft
+    - name: source
+      label: 客户来源
+      type: enum
+      options:
+        - manual
+        - import
+        - campaign
+      default: manual
+  children:
+    - name: contacts
+      label: 联系人
+      table: crm_customer_contact
+      foreignKey: customerId
+      fields:
+        - name: contactName
+          label: 联系人姓名
+          type: string
+          required: true
+        - name: mobile
+          label: 手机号
+          type: string
+        - name: email
+          label: 邮箱
+          type: string
+        - name: isPrimary
+          label: 是否主联系人
+          type: boolean
+          default: false
+app:
+  actions:
+    - create
+    - update
+    - list
+    - detail
+    - activate
+    - deactivate
+  defaultStatus: draft
+  statusFlow:
+    enabled: true
+    states:
+      - draft
+      - active
+      - inactive
+    transitions:
+      - action: activate
+        from:
+          - draft
+          - inactive
+        to: active
+      - action: deactivate
+        from:
+          - active
+        to: inactive
+  responseContract:
+    envelope: standard
+    listSchema: pagedList
+    detailSchema: object
+    mutationSchema: object
+  permissionProfile:
+    mode: inherit
+    resourceScope: object
+    actionPolicies:
+      - action: create
+        permission: create
+      - action: update
+        permission: update
+      - action: list
+        permission: list
+      - action: detail
+        permission: detail
+      - action: activate
+        permission: activate
+      - action: deactivate
+        permission: deactivate
+  validationRules:
+    - name: statusTransition
+      scope: workflow
+      rule: statusTransition
+      fields:
+        - status
+      message: 状态流转必须符合既定规则
+  errorCodes:
+    - code: VALIDATION_FAILED
+      message: 输入校验失败
+    - code: RECORD_NOT_FOUND
+      message: 记录不存在
+    - code: DUPLICATE_KEY
+      message: 唯一键冲突
+    - code: INVALID_STATUS_TRANSITION
+      message: 当前状态不允许执行该动作
+ui:
+  list:
+    columns:
+      - ownerName
+      - customerCode
+      - customerName
+      - status
+      - source
+      - createdAt
+    filters:
+      - customerCode
+      - customerName
+      - status
+      - source
+  form:
+    groups:
+      - title: 基本信息
+        fields:
+          - ownerName
+          - customerCode
+          - customerName
+          - level
+          - status
+          - source
+      - title: 联系人
+        childTable: contacts
+  detail:
+    sections:
+      - basicInfo
+      - contacts

package/specs/projects/generated-from-nl/crm-lead.yaml

@@ -0,0 +1,76 @@
+meta:
+  domain: crm
+  object: lead
+  label: 线索
+  version: 0.1.0
+  description: 由 requirement:analyze 从自然语言需求推导出的候选业务模型。
+data:
+  table: crm_lead
+  fields:
+    - name: leadCode
+      label: 线索编号
+      type: string
+      required: true
+      unique: true
+    - name: leadName
+      label: 线索名称
+      type: string
+      required: true
+    - name: source
+      label: 线索来源
+      type: enum
+      options:
+        - website
+        - referral
+        - campaign
+        - manual
+      default: manual
+    - name: ownerName
+      label: 负责人
+      type: string
+    - name: phone
+      label: 联系电话
+      type: string
+    - name: status
+      label: 状态
+      type: enum
+      options:
+        - draft
+        - following
+        - converted
+        - closed
+      default: draft
+app:
+  actions:
+    - create
+    - update
+    - list
+    - detail
+  defaultStatus: draft
+ui:
+  list:
+    columns:
+      - leadCode
+      - leadName
+      - source
+      - ownerName
+      - status
+      - createdAt
+    filters:
+      - leadCode
+      - leadName
+      - source
+      - status
+  form:
+    groups:
+      - title: 基本信息
+        fields:
+          - leadCode
+          - leadName
+          - source
+          - ownerName
+          - phone
+          - status
+  detail:
+    sections:
+      - basicInfo