# ============================
# Tab 1: 基本信息
# ============================
basicInfo:
  tableName: <表名>                    # 从 DDL 读取
  tableComment: <表注释>               # 从 DDL COMMENT 读取
  className: <实体类名>                # 去前缀后转 PascalCase
  functionAuthor: <作者>               # 从 generator.yml 读取
  remark: ""

# ============================
# Tab 2: 字段信息
# ============================
columns:
  <列名>:
    columnComment: <字段描述>          # 从 DDL COMMENT 读取
    javaType: <Java类型>               # 推断规则见下
    javaField: <java属性>              # 列名转 camelCase
    isInsert: <bool>                   # 默认 true
    isEdit: <bool>                     # 主键和 create_by/create_time/del_flag 为 false
    isList: <bool>                     # 上述 + update_by/update_time 为 false
    isQuery: <bool>                    # 上述 + remark 为 false
    queryType: <查询方式>              # 默认 EQ，*_name 列为 LIKE
    isRequired: <bool>                 # DDL 中 NOT NULL 为 true
    htmlType: <显示类型>               # 推断规则见下
    dictType: ""                       # 需要用户确认

# 注意：不要包含 columnType 和 isPk 字段，CLI 会从 DDL 自动解析

# ============================
# Tab 3: 生成信息
# ============================
genInfo:
  tplCategory: crud                    # crud / tree / sub
  tplWebType: element-plus             # element-ui / element-plus
  packageName: <从generator.yml>       # 如 com.ruoyi.system
  moduleName: <从packageName提取末段>
  businessName: <从tableName提取末段>
  functionName: <从tableComment去除"表"字>
  parentMenuId: 3
  # treeCode / treeParentCode / treeName       (tplCategory=tree)
  # subTableName / subTableFkName / subTableGenerateMenu  (tplCategory=sub)

# ============================
# 子表字段信息（仅 tplCategory=sub 时需要）
# ============================
subTableColumns:
  <列名>:
    columnComment: <字段描述>
    javaType: <Java类型>
    javaField: <java属性>
    isInsert: <bool>
    isEdit: <bool>
    isList: <bool>
    isQuery: <bool>
    queryType: <查询方式>
    isRequired: <bool>
    htmlType: <显示类型>
    dictType: ""

# 注意：子表字段也不要包含 columnType 和 isPk，CLI 会从 DDL 自动解析

# ============================
# 定制需求（超出标准模板的组件/交互/接口需求）
# ============================
customizations:
  # <功能标识>:                    # 语义化命名，如 dept_tree_select
  #   intent: <用户原始意图>
  #   component:
  #     type: <组件名 | "custom">  # 已有组件写组件名，自建写 "custom"
  #     props: { ... }             # 已有组件：关键 props（接口级）
  #     events: { ... }            # 已有组件：关键事件绑定（可选）
  #     spec: <功能描述+关键约束>   # 自建组件：意图+约束
  #   bindTo: <锚点>               # 列名 | 列名数组 | toolbar | form | dialog | page（可选）
  #   service:                     # null 表示纯前端
  #     endpoint: <HTTP method + path>
  #     source: <"复用 XxxService" | "new">
  #     returns: <返回数据描述>     # 可选
  #     newApi: <bool>
  #   notes: <补充说明>             # 可选

=== 基本信息 ===
表名称: sys_product    表描述: 产品表
实体类: Product        作者: ruoyi

=== 关联分析 ===
本表外键引用: (无)
被以下表引用: pm_project_approval(project_id), pm_contract(project_id)

=== 生成信息 ===
模板: 单表(crud)       前端: element-plus
包路径: com.ruoyi.system    模块: system
业务名: product             功能名: 产品管理
上级菜单: 3

=== 字段信息 ===
列名            描述      Java类型    插编列查  查询方式 必填 显示类型     字典类型
product_id      产品ID    Long        ✓---      EQ       -    -            -
product_name    产品名称  String      ✓✓✓✓      LIKE     ✓    文本框       -
product_type    产品类型  String      ✓✓✓✓      EQ       -    下拉框       (待确认)
price           价格      BigDecimal  ✓✓✓-      EQ       -    文本框       -
status          状态      String      ✓✓✓✓      EQ       -    单选框       (待确认)
create_by       创建者    String      ✓---      -        -    -            -
create_time     创建时间  Date        ✓---      -        -    -            -
update_by       更新者    String      -✓--      -        -    -            -
update_time     更新时间  Date        --✓-      -        -    -            -
remark          备注      String      ✓✓--      -        -    -            -

mvn clean package -pl ruoyi-gen-cli -am -Dmaven.test.skip=true

global:
  author: <basicInfo.functionAuthor>
  packageName: <genInfo.packageName>
  tplCategory: <genInfo.tplCategory>
  tplWebType: <genInfo.tplWebType>
  parentMenuId: <genInfo.parentMenuId>
  autoRemovePre: <根据 generator.yml>
  tablePrefix: <根据 generator.yml>

tables:
  <主表名>:
    className: <basicInfo.className>
    functionName: <genInfo.functionName>
    businessName: <genInfo.businessName>
    moduleName: <genInfo.moduleName>
    # 主子表配置（tplCategory=sub 时必须）
    subTableName: <genInfo.subTableName>
    subTableFkName: <genInfo.subTableFkName>
    columns:
      <列名>:
        columnComment: <字段描述>
        javaType: <Java类型>
        javaField: <java属性>
        isInsert: <bool>
        isEdit: <bool>
        isList: <bool>
        isQuery: <bool>
        queryType: <查询方式>
        isRequired: <bool>
        htmlType: <显示类型>
        dictType: ""

  # 如果是主子表模式，必须同时配置子表
  <子表名>:
    className: <子表实体类名>
    functionName: <子表功能名>
    businessName: <子表业务名>
    moduleName: <genInfo.moduleName>
    tplCategory: crud  # 子表必须设为 crud
    columns:
      <子表字段配置，格式同上>

java -jar ruoyi-gen-cli/target/ruoyi-gen-cli-3.9.1.jar \
  --sql=<tmp>.sql \
  --config=<tmp-config>.yml \
  --output=<tmp>.zip

java.sql.SQLException: Illegal mix of collations (utf8mb4_0900_ai_ci,IMPLICIT)
and (utf8mb4_unicode_ci,IMPLICIT) for operation '='

<!-- 错误写法 -->
left join sys_dict_data d1 on c.industry = d1.dict_value and d1.dict_type = 'industry'

<!-- 正确写法 -->
left join sys_dict_data d1 on c.industry COLLATE utf8mb4_unicode_ci = d1.dict_value and d1.dict_type = 'industry'

<select id="selectCustomerList" parameterType="Customer" resultMap="CustomerCustomerContactResult">
    select
        c.customer_id,
        c.customer_simple_name,
        d1.dict_label as industry_name,
        d2.dict_label as region_name,
        u.nick_name as sales_manager_name
    from pm_customer c
    left join sys_dict_data d1 on c.industry COLLATE utf8mb4_unicode_ci = d1.dict_value and d1.dict_type = 'industry'
    left join sys_dict_data d2 on c.region COLLATE utf8mb4_unicode_ci = d2.dict_value and d2.dict_type = 'sys_yjqy'
    left join sys_user u on c.sales_manager_id = u.user_id
    ...
</select>

=== 定制需求探查 ===

AI: 以下字段可能需要定制组件：dept_id、customer_id、project_manager。
    你有哪些定制需求？也可以补充其他字段或页面级需求。

用户: dept_id 做树形选择关联 dept 表，customer_id 做 autocomplete 关联客户表，
     project_manager 做 autocomplete 关联 manager 表

AI: dept_id 树形选择——部门是分层级的，Element Plus 有 el-tree-select。
    选择时是只能选叶子节点，还是任意层级都能选？

用户: 任意层级

AI: customer_id autocomplete——搜索匹配客户名称，提交 customer_id。
    客户数据量大概多少？几十个前端过滤就够，上千就需要后端搜索。

用户: 上万

AI: project_manager autocomplete——同样按姓名搜索。manager 数据量呢？

用户: 几十个

AI: 好的，完整定制规格如下：

customizations:
  dept_tree_select:
    intent: "部门选择，树形结构，任意层级可选"
    component:
      type: el-tree-select
      props:
        data: "部门树数据"
        checkStrictly: true
        valueKey: "id"
        renderAfterExpand: false
    bindTo: dept_id
    service:
      endpoint: "GET /system/dept/treeselect"
      source: "复用 SysDeptService，RuoYi 自带"
      newApi: false
    notes: null

  customer_autocomplete:
    intent: "客户选择，按客户名称远程模糊搜索，数据量大"
    component:
      type: el-autocomplete
      props:
        fetchSuggestions: "后端远程搜索"
        valueKey: "customerName"
        debounce: 300
        triggerOnFocus: false
    bindTo: customer_id
    service:
      endpoint: "GET /project/customer/search?name={keyword}"
      source: "复用 PmCustomerService，需新增轻量搜索接口返回 id+name"
      returns: "[{ customerId, customerName }]"
      newApi: true
    notes: "提交值为 customerId，显示值为 customerName"

  manager_autocomplete:
    intent: "项目经理选择，按姓名搜索，数据量小前端过滤"
    component:
      type: el-autocomplete
      props:
        fetchSuggestions: "前端过滤"
        valueKey: "managerName"
    bindTo: project_manager
    service:
      endpoint: "GET /project/manager/listAll"
      source: "复用 PmManagerService，需新增返回全量 id+name 的接口"
      returns: "[{ managerId, managerName }]"
      newApi: true
    notes: "页面加载时一次性获取全量数据，前端 filter 匹配"

还有其他定制需求吗？

用户: OK

AI: → 写入 docs/gen-specs/pm_project.yml，进入 5.2 改造

// 方式 1：使用封装好的 API 函数（推荐）
import { listUser } from '@/api/system/user'
listUser(queryParams).then(response => {
  // response.rows, response.total
})

// 方式 2：直接调用 request（用于自定义接口）
import request from '@/utils/request'
request({
  url: '/system/user/listByPost',
  method: 'get',
  params: { postCode: 'xsfzr' }
}).then(response => {
  // response.data
})

// ❌ 错误：不要使用 proxy.$http 或 proxy.request
// const { proxy } = getCurrentInstance()
// proxy.$http.get(...)  // 不存在
// proxy.request(...)    // 不存在