README.md: move the content in app/README.md to this one.

README.md

@@ -1,9 +1,128 @@
-在生词簿每个单词后面，加上两个按钮，熟悉与不熟悉:
-1.如果点熟悉，就将生词簿中该单词后面记录的添加次数减一，直至减为0，就将该单词从生词簿中移除。
-2.如果点不熟悉，就将生词簿中该单词后面记录的添加次数加一。
+EnglishPal - Learn English Words Smartly
+==========================================
+
+
+
+
+Hui Lan <hui.lan@cantab.net>
+
+1 November 2019
+
+
+What is it?
+-----------------
+
+EnglishPal allows the user to build his list of new English words
+picked from articles selected for him according his vocabulary level
+by EnglishPal.
+
+
+Run it on a local machine
+-------------------------
+
+python3 main.py
+
+
+
+Run it within Docker
+--------------------
+
+Assuming that docker has been installed ...
+
+ssh to ubuntu@118.25.96.118
+cd to /home/lanhui/englishpal
+
+# Stop all docker service
+sudo service docker restart
+
+# If you know the container ID, then the above comamnd is an overkill.  Use the following command instead.
+sudo docker stop ContainerID
+
+# You could get all container ID with the following command.
+sudo docker ps 
+
+# Rebuild container. Run this after modifying the source code.
+sudo docker build -t englishpal .
+
+# Run the application
+sudo docker run -d -p 90:80 -v /home/lanhui/englishpal/app/static/frequency:/app/static/frequency -t englishpal  # for permanently saving data
+sudo docker run -d -p 90:80 -t englishpal # data will be lost after existing
+
+# Save space.  Run it after sudo docker run
+sudo docker system prune -a -f
+
+
+# Other commands
+sudo docker ps -a
+
+sudo docker logs image_name, where image name could be obtained from sudo docker ps.
+
+build.sh contains all the above commands.  Run "sudo ./build.sh" to rebuild the web application.
+
+
+
+Update articles
+---------------
+
+All articles are stored in a SQLite file called wordfreqapp.db.
+
+pscp wordfreqapp.db lanhui@118.25.96.118:/home/lanhui/englishpal/app/static
+
+
+
+Feedback
+---------
+
+Tianhua people
+~~~~~~~~~~~~~~~~
+
+- Need a smart phone app.  I use phone a lot.  You cannot ask students to use computers.
+
+- Can take a picture for text.  Automatic translation.
+
+
+Usability testing
+~~~~~~~~~~~~~~~~~~~~~~
+
+Respondent 1 --- Paid 10 yuan
+
+“成为会员”改成“注册”
+
+“登出”改成“退出”
+
+“收集生词吧”改成“生词收集栏”
+
+***不要自动显示下一篇
+
+需要有“上一篇”、“下一篇”
+
+Internal server error when register using an email address.
+
+
+Improvements made by contributors
+-----------------------------------
 
 - 朱文绮
 
+在生词簿每个单词后面，加上两个按钮，熟悉与不熟悉:
+
+1.如果点熟悉，就将生词簿中该单词后面记录的添加次数减一，直至减为0，就将该单词从生词簿中移除。
+
+2.如果点不熟悉，就将生词簿中该单词后面记录的添加次数加一。
+
+- 李康恬
+
+Add the function of "Delete already known and well-known words from
+the words' library", on the one hand, it can conform to the usage
+habits of some users, who do not like that their words' libraries have
+too many words that they already know, on the other hand, it can
+reduce unnecessary memory occupied by the database, in addition, it
+can also improve the simplicity of the page.
+
+More information at: http://118.25.96.118/kanboard/?controller=TaskViewController&action=readonly&task_id=736&token=81a561da57ff7a172da17a480f0d421ff3bc69efbd29437daef90b1b8959
+
+
+- 占健豪
 
 Click the Familiar or Unfamiliar button (current word frequency>1), the current word position is displayed at the top of the page;
 
@@ -11,4 +130,13 @@ Click the Familiar or Unfamiliar button (current word frequency is 1), and the p
 
 Demo video link: https://b23.tv/QuB77m
 
-- 占健豪
+- 张小飞
+
+修复了以下漏洞。
+
+漏洞：用****这段字符可以作为任何账号的密码登录。
+
+Bug report: http://118.25.96.118/bugzilla/show_bug.cgi?id=215
+
+
+Last modified on 2021-07-16