From e5850ecfe9e4dcb1f5e8f69c0c1c83da2685f657 Mon Sep 17 00:00:00 2001 From: tianjiaxing Date: Tue, 14 Jun 2022 20:25:37 +0800 Subject: [PATCH] docs(admin): add uni-stat --- docs/uniCloud/admin.md | 195 ++++++++++++++++++++++++++++++++++------- 1 file changed, 162 insertions(+), 33 deletions(-) diff --git a/docs/uniCloud/admin.md b/docs/uniCloud/admin.md index 4f4a7b5f8..af931942a 100644 --- a/docs/uniCloud/admin.md +++ b/docs/uniCloud/admin.md @@ -41,11 +41,17 @@ uni-admin有预置功能、插件生态和数据表管理的代码生成工具 - 动态菜单的数据存储在数据库表opendb-admin-menus中，基于uni-id角色权限，在菜单管理中可以对菜单进行增删改查 - 开发模式下的 debug 功能，帮助开发者及时发现报错和搜索错误信息，可在`admin.config.js`文件中配置 -2. 扩展插件 +2. 内置 uni统计2.0 + +- uni统计2.0 是开源、全端、云端一体、更适合uni-app的统计平台，详见[统计文档](https://uniapp.dcloud.net.cn/uni-stat-v2.html) +- 无需开发，在manifest的 uni统计 中打勾并发行，在uniCloud服务空间部署uni-admin，即可查看报表，见下文介绍 +- 开发者也可以自定义打点数据、自定义展现报表 + +3. 扩展插件 - uni-admin支持插件生态，包括cms插件、banner管理插件、日志管理插件、图表示例等，详见[插件市场](https://ext.dcloud.net.cn/?cat1=7&cat2=74&orderBy=UpdatedDate) -3. 数据表管理的代码生成工具 +4. 数据表管理的代码生成工具 - 对于数据表的管理，如列表浏览、分页搜索、详情修改、新增删除，这些代码都无需自己开发。建好数据表的schema表结构，利用schema2code工具，即可自动生成该表的管理页面的代码。详见[schema2code](https://uniapp.dcloud.net.cn/uniCloud/schema?id=autocode) @@ -96,27 +102,96 @@ PC 端如下图： ### 目录结构 ```bash -├── cloudfunctions # 云函数 -├── common -│ │── uni.css # 公共样式 -│ └── uni-icons.css # icon样式 -├── components # 自定义组件 -├── js_sdk # js sdk -├── pages # 页面 -│ │── index # 首页 -│ └── login # 登录页 +├── cloudfunctions # 云函数 +├── common +│ │── uni.css # 公共样式 +│ └── uni-icons.css # icon样式 +├── components # 自定义组件 +├── js_sdk # js sdk +│ └── uni-stat +│ └── util.js # uni统计相关工具方法 +├── pages # 页面 +│ │── index # 首页 +│ │── login # 登录页 +│ │── system # 系统管理 +│ │ │── app # 应用管理 +│ │ │── menu # 菜单管理 +│ │ │── permission # 权限管理 +│ │ │── role # 角色管理 +│ │ │── tag # 标签管理 +│ │ └── user # 用户管理 +│ └── uni-stat # uni统计 +│ │── channel # 渠道（app） +│ │ │── channel.vue # 页面（下同） +│ │ └── fieldsMap.js # 字段配置（下同） +│ │── device # 设备统计 +│ │ │── activity # 渠道/场景分析 +│ │ │ │── activity.vue +│ │ │ └── fieldsMap.js +│ │ │── comparison # 平台对比 +│ │ │ │── comparison.vue +│ │ │ └── fieldsMap.js +│ │ │── overview # 今日概览 +│ │ │ │── overview.vue +│ │ │ └── fieldsMap.js +│ │ │── retention # 留存 +│ │ │ │── retention.vue +│ │ │ └── fieldsMap.js +│ │ │── stickiness # 粘性 +│ │ │ │── stickiness.vue +│ │ │ └── fieldsMap.js +│ │ └── trend # 趋势分析 +│ │ │── trend.vue +│ │ └── fieldsMap.js +│ │── error # 错误分析 +│ │ │── error.vue +│ │ └── fieldsMap.js +│ │── event # 事件分析 +│ │ │── event.vue +│ │ └── fieldsMap.js +│ │── index # 统计首页 +│ │ │── index.vue +│ │ └── fieldsMap.js +│ │── page-ent # 入口页 +│ │ │── page-ent.vue +│ │ └── fieldsMap.js +│ │── page-res # 受访页 +│ │ │── page-res.vue +│ │ └── fieldsMap.js +│ │── scene # 场景值（小程序） +│ │ │── scene.vue +│ │ └── fieldsMap.js +│ └── user # 用户统计 +│ │── activity # 渠道/场景分析 +│ │ │── activity.vue +│ │ └── fieldsMap.js +│ │── comparison # 平台对比 +│ │ │── comparison.vue +│ │ └── fieldsMap.js +│ │── overview # 今日概览 +│ │ │── overview.vue +│ │ └── fieldsMap.js +│ │── retention # 留存 +│ │ │── retention.vue +│ │ └── fieldsMap.js +│ │── stickiness # 粘性 +│ │ │── stickiness.vue +│ │ └── fieldsMap.js +│ └── trend # 趋势分析 +│ │── trend.vue +│ └── fieldsMap.js ├── static -├── store # vuex -├── windows -│ │── component # 项目中使用的组件 -│ │── leftWindow.vue # 左侧窗口（菜单栏） -│ └── topWindow.vue # 顶部窗口（导航栏） -├── admin.config.js # 系统配置（配置导航，菜单等） -├── App.vue -├── main.js -├── mainfest.json -├── pages.json -├── postcss.config.js # postcss 配置（浏览器兼容性） +├── store # vuex +├── windows +│ │── component # 项目中使用的组件 +│ │── leftWindow.vue # 左侧窗口（菜单栏） +│ └── topWindow.vue # 顶部窗口（导航栏） +├── admin.config.js # 系统配置（配置导航，菜单等） +├── App.vue +├── main.js +├── mainfest.json +├── pages.json +├── postcss.config.js # postcss 配置（浏览器兼容性） └── uni.scss ``` @@ -254,22 +329,59 @@ $menu-text-color-actived: #409eff; /* 菜单激活前景色 */ 如果想将自己开发的页面调到登录后首页，可在 page.json 调整。 -### icon 图标 +### uni统计2.0 介绍 -admin 框架内置了一套 icon 图标，在`静态功能演示-图标`菜单中，点击图标即可复制图标的 class 定义。 +uni统计2.0 是开源、全端、云端一体、更适合uni-app的统计平台，下图为概览图和简介，详见[统计文档](https://uniapp.dcloud.net.cn/uni-stat-v2.html) -选中样式后，在新建菜单页面的表单中输入样式名称。没有样式的菜单项将没有图标。 +![统计-概况页](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/28ddae77-dda6-448f-86aa-7e59bb7c4f8d.png) -当然，你也可以使用三方 icon 库。以使用 `elementUI` 的图标为例，在 `app.vue` 中导入图标库的样式文件： +**1. 全端** -```javascript - -``` +全端流量统计，一张报表可查看所有端（iOS、Android、Web 及各家小程序）的运营数据。 -在标签上使用图标的 class 名称即可：``el-icon-s-tools`` +无需在各端接不同的sdk、无需在不同报表看数据。目前市面已知唯一一个一张报表看遍业务全景的方案。 + +**2. 开源、免费、自由定制** + +无论前端采集数据的SDK、云端接收数据的云函数、云端跑批统计的云函数、展示统计结果的报表，所有这些代码全部开源。 + +前端自定义打点，后端自定义统计维度，自由定制报表，一切都可以灵活定制。 + +**3. 私有部署、数据自控** + +使用传统saas类统计产品，所有数据都上报给统计服务厂商。 + +`uni统计2.0`基于`uniCloud`实现，云函数、统计数据全部托管在开发者自己的服务空间（阿里云或腾讯云自选）中，开发者对自己的统计数据拥有完整的控制权。 + +**4. 默认功能丰富** + +- 设备统计 +- 注册用户统计（基于[uni-id](https://uniapp.dcloud.io/uniCloud/uni-id.html)） +- 页面统计 +- 新增、活跃、留存、跳出率分析 +- 渠道分析：辅助渠道推广 +- 错误统计和上报：辅助产品质量提升 +- 自定义打点、开源可扩展的报表 + +**5. 有效的错误分析** + +传统统计平台，都没有js错误统计。开发者无法了解到自己的js代码在哪些设备上会报错。 + +uni统计的错误信息更全面，包括 js前端错误和 App 原生层的崩溃。辅助开发者把应用做的更好。 + +**6. 更适合uni-app和uniCloud** + +uni统计深入uni-app和uniCloud框架底层，提供了众多其他统计平台无法提供的功能： +- uni-app全端识别，无需对接不同sdk、无需在不同报表中切换和自己累加数据 +- 自动识别uni-app路由，自动采集页面标题（基于navigationBar或uni-title组件） +- 自动捕获js错误，上报app端原生崩溃日志 +- 兼容uni-app渠道包打包体系，自动识别渠道包 +- 基于uni-id账户体系，自动出具注册用户（不是设备）的新增、活跃、留存报表 +- 兼容uniCloud [opendb规范](/uniCloud/opendb)，从服务器端统计各项数据 + +**7. 开放生态** + +uni统计的开源且基于[uni-admin](/uniCloud/admin)的插件规范提供了插件机制，会有更多插件作者提供各种丰富的统计插件（如电商统计、内容统计等）。见[插件市场](https://ext.dcloud.net.cn/?cat1=7&cat2=74&type=HotList) ### 用户-角色-权限 @@ -331,6 +443,23 @@ admin 提供了两个内置方法，方便在页面中鉴定登录用户权限 ![](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/81e38081-9507-4e00-bafd-7dab26e9a119.png) ##### 9.此时你再刷新页面即可访问用户管理的数据列表 +### icon 图标 + +admin 框架内置了一套 icon 图标，在`静态功能演示-图标`菜单中，点击图标即可复制图标的 class 定义。 + +选中样式后，在新建菜单页面的表单中输入样式名称。没有样式的菜单项将没有图标。 + +当然，你也可以使用三方 icon 库。以使用 `elementUI` 的图标为例，在 `app.vue` 中导入图标库的样式文件： + +```javascript + +``` + +在标签上使用图标的 class 名称即可：``el-icon-s-tools`` + ### 新增页面 新增页面可以自己开发页面，也可以从插件市场下载插件。页面如需添加菜单，参见上文的[菜单管理](#静态菜单和动态菜单)。 -- GitLab