一个导航页🗺

当前大部分导航页类开源项目的可定制度都不高，个人想要关注的信息又过于分散，因此决定自己写一个可以由用户高度定制的导航页，并整合自己所需要的信息和功能。
前端使用Vue.js，后端使用Python，MariaDB+Redis提供数据存储。前端框架使用Element UI，后端框架使用Flask，后端ORM使用Peewee。
🐞 如果有任何BUG/需求/建议，欢迎提Issues！
⭐ 欢迎star！尽量保证每天都有提交！

功能

多用户登录
搜索引擎（仅为入口，支持配置多搜索引擎）
灵活方便的异步脚本统一驱动和管理平台
接口层级的权限控制（用户、角色、权限的新增与关联）
网盘和图床（支持生成链接分享）
易于操作的小组件编辑器
小组件-天气（未登录用户识别ip位置，登录后用户还可以添加自定义位置，支持天气异常时推送微信或发送邮件）
小组件-书签
小组件-AppStore价格监控（支持设置触发阈值后推送微信或发送邮件）
小组件-黄金价格（支持设置触发阈值后推送微信或发送邮件）
小组件-便签（支持定时发送便签内容到微信或邮箱）
小组件-翻译
小组件-必应壁纸
小组件-股票（支持设置触发阈值后推送微信或发送邮件）
小组件-基金（支持设置触发阈值后推送微信或发送邮件）
小组件-新闻

特性

简介优雅的展示方式：没有广告、没有信息流、只有你需要的功能和信息
灵活的组件配置：用不到某个组件？不满意默认的排序方式？使用组件编辑器轻松组织你的主页组件！
组件内容随心定制：几乎所有的组件都可以自由修改内容，显示的天气、展示的书签、关注的App Store应用、跟踪的股票或基金、黄金价格提醒的阈值...统统可以自由修改！
功能丰富的后端：当前类似的导航页项目大部分都仅有前端，或只有负责爬取数据的后端，本项目有功能丰富的后端，数据均会被保存在库中，相对于无前端可以实现更多的功能，With great backend comes great ability!

部署

dev分支为开发中分支，运行可能会有问题，建议使用master分支进行部署测试
首先需要本地安装MySQL（测试时使用的是MariaDB）和Redis
申请SeverChan的key用于推送提醒到微信；和风天气的key用于获取天气信息；默认发送邮箱和口令，参考QQ邮箱的口令获取方式
在具备环境后，使用python3运行根目录下的start.py并根据提示进行操作

代码结构

目录	内容
/backend	后端代码
/backend/run.py	后端入口文件
/frontend	前端代码
/dist	前端编译的产物
/upload	存储用户上传的文件
/wallpapers	存储爬取的必应壁纸

介绍

搜索

入口：主页

功能：输入内容后跳转到搜索网址，进入页面焦点自动置于搜索框内，输入文字可以带出提示（使用的百度的接口）增加引擎的话是在数据库中增加数据(search_engines)

控制台

入口：登陆后左上角hover用户名-控制台

功能：提供在console表中注册的前端组件入口，方便日后权限控制或进行排序等操作，如需增加前端模块，除了编写前端业务外，还需要在console表中增加一条记录

控制台-脚本运行平台

入口： 登陆后左上角hover用户名-控制台-脚本运行平台。

功能： 用于后台程序的统一驱动。前端表单均由配置产生，无需接触前端代码，通过填写配置生成的表单来提交脚本至后端运行脚本，并展示运行结果，而且具有定时运行脚本、对以前运行的任务进行回放、记录运行耗时、记录运行日志、定制运行记录表格等人性化功能

注意：

为了使作为html展示的运行结果正确展示空格数量，输出的所有空格都会被替换为" "，如果需要在输出中真正输出空格，则脚本输出的空格必须使用"# "来代替空格，如：自己组装html标签并增加样式的时候，标签中就必须有空格，所以需要使用"<table# border="1">"代替"<table border="1">"
定时任务需要配置"\backend\app\script\schedule_monitor.sh"为定时运行，因为系统默认可以配置的最短的定时运行间隔为五分钟，所以此定时任务的运行步长最好设置为五分钟

模块：

首页：左侧为脚本所属栏目，右侧为栏目下的脚本，一个脚本为一个tab，通过右上角的"+"可以增加所选栏目的脚本
按钮区域：右上角的五个按钮依次为：回放我上一次运行的参数（回填到表单中）、展示我上一次运行的日志、展示最近50条运行记录、配置定时运行、编辑脚本和删除按钮（此系统中所有删除和更新操作都为逻辑删除）
定时任务：最小颗粒度为五分钟，实际上更小也可以，但是没有试过，如果调小颗粒度，则需要减小定时任务扫库脚本的运行步长。定时任务驱动的脚本，在列表中会在运行人后方加上"(定时)"字样

运行列表：默认展示运行人、操作、运行开始时间、耗时、运行ID五列，其中操作列包含两个按钮：日志和回放。"日志"按钮点击可以展示日志，"回放"按钮悬浮可以展示参数，点击可以将所选运行记录的参数回填至当前表单上。运行列表可以通过配置组件的"是否在列表展示"选项来自定义列，但不建议设置过多。

编辑脚本：

初始选项：
- 脚本名称：展示在tab上
- 起始文件夹：配置在此处的文件夹会使用cd命令打开
- 起始脚本：配置在此处的脚本会作为初始命令
- 组合方式：提供两种组合方式-"顺序"和"替换"："顺序"将起始脚本和参数顺序组合提交；"替换"则类似Jenkins的处理方式，如，当配置为"python3 %参数%"的时候，系统会将"%参数%"替换为"参数"组件内填写或选择的值，当"参数"填写为"Awesome.py"的时候，最终生成的命令将是"python3 Awesome.py"
组件选项：
- 组件名称：前端展示的label
- 组件类型：提供四种类型-输入框、选择器、日期选择器和日期范围选择器，根据用户配置展示为相应的组件
- 默认值：组件默认值
- 是否只读：前端是否只读
- 占位文字：前端展示的placeHolder
- 备注：备注将以组件后一个icon的方式展现，鼠标悬浮即可展示
- 是否有额外按钮：配置为是时，组件后方会展示一个按钮，运行按钮可以运行小型脚本，适用于动态提醒用户参数，如下方图片所示。有两种数据的展示模式，一种是脚本内直接使用print()来打印需要输出的文字；此外，通过一定的数据格式，可以选择器组件的选项进行初始化，见下方实例：
```
import json
d = {
    'code': 200,                                # 状态码，非必填，无实际作用
    'data': {
        'msg': 'hello\nworld qwe\nqewqweewqwe', # 展示的文本，非必须，会被解析为html，使用"\n"换行
        'value': '123',                         # 非必须，当传递value时，会将组件内的值替换成传回的值
        'options': [                            # 非必须，当传递options时，会将选择器组件内的选项替换成传回的选项
            {
                'label': '234',                 # 标签，用于选择器组件展示的值
                'value': '234'                  # 值，用于选择器组件选择时实际代表和传递的值
            },
        ]
    }
}
print(json.dumps(d))
```
- 是否在列表展示：配置为是时，在运行列表中会以单独一列的方式呈现运行时提交的参数，但是，如果将太多的组件都设置为"在列表展示"，会带来前端性能的影响，所以建议不要设置太多个
- 是否显示：配置为否时前端不展示

控制台-账户和权限

入口：登陆后左上角hover用户名-控制台-账户和权限

功能：使用"用户-角色-权限"模型编写的接口层级的权限控制系统，接口使用一个装饰器即可以对权限进行控制。默认用户请求接口时，请求IP必须与登录时使用的IP一致，这是一种较为严格的策略，在"/backend/app/privilege/privilege_control.py:24"可以关闭

模块：

用户设置：新增用户、禁用用户、删除用户、修改用户角色、修改用户密码
角色对应权限设置：新增角色、禁用角色、删除角色、修改角色名称、修改角色对应权限
权限设置：新增权限、禁用权限、删除权限、修改权限

控制台-小组件编辑器

入口：登陆后左上角hover用户名-控制台-修改主页组件

功能：拖拽来修改主页显示的方式。组件的父级定义为"组件集"，当有且只有一个组件集的时候，页面不展示组件集标题，仅展示它所包含的组件，当有两个及两个以上的组件集时，展示组件集及其所包含的组件

按钮：使用左右拖拽的方式来编辑组件集的顺序，使用组件集右侧圆形加号按钮来添加组件集，使用每个组件集内部的编辑按钮来修改组件集的名称，使用每个组件集内部的删除按钮来删除组件集；组件集内的组件使用上下拖拽的方式来编辑顺序，使用每个组件集内的方形加号按钮来添加组件，使用组件右侧的删除按钮来删除组件。组件详情不支持修改，可以手动改库(widget)来对其进行修改

网盘&图床

入口：登陆后左上角hover用户名-网盘/图床

网盘：

一个简易的网盘功能，并支持通过下载链接分享，文件上传不限制大小，下载不限制速度，但是大文件上传时需要多等一会直到loading结束。文件存储于根目录的upload文件夹，并建立名称为日期的子文件夹。
按钮：界面上方为上传文件按钮，可以点击并选择文件或者通过拖拽文件至浏览器来上传文件；下方文件列表的按钮有：1.下载按钮-点击会下载文件；2.分享按钮(未分享时出现)-点击后会生成分享链接，分享给其他人后，其他人粘贴至浏览器即可触发该文件的下载，分享链接经过加密和压缩，真实下载链接会被压缩为短链接，方便使用，且链接带有鉴权token，保证基本的安全性；3.复制分享链接按钮(分享后出现)-点击后复制分享链接至剪贴板；4.取消分享按钮(分享后出现)-将分享链接置为失效并取消分享；5.删除按钮-将文件逻辑删除；6.修改文件名按钮，可以对文件名进行修改

图床：

上传图片并生成链接
按钮：预览&下载、复制图片链接、删除按钮

小组件-天气

如不登录则展示IP所在地的天气信息(受限于第三方API，IP位置为国外时，支持不好)，登录后可以进行自定义，展示范围为IP+自定义位置的信息。此外，当请求数据时，为了保障速度，首先会使用缓存，缓存数据有效期为3小时（在\backend\app\weather\weather_function.py:16修改），如果没有有效缓存，则会请求外部API以获取数据并存为缓存

按钮：新增-登录后新增城市；排序-可拖动对自定义的城市进行排序或删除；推送-推送有三种异常天气可选，分别为雨雪天气、温度骤升/骤降、空气质量，且需要推送到位置和展示的位置是独立的，可以分别设置