1. SaaS 数据库操作规范

1.1 命名规范

  • 现阶段 SaaS 系统拆分成 3 个独立的服务/模块,分别为基础服务模块/服务、就诊随访模块/服务、问卷模块/服务。
  • 数据库名统一命名为 saas。
  • 数据表按照服务模块使用固定模块前缀开头,对表的功能进行区分。各模块和对应的前缀如下表。各个单词之间使用下划线 _ 连接,字母全部小写,如有数字,数字不可单独出现在两个下划线之间,例如 base_user_1_plan非法的命名格式。数据表的命名请严格遵守此命名规范,如不按规范命名,则执行者有权拒绝创建表结构直到修改为合法命名规范为止
模块名 固定前缀 前缀含义
基础服务模块/服务 base base service
就诊随访模块/服务 cons consultation
问卷模块/服务 surv survey
  • 表字段命名只允许小写英文字符、数字和下划线 _ 的有限组合,数字不可单独出现在两个下划线之间,字段命名要求做到见文知义,一定要有备注说明其用途,如有更新请一定同步更新备注

1.2 优化建议和其他规范

  • 回收个人直接在数据中创建表的权限。所有的数据表结构创建都要经过会议上的讨论,且在表结构通过技术方案讨论后方能由开发者创建 Yearning 工单来创建表结构。
  • 如果表结构设计使用了软删除,且表中有业务唯一索引,要考虑软删除对唯一索引的影响可能导致的逻辑问题。(举例,如患者唯一字段身份证号加了ID,删除患者时对delete_at赋值删除时间,然后患者再次注册时的程序和业务的处理逻辑)。
  • 参考技术规范中的MySQL数据库规范。