sohelp-eleplus 1.1.26 → 1.1.28

package/sohelp-application-select/README.md

@@ -1,15 +1,17 @@
-# 应用列表选择 (Application Select)
+# SohelpApplicationSelect 应用选择器
 
-用于展示或选择应用的组件。
+应用列表选择组件，用于选择系统中的应用。当前为占位状态，功能待实现。
 
-## 属性 (Props)
-
-该组件目前主要作为展示用途，暂无特定配置属性。
-
-## 使用示例
+## 基础用法
 
 ```vue
 <template>
   <sohelp-application-select />
 </template>
 ```
+
+## 属性 (Props)
+
+| 属性名 | 类型 | 默认值 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- | :--- |
+| - | - | - | - | 当前暂无属性，待功能实现后补充 |

package/sohelp-application-select/index.vue

@@ -1,15 +1,12 @@
-<script>
-export default {
-  name: "SohelpApplicationSelect"
-}
-</script>
-
 <template>
-<div>
-  应用列表
-</div>
+  <div class="sohelp-application-select">
+    <!-- TODO: 待实现 - 应用列表选择器 -->
+    <el-empty description="应用列表选择器 - 待实现" />
+  </div>
 </template>
-
-<style scoped>
-
-</style>
+<script setup>
+  // TODO: 待实现
+</script>
+<script>
+  export default { name: 'SohelpApplicationSelect' };
+</script>

package/sohelp-autocode/README.md

@@ -1,38 +1,26 @@
-# 自动编码组件 (Autocode)
+# SohelpAutocode 自动编码
 
-用于生成和显示自动编码的输入组件，支持从后端自动获取编码。
+基于 `sohelp-input` 封装的自动编码输入框组件，支持通过接口自动生成编码值。
 
-## 功能特性
-
-- **自动加载**：支持挂载时自动获取编码。
-- **手动刷新**：提供刷新按钮重新获取编码。
-- **后端集成**：通过 `field` 和 `refid` 调用后端接口生成编码。
-
-## 属性 (Props)
-
-| 属性名 | 类型 | 默认值 | 说明 |
-| :--- | :--- | :--- | :--- |
-| modelValue | String | - | 绑定的编码值 (v-model)。 |
-| field | String | '' | 对应后端的字段名，用于生成编码。 |
-| refid | String | '' | 对应后端的引用ID。 |
-| autoLoad | Boolean | false | 是否在组件挂载时自动加载编码 (通过 `$attrs` 传递)。 |
-| readonly | Boolean | false | 是否只读，只读状态下无法刷新编码 (通过 `$attrs` 传递)。 |
-
-## 使用示例
+## 基础用法
 
 ```vue
 <template>
-  <sohelp-autocode
-    v-model="code"
-    field="order_no"
-    refid="order_module"
-    autoLoad
-  />
+  <sohelp-autocode v-model="code" field="order_no" refid="myRefId" />
 </template>
 
 <script setup>
 import { ref } from 'vue';
-
 const code = ref('');
 </script>
 ```
+
+## 属性 (Props)
+
+| 属性名 | 类型 | 默认值 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| modelValue (v-model) | String | - | 否 | 编码值 |
+| field | String | `''` | 否 | 字段名称，用于接口查询 |
+| refid | String | `''` | 否 | 业务关联ID，用于接口查询 |
+
+> 通过 `$attrs` 还支持 `readonly`（只读时隐藏刷新按钮）和 `autoLoad`（挂载后自动获取编码）等属性。

package/sohelp-calendar-view/README.md

@@ -1,15 +1,17 @@
-# 日历视图 (Calendar View)
+# SohelpCalendarView 日历视图
 
-日历视图展示组件。
+基于 `el-empty` 的日历视图占位组件，当前功能待实现。
 
-## 属性 (Props)
-
-该组件目前主要作为展示用途，暂无特定配置属性。
-
-## 使用示例
+## 基础用法
 
 ```vue
 <template>
   <sohelp-calendar-view />
 </template>
 ```
+
+## 属性 (Props)
+
+| 属性名 | 类型 | 默认值 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- | :--- |
+| — | — | — | — | 暂无自定义属性，组件功能待实现 |

package/sohelp-calendar-view/index.vue

@@ -1,11 +1,12 @@
-<script setup>
-
-</script>
-
 <template>
-<div>日历视图</div>
+  <div class="sohelp-calendar-view">
+    <!-- TODO: 待实现 - 日历视图 -->
+    <el-empty description="日历视图 - 待实现" />
+  </div>
 </template>
-
-<style scoped lang="scss">
-
-</style>
+<script setup>
+  // TODO: 待实现
+</script>
+<script>
+  export default { name: 'SohelpCalendarView' };
+</script>

package/sohelp-card/README.md

@@ -1,22 +1,8 @@
-# 卡片容器 (Card)
+# SohelpCard 卡片容器
 
-基于 `ele-card` 封装的卡片容器组件，支持 Flex 布局。
+基于 `ele-card` 封装的卡片容器组件，默认启用 `flex-table` 布局，通过 `v-bind="$attrs"` 透传所有属性至 `ele-card`。
 
-## 属性 (Props)
-
-| 属性名 | 类型 | 默认值 | 说明 |
-| :--- | :--- | :--- | :--- |
-| flex-table | Boolean | - | 是否启用 Flex 表格布局样式 (通过 `$attrs` 传递)。 |
-
-此组件继承了 `ele-card` 的所有属性和事件。
-
-## 插槽 (Slots)
-
-| 插槽名 | 说明 |
-| :--- | :--- |
-| default | 卡片内容区域。 |
-
-## 使用示例
+## 基础用法
 
 ```vue
 <template>
@@ -25,3 +11,15 @@
   </sohelp-card>
 </template>
 ```
+
+## 属性 (Props)
+
+| 属性名 | 类型 | 默认值 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| - | - | - | - | 继承 ele-card 的所有属性，通过 $attrs 透传 |
+
+## 插槽 (Slots)
+
+| 插槽名 | 说明 |
+| --- | --- |
+| default | 卡片内容区域 |

package/sohelp-card/index.vue

@@ -3,7 +3,7 @@
 </script>
 
 <template>
-  <ele-card flex-table  v-bind="$attrs" v-on="$attrs">
+  <ele-card flex-table  v-bind="$attrs">
     <slot></slot>
   </ele-card>
 </template>

package/sohelp-card-view/README.md

@@ -1,15 +1,17 @@
-# 卡片视图 (Card View)
+# SohelpCardView 卡片视图
 
-卡片视图展示组件。
+当前版本仅为占位组件，卡片视图展示功能待实现。
 
-## 属性 (Props)
-
-该组件目前主要作为展示用途，暂无特定配置属性。
-
-## 使用示例
+## 基础用法
 
 ```vue
 <template>
   <sohelp-card-view />
 </template>
 ```
+
+## 属性 (Props)
+
+| 属性名 | 类型 | 默认值 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| - | - | - | - | 暂无属性 |

package/sohelp-card-view/index.vue

@@ -1,11 +1,12 @@
-<script setup>
-
-</script>
-
 <template>
-<div>卡片视图</div>
+  <div class="sohelp-card-view">
+    <!-- TODO: 待实现 - 卡片视图 -->
+    <el-empty description="卡片视图 - 待实现" />
+  </div>
 </template>
-
-<style scoped lang="scss">
-
-</style>
+<script setup>
+  // TODO: 待实现
+</script>
+<script>
+  export default { name: 'SohelpCardView' };
+</script>

package/sohelp-condition/README.md

@@ -1,61 +1,41 @@
-# 条件构建器 (Condition)
+# SohelpCondition 条件构造器
 
-用于构建复杂查询条件的组件，支持嵌套的“且(AND)”/“或(OR)”逻辑分组。
+递归嵌套的条件构造器组件，支持"满足所有条件"（AND）和"满足任一条件"（OR）逻辑组合，可添加子条件组和多种比较操作符。
 
-## 功能特性
-
-- **多级嵌套**：支持无限层级的条件组嵌套。
-- **逻辑运算**：支持 AND 和 OR 逻辑切换。
-- **丰富操作符**：支持等于、包含、大于、小于、为空等多种比较操作符。
-- **动态字段**：根据传入的 `fields` 动态生成可选条件字段。
-
-## 属性 (Props)
-
-| 属性名 | 类型 | 默认值 | 说明 |
-| :--- | :--- | :--- | :--- |
-| modelValue | Object | - | 绑定的条件数据对象 (v-model)。 |
-| value | Object | - | 同 `modelValue`，条件数据对象。 |
-| fields | Array | - | 可选字段列表，每项包含 `label` 和 `value` (或字段名)。 |
-| currentIndex | Number | -1 | 当前条件索引 (内部使用)。 |
-
-## 数据结构示例
-
-```javascript
-// modelValue 结构示例
-{
-  and: [
-    { label: '姓名', value: '张三', comparison: 'EQ' },
-    {
-      or: [
-        { label: '年龄', value: '18', comparison: 'GT' },
-        { label: '状态', value: '1', comparison: 'EQ' }
-      ]
-    }
-  ]
-}
-```
-
-## 使用示例
+## 基础用法
 
 ```vue
 <template>
-  <sohelp-condition
-    v-model="conditions"
-    :fields="fieldList"
-  />
+  <sohelp-condition v-model="condition" :value="condition" :fields="fields" />
 </template>
 
 <script setup>
 import { ref } from 'vue';
-
-const fieldList = [
-  { label: '用户名', value: 'username' },
-  { label: '邮箱', value: 'email' },
-  { label: '年龄', value: 'age' }
-];
-
-const conditions = ref({
-  and: []
+const fields = ref([
+  { label: '姓名', name: 'name' },
+  { label: '年龄', name: 'age' }
+]);
+const condition = ref({
+  type: 'and',
+  children: []
 });
 </script>
 ```
+
+## 属性 (Props)
+
+| 属性名 | 类型 | 默认值 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| modelValue (v-model) | Object | - | 是 | 条件数据对象 |
+| value | Object | - | 是 | 当前条件节点数据（含 `type` 和 `children`） |
+| fields | Array | - | 是 | 可选字段列表，每项含 `label` 和 `name` |
+| currentIndex | Number | `-1` | 否 | 当前条件在父级中的索引，用于删除操作 |
+
+支持的比较操作符：`LIKE`（包含）、`NOT_LIKE`（不包含）、`EQ`（等于）、`NE`（不等于）、`GT`（大于）、`LT`（小于）、`GTE`（大于等于）、`LTE`（小于等于）、`LEFT_LIKE`（左包含）、`RIGHT_LIKE`（右包含）、`EMPTY`（为空）、`NOT_EMPTY`（不为空）。
+
+## 事件 (Events)
+
+| 事件名 | 回调参数 | 说明 |
+| --- | --- | --- |
+| update:modelValue | `value: Object` | 条件变更时触发 |
+| removeCondition | `index: Number` | 请求父级移除当前条件组 |

package/sohelp-condition/index.vue

@@ -64,10 +64,11 @@
 </template>
 
 <script>
+  import { defineAsyncComponent } from 'vue';
   export default {
     name: 'SohelpCondition',
     components: {
-      SohelpCondition: import('./index.vue')
+      SohelpCondition: defineAsyncComponent(() => import('./index.vue'))
     },
     props: {
       fields: {

package/sohelp-country-select/README.md

@@ -1,69 +1,8 @@
-# 国家选择组件 (SohelpCountrySelect)
+# SohelpCountrySelect 国家选择器
 
-支持国旗、中英文名称的国家选择组件，具备丝滑的动画过渡效果。
+基于 `el-select` 封装的国家选择组件，内置国旗图标和中英文国家名称，支持搜索过滤和 v-model 双向绑定。
 
-## 特性
-
-- ✅ 支持 25 个主流国家/地区
-- ✅ 显示国旗图标 + 中文 + 英文名称
-- ✅ 支持搜索过滤
-- ✅ 可自定义显示/隐藏国旗
-- ✅ 丝滑的动画过渡效果
-- ✅ 选中状态高亮显示
-- ✅ 支持 v-model 双向绑定
-- ✅ 支持所有 el-select 原生属性和事件
-
-## 属性 (Props)
-
-| 属性名     | 类型    | 默认值 | 说明                              |
-| :--------- | :------ | :----- | :-------------------------------- |
-| modelValue | String  | ''     | 绑定值（国家代码，如 'CN', 'US'） |
-| showFlag   | Boolean | true   | 是否显示国旗                      |
-
-**其他属性**：支持通过 `v-bind` 传递所有 el-select 的原生属性，如 `placeholder`、`disabled`、`size`、`multiple` 等
-
-## 事件 (Events)
-
-| 事件名            | 说明         | 回调参数        |
-| :---------------- | :----------- | :-------------- |
-| update:modelValue | 值变化时触发 | (value: string) |
-
-**其他事件**：支持通过 `v-on` 绑定所有 el-select 的原生事件
-
-## 支持的国家
-
-| 代码 | 中文       | 英文           |
-| :--- | :--------- | :------------- |
-| US   | 美国       | United States  |
-| CN   | 中国       | China          |
-| GB   | 英国       | United Kingdom |
-| JP   | 日本       | Japan          |
-| KR   | 韩国       | South Korea    |
-| HK   | 香港       | Hong Kong      |
-| SG   | 新加坡     | Singapore      |
-| AU   | 澳大利亚   | Australia      |
-| CA   | 加拿大     | Canada         |
-| CH   | 瑞士       | Switzerland    |
-| MY   | 马来西亚   | Malaysia       |
-| TH   | 泰国       | Thailand       |
-| IN   | 印度       | India          |
-| RU   | 俄罗斯     | Russia         |
-| BR   | 巴西       | Brazil         |
-| ZA   | 南非       | South Africa   |
-| MX   | 墨西哥     | Mexico         |
-| PH   | 菲律宾     | Philippines    |
-| ID   | 印度尼西亚 | Indonesia      |
-| VN   | 越南       | Vietnam        |
-| NZ   | 新西兰     | New Zealand    |
-| TR   | 土耳其     | Turkey         |
-| PL   | 波兰       | Poland         |
-| SE   | 瑞典       | Sweden         |
-| NO   | 挪威       | Norway         |
-| DK   | 丹麦       | Denmark        |
-
-## 使用示例
-
-### 基础用法
+## 基础用法
 
 ```vue
 <template>
@@ -71,70 +10,23 @@
 </template>
 
 <script setup>
-  import { ref } from 'vue';
+import { ref } from 'vue';
 
-  const country = ref('CN');
+const country = ref('CN');
 </script>
 ```
 
-### 不显示国旗
-
-```vue
-<template>
-  <sohelp-country-select v-model="country" :show-flag="false" />
-</template>
-```
-
-### 自定义占位符
-
-```vue
-<template>
-  <sohelp-country-select v-model="country" placeholder="请选择国家" />
-</template>
-```
-
-### 禁用状态
-
-```vue
-<template>
-  <sohelp-country-select v-model="country" disabled placeholder="禁用状态" />
-</template>
-```
-
-### 不同尺寸
-
-```vue
-<template>
-  <div>
-    <sohelp-country-select v-model="country1" size="large" />
-    <sohelp-country-select v-model="country2" />
-    <sohelp-country-select v-model="country3" size="small" />
-  </div>
-</template>
-
-<script setup>
-  import { ref } from 'vue';
-
-  const country1 = ref('CN');
-  const country2 = ref('US');
-  const country3 = ref('GB');
-</script>
-```
-
-### 事件监听
+## 属性 (Props)
 
-```vue
-<template>
-  <sohelp-country-select v-model="country" @change="handleChange" />
-</template>
+| 属性名 | 类型 | 默认值 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- | :--- |
+| modelValue | String | `''` | 否 | 绑定值，国家代码（如 `'CN'`、`'US'`）（v-model） |
+| showFlag | Boolean | `true` | 否 | 是否显示国旗图标 |
 
-<script setup>
-  import { ref } from 'vue';
+> 同时支持所有 `el-select` 原生属性（如 `placeholder`、`disabled`、`size`），通过 `v-bind="$attrs"` 透传。
 
-  const country = ref('CN');
+## 事件 (Events)
 
-  const handleChange = (value) => {
-    console.log('选择的国家:', value);
-  };
-</script>
-```
+| 事件名 | 回调参数 | 说明 |
+| :--- | :--- | :--- |
+| update:modelValue | `(value: string)` | 选中国家变化时触发 |

package/sohelp-country-select/index.vue

@@ -20,7 +20,7 @@
 
 <script setup>
   import { ref, defineAsyncComponent, watch, computed } from 'vue';
-  import { FlagMap, CountryCodeToCurrency, CountryNameMap } from '@/components/sohelp-eleplus/icons/flag';
+  import { FlagMap, CountryCodeToCurrency, CountryNameMap } from '../icons/flag';
 
   // Props 定义
   const props = defineProps({