af-mobile-client-vue3 1.3.61 → 1.3.64

package/src/stores/modules/homeApp/README.md

@@ -1,124 +0,0 @@
-# HomeApp Store 使用说明
-
-## 概述
-`useHomeAppStore` 是一个专门用于管理首页应用列表的 Pinia store，与 `useSettingStore` 配合使用。
-
-## 特性
-- 独立管理 `homeAppList` 数据
-- 提供完整的 CRUD 操作
-- 与 setting store 自动同步数据
-- 支持类型安全的 TypeScript 接口
-
-## 基本使用
-
-### 1. 导入和使用
-```typescript
-import { useHomeAppStore } from '@/stores'
-
-const homeAppStore = useHomeAppStore()
-```
-
-### 2. 获取应用列表
-```typescript
-// 获取所有应用
-const apps = homeAppStore.getHomeAppList()
-
-// 直接访问响应式数据
-const apps = homeAppStore.homeAppList
-```
-
-### 3. 添加应用
-```typescript
-homeAppStore.addHomeApp({
-  id: 'new-app',
-  name: '新应用',
-  icon: '/icon.png',
-  url: 'https://example.com',
-  description: '应用描述'
-})
-```
-
-### 4. 更新应用
-```typescript
-homeAppStore.updateHomeApp('app-id', {
-  name: '更新后的名称',
-  description: '新的描述'
-})
-```
-
-### 5. 删除应用
-```typescript
-homeAppStore.removeHomeApp('app-id')
-```
-
-### 6. 清空列表
-```typescript
-homeAppStore.clearHomeAppList()
-```
-
-## 数据同步
-
-### 自动同步
-- 当 `useSettingStore.init()` 被调用时，`homeAppList` 会自动同步到 `useHomeAppStore`
-- 无需手动同步，数据会自动保持一致
-
-### 手动同步
-```typescript
-import { useSettingStore, useHomeAppStore } from '@/stores'
-
-const settingStore = useSettingStore()
-const homeAppStore = useHomeAppStore()
-
-// 手动同步数据
-homeAppStore.setHomeAppList(settingStore.getSetting()?.homeAppList || [])
-```
-
-## 在组件中使用
-
-### Vue 组件示例
-```vue
-<template>
-  <div class="home-apps">
-    <div 
-      v-for="app in homeAppStore.homeAppList" 
-      :key="app.id"
-      class="app-item"
-      @click="openApp(app)"
-    >
-      <img :src="app.icon" :alt="app.name" />
-      <span>{{ app.name }}</span>
-    </div>
-  </div>
-</template>
-
-<script setup lang="ts">
-import { useHomeAppStore } from '@/stores'
-
-const homeAppStore = useHomeAppStore()
-
-function openApp(app) {
-  // 处理应用点击
-  window.open(app.url, '_blank')
-}
-</script>
-```
-
-## 注意事项
-
-1. **初始化顺序**：确保先调用 `useSettingStore.init()`，再使用 `useHomeAppStore`
-2. **数据一致性**：两个 store 中的数据会自动保持同步
-3. **类型安全**：使用 TypeScript 接口确保类型安全
-4. **响应式**：所有数据都是响应式的，可以直接在模板中使用
-
-## 接口定义
-
-```typescript
-export interface HomeApp {
-  id: string          // 应用唯一标识
-  name: string        // 应用名称
-  icon: string        // 应用图标
-  url: string         // 应用链接
-  description?: string // 应用描述（可选）
-  [key: string]: any  // 其他属性
-}
-```