测试报告$\alpha$

pytorch可视化编程网站VisualPytorch NAG \(\alpha\)版本发布了！点击网址访问：VisualPytorch

一、测试查虫（bug detection）

测试贯穿了开发、集成、部署，甚至整个\(\alpha\) 阶段，我们遇到了各种各样的bug，既有往届学长遗留下来的，也有添加新功能过程中遇到的。由于时间问题，我们对其中发现的一些问题进行了修复，剩下的问题我们会在尽快修复并更新。以下是测试中发现的问题：

bug分类	solved	Unsolved
界面	1. 前端表单回显出现问题	1. 表单验证时的图片显示异常 2. create_models中字体不一致，没有利用上模板的字体，找不到是因为哪个CSS没导入引起的问题 3. 部分字体被方格遮挡，影响用户体验
工具使用	1. git使用不当造成的文件冗余/减少 2. bootstrap自带模态框的bug,同一页面的多个模态框切换会出现无法关闭模态框的情况（已解决，将注册/登录模态框分离为两个不同的Button）	免费版jsplumb不支持模块封装的功能，使用jsplumbtoolkit可以避免这一问题，准备在\(\beta\)阶段开发
前端功能	1. model_details可能存在模型加载不出来的问题，概率较高（已解决，是由于重复导入js引起的问题） 2. model_details网络层元素有可能加载到模板外面（已解决，但由于create_model.html里模板大小的改变可能还会加载到外面） 3. 部分图块在移动鼠标后信息丢失 4. 预留了一些栏目待开发，点击无响应	1. help.html中相比原来的版本少了一个模型构建实例的gif，因为缺少相应的参数 2. 有时create_model.html里的jsplumb元素点不动，无法调整网络层 3. 有时页面跳转会异常，出现signiture timeout情况
后端功能	1.shape, layer_type, dampening, nesterov字段与实现与说明文档不符 2. 前端没有传入默认参数，需要后端进行处理	传入后端的内容缺少creator信息
前后端接口	1. 采用前后端分离，单独提出header之后，部分页面引用重复/出错 2. 前后端json格式未统一，json中缺失out字段	前后端分离且header单独提出，并使用了文件夹分层，文件夹内外对header引用的相对地址不一致（目前的方法是在document.ready中修改属性，但会导致浏览器console对资源引用报错，无法找到。对实际使用/观感，均无影响）
往届	1. 之前项目遗留的OPS字段未去除 2. 往届项目生成与保存按钮错位

二、场景测试（scenario testing）

1. 典型用户

属性	描述
姓名	赵XX
年龄	22
职业	学生，deep learning初学者
重要性	这一类的用户是本网站的主体用户，我们的项目主要就是为了对于pytorch没有基础的新手菜鸟，所以这一类的用户对我们来讲非常重要
所占比例	60%~65%
知识层次	对深度学习有一个基本的认知，但不知道pytorch的具体使用方法
动机	希望通过本项目帮助学习深度学习和pytorch的使用
用户要求	界面简单直观，生成的代码简洁明了，并且希望在关键的地方有相应的教程辅助

属性	描述
姓名	钱XX
年龄	31
职业	相关领域从业者，deep learning初学者
重要性	也很重要，虽然所占比例可能不如第一类典型用户大，但是这一类的用户如果底本项目很满意的话，可能会成为本项目的长期用户
所占比例	25%~30%
知识层次	长期在相关领域工作，对深度学习和pytorch都有了一定认识，但是很少自己动手开发
动机	这一类的用户可能是短期内接到某一项目需要deep learning，希望通过本项目来学习或者直接用本项目来完成工作
用户要求	除了界面、代码、教程辅助这些部分之外，他还对所生成代码的可移植性有一定的要求

属性	描述
姓名	孙XX
年龄	38
职业	IT行业精英，deep learning精通者
重要性	有一定的重要性，这一类的用户不会太多，他们可能会为本项目提出改进意见，但是一般不会在自己的项目中真正的使用。但是如果能让他们觉得方便实用，也有可能让他们在一些小工程中应用本项目
所占比例	5%~15%
知识层次	长期在这一领域工作，有丰富的深度学习的知识，精通pytorch，曾多次开发基于pytorch的深度学习项目
动机	这一类的用户可能是短期内接到某一项目需要deep learning，希望通过本项目来学习或者直接用本项目来完成工作
用户要求	对生成的代码有较高的要求，希望其能满足工程性的要求

2. 场景测试

典型用户：赵XX

• 场景描述：
  
  赵XX正在学习深度学习相关的课程，希望通过可视化编程对深度学习有一个直观的映像。他登陆本网站第一件事就是查看帮助信息，了解各个模块的功能和使用方法。但由于对pytorch不够熟悉，他不知道各个网络层以及全局数据的参数应该怎么选择，在看了帮助文档中对他所需参数的大致介绍后，他配置出了自己的模型，并生成了代码，成功运行。

• 需求分析：

  用户界面简洁优雅，操作过程顺滑（比如拖拽组件和模块之间连线）
  
  由于赵XX的深度学习基础有限，需要在帮助文档的辅助下才能配置好自己的模型。
  
  本网站也会提供一些经典的模型，让初学者即使短时间无法完成自己模型的配置，也可以引入经典模型来体验本网站的用法。

典型用户：钱XX

• 场景描述：
  
  钱XX接到一个工程需要用到简单的深度学习网络，他久闻pytorch的大名，决定用它来搭建自己的网络，但他此前没有使用pytorch的经验，这时他了解到本网站。通过相关的辅助信息，他轻松地在网站上搭建了自己所需要的网络，并且成功地将这个网络应用在了工程中。
• 需求分析：
  
  与第一个场景的要求大致相似，但是这一场景由于会应用到实际工程中，对代码的可移植性有一定要求。

典型用户：孙XX

• 场景描述：
  
  孙XX是工作在这一领域的老江湖，他听说有一个可视化pytorch编程的网站，就想着进来体验一下。进来网站之后，他发现在网站的界面优雅，拖拽组件和连线过程顺滑，但是作为一个专业人士，他还是发现一些参数设置上的不合理，于是他在评论区留言，提供了改进的意见。在经过数次的改动之后，孙觉得这个网站已经达到自己的标准，开始长期在工作中使用这个网站

• 需求分析：

  设置评论交流区，一方面可以接受大佬对本项目的意见，另一方面也方便用户之间关于本项目的交流。
  
  除了前面提到的要求，专业的从业人员对所生成代码的要求更高

三、测试矩阵（test matrix）

测试浏览器	测试环境（浏览器版本）	组件拖拽	组件连线	参数输入	点击事件（组件按钮、链接）下拉框	报错情况	生成代码	主页面	联系我们页面	访问量统计页面	代码生成页面	页面切换
chrome	81.0.4044.122	正常	正常	正常	正常	正常	正常	正常	正常	正常	正常	帮助文档跳转其他界面时有时url会出错
火狐	75.0.0.7398	正常	正常	正常	正常	正常	正常	正常	正常	正常	正常	同上
ie	11.0.9600.16428	正常	正常	正常	正常	正常	正常	正常	正常	正常	正常	同上
edge	42.17134.1.0	正常	正常	正常	正常	正常	正常	正常	正常	正常	正常	同上
QQ	10.5.3	正常	正常	正常	正常	正常	正常	正常	正常	正常	正常	同上
UC	6.2.4094.1	正常	正常	正常	正常	正常	正常	正常	正常	正常	正常	同上
Opera	69.0.3653	正常	正常	正常	正常	正常	正常	正常	正常	正常	正常	同上
搜狗	8.6.3.32395	正常	正常	正常	正常	正常	正常	正常	正常	正常	正常	同上
猎豹	6.5.115.18480	正常	正常	正常	正常	正常	正常	正常	正常	正常	正常	同上

四、\(\alpha\) 出口条件（exit criteria）

1. 需求

我们在功能设计阶段，定下了以下四个大的目标任务，可以说是原始出口条件：

• 扩展更多的网络层（如BN, ConvTranspose等）
• 支持网络封装成基本模块
• 经典模型（如U-Net, ResNet, AlexNet, VGG-16等）
• 更精美的可视化

可是在开发的过程中，由于需要对相关知识的学习，读懂往届的代码，最终开发的时间仅有10天的时间。同时发现实现封装的过程并非像想象中那么容易（免费版本的JSPlumb不支持这一功能），封装无法完成，自然基于封装的经典模型就只能搁置，转而去完成一些相对简单的任务。于是出口的条件改变了：

• 扩展更多的网络层（如BN, ConvTranspose等）
• 扩展更多的静态参数（如损失函数、优化器等）
• 更精美的可视化
• 用户登录与模型保存
• 帮助文档的撰写

2. 功能

页面	功能交互描述	已完成	未完成	页面展示
登录界面	1、用户的注册功能 2、用户的登录功能 3、忘记密码功能	1,2	3
框架构建	1、构建已经有的经典框架 2、个性化构建自己的框架 3、能够保存为自己的个性化构建 4、能够实现参数调整	2,3,4	1
模型管理	1、模型的删除功能 2、模型的查看 3、导出代码	1,2,3
代码生成	1、根据所选框架生成特定代码	1
问题反馈	1、可以向后台反馈存在的bug，可配图可配文件 2、可以看到之前反馈问题的应答	2	1
共享空间	1、共享自己编辑的模型，并附上模型的说明 2、他人可进行评价、克隆模型 3、显示模型的阅读、点赞数据		1,2,3
用户统计	1、统计网站ip的访问次数，记录用户使用人数	1
关于我们	1、罗列有制作团队的具体信息，可以发邮件进行询问	1
帮助文档	1、动图展示操作方式 2、对模型参数的文档	1,2

3. \(\beta\)计划

在接下来的版本中，我们会更多地花时间去支持更多模型的搭建、丰富产品内容、提升用户体验。

包括\(\alpha\)阶段希望实现而尚未实现的：

• 支持网络封装成基本模块
• 经典模型（如U-Net, ResNet, AlexNet, VGG-16等）

已经实现还可以进一步改进的：

• 更精美的可视化
• 帮助文档的撰写

以及需要在未来实现的：

• 模型的本地部署与在线运行
• 集成tensorboard可视化
• 模型分享与交流
• 模型参数分析与可视化

在\(\beta\)阶段，我们会继续努力，争取完成以上预定的目标，提供一个尽可能实现的最好的产品。