@zfqh/uniapp 0.2.20 → 0.2.21

package/CHANGELOG.md

@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [0.2.21](http://10.10.10.16/caoben/front-end/compare/@zfqh/uniapp@0.2.20...@zfqh/uniapp@0.2.21) (2026-06-26)
+
+**Note:** Version bump only for package @zfqh/uniapp
+
+
+
+
+
 ## [0.2.20](http://10.10.10.16/caoben/front-end/compare/@zfqh/uniapp@0.2.19...@zfqh/uniapp@0.2.20) (2026-06-25)
 
 **Note:** Version bump only for package @zfqh/uniapp

package/docs/api/apis/core.md

@@ -10,6 +10,8 @@
 | `getCosUrls` | `POST` | `/app-api/infra/cos/getUrls` | 获取 COS 签名后的地址。 |
 | `postRefreshToken` | `POST` | `/app-api/robot/store/auth/refreshToken?refreshToken=:refreshToken` | 刷新 token。 |
 | `getDictData` | `GET` | `/app-api/system/dict-data/type` | 获取字典数据。 |
+| `getAppData` | `GET` | `/admin-api/robot/authority/queryAppDetail` | 获取应用详情（未登录）。 |
+| `getAppByUser` | `GET` | `/admin-api/robot/authority/queryUserAppDetail` | 获取用户应用详情（已登录）。 |
 | `getImData` | `GET` | `/admin-api/system/im/buildApiConfig` | 获取 IM 配置（usersig、sdkappid 等）。 |
 
 ## 基本使用
@@ -174,6 +176,46 @@ const options = data.map((item) => ({
 | --- | --- |
 | `Promise<ApiResponse<DictItem[]>>` | 成功时 `data` 为字典项数组，字段以当前后端返回为准。 |
 
+### getAppData
+
+获取应用详情（未登录场景），`app` 模块的 `getAppInfo` action 在未登录时会调用。
+
+```ts
+import { getAppData } from '@zfqh/uniapp/lib/apis';
+
+const { data } = await getAppData({
+  appId: 'com.qihuangai.patient',
+});
+```
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `data.appId` | `string` | 是 | 应用 ID，从 `configs/app.appId` 获取。 |
+
+| 返回值 | 说明 |
+| --- | --- |
+| `Promise<ApiResponse<AppDetail>>` | 成功时 `data` 包含 appId、identifier、iconUrl、name、brief、configJson、perms、appType 等字段。 |
+
+### getAppByUser
+
+获取用户应用详情（已登录场景），`app` 模块的 `getAppInfo` action 在已登录时会调用。
+
+```ts
+import { getAppByUser } from '@zfqh/uniapp/lib/apis';
+
+const { data } = await getAppByUser({
+  appId: 'com.qihuangai.patient',
+});
+```
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `data.appId` | `string` | 是 | 应用 ID，从 `configs/app.appId` 获取。 |
+
+| 返回值 | 说明 |
+| --- | --- |
+| `Promise<ApiResponse<AppDetail>>` | 成功时 `data` 包含 appId、identifier、iconUrl、name、brief、configJson、perms、appType 等字段，已登录时返回用户级别权限。 |
+
 ### getImData
 
 获取 IM 配置（usersig、sdkappid 等），`im` 模块的 `getImInfo` action 内部会调用。

package/docs/api/apis/index.md

@@ -60,6 +60,8 @@ export const removeItem = (id: number) => DELETE('/app-api/demo/delete?id=:id',
 | `getCosUrls(data)` | `data: { urls: string[] }` | `Promise<ApiResponse<string[]>>` | 获取 COS 签名后的访问地址。 |
 | `postRefreshToken(data)` | `data: { refreshToken: string }` | `Promise<ApiResponse<LoginToken>>` | 刷新登录 token。 |
 | `getDictData(data)` | `data: { type: string }` | `Promise<ApiResponse<DictItem[]>>` | 按字典类型获取字典数据。 |
+| `getAppData(data)` | `data: { appId: string }` | `Promise<ApiResponse<AppDetail>>` | 获取应用详情（未登录）。 |
+| `getAppByUser(data)` | `data: { appId: string }` | `Promise<ApiResponse<AppDetail>>` | 获取用户应用详情（已登录，含用户级权限）。 |
 
 ```ts
 import {
@@ -69,6 +71,8 @@ import {
   getCosUrls,
   postRefreshToken,
   getDictData,
+  getAppData,
+  getAppByUser,
 } from '@zfqh/uniapp/lib/apis';
 
 await sendSmsCode({ phone: '13800138000' });
@@ -77,6 +81,8 @@ await getLastVersion({ version: '1.0.0', packageName: 'uni.UNI07DD08D', type: 2,
 await getCosUrls({ urls: ['/report/demo.pdf'] });
 await postRefreshToken({ refreshToken: 'refresh-token' });
 await getDictData({ type: 'group_relation' });
+await getAppData({ appId: 'com.qihuangai.patient' });
+await getAppByUser({ appId: 'com.qihuangai.patient' });
 ```
 
 更细的参数说明和单接口用法见 [request](./request.md) 与 [core](./core.md)。

package/docs/api/index.md

@@ -150,14 +150,14 @@ defineConfig({
 当前 API 聚合入口位于 `lib/apis`，由 `@zfqh/uniapp/lib/apis` 导出 `request` 和 `core`：
 
 ```ts
-import { GET, POST, PUT, DELETE, getTencentToken, getLastVersion, getDictData } from '@zfqh/uniapp/lib/apis';
+import { GET, POST, PUT, DELETE, getTencentToken, getLastVersion, getDictData, getAppData, getAppByUser } from '@zfqh/uniapp/lib/apis';
 ```
 
 也可以按文件深度引用：
 
 ```ts
 import request, { GET, POST, PUT, DELETE } from '@zfqh/uniapp/lib/apis/request';
-import { getTencentToken, getCosUrls, getDictData, sendSmsCode, postRefreshToken } from '@zfqh/uniapp/lib/apis/core';
+import { getTencentToken, getCosUrls, getDictData, getAppData, getAppByUser, sendSmsCode, postRefreshToken } from '@zfqh/uniapp/lib/apis/core';
 ```
 
 已有 API 文件：
@@ -166,7 +166,7 @@ import { getTencentToken, getCosUrls, getDictData, sendSmsCode, postRefreshToken
 | --- | --- |
 | `apis/index` | 聚合导出 `request` 和 `core`。 |
 | `apis/request` | 业务请求实例和 `GET/POST/PUT/DELETE`。 |
-| `apis/core` | 短信验证码、腾讯上传 Token、版本、COS URL、刷新 token、字典数据等公共接口。 |
+| `apis/core` | 短信验证码、腾讯上传 Token、版本、COS URL、刷新 token、字典数据、应用详情等公共接口。 |
 
 ### 内置 API 函数示例
 
@@ -176,6 +176,7 @@ import {
   getTencentToken,
   getLastVersion,
   getDictData,
+  getAppData,
   getCosUrls,
   sendSmsCode,
   postRefreshToken,
@@ -198,6 +199,12 @@ await postRefreshToken({ refreshToken: 'xxx' });
 
 // 获取 COS 签名地址
 const urls = await getCosUrls({ keys: ['avatar/1.png'] });
+
+// 获取应用详情（未登录）
+const appDetail = await getAppData({ appId: 'com.qihuangai.patient' });
+
+// 获取用户应用详情（已登录）
+const userAppDetail = await getAppByUser({ appId: 'com.qihuangai.patient' });
 ```
 
 ### 自定义业务 API
@@ -215,11 +222,12 @@ export const getOrderList = (...args) => GET('/app-api/order/page', ...args);
 ## Modules
 
 ```ts
-import { dict, launch, login, network, system, im, location } from '@zfqh/uniapp/lib/modules';
+import { app, dict, launch, login, network, system, im, location } from '@zfqh/uniapp/lib/modules';
 ```
 
 | 模块 | 说明 |
 | --- | --- |
+| `app` | 应用详情（appId、identifier、name、perms、configJson），已登录调用 `getAppByUser`、未登录调用 `getAppData`，无需额外配置 |
 | `dict` | 字典数据（内置接口，无需额外配置） |
 | `launch` | 启动参数（id、path、query、scene 等） |
 | `login` | 登录态（token、userId、tenantId 等） |

package/docs/api/modules/app.md

@@ -0,0 +1,29 @@
+# app
+
+应用详情模块。发布路径：`@zfqh/uniapp/lib/modules/app`
+
+| 项 | 说明 |
+| --- | --- |
+| `state.info` | 应用详情，包含 appId、identifier、iconUrl、name、brief、configJson（对象）、perms、appType。 |
+| `action getAppInfo()` | 已登录时调用 `getAppByUser`，未登录时调用 `getAppData`，appId 从 `configs/app.appId` 读取。 |
+| `mutation setAppInfo(data)` | 直接赋值应用信息，自动将 configJson 字符串解析为对象，并持久化到本地缓存。 |
+
+## 基本使用
+
+注册后通过 dispatch 拉取应用详情，获取权限列表和配置信息。
+
+```ts
+// 拉取应用详情
+await store.dispatch('getAppInfo');
+
+// 读取应用信息
+const appInfo = store.state.app.info;
+console.log(appInfo.name, appInfo.identifier);
+
+// 读取权限列表
+const perms = store.state.app.info.perms;
+// [{ menuId: 2659, menuName: '导出客户', channel: 1, isSelect: true }]
+
+// 读取解析后的 configJson（对象）
+const config = store.state.app.info.configJson;
+```

package/docs/api/modules/index.md

@@ -10,7 +10,7 @@
 
 ```ts
 import { createStore } from 'vuex';
-import { app, dict, im, system } from '@zfqh/uniapp/lib/modules';
+import { app, dict, im, system, location } from '@zfqh/uniapp/lib/modules';
 import login from './modules/login';
 import setting from './modules/setting';
 
@@ -30,6 +30,7 @@ export default store;
 
 关键点：
 
+- `app` 模块已内置 `getAppData` / `getAppByUser` 接口，注册后调用 `dispatch('getAppInfo')` 即可拉取应用详情（已登录时自动使用 `getAppByUser`），无需额外配置。
 - `dict` 模块已内置字典接口（`getDictData`），无需额外配置。
 - `im` 模块已内置 `getImData` 接口，业务方调用 `dispatch('getImInfo', { username, userType })` 即可，无需额外配置。
 - `system` 模块无需额外配置，注册后即可通过 `store.state.system.info` 读取系统信息。

package/docs/api/utils/storage.md

@@ -38,30 +38,31 @@ setStorageSync('login', { accessToken: 'xxx' });
 // 实际存储 key: 'ZFQH_LOGIN'
 ```
 
-## storageKeys 内置常量
+## TYPES.STORAGE 内置常量
 
 ```ts
-import { storageKeys } from '@zfqh/uniapp';
+import { TYPES } from '@zfqh/uniapp';
 ```
 
 | 属性 | 值 | 用途 |
 | --- | --- | --- |
-| `query` | `'query'` | URL query 参数缓存 |
-| `login` | `'login'` | 登录信息（accessToken、userId 等） |
-| `user` | `'user'` | 用户信息 |
-| `open` | `'open'` | 第三方开放平台信息 |
-| `launch` | `'launch'` | 启动参数 |
-| `location` | `'location'` | 定位信息 |
+| `TYPES.STORAGE.APP` | `'app'` | 应用详情（appId、name、perms、configJson 等） |
+| `TYPES.STORAGE.QUERY` | `'query'` | URL query 参数缓存 |
+| `TYPES.STORAGE.LOGIN` | `'login'` | 登录信息（accessToken、userId 等） |
+| `TYPES.STORAGE.USER` | `'user'` | 用户信息 |
+| `TYPES.STORAGE.OPEN` | `'open'` | 第三方开放平台信息 |
+| `TYPES.STORAGE.LAUNCH` | `'launch'` | 启动参数 |
+| `TYPES.STORAGE.LOCATION` | `'location'` | 定位信息 |
 
 ```ts
 // 保存登录信息
-setStorageSync(storageKeys.login, { accessToken: 'xxx', userId: 1, tenantId: 1 });
+setStorageSync(TYPES.STORAGE.LOGIN, { accessToken: 'xxx', userId: 1, tenantId: 1 });
 
 // 读取登录信息
-const loginInfo = getStorageSync(storageKeys.login);
+const loginInfo = getStorageSync(TYPES.STORAGE.LOGIN);
 
 // 删除缓存
-removeStorageSync(storageKeys.login);
+removeStorageSync(TYPES.STORAGE.LOGIN);
 ```
 
 ## 完整工作流
@@ -108,23 +109,6 @@ clearStorageSync();
 await clearStorage();
 ```
 
-### 自定义 storageKeys
-
-如果项目需要额外的缓存 key，可以用 `setStorageKeys` 扩展：
-
-```ts
-import { setStorageKeys, setStorageSync, getStorageSync } from '@zfqh/uniapp';
-
-const myKeys = setStorageKeys({
-  constitution: '',
-  medicalRecord: '',
-  cartData: '',
-});
-
-setStorageSync(myKeys.constitution, { type: '气虚', score: 85 });
-const data = getStorageSync(myKeys.constitution);
-```
-
 ## API
 
 发布路径：`@zfqh/uniapp/lib/utils/storage`
@@ -139,7 +123,4 @@ const data = getStorageSync(myKeys.constitution);
 | `removeStorage` | `export function removeStorage(name: string) {` | 按命名空间 key 异步删除缓存。 |
 | `clearStorageSync` | `export function clearStorageSync() {` | 同步清空全部本地缓存。 |
 | `clearStorage` | `export function clearStorage() {` | 异步清空全部本地缓存。 |
-| `setStorageKeys` | `export function setStorageKeys<T>(data: T) {` | 把对象每个字段值设置为字段名，用于生成稳定 storageKeys。 |
-| `StorageKeys` | `export interface StorageKeys {` | 内置缓存 key 类型，包含 query、login、user、open、launch、location。 |
-| `storageKeys` | `export const storageKeys: StorageKeys = setStorageKeys({` | 内置缓存 key 常量。 |
 

package/lib/apis/core.d.ts

@@ -12,3 +12,7 @@ export declare const postRefreshToken: (...args: any[]) => any;
 export declare const getDictData: (...args: any[]) => any;
 /** 获取 IM 配置（IM userSig、SDKAppID 等） */
 export declare const getImData: (...args: any[]) => any;
+/** 获取应用详情 */
+export declare const getAppData: (...args: any[]) => any;
+/** 获取用户应用详情 */
+export declare const getAppByUser: (...args: any[]) => any;

package/lib/apis/core.js

@@ -13,3 +13,7 @@ export const postRefreshToken = (...args) => POST('/app-api/robot/store/auth/ref
 export const getDictData = (...args) => GET('/app-api/system/dict-data/type', ...args);
 /** 获取 IM 配置（IM userSig、SDKAppID 等） */
 export const getImData = (...args) => GET('/admin-api/system/im/buildApiConfig', ...args);
+/** 获取应用详情 */
+export const getAppData = (...args) => GET('/admin-api/robot/authority/queryAppDetail', ...args);
+/** 获取用户应用详情 */
+export const getAppByUser = (...args) => GET('/admin-api/robot/authority/queryUserAppDetail', ...args);

package/lib/modules/app.d.ts

@@ -0,0 +1,5 @@
+import type { StoreOptions } from 'vuex';
+interface VuexStoreOptions extends StoreOptions<any> {
+}
+declare const store: VuexStoreOptions;
+export default store;

package/lib/modules/app.js

@@ -0,0 +1,52 @@
+import { getStorageSync, setStorage } from '../utils/storage';
+import { TYPES } from '../utils/consts';
+import { getAppData, getAppByUser } from '../apis/core';
+import app from '../configs/app';
+function getDefaultState() {
+    return {
+        appId: '',
+        identifier: '',
+        iconUrl: '',
+        name: '',
+        brief: '',
+        configJson: {},
+        perms: [],
+        appType: 0,
+    };
+}
+const store = {
+    state() {
+        return {
+            info: getStorageSync(TYPES.STORAGE.APP) || getDefaultState(),
+        };
+    },
+    mutations: {
+        setAppInfo(state, data) {
+            const info = data || {};
+            try {
+                if (typeof info.configJson === 'string') {
+                    info.configJson = JSON.parse(info.configJson || '{}');
+                }
+            }
+            catch (e) {
+                info.configJson = {};
+            }
+            state.info = info;
+            setStorage(TYPES.STORAGE.APP, state.info);
+        },
+    },
+    actions: {
+        async getAppInfo({ commit, rootGetters }) {
+            try {
+                const appId = app.appId;
+                if (!appId)
+                    return;
+                const request = rootGetters.isLogin ? getAppByUser : getAppData;
+                const { data } = await request({ appId }, { custom: { message: false } });
+                commit('setAppInfo', data);
+            }
+            catch (e) { }
+        },
+    },
+};
+export default store;

package/lib/modules/index.d.ts

@@ -1,3 +1,4 @@
+export { default as app } from './app';
 export { default as dict } from './dict';
 export { default as launch } from './launch';
 export { default as login } from './login';

package/lib/modules/index.js

@@ -1,3 +1,4 @@
+export { default as app } from './app';
 export { default as dict } from './dict';
 export { default as launch } from './launch';
 export { default as login } from './login';

package/lib/modules/launch.js

@@ -1,4 +1,5 @@
-import { getStorageSync, setStorage, storageKeys } from '../utils/storage';
+import { getStorageSync, setStorage } from '../utils/storage';
+import { TYPES } from '../utils/consts';
 function getDefaultState() {
     return {
         info: {
@@ -8,7 +9,7 @@ function getDefaultState() {
             referrerInfo: {},
             scene: 0,
         },
-        key: getStorageSync(storageKeys.launch) || 0,
+        key: getStorageSync(TYPES.STORAGE.LAUNCH) || 0,
     };
 }
 const store = {
@@ -25,7 +26,7 @@ const store = {
             Object.assign(state.info, data, { scene, path });
         },
         setLaunchId(state, data) {
-            setStorage(storageKeys.launch, (state.key = data || 0));
+            setStorage(TYPES.STORAGE.LAUNCH, (state.key = data || 0));
         },
     },
 };

package/lib/modules/location.js

@@ -1,5 +1,6 @@
 import { requestPermission } from '../utils/permit';
-import { getStorageSync, setStorage, storageKeys } from '../utils/storage';
+import { getStorageSync, setStorage } from '../utils/storage';
+import { TYPES } from '../utils/consts';
 const defaultState = {
     name: '北京', // 城市名称
     address: {}, // 地址信息
@@ -8,7 +9,7 @@ const defaultState = {
 };
 function getDefaultState() {
     return {
-        info: getStorageSync(storageKeys.location) || defaultState,
+        info: getStorageSync(TYPES.STORAGE.LOCATION) || defaultState,
     };
 }
 const store = {
@@ -19,7 +20,7 @@ const store = {
                 ...state.info,
                 ...data,
             };
-            setStorage(storageKeys.location, state.info);
+            setStorage(TYPES.STORAGE.LOCATION, state.info);
         },
     },
     actions: {

package/lib/modules/login.js

@@ -1,4 +1,5 @@
-import { storageKeys, getStorageSync, setStorage, removeStorage } from '../utils/storage';
+import { getStorageSync, setStorage, removeStorage } from '../utils/storage';
+import { TYPES } from '../utils/consts';
 import query from '../utils/query';
 import navigate from '../utils/navigate';
 import Throttle from '../utils/throttle';
@@ -38,7 +39,7 @@ const store = {
             };
         }
         return {
-            info: getStorageSync(storageKeys.login) || defaultState,
+            info: getStorageSync(TYPES.STORAGE.LOGIN) || defaultState,
         };
     },
     getters: {
@@ -54,12 +55,12 @@ const store = {
             }
             state.info = { ...state.info, ...data };
             if (!_accessToken) {
-                setStorage(storageKeys.login, state.info);
+                setStorage(TYPES.STORAGE.LOGIN, state.info);
             }
         },
         resetState(state) {
             state.info = getDefaultState();
-            removeStorage(storageKeys.login);
+            removeStorage(TYPES.STORAGE.LOGIN);
         },
     },
     actions: {

package/lib/utils/consts.d.ts

@@ -47,4 +47,13 @@ export declare const TYPES: {
         readonly APP_RESTART: "APP_RESTART";
         readonly APP_INSTALL: "APP_INSTALL";
     };
+    readonly STORAGE: {
+        readonly APP: "app";
+        readonly QUERY: "query";
+        readonly LOGIN: "login";
+        readonly USER: "user";
+        readonly OPEN: "open";
+        readonly LAUNCH: "launch";
+        readonly LOCATION: "location";
+    };
 };

package/lib/utils/consts.js

@@ -70,4 +70,13 @@ export const TYPES = {
         APP_RESTART: 'APP_RESTART',
         APP_INSTALL: 'APP_INSTALL',
     },
+    STORAGE: {
+        APP: 'app',
+        QUERY: 'query',
+        LOGIN: 'login',
+        USER: 'user',
+        OPEN: 'open',
+        LAUNCH: 'launch',
+        LOCATION: 'location',
+    },
 };

package/lib/utils/storage.d.ts

@@ -38,16 +38,3 @@ export declare function clearStorageSync(): void;
  * 异步删除全部本地缓存
  */
 export declare function clearStorage(): Promise<void>;
-/**
- * 设置缓存Key
- */
-export declare function setStorageKeys<T>(data: T): T;
-export interface StorageKeys {
-    query: string;
-    login: string;
-    user: string;
-    open: string;
-    launch: string;
-    location: string;
-}
-export declare const storageKeys: StorageKeys;

package/lib/utils/storage.js

@@ -126,20 +126,3 @@ export function clearStorage() {
         }
     });
 }
-/**
- * 设置缓存Key
- */
-export function setStorageKeys(data) {
-    Object.keys(data).forEach((key) => {
-        data[key] = key;
-    });
-    return data;
-}
-export const storageKeys = setStorageKeys({
-    query: '',
-    login: '',
-    user: '',
-    open: '',
-    launch: '',
-    location: '',
-});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zfqh/uniapp",
-  "version": "0.2.20",
+  "version": "0.2.21",
   "description": "uniapp公共模块",
   "author": "yinjiazeng@163.com",
   "license": "MIT",
@@ -46,5 +46,5 @@
     "@types/qs": "^6.9.16",
     "@types/url-parse": "^1.4.11"
   },
-  "gitHead": "795623145cc7dc0f0f9f7a1970a7a020b7bef16c"
+  "gitHead": "d86be29025a2dd89701bda61dc8f654467771c43"
 }