找回密码
 立即注册

QQ登录

只需一步,快速开始

Lay.Li 悬赏达人认证 活字格认证
超级版主   /  发表于:2024-10-28 19:04  /   查看:387  /  回复:0
本帖最后由 Lay.Li 于 2024-11-5 18:09 编辑

前端
规则
  • 命名规则:基于业务,创建统一的命名规则。例如,使用"模块_功能"的命名规则创建"purchase_list"的页面名称。
  • 分类规则:根据模块功能划分相应的文件目录,以便更好的管理和维护。
  • 引用规则:建议给要引用的单元格和表格列命名,这样引用时使用单元格或者列名称,更容易理解和维护。
  • 注释规则:建议在一些重要或者复杂的命令或者单元格中添加注释,以便后续的维护。

页面布局设计
  • 在开始开发页面之前,应该要先设计页面的总体布局。布局定义了页面的大致结构(如左右,上中下,左中右等)。
  • 如果团队中有设计师,请遵循设计师设计的布局结构。
  • 如果团队中没有设计师的话,可以选择活字格中提供的页面模板作为基本布局。
  • 根据业务需求,应该事先设计好多种页面类型,比如导航菜单页面,主页,列表页面,详情页面,卡片页面等

页面样式设计

  • 建议页面给页面设置流式布局,以便最终网页可以在不同屏幕的设备中自适应,可以参考流式布局
  • 为每种页面类型定义统一的单元格样式。例如对于表单页面,对按钮,输入框,表格等都定义为"提交"的单元格样式。
  • 建议使用主题颜色和字体定义单元格样式。这样切换主题时,相应的颜色和字体会自动变化。
  • 当许多页面需要使用相同的背景图片时,建议使用主题图片。这样在修改背景图片时,只需要修改主题的背景图片,不需要单独修改每个页面的背景图片。
  • 页面拉伸模式避免选择为等比拉伸(填满宽度),因为这可能会导致性能问题。

交互逻辑
        网站的交互逻辑是指用户与网站之间交互所涉及的规则和过程。良好的交互逻辑可以提高网站的可用性、功能性、可靠性和用户满意度,网站的交互逻辑是网站设计和开发过程中至关重要的一步。
  • 命令-在活字格汇总,使用三种命令让用户处理交互逻辑。
命令类型 触发时机 备注
普通命令 根据单元格类型触发,比如按钮的点击,文本框的值变更 通常用于页面的交互逻辑,比如导航到另一个页面,弹出消息框等
模板命令 在单元格命令中调用 用于普通命令的复用
服务端命令可以在页面单元格命令,服务端命令,计划任务或者第三方程序中调用 重要或复杂的业务逻辑(如操作数据表)应在服务器命令中处理,要做好前端和后端之间的分离。
  • 公式-活字格中的公式类似于excel中的公式,用于执行计算或者操作数据的数据表达式。可以参考Excel公式
  • 校验-在用户使用应用的时候,适当的错误处理和提示是至关重要的。


  • 对输入做校验很重要,通过校验,可以防止给应用中存入不正确,不恰当或者有害的数据。根据业务需求,使用数据验证功能定义对应的校验规则
  • 对于特殊或者重要的操作,应该给予用户警告。比如删除数据时,应该提示用户是否确认操作。
  • 当用户的操作有业务逻辑的错误是,应该给予清晰和合理的错误信息。
  • 消息通知是必不可少的,尤其是对于流程审批业务。推荐使用服务端通知功能实现实时通知的需求。


服务端
服务端命令建议
  • 根据业务需求为命令,参数,返回值等创建统一的命名规则。
  • 根据业务需求,将实现同一模块业务逻辑的命令放在同一个文件夹中,以便进行高效的管理和维护。
  • 为命令,参数,返回值和其他重要的关键内容创建注释。
  • 如果服务端命令只能由其他的服务端命令/计划任务调用,那么应该设置为私有的服务端命令。
  • 构建服务端命令时应该独立于前端的数据,只处理基本的业务逻辑。




  • 在构建服务端命令/WebAPI时,应考虑到之后与第三方系统集成的可能性。
  • 设置参数的数据验证和服务端命令的调用权限
  • 在第三方系统需要调用服务端命令时,根据需要做第三方授权验证
  • 封装服务端命令的返回结果,提供标准化的返回值。
  • 使用异常捕获命令处理服务端命令内部的逻辑错误,确保可以正确的执行回滚操作,并为最终用户提供明确的错误信息。



  • 在服务端命令操作数据表数据时,使用事务命令确保数据的一致性
  • 根据业务需求选择合适的隔离级别,较低的隔离级别通常提供更好的并发性能,但可能会导致数据一致性问题,而较高的隔离级别可以提供更强的数据一致性保证,但可能会降低并发性能。
  • 合理的使用数据表操作命令,调用存储过程命令和sql命令。活字格内置的数据表操作命令使用起来比较简单方便。但是如果内置命令不能满足复杂的业务场景或性能要求,可以使用调用存储过程命令或执行SQL命令。建议由经验丰富的数据库管理人员执行此类操作。

运行维护建议
  • 使用管理控制台的监控和日志功能,监控应用的运行状态和查看应用的日志记录。
  • 对于每个发布的应用,默认情况下需启用除http请求之外所有的日志模块,http请求将记录每个http请求的日志,这些请求将包含大量日志内容。
  • 开启服务管理器中的定时备份功能,定时备份服务器中所有已发布的应用。
  • 开启设计器中的保存时备份功能,以防工程文件丢失。
  • 如果应用使用的内置数据库,活字格的备份功能也会备份内置数据库,如果使用外连数据库,请在外连数据库中开启自动备份功能。
  • 如果应用程序的附件文件路径是默认路径,活字格的备份功能可以备份附件文件。但如果将附件文件路径更改为其他文件路径,请自行备份附件文件。

0 个回复

您需要登录后才可以回帖 登录 | 立即注册
返回顶部