добавил много комментариев, везде, кроме Mathematics.py

conf/debug_functions.py

@@ -1,20 +1,27 @@
-def add_new_event():
-    name = input("Введите название ивента\n")
-    description = input("Введите описание ивента\n")
+def add_new_event() -> dict:
+    """
+    Создаёт новый ивент в систему
+
+    :return: Dict - json объект, в нём либо ошибка, либо созданный элемент
+    """
+    name = input("Введите название ивента\n")  # получаю name
+    description = input("Введите описание ивента\n")  # получаю description
     try:
-        well = input("Этот ивент хороший?\n")
-        if well == "True":
+        well = input("Этот ивент хороший?\n")  # получаю well
+        if well == "True":  # временный костыль
             well = True
         else:
             well = False
+        # TODO заменить костыль
     except Exception as e:
-        return e
-    variants = input("Введите варианты развития ивентов, разделённые */!/*\n").split("*/!/*")
+        return {"err": e}
+    variants = input("Введите варианты развития ивентов, разделённые */!/*\n").split("*/!/*")  # получаю variants
     consequence = input("Введите функции которые выполнятся при варианте ивента, "
-                        "разделённые */!/*\n").split("*/!/*")
-    probability_consequence = [int(i) for i in input("Введите вероятности вариантов ивентов,"
-                                                     " разделённые */!/*\n").split("*/!/*")]
-    if len(variants) == len(consequence) == len(probability_consequence):
+                        "разделённые */!/*\n").split("*/!/*")  # получаю consequence
+    probability_consequence = [int(i) for i in input("Введите вероятности вариантов"
+                                                     " ивентов, разделённые */!/*\n"
+                                                     "").split("*/!/*")]  # получаю probability_consequence
+    if len(variants) == len(consequence) == len(probability_consequence):  # если все длины сошлись
         response = {
             "name": name,
             "description": description,
@@ -23,18 +30,18 @@ def add_new_event():
             "probability_consequence": probability_consequence,
             "probability": 50,
             "well": well
-        }
-        from modules.DB import UseDB
-        db = UseDB("events")
-        db.insert_document(response)
-        return response
+        }  # собираю json объект для сохранения
+        from modules.DB import UseDB  # импортирую базу
+        db = UseDB("events")  # соединяюсь
+        db.insert_document(response)  # записываю объект
+        return response  # возвращаю его
     else:
-        return "Длины variants, consequence и probability_consequence не равны"
+        return {"err": "Длины variants, consequence и probability_consequence не равны"}
 
 
 def main():
     while True:
-        answer = input("Что сегодня сделаем?\n")
+        answer = input("Что сегодня сделаем?\n")  # получаем вопрос
         if answer == "добавить эвент":
             print(add_new_event())
         else: