阳光厨房管理系统

要求规格说明书

文档类别：说明需求分析规格

项目名称：阳光厨房管理系统

编写人员：陈梦珍、戴佳仪、徐莹、张默涵

完成日期：2022.4.26

说明软件需求规格

(IEEE830标准)

结构化需求规格说明书

a. 引言

a. 1目的

a. 2文档约定

a. 3.期待读者和阅读建议

a. 4产品的范围

a. 5参考文献

b. 综合描述

b.1产品的前景

b.2产品的功能

b.用户类和特征

b.4运行环境

b.5设计和实现的限制

b.6假设和依赖

c. 外部接口需求

c.1用户界面

c.3软件接口

c.4通信接口

d.系统特性

d.1系统需求概述

d.说明和优先级

d.3激励/响应序列

d.4功能需求

d.5系统功能图

e.其它非功能需求

e.1性能需求

e.2.安全设施要求

e.3安全性需求

e.3.1 限制用户登录

e.3.2 用户访问权限

e.3.3用户的账号信息

e.3.4基于token授权认证

e.4软件质量标准属性

e.5业务规则

e.6用户文档

f.其它需求

附录A:词汇表

附录B：分析模型

附录C:待确定问题的列表

结构化需求规格说明书

a. 引言 

a. 1目的 

阳光厨房是基于安卓操作系统、Windows、IOS等操作系统的一个将食品安全监管措施落实到实处的一个平台，旨在让厨房操作间变得公开化、透明化，让厨房通过监控系统将每一个角落展现在阳光下并被消费者和监管部门实时监督，提高广大消费者对食品安全的信任度。

a. 2文档约定 

编写文档时以字母和数字共同组成编号，只有字母的编号是大的阅读分类，分为引言、综合描述、外部接口需求、系统特性等，每一部分都有更细致的分类，在数字后面加上数字来标记。

文档第一页是目录，读者可以通过上面的索引找到自己想读的部分。

a. 3预期的读者和阅读建议 

这份软件需求规格说明是针对开发人员、项目经理、营销人员、用户、测试人员和文档的编写人员的。开发人员和测试人员应重点阅读文档的各个部分，项目经理、营销人员、用户应重点阅读综合描述，其他部分可作选择性阅读。

a. 4产品的范围 

产品在微信小程序和电脑端运行，这两个途径具有相同的功能。面对不同的用户，除了每种用户都有的基础功能，如注册、登录外，阳光平台针对不同用户有不同的界面设计。

面向消费者的界面会有评价和举报的入口，面向监管者的界面会有向商家提出警告并要求其整改的入口，面向商家则是接收消费者和监管者的信息并有回复入口。

a. 5参考文献 

【1】张海潘.软件工程导论（第六版）.北京：清华大学出版社，2013年

【2】刘俊.ATM机存取款管理系统需求分析[D] .2015年

【3】毛玉萃，邱少明.软件项目实践案例教程.北京：清华大学出版社，2014年

【4】骆斌.需求工程.北京：高等教育出版社，2015.2

b. 综合描述 

b.1产品的前景 

几年来，无论是食品生产企业还是餐饮单位，食品安全事件频频发生。面对这种禁不止的不诚信现象，光靠监管部门的监管明显不能起到很好的效果。食品生产及餐饮单位需要将关键环节透明化，让公众参与到监督环节，只有这样才能真正保障公众的食品安全。现在已经有一些阳光厨房平台投入使用，我们设计的这个平台吸收了一些经验并在其中加以创新。

b.2产品的功能 

平台最主要的功能是可以让消费者对在阳光平台注册的商家进行监督，在监督这个功能中，不同的用户会用到不同的功能。 以下是平台的主要功能。

消费者：点菜、评价、查看监控、举报。

监管者：接收举报信息、向商家发送举报信息并要求其整改。

商家：接收消费者的评价、与监管部门沟通。

b.3用户类和特征 

特定的用户类有较为注重食品安全的消费者、好奇阳光厨房平台而进来点餐的消费者、借阳光厨房这个平台宣传自己的食品的商家等。

其中，较为注重食品安全的消费者会着重观看商家的监控视频信息，并结合商家评论区的评价决定是否购买，这属于较为重要的用户类；出于好奇使用阳光厨房的消费者可能不会长期关注这个平台及其特殊的机制，属于不太重要的用户类；借阳光平台宣传食品的商家有意生产符合规定、绿色健康的食品，是好的倾向，也有利于阳光厨房平台的宣传，因此是较为重要的用户类。

b.4运行环境 

安卓操作系统、Windows、IOS等操作系统，用户可以在微信小程序和电脑端进入阳光厨房平台。 

b.5设计和实现上的限制 

设计之初先用手绘的形式设计出初步的界面形态，再在电脑或手机上以网页或小程序的形式进行呈现。

制作阳光厨房这个小程序需要用到微信Web开发者工具，在这个软件中编写相应代码来搭建小程序。

制作阳光厨房电脑界面时用到html语言，语言在vs code上编写，为达到较好的视觉效果可以使用CSS对界面进行美化。

b.6假设和依赖 

餐饮行业会因为阳光厨房变得更加规范，餐饮企业经营管理者会对加强自身的责任感，因为阳光厨房让本来不为人知的角落展现在阳光下，整个社会都可以参与到监督的行列里来。

但是在运行时，可能会遇到一些问题，例如短时间举报信息过多而无法得到及时的处理，而监控视频并不会永久保存，若超过了预定时间，会造成视频自动删除而无法取证。这个问题可以依赖于一个事先定好的时钟，每个监控视频过气前筛选涉及这个日期的举报记录并提醒监管部门优先解决。

可能会遇到的另一个问题是存在恶意举报现象。要解决这个问题可以在监管部门处理举报信息时设置一个筛选的过程，人为过滤掉没有价值的举报信息，提高有效举报信息处理的效率。但这个筛选过程同样也存在主观判断问题，因此也暂时无法得到完美的解决。

c. 外部接口需求 

c. 1用户界面 

我们设计界面的理念是简洁，清晰，方便操作。

由于阳光厨房系统面向顾客，商家，监管部门三类用户，所以设计了三种不同的用户界面。顾客用户界面运行在手机APP微信小程序上，商家以及监管部门运行在pc端上。

c. 2硬件接口

内存：512M以上

2.磁盘空间：40G以上

3.CPU：233Mhz以上

硬盘空间：1.5G以上

传感器接口：获取传感器数据

监控设备接口：获取视频资料

c.3软件接口 

操作系统：

手机端：安卓系统、ios系统

pc端：Microsoft Windows 10、Microsoft Windows 11

软件设备：VScode、IntelliJ IDEA、MySQL8.0

微信提供顾客个人信息

个体工商户管理系统提供商户信息

定位系统提供顾客位置

c.4通信接口 

Web 浏览器：0+、Chrome、Opera、Safari、Firefox及任何支持HTML5标准的浏览器。

d.系统特性

d.1系统需求概述

帮助顾客监管餐厅食物制作，监督餐厅，提高食品质量，帮助监管部门及时得到顾客反馈，举报，使得监管部门能及时的对不法餐厅做出批评，警告。

d.2说明和优先级

阳光厨房系统的主要功能

功能

概述

用户

优先级

餐厅监控

通过多方位摄像头，实时监控厨房温度、湿度、卫生等情况

客户、商家、监管部门

查看厨房信息

通过系统查看厨房的各种信息

客户、监管部门

保存违法视频到云端

通过系统将认定有违规违法行为的视频上传至云端

系统管理员

客户反馈

客户通过系统客户端对厨房情况进行反馈

客户

用户信息管理

通过管理员系统后台对用户信息进行管理规范

系统管理员

上传餐厅信息

商家通过系统将餐厅相关信息上传

商家

搜索功能

客户在客户端搜索相关餐厅信息

客户

注：优先级划分为9~1，表示优先级由高到低。

d.3激励/响应序列 

本系统主要用于以下几类用户：

商家：主要使用系统上传、更新餐厅相关信息，处理客户的反馈信息，处理监管部门的反馈消息，接受监管部门的调查、询问等。

顾客：通过系统查看餐厅监控，反馈餐厅问题，向监管部门举报餐厅违规行为

监管部门：查看餐厅监控录像，处理客户的举报信息，调查餐厅违规行为，处理违规餐厅

管理员：维护系统运行，维护用户信息，修复系统漏洞

d.4功能需求

用例示例

监管部门处理违规餐厅

使用者：监管部门

目的：督促违规餐厅整改基本事件流：

1.用户进入系统界面，用例开始

2.系统显示违规餐厅信息和，用户查看相关监控进行核对

3.用户确认后输入督促整改信息警告，系统将信息传输至餐厅对应商家处，本用例结束。

商家处理客户反馈

使用者：商家

目的：维护餐厅卫生环境

基本事件流：

用户进入系统界面，用例开始

系统通知客户反馈信息，用户进行查看

确认后对客户反馈进行回复，系统将回复传至客户处，本用例结束

客户举报

使用者：客户

目的：举报餐厅不合规行为

基本事件流：

用户进入系统界面，用例开始

用户上传相关证据和违规信息，系统进行上传

信息传至监管部门处，等待处理，本用例结束

d.5系统功能图

 e.其它非功能需求

e.1性能需求

阳光大厨房系统使用者是监管机构管理者，商家和所有开通阳光厨房账户的顾客。

阳光大厨房系统实例要面向北京市大部分人口，数据量较大，因此在数据存储方面需要较大的数据库和性能较好的服务器。

阳光厨房系统能够7×24小时运行。

阳光厨房系统用于对餐饮单位，食品安全的监督，真实性要求较高，因此设计多级权限管理系统（例如商家不能自己删除拍摄的视频，仅有监督机构能够处理）。

阳光大厨房系统借助互联网，多平台开发。用户能够在餐厅大屏幕，手机APP微信小程序以及官方网站进行数据和录像的查询。

多系统开放：IOS、WIN以及安卓系统。

商家后厨监控回放存储周期为15天，用户的对于商家的评价保存1年，用户的注册信息，除非用户修改或管理人员修改，否则永久保存。商家上传的所有信息，除非商家修改或管理人员修改，否则永久保存。用户上传的举报视频（包括用户截取的商家后厨监控片段和用户自己拍摄并进行上传的视频）以及举报信息会保存在云端2年。

在线人数方面要能满足北京市2189.3万人的1/50,约43.7万人同时在线的用户查看信息，处理业务。

数据处理能力要高于每分钟50万条数据，一天的数据量为2.4亿条，一年876亿条。

对于目前普遍的硬件配置，响应时间本软件控制在20秒以内，更新处理时间控制在5秒之内，数据的转换和传送时间在5秒以内，所有的用户查询都必须在10秒内完成，准确率要求达到99%。以上数据仅供参考，真实数据以测试结果为准。

当用户需求，如操作方式，运行环境，结果精度，数据结构与其他软件接口等发生变化时，设计的软件要适当调整，灵活性非常大。

系统应该能存储至少900亿条用户评价。

保证正常使用出现问题频率小于1次/月，如果出现问题能在24小时内及时修复。

e.2安全设施需求

无。

e.3安全性需求

e.3.1 用户登录限定

唯一标识：系统中的每位参与者都有唯一的昵称和头像，每个手机号、邮箱只能注册一个账号。

使用强密码策略：用户自定义密码，要求输入至少 8 位字符，其中要包含大写字母、小写字母、数字和特殊字符。每个用户在修改密码后，此前设定的密码不能再次设为作为此系统的登录密码。

账户管理方式：账户的产生、修改、变更、删除以及身份认证采用统一的身份认证平台来实现。允许用户在不同系统作多重登录。当参与者需要通过多种身份验证技术在不同系统作多重登录时，在不同的底层系统上使用单点登录技术作统一层。

认证失败后的处理方式设计，防止黑客暴力猜测：连续失败登录后锁定账户。账户锁定后用户可以向系统发送请求解锁的信息，系统通过向用户注册的手机或邮箱发送验证码，进行验证，经过系统验证后进行解锁。

e.3.2 用户访问权限

区分公共区域和受限区域：将站点分割为公共访问区域和受限访问区域，受限区域只能接受特定用户的访问，而且用户必须通过站点的身份验证。当未经认证的用户试图访问受限资源时，应用应自动提示用户认证。

顾客可以获得商家店面信息，菜品信息，后厨监控，商家评分，其他顾客对于该商家的评价等信息。

商家可以获得顾客的打分，评价以及评价该商家的顾客的头像，昵称。

商家可以获得其他商家店面介绍，菜品信息，后厨监控，商家评分，其他顾客对于该商家的评价等信息。

商家可以获得监管人员的警告。

监管人员可以获得商家店面介绍，菜品信息，后厨监控，商家评分，其他顾客对于该商家的评价等信息。

监管人员可以获得顾客的举报信息以及顾客的头像，昵称和对商家的评价。

e.3.3用户的账号信息

由于阳光厨房系统的客户量很大，所以在对用户账号信息的导入和交易操作要保证速度。

在用户进行操作的过程中又要保证事务的完整性。

在整个系统中，需要完整的权限控制，以防止某些人恶意地攻击系统，修改系统中的原始数据。

e.3.4基于token授权认证

身份验证基于JWT的token认证。

e.4软件质量标准属性

特征

子特征

简要描述

功能性

精确性

准确

依从性

待检测

互操作性

系统需要同顾客app，餐饮服务业网页端和监管部门网页端同步交互。

安全性

允许经过授权的用户和系统能够正常的访问相应的数据和信息，禁止

未授权的用户访问。

适合性

用户可以通过系统进行商家后厨监控画面，商家评价，食材信息的查询。

用户可以通过系统进行商家进行举报，评价。

用户可以通过系统进行商家进行警告。

可靠性

成熟性

内部设有防火墙，及时对内部错误进行隔离。

容错性

阳光厨房系统提供多种外部接口。

可恢复性

阳光厨房系统提供定时备份功能，预防出现系统

崩溃或需回滚系统状态的情况。

依从性

待检测

易用性

可理解性

用户文档语言简练，，内容应该与产品实际情况相一致，且所有文档

中的语句无歧义。

可学习性

系统需要提供用户手册以及新手指导教程，方便用户学习使用该系统。

可操作性

用户可以直接根据窗口提示进行使用，用户可以在一个窗口完成一套操作，并附

有有详细的用户操作手册。

吸引性

界面简洁明了，美丽大方，重点突出。

依从性

待检测

效率

时间行为

系统要保证系统稳定性以及响应时间不超过20s等。

资源行为

在线人数方面要能满足北京市2189.3万人的1/50,约43.7万人同时在线的用户查看信息，处理业务。

数据处理能力要高于每分钟50万条数据，一天的数据量为2.4亿条，一年876亿条。

依从性

待检测

可移植性

适应性

适应不同平台，多系统开放，IOS、WIN以及安卓系统。

可安装性

多种系统（IOS、WIN以及安卓系统）安装。

共存性

系统需要借助厨房监控系统完成厨房后厨信息的获取。

系统需要与移动应用平台完成手机端app以及网页端登录信息的获取。

可代替性

比其他同类型软件更适应用户需求，与各大平台的适应性好

依从性

待检测

可维护性

可分析性

系统能诊断软件中的缺陷,失效原因或识别待修改内部错误。

可改变性

阳光大厨房系统需要根据实际情况的发展变化， 系统自身

问题等情况定期进行系统版本更新，升级。

稳定性

阳光大厨房系统要首先保证系统稳定性，提供功能的正常运行。

可测试性

阳光大厨房系统内部修改能够及时的反映到系统功能的应用。

依从性

待检测

e.5业务规则

只有监管部门人员才能对商家监控视频进行删除操作。

除了软件管理人员，只有用户本身可以对自己的账号信息进行修改。

e.6用户文档

顾客界面：

（1）登录：用户可选择微信一键授权登录，用户昵称默认为用户微信名，用户id由系统自动生成。

（2）首页：此页面提供搜索功能，基于用户地理位置和商家、餐品评分显示推荐商家和推荐菜品；点击推荐列表中的商家和菜品可以查看详细信息；用户在上方搜索框内输入“搜索信息”后回车，下方列表即变为“包含搜索信息的结果”；点击下方导航列表可切换至“我的”界面。

（3）我的：上方显示该用户的基本数据信息，包括用户头像、昵称、ID；点击用户头像可以修改资料；下方提供列表，包括收藏商铺、收藏餐品、发出举报、发出评价、我的足迹这五个功能；点击下方导航列表可切换至“首页”界面。

（4）修改资料：点击头像旁边的上传新头像后可以更新头像；填写修改信息下的“昵称”后点击确认修改可以修改昵称。

（5）收藏商铺：列出来了该用户的所有商铺收藏信息，点击删除即可删除该条收藏信息；点击该商铺会返回该商铺的所有信息。

（6）收藏餐品：列出来了该用户的所有餐品收藏信息，点击删除即可删除该条收藏信息；点击该餐品会返回该餐品的所有信息。

（7）发出举报：列出来了该用户的所有举报信息，点击删除即可删除该条举报信息；点击该举报信息会返回该条举报信息的详情，包括举报时间、举报商铺或餐品、举报详情、举报处理结果。

（8）发出评论：列出来了该用户的所有评论信息，点击删除即可删除该条评论信息；点击该评论会返回该评论的所有信息。

（9）我的足迹：列出来了该用户的所有浏览信息，点击删除即可删除该条浏览信息；点击该浏览记录会返回该记录的所有信息。

（10）设置：点击设置可修改该系统对用户位置的访问权限、消息提醒方式、页面风格，查看系统详细信息。

（11）商铺信息：上方显示该商家的基本数据信息，包括商铺头像、商户名称、商户ID、商户地址；提供后厨直播和举报记录两个快捷键；中间列表显示该商铺的所有餐品简要信息，包括餐品名、餐品图、餐品评分、餐品价格；点击下方导航列表可切换至“首页”或“我的”界面。

（12）餐品信息：上方显示该商家的基本数据信息，包括商铺头像、商户名称、商户ID、商户地址；提供后厨直播和举报记录两个快捷键；中间显示菜品名称和查看原料信息快捷键；下方显示所有该菜品评价信息，包括顾客昵称、顾客评分、顾客文字评价、顾客配图；可以选择筛选评价，包括全部、带图、差评三类；点击最下方导航列表可切换至“首页”或“我的”界面。

（13）举报记录：列出了该商户的所有被举报信息，包括举报理由和举报处理结果。

（14）查看用户：查看该用户的头像、昵称和基本数据信息。

（15）后厨直播：上方显示该商家的基本数据信息，包括商铺头像、商户名称、商户ID、商户地址；提供我要举报快捷键；中间显示了直播和录播两个选项；下方显示了监控画面，画面上显示该段监控时间和后厨温度、湿度信息；点击监控画面左右的按键可切换监控画面；点击最下方导航列表可切换至“首页”或“我的”界面。

（16）查看原料信息：列出了该道餐品所有原料最近一次的采购信息，包括采购时间、采购人员、采购来源。

（17）我要举报：显示一个举报的表单，可填写举报理由；点击取消可取消该次举报；点击确认即提交此次举报。

（18）后厨录播：上方显示该商家的基本数据信息，包括商铺头像、商户名称、商户ID、商户地址；提供我要举报快捷键；中间显示了直播和录播两个选项；可自行选择月日时再点击确认即可选择指定时刻的监控画面；点击最下方导航列表可切换至“首页”或“我的”界面。

f.其它需求

暂无。

附录A:词汇表

附录B：分析模型

数据流程图

图2 阳光大厨房上下文图

图3 阳光大厨房0层图

图4

图5

图4，图5，图6阳光大厨房接受信号图

图7

图7，8 阳光大厨房管理餐品图

图9 阳光大厨房管理商户信息图

图10 阳光大厨房举报环节图

状态转换图

实体-关系图