团队作业（三）：确定分工
电子公文传输系统团队分工
成员：王菁 史婧怡 徐艺铭 马瑞婕 邵子洁 张敦敏
日期：2022年11月5日
一. 代码规范（参考腾讯编码规范）
1.1 代码风格
1.1.1 缩进
程序块要采用缩进风格编写，缩进只使用TAB键，不能使用空格键（编辑器中请将TAB设置为4格）；方法体的开始、类的定义、以及if、for、do、while、switch、case语句中的代码都要采用缩进方式；
1.1.2 对齐
程序块的分界符左大括号"{" 和右大括号"}"都另起一行，应各独占一行并且位于同一列，同时与引用它们的语句左对齐；对齐只使用TAB键，不使用空格键；不允许把多个短语句写在一行中，即一行只写一条语句；if、for、do、while、case、switch、default等语句自占一行。
1.1.3 换行（一行的长度超过80个字符需要换行，换行规则如下）
1.在一个逗号后面断开
2.在一个操作符前面断开
3.长表达式要在低优先级操作符处划分新行
4.新行缩进2个TAB
1.1.4 间隔
1.类、方法及相对独立的程序块之间、变量说明之后必须加空行；
2.关键字之后要留空格， 象if、for、while 等关键字之后应留一个空格再跟左括号"（"， 以突出关键字；方法名与其左括号"（"之间不要留空格, 以与关键字区别；
3.二元操作符如 " ="、" +=" " >="、" <="、" +"、" *"、" %"、" &&"、" ||"、" <<" ," ^" 等的前后应当加空格；
4.一元操作符如" !"、" ~"、" ++"、" --"等前后不加空格；xiang"［ ］"、" ." 这类操作符前后不加空格；
5.for语句中的表达式应该被空格分开；
6.强制转型后应该跟一个空格。
1.2 注释
1.2.1 原则
对已经不推荐使用的类和方法需要注明@Deprecated，并说明替代的类或者方法；对于针对集合、开关的方法，要在方法注释中表明是否多线程安全。
1.2.2 字段注释
采用JavaDoc文档注释，定义为public的字段必需给出注释，在类的(静态)变量、实例变量定义之前当对其进行注释，给出该字段的描述等。
1.2.3 方法注释
采用JavaDoc文档注释，在方法定义之前当对其进行注释，包括方法的描述、输入、输出及返回值说明、抛出异常说明、参考链接等。
1.2.4 单行注释格式：//
1.2.5 多行注释格式：/……/
1.3 命名规则
1.3.1 基本规则
使用可以准确说明变量、字段、类、接口、包等完整的英文描述符；采用大小写混合，提高名字的可读性；采用该领域的术语；尽量少用缩写，但如果一定要使用，当使用公共缩写和习惯缩写等；避免使用相似或者仅在大小写上有区别的名字。
1.3.2 包命名
包名一律小写, 少用缩写和长名；采用以下规则：
[基本包].[项目名].[模块名].[子模块名]...
不得将类直接定义在基本包下，所有项目中的类、接口等都应当定义在各自的项目和模块包中。
1.3.3 类或接口命名
类或接口名是个一名词，采用大小写混合的方式，每个单词的首字母大写。尽量使你的类名简洁而富于描述。使用完整单词，避免用缩写词(除非该缩写词被更广泛使用，像URL，HTML)。
1.3.4 变量命名
采用大小写混合的方式，第一个单词的首字母小写，其后单词的首字母大写；变量名不应以下划线或美元符号开头；尽量避免单个字符的变量名，除非是一次性的临时变量。临时变量通常被取名为i，j，k，m和n，它们一般用于整型；c，d，e，它们一般用于字符型；不采用匈牙利命名法则，对不易清楚识别出该变量类型的变量应使用类型名或类型名缩写作其后缀；组件或部件变量使用其类型名或类型名缩写作其后缀；集合类型变量，例如数组和矢量，应采用复数命名或使用表示该集合的名词做后缀。
1.3.5 常量命名
全部采用大写，单词间用下划线隔开。
1.3.6 方法命名
方法名是一个动词，采用大小写混合的方式，第一个单词的首字母小写，其后单词的首字母大写；取值类可使用get前缀，设值类可使用set前缀，判断类可使用is(has)前缀。
1.4 声明
1.4.1 类或接口的声名：类、接口定义语法规范如下
**[可见性][('abstract'|'final')] [Class|Interface] class_name
[('extends'|'implements')][父类或接口名]{
//方法体
}**
1.4.2 方法声明
良好的程序设计应该尽可能减小类与类之间耦合，所遵循的经验法则是：尽量限制成员函数的可见性。如果成员函数没必要公有 (public)，就定义为保护 (protected)；没必要保护 (protected)，就定义为私有 (private)；方法定义语法规范：
**[可见性]['abstract'] [‘static’] ['final'] ['synchronized'][返回值类型] method_name(参数列表)[('throws')][异常列表]{
//方法体
}**
声明顺序：构造方法、静态公共方法、静态私有方法、公共方法、友元方法、受保护方法、私有方法、main方法；方法参数建议顺序：(被操作者，操作内容，操作标志，其他)。
1.4.3 变量声明
一行一个声明；声明局部变量的同时初始化（在变量的初始值依赖于某些先前发生的计算的特殊情况下可以不用同时初始化）；只在代码块的开始处声明变量，（一个块是指任何被包含在大括号"{"和"}"中间的代码）不要在首次用到该变量时才声明；避免声明的局部变量覆盖上一级声明的变量，即不要在内部代码块中声明相同的变量名；公共和保护的可见性应当尽量避免，所有的字段都建议置为私有，由获取和设置成员函数（Getter、Setter）访问；定义一个变量或者常量的时候，不要包含包名（类似java.security.MessageDigest digest = null），除非是两个包有相同的类名；数组声明时应当将"[]"跟在类型后，而不是字段名后；声明顺序：常量、类变量、实例变量、公有字段、受保护字段、友元字段、私有字段。
1.5 异常
1.捕捉异常的目的是为了处理它
2. 多个异常应分别捕捉并处理，避免使用一个单一的catch来处理。
1.6 习惯
- if、for、do、while等语句的执行语句部分无论多少都要加括号"{}"
- 每当一个case顺着往下执行时(因为没有break语句)，通常应在break语句的位置添加注释；
- 尽量避免在循环中构造和释放对象
- 在使用局部变量的过程，按就近原则处理。不允许定义一个局部变量，然后在很远的地方才使用；
5.相同的功能不允许复制成N份代码； - 在处理 String 的时候要尽量使用 StringBuffer 类。
二. 编码原则（参考阿里开发规范）
三. 数据库项目ER图及后端架构设计
数据库ER图：
后端架构设计图：
四. 团队分工
4.1 核心需求优先级（WBS图）
4.2 子功能分配截图
4.3 成员TODOList（燃尽图）
前端页面设计（html jsp):徐艺铭、马瑞婕、邵子洁
后端架构、数据库配置：王菁、史婧怡、张敦敏
功能测试：全体成员
五. 《需求规格说明书》初稿改进部分
5.1 开发工具的优点
1.我们使用的汇编语言是java，一般使用eclipse进行编译。
2.tomcat是一个小型轻量级的web服务器，运行时占用的系统资源小，扩展性好，用来连接数据库，实现数据库管理系统。
3.html和JSP是用来设计前端页面的，美化页面
5.2 安全性
1.对登录用户进行真实身份认证
2.在编排、传输、管理的三个过程中确保涉密文件的机密性和完整性
5.3 格式
1.电子公文系统中生成和处理的电子公文应符合GB/T 33476.3-2016、GB/T33480-2016、GB/T33477-2016相关规范的要求，使用的文件格式应符合GB/T33190-2016(简称OFD)的要求。
2.对于各种不同类型的电子公文，其文件存储尽量采用通用格式（指XML、PDF、CEB、SEP、TIFF、JPEG、TXT、RTF、DOC、WPS等），将不同电子公文的计算机格式如显示格式、存储格式等按不同类别进行存储，提高传输和查找的便捷性。
任务分工
代码规范、编码原则：徐艺铭、马瑞婕
数据库ER图：史婧怡
后端架构设计图：王菁
核心需求优先级（WBS图）：张敦敏
成员TODOlist(燃尽图）：邵子洁
本次博客主要撰写人：徐艺铭
