
hi平台数据库设计规范.doc
7页Hi平台数据库设计规范版本:V1.0北京中交国科物流技术发展有限公司二○一○年三月该文档版权归北京中交国科物流技术发展有限公司所有文档管理信息表关 键 字xx_详细设计提交时间yyyy-mm-dd创 建 人文档修改记录表版本修改人修改时间修改内容V1.0李旺善2010-3-19新建文档 文档审批表审核人审核时间批准人批准时间 在能力与知识结构方面,要求学生应具有扎实的专业和日语语言基础,熟练掌握日语听、说、读、写、译的基本技能;了解日本社会及日本文化等方面的基本知识,熟悉日本国情,具有一定的日本人文知识及运用这些知识与日本人进行交流的能力北京中交国科物流技术发展有限公司1引言1.1编写目的指导进行数据库设计人员进行数据库开发1.2背景为了规范应用Hi平台进行软件开发环节中的数据库设计,特编制此数据库设计说明书,来规范数据库设计此规范也使用与非Hi平台的数据库设计2实体对象命名规范根据项目实际需要,在不违反2.1-2.6规范的前提下,可自行添加、修改或删除2.1表名的命名规范表名以英文单词、单词缩写、数字及下划线组成总长度要求小于30位数据库中的表分四类:l 系统表系统运行最基础的表,如用户表、权限表、日志表等,不需要开发人员自行定义有Hi平台自动生成,如果业务需要遵循以下命名规范:² 规则:sys_+表名² 说明:规则中的“表名”,有开发人员根据业务含义自行取名,如系统日志表取名为sys_log。
l 公共表系统各个模块都要用到的、与实际业务联系紧密的表遵循以下命名规范:² 规则:com_+表名² 说明:规则中的“表名”,有开发人员根据业务含义自行取名,如系统单位表取名为com_unitl 基础表系统中的基础数据,如员工表、仓库表等具有固定数据,作为其它数据流的基础的一部分表遵守以下命名规范:² 规则:base_+表名² 说明:规则中的“表名”,有开发人员根据业务含义自行取名,如仓库表取名为base_storagel 系统子模块表系统中各个模块所涉及的、可模块之间基本独立的表,遵循以下命名规范:² 规则:模块名简写_+表名² 说明:规则中的“表名”,有开发人员根据业务含义自行取名,如设备管理表中的设备申请报废表取名为equ_reqDisused2.2表的字段命名规范由于Hi平台自动生成数据库字段与系统业务实体bean一一对应,数据库字段命名应遵循javabean命名规范2.3序列命名规范考虑到表上大多只有一个递增的编号,故所有的序列的命名遵循以下规范:² 规则:表名_+列名² 说明:如sys_user表中的序列为sys_user_id2.4视图命名规范所有的视图名以v_开头,与表的命名方式相同。
2.5存储过程命名规范所有的存储过程名为pro_过程名,存储过程与表名的命名规范相同3实体关系(E-R)图说明:根据项目实际需要决定是否绘制实体关系图4数据库表4.1数据库设计规约根据hi平台自动生成代码的特点,对数据库设计作如下规定及说明l 应用面向对象的思想,设计数据库,尽量做到具体业务与数据库表一一对应表之间有继承关系的情况需要指明继承的具体关系)l 在表字段的设计过程中,应明确字段的中英文名称、数据类型、是否需要校验、是否是必填项、是否唯一、是否属于枚举类型、及于其它表的主外键(lookup)关系,并在设计中明确标识及说明l 所有表均有creator字段,默认值为UserContextHelper.getUser()4.2数据库字段说明必填项下图中所列项目是设计表必须填写的 l 中文名:表字段的中文含义,中文名应简洁、表意明确,切不要抽象、难懂因为通过Hi平台的自动生成后,字段的中文名会成为画面显示的一部分l 字段名:命名应遵守字段的命名规范l 数据类型:根据实际情况,定义字段数据类型String类型的需要标注字段长度,例如String(10)l 校验:明确字段是否需要基本校验,包括Integer、float、邮件、、格式的格式校验,需要校验,在表格里填写:“Y”。
l 必须:字段是否是必须入力项必须入力填写:“Y”l 查询:字段是否要求在画面作为检索条件出现需要的情况,填写:“Y”l 唯一:字段是否要求唯一性,要求的情况,填写:“Y”l 枚举:字段是否为枚举类型,是的情况,填写:“Y”并在描述栏列出枚举值l Lookup:字段是否作为外键,需要关联另一张表的信息,需要的话,填写:“Y”,并在描述栏说明要lookup的表,[xxx]表示该字段对应一张枚举表,后面列出枚举值l 描述:需要对该字段特别说明的信息,在这里说明如枚举及lookup信息4.3数据库表设计实例:l Employee 员工 继承平台的HiUser表编号中文名字段名数据类型校验必填查询唯一枚举Lookup描述1IDIDintYYY主键ID2员工编号userNumString(10)YY员工编号,DDDD3籍贯nativePlaceString(20)籍贯4学历degreeIntY学历,[Degree]小学/中学/高中/大专/大本/本科以上5专业specialtyString(20)YLookup: 专业(specialty)表6入厂时间jobDateDateY入厂时间7婚姻状况marryIntY婚姻状况,[Marry]未婚 /已婚8民族folkString(10)民族9个人爱好interest String(100)个人爱好10岗位jobPositionString(50)Y岗位,多选,[JobPosition]质检员/机长11员工图片userImageString(100)员工图片,附件12状态statusintY状态[EmployeeStatus]在职/离职。
