【Alpha】Phylab 发布说明
Phylab Alpha阶段发布说明
一、发布地址 Phylab
二、新功能
1. 控制台
由于往届项目控制台并未发布，因此我们在完善后将这部分放在新功能部分。目前使用控制台需要向开发者申请。
1.1 整体界面
1.2 新增实验
点击“新增实验”按钮，输入实验信息后便可以新增一个空实验。
关于新增实验模板
往届的新增实验后直接生成三个空文件，没有帮助意义。目前我们新建实验后会生成三个模板文件，其中以python脚本模板为主。三者合起来为一个可以直接运行的“迷你实验”。
1.3 在线编辑
在线可以编辑一个实验所需的三个主要部分:Python、Latex和Html表格
其中Html表格的编辑可以实时在左侧的输入框处预览。
1.4 上传预习报告
可以根据实验组上传PDF格式的预习报告。
1.5 运行测试
实验脚本编写完毕后，可以在左侧的输入框输入数据，运行简单的测试，并可以收到服务端返回的运行输出及结果。
1.6 保存/发布/删除实验
可以对实验进行保存、发布，可以对未发布的实验进行删除操作。（需要权限设置）
2. 新实验
新增了 2110114 与 2140113 两个实验
其他实验陆续完成中 😃
3. 用户界面
完善了用户个人信息界面，可以修改个人信息了。
三、修复缺陷
1. 网站整体功能
接受项目时网站又一次处于无法运行的状态，经过联系往届学长我们获得了数据库备份文件并重新部署了网站。并修改了代码中多个问题让网站可以正常运行
包括但不限于：
- 注册/登陆/注册邮件确认，添加等待转圈gif缓解邮件系统较慢的问题
- 社区功能正常使用
- 已有实验大部分正常运行
- 社区图片的正常显示
- 后台管理的正常使用
2. 收藏夹
完整修复收藏夹功能，目前收藏功能大体可以正常使用，可以收藏新内容，查看并下载已收藏内容
3. 评论区
大体修复小实验评论区，目前可以在实验界面直接进行简单评论
4. 其他
修订了去年的部署文档，现在在拥有网站全量备份的情况下可以按照部署文档将整个网站部署到新服务器上。
将全部脚本升级为python3，便于部署和后期维护（python2.7在目前环境下安装matplotlib包时会出问题，并且到2020年将停止维护）
四、目前已知问题与限制
1. 问题
- 移动端仍处于几乎不可用状态。
- 登出问题：社区和实验网站的登出不同步
- 1020实验在测试中发现奇怪的问题暂无法运行
- 收藏夹数字显示有bug，时好时坏，但不影响使用
- 实验评论区需要验证码时无法使用
- 修改密码无法使用
- 注册部分的年级信息没有和后端关联起来
- 控制台偶尔出现编辑器需要点击才能唤醒的情况
2. 限制
- 用户生成实验报告部分没有接入类似控制台的出错系统，出错后无法得知具体原因
- 注册邮件由于使用了普通的个人邮箱进行发送，可能出现发送较慢或被识别为垃圾邮件的情况。
- 注册部分由于发邮件并不是异步过程，导致邮件必须发出后页面才能跳转，目前仅能添加一个加载gif缓解问题
- 验证码比较难看
- 新增实验仍较少
- 用户看到控制台需要开发者操作数据库添加权限
- 部分实验PDF生成可能较慢
- 报告生成界面的评论区与社区中的文章相关联，但新增实验仍需要手动在社区新建文章并操作数据库关联二者
五、运行环境要求
1. 服务端
详见部署文档
基本要求：Ubuntu 16.04，php7.0，apache2，python3.5，texlive2018（使用Ubuntu 16.04软件源安装即可）
2. 客户端
PC端主流浏览器即可，推荐Chrome
详见 测试报告中的测试矩阵
六、安装方法
直接访问网站即可：Phylab
