【Gamma】 Phylab 发布说明

Phylab Gamma阶段发布说明

一、发布地址

网站：Phylab

GitHub Release: WhatAHardChoice/Phylab Gamma版本

二、新功能

1. 控制台完全接入

控制台管理的内容由之前的三件套（Python/Latex/HTML）转为了四件套（+Markdown）。原先的操作均不受影响。增加了Markdown接口的测试。

Markdown模板内容与Latex模板内容一致，仅样式略显简陋，但生成速度大大提升（详见测试报告-性能测试部分）。

2. 可编辑公告栏

Gamma阶段引入了公告栏的编辑功能。

三、修复缺陷

1. 移动端设计性实验问题

修复了上阶段遗留的移动端设计性实验点击无法直接隐藏答案的问题。

2. Markdown模板补全

补全了所有实验的Markdown模板报告。

3. 工程方面的提升

• 完成了绝大部分控制器单元测试，测试代码在tests文件夹下。
• 上传了Postman接口测试的可导入文件及配套文档。
• 在后端增加了大量注释，在前端删除了大部分无用代码。大部分配置已经从代码中解耦。
• 后端增加了错误码，并提供了相关文档。
• 除了上述文档外还上传了项目入门及结构介绍、配置文件说明、本地部署踩坑文档。修订了已有的接口文档、部署文档。

四、目前已知问题与限制

1. 问题

1. 登出问题：社区和实验网站的登出不同步
2. 移动端实验评论区无法使用，实际上问题是移动端社区无法使用，问题出在移动端社区的登陆与pc端不同。
3. 注册部分的年级信息没有和后端关联起来，此问题修改难度较大暂时搁置
4. 控制台偶尔出现编辑器需要点击才能唤醒的情况

2. 限制

1. 上传头像功能和社区有小部分冲突

2. 修改密码的邮件极容易被识别为垃圾邮件

3. 手机上传的头像在电脑上方向不太对

五、运行环境要求

1. 服务端

详见部署文档

基本要求：Ubuntu 16.04，php7.0，apache2，python3.5，texlive2018（使用Ubuntu 16.04软件源安装即可）

2. 客户端

PC端主流浏览器即可，推荐Chrome
详见 测试报告中的测试矩阵

六、安装方法

直接访问网站即可：Phylab

Github上的Release页面有目前服务端运行的完整代码，只需要少量修改并导入数据库文件即可运行。详见部署文档。