- documentation update: setting up letsencrypt certificates.

- fixed duplicate generation of questions. - fixed crash when all topics are solved.

- documentation update: setting up letsencrypt certificates.
- fixed duplicate generation of questions. - fixed crash when all topics are solved.
Miguel Barão
1 parent f75a344f
Showing 3 changed files with 50 additions and 32 deletions Show diff stats
BUGS.md
README.md
knowledge.py
+
 BUGS:
 - guardar state cada vez que topico termina
-- logs mostram que está a gerar cada pergunta 2 vezes...??
 - reload da página rebenta o estado.
 - indicar o topico actual no sidebar
 - session management. close after inactive time.
@@ -9,7 +9,6 @@ BUGS:
 TODO:
-- letsencrypt.org
 - logs de debug devem indicar o user.
 - implementar http com redirect para https.
 - topicos no sidebar devem ser links para iniciar um topico acessivel. os inacessiveis devem estar inactivos.
@@ -17,8 +16,10 @@ TODO:
 - mostrar comments quando falha a resposta
 - generators not working: bcrypt (ver blog)
-SOLVED:
+FIXED:
+- logs mostram que está a gerar cada pergunta 2 vezes...??
+- letsencrypt.org
 - alterar password.
 - barra de progresso a funcionar
 - mostra tópicos do lado esquerdo, indicando quais estão feitos
@@ -71,12 +71,28 @@ First we need to create a database:
 ### SSL Certificates
+#### Selfsigned
 We also need certificates for https. Generate selfsigned certificates using openssl:
     openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -nodes
 and place them in `aprendizations/certs`.
+#### LetsEcrypt
+
+    sudo pkg install py27-certbot       # FreeBSD
+
+Shutdown any server running and the firewall, and then run the script to generate the certificate:
+
+    sudo pfctl -d                                   # disable pf firewall
+    sudo certbot certonly --standalone -d bit.xdi.uevora.pt
+    sudo pfctl -e; sudo pfctl -f /etc/pf.conf       # enable pf firewall
+
+Certificates are saved under `/usr/local/etc/letsencrypt/live/bit.xdi.uevora.pt/` which is readable only by root.
+
+Copy them to `aprendizations/certs` with names `cert.pem` and `key.pem`. And change permissions to be readble (FIXME how to do it with security?)
+
+
 ### Testing
 Run a demonstration:
@@ -126,16 +142,16 @@ To correct in FreeBSD, edit `~/.login_conf` to use UTF-8, for example:
 ## Useful sqlite3 queries
-- Which students have already done at least one topic?
+Which students have already done at least one topic?
     sqlite3 students.db "select distinct student_id from studenttopic"
-- How many topics have done each student?
+How many topics have done each student?
     sqlite3 students.db "select student_id, count(topic_id) from studenttopic group by student_id"
-- What questions have more wrong answers?
+What questions have more wrong answers?
     sqlite3 students.db "select count(ref), ref from answers where grade<1.0 group by ref order by count(ref) desc"
@@ -20,27 +20,30 @@ class Knowledge(object):
         self.depgraph = depgraph
         self.state = state   # {node: level, node: level, ...}
-        self.topic = self.topic_generator()
-        self.current_topic = next(self.topic)
+        self.topic_sequence = nx.topological_sort(self.depgraph) # FIXME
-        self.questions = self.generate_questions_for_topic(self.current_topic)
-        self.current_question = None
-        self.finished_questions = []
+        # select a topic to do
+        self.new_topic()
     # ------------------------------------------------------------------------
-    def topic_generator(self):
-        self.topic_sequence = nx.topological_sort(self.depgraph) # FIXME for now...
-        for t in self.topic_sequence:
-            if self.state.get(t, 0.0) > 0.999:
-                continue
-            self.questions = self.generate_questions_for_topic(t)
-            logger.info(f'Generated {len(self.questions)} questions for topic "{t}"')
-            yield t
+    def new_topic(self, topic=None):
+        if topic is None:
+            # select the first topic that has level < 0.9
+            for topic in self.topic_sequence:
+                if self.state.get(topic, 0.0) < 0.9:
+                    break
+
+        # FIXME if all are > 0.9, will stay in the last one forever...
+        self.current_topic = topic
+        self.current_topic_idx = self.topic_sequence.index(topic)
+        self.questions = self.generate_questions_for_topic(topic)
+        self.current_question = None
+        self.finished_questions = []
     # ------------------------------------------------------------------------
     def generate_questions_for_topic(self, topic):
-        factory = self.depgraph.node[topic]['factory']
-        return [q.generate() for q in factory]
+        factory_list = self.depgraph.node[topic]['factory']
+        return [q.generate() for q in factory_list]
     # ------------------------------------------------------------------------
     def get_current_question(self):
@@ -58,26 +61,24 @@ class Knowledge(object):
     def get_topic_progress(self):
         return len(self.finished_questions) / (len(self.finished_questions) + len(self.questions))
-    # --- generates a new question given the current state -------------------
+    # ------------------------------------------------------------------------
+    # if answer to current question is correct generates a new question
+    # otherwise returns none
     def new_question(self):
         logger.debug('Knowledge.new_question()')
-        if self.current_question is None or self.current_question.get('grade', 0.0) > 0.9999:
+        if self.current_question is None or \
+            self.current_question.get('grade', 0.0) > 0.9:
+            # if no more questions in this topic, go to the next one
+            # keep going if there are no questions in the next topics
             while not self.questions:
-                # finished topic!
                 self.state[self.current_topic] = 1.0
-                self.finished_questions = []
-                try:
-                    self.current_topic = next(self.topic)
-                except StopIteration:
-                    self.topic = self.topic_generator()
-                    self.current_topic = next(self.topic)
-                    self.questions = self.generate_questions_for_topic(self.current_topic)
+                self.new_topic()
             self.current_question = self.questions.pop(0)
             self.current_question['start_time'] = datetime.now()
-            self.finished_questions.append(self.current_question) # FIXME not yet finished...
+            self.finished_questions.append(self.current_question)
             return self.current_question
		1	+
1	BUGS:	2	BUGS:
2		3
3	- guardar state cada vez que topico termina	4	- guardar state cada vez que topico termina
4	-- logs mostram que está a gerar cada pergunta 2 vezes...??
5	- reload da página rebenta o estado.	5	- reload da página rebenta o estado.
6	- indicar o topico actual no sidebar	6	- indicar o topico actual no sidebar
7	- session management. close after inactive time.	7	- session management. close after inactive time.
	@@ -9,7 +9,6 @@ BUGS:		@@ -9,7 +9,6 @@ BUGS:
9		9
10	TODO:	10	TODO:
11		11
12	-- letsencrypt.org
13	- logs de debug devem indicar o user.	12	- logs de debug devem indicar o user.
14	- implementar http com redirect para https.	13	- implementar http com redirect para https.
15	- topicos no sidebar devem ser links para iniciar um topico acessivel. os inacessiveis devem estar inactivos.	14	- topicos no sidebar devem ser links para iniciar um topico acessivel. os inacessiveis devem estar inactivos.
	@@ -17,8 +16,10 @@ TODO:		@@ -17,8 +16,10 @@ TODO:
17	- mostrar comments quando falha a resposta	16	- mostrar comments quando falha a resposta
18	- generators not working: bcrypt (ver blog)	17	- generators not working: bcrypt (ver blog)
19		18
20	-SOLVED:	19	+FIXED:
21		20
		21	+- logs mostram que está a gerar cada pergunta 2 vezes...??
		22	+- letsencrypt.org
22	- alterar password.	23	- alterar password.
23	- barra de progresso a funcionar	24	- barra de progresso a funcionar
24	- mostra tópicos do lado esquerdo, indicando quais estão feitos	25	- mostra tópicos do lado esquerdo, indicando quais estão feitos