pit-docs-mcp 1.0.2

package/docs/pitBusinessUi/select-project-unit.md

@@ -0,0 +1,48 @@
+# pit-select-project-unit 项目单位选择器
+
+自动拉取当前项目的参建单位树，基于 `PitTreeSelectPlus`，支持按施工单位类型筛选。
+
+## 前置依赖
+
+- `localStorage.projectId` — 当前项目 ID
+- 后端接口：`getProjectUnit`
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| value / v-model | 已选单位 ID（逗号分隔字符串） | String | `null` |
+| multiple | 是否多选 | Boolean | `false` |
+| disabled | 是否禁用 | Boolean | `false` |
+| clearable | 是否可清空 | Boolean | `true` |
+| appendToBody | 下拉插入 body | Boolean | `true` |
+| isAll | 多选时显示全选 | Boolean | `false` |
+| isSGDW | 是否只筛选施工单位 | Boolean | `false` |
+| companyType | 按单位类型筛选（传入类型编码） | String | `null` |
+
+> 其余 `PitTreeSelectPlus` 属性通过 `v-bind="$attrs"`、`v-on="$listeners"` 透传。
+
+## Events
+
+| 事件名 | 说明 | 参数 |
+| --- | --- | --- |
+| input | 值变化（v-model） | `value` |
+| change | 值变化（同 PitTreeSelectPlus） | `value, nodeData` |
+
+## 示例
+
+```vue
+<!-- 单选所有参建单位 -->
+<pit-select-project-unit v-model="form.unitId" />
+
+<!-- 只筛选施工单位，多选 -->
+<pit-select-project-unit
+  v-model="form.unitIds"
+  multiple
+  :is-s-g-d-w="true" />
+
+<!-- 按类型筛选 -->
+<pit-select-project-unit
+  v-model="form.unitId"
+  company-type="01" />
+```

package/docs/pitBusinessUi/select-section-tree.md

@@ -0,0 +1,45 @@
+# pit-select-section-tree 标段树选择器
+
+与 `PitSelectSection` 功能相同，区别在于数据以树形结构呈现（保留父子层级），而非平铺列表，节点键为 `bidId`。
+
+## 前置依赖
+
+同 `PitSelectSection`（`localStorage.projectId`，标段列表接口）
+
+## Props
+
+`PitSelectSection` 全部 Props 均适用，参数基本一致：
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| value / v-model | 已选标段 ID（逗号分隔字符串） | String | `null` |
+| multiple | 是否多选 | Boolean | `false` |
+| disabled | 是否禁用 | Boolean | `false` |
+| clearable | 是否可清空 | Boolean | `true` |
+| flat | 是否平级模式 | Boolean | `false` |
+| isAll | 显示全选 | Boolean | `false` |
+| appendToBody | 插入 body | Boolean | `true` |
+| bidCategory | 标段分类筛选 | String | — |
+| isJL | 只查监理标段 | Boolean | — |
+| isSelectedFirstVal | 自动选中第一个 | Boolean | `false` |
+| callback | 选中回调 | Function | `() => {}` |
+
+## 与 PitSelectSection 的区别
+
+| 特性 | PitSelectSection | PitSelectSectionTree |
+| --- | --- | --- |
+| 数据接口 | `getBidList`（列表） | `getBidTreeAll`（树形） |
+| 节点键字段 | 由 API 决定 | `bidId` |
+| 父子层级 | 无 | 保留树结构 |
+
+## 示例
+
+```vue
+<pit-select-section-tree v-model="form.bidId" />
+
+<pit-select-section-tree
+  v-model="form.bidIds"
+  multiple
+  is-all
+  :flat="true" />
+```

package/docs/pitBusinessUi/select-section.md

@@ -0,0 +1,66 @@
+# pit-select-section 标段选择器
+
+自动从项目 API 加载标段树数据的树形下拉组件，基于 `PitTreeSelectPlus`，展示字段优先使用 `bidShortName`（短名称），其次 `bidName`。
+
+## 前置依赖
+
+- `localStorage.projectId` — 当前项目 ID（组件初始化时自动读取）
+- 后端接口：`/api/project/pj-bid-entity/getBidList` 或 `getBidTreeAll`
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| value / v-model | 已选标段 ID（逗号分隔字符串） | String | `null` |
+| multiple | 是否多选 | Boolean | `false` |
+| disabled | 是否禁用 | Boolean | `false` |
+| clearable | 是否可清空 | Boolean | `true` |
+| flat | 是否启用平级模式 | Boolean | `false` |
+| isAll | 多选时显示全选 | Boolean | `false` |
+| appendToBody | 下拉面板插入 body | Boolean | `true` |
+| bidCategory | 标段分类筛选 | String | — |
+| isJL | 是否只查询监理标段 | Boolean | — |
+| isSelectedFirstVal | 初始化时是否自动选中第一个 | Boolean | `false` |
+| callback | 选中后回调函数 | Function | `() => {}` |
+
+## Events
+
+| 事件名 | 说明 | 参数 |
+| --- | --- | --- |
+| input | 值变化（v-model） | `value` |
+| change | 值变化 | `value, nodeData` |
+
+## 示例
+
+### 单选
+
+```vue
+<pit-select-section v-model="form.bidId" />
+```
+
+### 多选，按监理标段筛选
+
+```vue
+<pit-select-section
+  v-model="form.bidIds"
+  multiple
+  :is-j-l="true"
+  is-all />
+```
+
+### 选中后触发回调
+
+```vue
+<pit-select-section
+  v-model="form.bidId"
+  :callback="onBidChange" />
+
+<script>
+methods: {
+  onBidChange(value) {
+    // 根据标段 ID 联动加载其他数据
+    this.loadContracts(value)
+  }
+}
+</script>
+```

package/docs/pitBusinessUi/select-string.md

@@ -0,0 +1,60 @@
+# pit-select-string 多值字符串下拉
+
+封装 `el-select`，将多选值自动在 `String`（逗号分隔）和 `Array` 之间相互转换，让调用方无需手动处理格式。
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| value / v-model | 绑定值（英文逗号分隔的字符串） | String | — |
+
+> 其余 `el-select` 属性通过 `v-bind="$attrs"` 透传（如 `placeholder`、`disabled`、`filterable` 等）。
+
+## 内置特性
+
+- `multiple`、`clearable`、`filterable` 已默认开启。
+- `value` 字符串 → 内部拆分为数组；内部选中数组 → emit 为逗号拼接字符串。
+
+## Events
+
+| 事件名 | 说明 | 参数 |
+| --- | --- | --- |
+| input | 值变化（v-model） | `String`（逗号分隔） |
+| change | 值变化 | `String`（逗号分隔） |
+
+## Slots
+
+| 插槽名 | 说明 |
+| --- | --- |
+| default | 放置 `el-option` 列表 |
+
+## 示例
+
+### 基础用法
+
+```vue
+<pit-select-string v-model="form.roleIds" placeholder="请选择角色">
+  <el-option
+    v-for="item in roleList"
+    :key="item.id"
+    :label="item.roleName"
+    :value="item.id" />
+</pit-select-string>
+```
+
+### 结合字典数据
+
+```vue
+<pit-select-string v-model="form.tagIds">
+  <el-option
+    v-for="tag in tags"
+    :key="tag.value"
+    :label="tag.label"
+    :value="tag.value" />
+</pit-select-string>
+```
+
+## 注意事项
+
+- `value` 为空字符串 `""` 时，组件内部会过滤后得到空数组，不会出现空 option 项。
+- 分隔符固定为英文逗号 `,`，不可配置。

package/docs/pitBusinessUi/select-system-unit.md

@@ -0,0 +1,41 @@
+# pit-select-system-unit 系统单位选择器
+
+自动拉取系统（全局）关联单位列表（非项目级），基于 `el-select`，单选，显示字段为 `fullName`，绑定值为 `id`。
+
+## 前置依赖
+
+- 后端接口：`getAllRelationList`（`/api/project/pj-project-info/getAllRelationList`）
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| value / v-model | 已选单位 ID | String | `""` |
+| placeholder | 占位文字 | String | 国际化默认值 |
+| disabled | 是否禁用 | Boolean | `false` |
+| clearable | 是否可清空 | Boolean | `true` |
+| filterable | 是否可搜索 | Boolean | `true` |
+| callback | 选中回调 `(value) => void` | Function | `() => {}` |
+
+## Events
+
+| 事件名 | 说明 | 参数 |
+| --- | --- | --- |
+| input | 值变化（v-model） | `String`（单位 ID） |
+
+## 示例
+
+```vue
+<pit-select-system-unit v-model="form.companyId" />
+
+<pit-select-system-unit
+  v-model="form.companyId"
+  :callback="onUnitChange" />
+```
+
+## 与 PitSelectProjectUnit 的区别
+
+| 组件 | 数据范围 | 多选 | 树形 |
+| --- | --- | --- | --- |
+| PitSelectProjectUnit | 当前项目参建单位 | ✅ | ✅ |
+| PitSelectSystemUnit | 系统所有关联单位 | ❌ | ❌ |

package/docs/pitBusinessUi/select-user-by-role.md

@@ -0,0 +1,51 @@
+# pit-select-user-by-role 按角色选用户
+
+根据流程节点角色自动拉取可选用户列表，基于 `el-select` 多选，绑定值为用户 ID 数组。
+
+## 前置依赖
+
+- 后端接口：`getUserListByRole`、`getUserListByRoleNextUsers`（`/api/bpm/deployment/...`）
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| value / v-model | 已选用户 ID 数组 | Array | `[]` |
+| placeholder | 占位文字 | String | 国际化"请选择下一审批人" |
+| clearable | 是否可清空 | Boolean | `true` |
+| disabled | 是否禁用 | Boolean | `false` |
+| filterable | 是否可搜索 | Boolean | `true` |
+| isFirstNode | 是否为发起节点（影响调用接口） | Boolean | `false` |
+| interfaceParams | 调用接口的额外参数对象 | Object | `null` |
+| nextNodeRole | 下一节点角色编码（`isFirstNode=true` 时使用） | String | `""` |
+
+## Events
+
+| 事件名 | 说明 | 参数 |
+| --- | --- | --- |
+| input | 值变化（v-model） | `Array`（用户 ID 数组） |
+| change | 值变化 | `Array` |
+
+## 示例
+
+### 基础（非发起节点）
+
+```vue
+<pit-select-user-by-role
+  v-model="form.nextApproverIds"
+  :interface-params="{ roleId: currentRoleId }" />
+```
+
+### 发起节点（第一个审批环节）
+
+```vue
+<pit-select-user-by-role
+  v-model="form.nextApproverIds"
+  :is-first-node="true"
+  next-node-role="APPROVE_ROLE_CODE" />
+```
+
+## 注意事项
+
+- 组件挂载（`mounted`）时自动请求用户列表，切换参数后需通过外部 key 触发重渲染，或监听参数变化后手动调用 refresh。
+- 绑定值为 **ID 数组**（非逗号字符串），与其他 Select 类组件不同，注意区分。

package/docs/pitBusinessUi/switch.md

@@ -0,0 +1,43 @@
+# pit-switch 开关
+
+对 `el-switch` 的极简封装，统一 v-model 双向绑定。
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| value / v-model | 绑定值 | Boolean | — |
+
+> 其余 `el-switch` 属性（`active-text`、`inactive-text`、`active-color`、`disabled` 等）通过 `v-bind="$attrs"` 透传。
+
+## Events
+
+| 事件名 | 说明 | 参数 |
+| --- | --- | --- |
+| input | 值变化（v-model） | `Boolean` |
+| change | 值变化 | `Boolean` |
+
+## 示例
+
+### 基础用法
+
+```vue
+<pit-switch v-model="form.enabled" />
+```
+
+### 带文字标签与颜色
+
+```vue
+<pit-switch
+  v-model="form.enabled"
+  active-text="启用"
+  inactive-text="禁用"
+  active-color="#409EFF"
+  inactive-color="#909399" />
+```
+
+### 禁用状态
+
+```vue
+<pit-switch v-model="form.enabled" disabled />
+```

package/docs/pitBusinessUi/table-contract.md

@@ -0,0 +1,66 @@
+# pit-table-contract 合同选择器（弹窗）
+
+弹窗形式的合同选择器，通过内部表格分页查询合同列表，支持按合同名称/编号搜索，选中后返回合同 ID。
+
+## 前置依赖
+
+- `localStorage.projectId` — 当前项目 ID
+- `this.$route.meta.modelId` — 当前菜单 ID
+- 后端接口：`/api/contract/contract-base-information/getContractListByCompanyId`
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| value / v-model | 已选合同 ID | String | `""` |
+| initInnerValue | 回显用的合同名称 | String | `""` |
+| classNumber | 合同分类编号（传入时固定合同类型，不显示类型筛选器） | String | `""` |
+| currencyId | 货币 ID（传递给查询接口） | String | `""` |
+
+## Events
+
+| 事件名 | 说明 | 参数 |
+| --- | --- | --- |
+| input | 值变化（v-model） | `String`（合同 ID） |
+| change | 表格行确认选中 | `rowData`（合同完整对象） |
+
+## Methods
+
+| 方法名 | 说明 |
+| --- | --- |
+| `open()` | 手动打开弹窗 |
+
+## 示例
+
+```vue
+<el-form-item label="合同" prop="contractId">
+  <pit-input
+    v-model="form.contractName"
+    readonly
+    placeholder="请选择合同"
+    @click.native="$refs.contractSelector.open()">
+    <i slot="suffix" class="el-icon-arrow-down" />
+  </pit-input>
+  <pit-table-contract
+    ref="contractSelector"
+    v-model="form.contractId"
+    :init-inner-value="form.contractName"
+    @change="onContractSelected" />
+</el-form-item>
+
+<script>
+methods: {
+  onContractSelected(row) {
+    this.form.contractName = row.contractName
+    this.form.contractNumber = row.contractNumber
+  }
+}
+</script>
+```
+
+## 注意事项
+
+- 表格展示字段：合同名称、合同编号、合同类型、乙方名称。
+- 表格高度通过 `this.$Business.selectBidListStyle` 配置（默认 `{ height: '461px' }`）。
+- 双击行或点击"确认"均可完成选择；点击"取消"关闭弹窗不修改值。
+- `classNumber` 为空时，上方显示合同类型下拉筛选；否则隐藏该筛选项。

package/docs/pitBusinessUi/table-operation.md

@@ -0,0 +1,81 @@
+# pit-table-operation 表格行操作
+
+表格行内操作按钮组，默认包含"编辑"和"删除"，支持权限控制，提供三个插槽扩展。
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| hasEdit | 是否显示编辑按钮 | Boolean | `true` |
+| hasDel | 是否显示删除按钮 | Boolean | `true` |
+| editText | 编辑按钮文案 | String | `"编辑"` |
+| delText | 删除按钮文案 | String | `"删除"` |
+| editDisabled | 编辑按钮是否禁用 | Boolean | `false` |
+| delDisabled | 删除按钮是否禁用 | Boolean | `false` |
+| editPerCode | 编辑按钮权限标识 | String | `"btn_edit"` |
+| delPerCode | 删除按钮权限标识 | String | `"btn_remove"` |
+| isJudgePer | 是否启用权限判断 | Boolean | `false` |
+
+## Events
+
+| 事件名 | 说明 | 参数 |
+| --- | --- | --- |
+| edit | 点击编辑按钮 | — |
+| del | 点击删除按钮 | — |
+
+## Slots
+
+| 插槽名 | 说明 |
+| --- | --- |
+| left | 编辑按钮左侧扩展区 |
+| center | 编辑与删除按钮之间扩展区 |
+| default | 删除按钮右侧扩展区 |
+
+## 示例
+
+### 基础用法
+
+```vue
+<el-table-column label="操作" width="120">
+  <template slot-scope="{ row }">
+    <pit-table-operation
+      @edit="handleEdit(row)"
+      @del="handleDel(row)" />
+  </template>
+</el-table-column>
+```
+
+### 开启权限控制
+
+```vue
+<pit-table-operation
+  :is-judge-per="true"
+  edit-per-code="project:edit"
+  del-per-code="project:delete"
+  @edit="handleEdit(row)"
+  @del="handleDel(row)" />
+```
+
+### 新增自定义按钮
+
+```vue
+<pit-table-operation @edit="handleEdit(row)" @del="handleDel(row)">
+  <!-- 编辑与删除之间 -->
+  <template slot="center">
+    <el-button size="mini" type="text" @click="handleView(row)">查看</el-button>
+  </template>
+  <!-- 删除按钮右侧 -->
+  <el-button size="mini" type="text" @click="handleLog(row)">日志</el-button>
+</pit-table-operation>
+```
+
+### 仅保留删除
+
+```vue
+<pit-table-operation :has-edit="false" @del="handleDel(row)" />
+```
+
+## 注意事项
+
+- `isJudgePer` 为 `false` 时，`editPerCode`/`delPerCode` 不生效。
+- 权限判断依赖全局 `v-has` 指令，需确保已注册权限指令（通过 `Vue.use(PitBusinessUI, { store })` 注入）。

package/docs/pitBusinessUi/table.md

@@ -0,0 +1,75 @@
+# pit-table 表格
+
+对 `el-table` 的轻量封装，内置序号列、多选列自动布局，数据变化时自动触发 `doLayout`。
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| data | 表格数据 | Array | `[]` |
+| hasNO | 是否显示序号列 | Boolean | `true` |
+| hasC | 是否显示多选列 | Boolean | `false` |
+| border | 是否带边框 | Boolean | `false` |
+| height | 表格高度 | String / Number | `"100%"` |
+| columnData | 列配置（预留，暂未直接渲染） | Array | `[]` |
+
+> 其余 `el-table` 支持的属性均可通过 `v-bind="$attrs"` 透传。
+
+## Events
+
+`el-table` 所有事件均通过 `v-on="$listeners"` 透传，无额外自定义事件。
+
+## Slots
+
+| 插槽名 | 说明 |
+| --- | --- |
+| default | 放置 `el-table-column` 列配置 |
+
+## Methods
+
+| 方法名 | 说明 | 参数 |
+| --- | --- | --- |
+| doLayout | 手动触发重新布局（内部已在数据变化时自动调用） | — |
+
+## 示例
+
+### 基础用法
+
+```vue
+<template>
+  <pit-table :data="tableData">
+    <el-table-column prop="name" label="姓名" />
+    <el-table-column prop="age"  label="年龄" />
+  </pit-table>
+</template>
+
+<script>
+export default {
+  data() {
+    return {
+      tableData: [
+        { name: '张三', age: 28 },
+        { name: '李四', age: 32 }
+      ]
+    }
+  }
+}
+</script>
+```
+
+### 带多选与无序号
+
+```vue
+<pit-table :data="tableData" :has-n-o="false" :has-c="true" @selection-change="onSelect" />
+```
+
+### 固定高度 + 边框
+
+```vue
+<pit-table :data="tableData" height="400px" border />
+```
+
+## 注意事项
+
+- 内部已处理数据变化时的 `doLayout`，一般无需手动调用。
+- 更多列配置请直接使用 `el-table-column`，使用方式与官方一致。

package/docs/pitBusinessUi/tag.md

@@ -0,0 +1,86 @@
+# pit-tag 标签
+
+对 `el-tag` 的封装，支持通过键值映射对象动态确定标签类型（颜色），适用于状态标签场景。
+
+## Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| tagKey | 当前值（用于匹配 `tagObj` 中的 key） | String / Number / Boolean | `""` |
+| tagObj | 键值映射对象，key 为竖线分隔的值列表，value 为 el-tag type | Object | `{}` |
+
+> 其余 `el-tag` 属性（`size`、`effect`、`closable` 等）通过 `v-bind="$attrs"` 透传，事件通过 `v-on="$listeners"` 透传。
+
+## Slots
+
+| 插槽名 | 说明 |
+| --- | --- |
+| default | 标签显示文字 |
+
+## tagObj 格式说明
+
+```js
+// key 为竖线分隔的匹配值列表，value 为 el-tag type
+{
+  '0': 'info',          // tagKey === '0' → info（灰色）
+  '1': 'success',       // tagKey === '1' → success（绿色）
+  '2|3': 'warning',     // tagKey === '2' 或 '3' → warning（橙色）
+  '4': 'danger'         // tagKey === '4' → danger（红色）
+}
+```
+
+**el-tag type 可选值**：`''`（蓝色）、`'success'`、`'warning'`、`'danger'`、`'info'`
+
+## 示例
+
+### 基础用法（状态标签）
+
+```vue
+<template>
+  <pit-tag :tag-key="row.status" :tag-obj="statusMap">
+    {{ statusLabel }}
+  </pit-tag>
+</template>
+
+<script>
+export default {
+  data() {
+    return {
+      statusMap: {
+        '0': 'info',
+        '1': 'success',
+        '2': 'warning',
+        '3': 'danger'
+      }
+    }
+  }
+}
+</script>
+```
+
+### 在表格列中使用
+
+```vue
+<el-table-column label="状态" width="100">
+  <template slot-scope="{ row }">
+    <pit-tag :tag-key="String(row.status)" :tag-obj="statusTagMap">
+      {{ statusText[row.status] }}
+    </pit-tag>
+  </template>
+</el-table-column>
+```
+
+### 多值共用同一类型
+
+```vue
+<!-- row.type 为 'draft' 或 'pending' 时均显示 warning 样式 -->
+<pit-tag :tag-key="row.type" :tag-obj="{ 'draft|pending': 'warning', 'approved': 'success' }">
+  {{ row.typeName }}
+</pit-tag>
+```
+
+## 注意事项
+
+- `tagObj` 的 key 使用 `|` 分隔多个匹配值，可实现多值共用同一 type。
+- `tagKey` 匹配时为**字符串精确匹配**，若值为数字请手动转成字符串（`String(row.status)`）。
+- 未匹配到任何 key 时，`type` 为空字符串（默认蓝色 el-tag 样式）。