一二三应用开发平台使用手册——系统管理-系统参数系统日志-使用说明

news2024/10/6 2:24:18

系统参数

概述

通过配置化，可以提升系统灵活性和运维便利性。
配置化往往分为两大类，一类是偏技术层面的，如平台的发送邮件提醒的邮箱，相对固化，不会频繁调整，一般放在系统的配置文件里，如springboot项目的application.yml中；另一类则偏业务层面，与业务规则有关，如密码长度，由系统管理员来维护。这类配置由系统参数功能来管理,平台提供可视化的功能菜单，通过数据库来持久化，修改实时生效。

属性

参数名称
参数编码
参数值
排序

功能项

常规功能

新增：新增单条数据。
修改：修改单条数据。
删除：删除数据，这里的删除跟上文中的设置状态停用不同，是真正的删除（逻辑删除）。对于确认录入错误的数据，尚未被单据使用，应当彻底清理掉而不是将其状态设置为停用。删除时系统会清理用户组关联的用户数据和权限项数据，避免关联表中残留垃圾对应关系数据。
查询：多条件组合，模糊匹配当前系统中的数据。
查看：查看单条数据。

扩展功能

无

界面设计

列表查询

典型的列表页面布局。
上方为查询区域，可灵活组合多种查询条件，筛选需要的数据。
下方为查询结果列表。

新建/修改/查看

这三个功能界面差不多，操作上略有差异。
新建会打开空白表单，部分属性以默认值填充。
修改则会查询数据库，填充实体属性值，在此基础上修改。
查看也是查询数据库填充实体属性，但不能保存。

系统日志

概述

日志是系统的重要组成部分，往往容易被忽视。在生产环境，出现异常进行排查的时候，日志是重要的手段甚至在很多情况下是唯一可提供有价值信息的途径。

从定位上说，日志可以分为几类：
**运行日志：**平台启动或执行关键组件初始化、功能组件、中间件的启动和警告、报错等信息。
**操作日志：**用户在系统中操作留下的记录，如访问哪个菜单，执行了哪个操作。
**审计日志：**与安全相关的日志，如用户登录系统，修改密码，锁定用户等。
**调度日志：**调度任务产生的日志，包括任务名称、执行时间、执行结果等。

日志的持久化有多种方式，运行日志，通常直接以日志文件的形式输出到磁盘；对于其他三类，操作日志、审计日志、调度日志，需要考虑系统的规模，用户的数量以及运维的便利性。在中小型系统或系统初上线阶段，可以考虑放到数据库表中，查询日志上而言，比去磁盘文件中找日志文件要便利得多，并且可以使用sql进行查询或统计。但如果系统规模很大，把日志放到数据库表中明显是不合理的，还是需要以日志文件的方式输出，但这样还不够。为了解决日志查询的问题，通常会使用ELK来实现日志的采集、存储和查询。

本平台中，运行日志是输出到磁盘的日志文件，操作日志、审计日志和调度日志是输出到数据库表中。