Работа над Учебками

Материал из Брацка Правки
Перейти к: навигация, поиск

Работа над Учебками -- это вики-страница, созданная и существующая для работы над Брацкой, Курсовой и Будущей Учебками. Вместе эти три прилады далее именуются Учебками.

Основные потребители страницы -- это заказчик работ, координаторы и подрядчики. Однако каждый может внести свой вклад в эту работу. В частности, здесь можно оставить замечание, проинформировать о выявленных проблемах и предложить пути их разрешения.


Координация

Координаторы организуют работу над Учебками. Последовательность заданий координаторам:

  1. Сформулировать требования к Учебкам
  2. Администрировать Учебки
  3. Работать с подрядчиками
  4. Дорабатывать инструкции координаторам

Требования к Учебкам

Определить, что мы собираемся предлагать ученикам в качестве прилад под именами бренда Учебок и как мы собираемся предлагать. Для этого:
  1. Внимательно просмотреть вики-страницы Учебок.
  2. Спросить, что непонятно.
  3. Проверить вики-страницы Учебок на соответствие курсам Брацка Вводка и Брацки Техобзор.
  4. Добавить/удалить/поредактировать до ясности того, что Учебки из себя должны представлять.
  5. Проверить реальные Учебки на соответствие их вики-страницам.
  6. Найти различия между реальностью и описанием.
  7. Проверить, все ли различия задокументированы на этой вики-странице требованиями к подрядчикам.
  8. Создать нехватающие требования или улучшить существующие.
Так как прилад три, то и страницы три; по одной странице на каждую приладу. Эти страницы нужны тем, кто работает над Учебкой, чтобы знать, что должно в итоге работы получиться. Координаторов могут попросить объяснить, что там написано. При это он должен уметь изложить суть требований подрядчику.
Есть два вида работ над требованиями - это доработка существующих и создание новых. Основными источниками информации для требований есть сторона заказчика, отзывы учеников, собственные наблюдения, анализ документации и общение з подрядчиком. Задача координаторов состоит в соборе информации и ее документировании. Для ее сбора на проекте используются еженедельные разговоры, конференции и переписки. Документировать лучше все, потом лишнее можно удалить, это лучше, чем что-то упустить. Не забывать ставить пометки источника требований, так как они могут не совпадать с мнением заказчика. Возникшие вопросы желательно тоже документировать, до получения на них ответов.

Администрация Учебок

Что можно поправить на Учебках самим -- поправить. Документация на проекте должна быть понятна тем, кто ничего не слышал о нем. В случае использования терминологии проекта, нужно использовать использовать внутренние ссылки на его определение или страницу с описанием.

Инструкции для координаторов

Дорабатывать инструкции для следующих координаторов. Нужно учитывать то, что требования, которые выполнены, стают функционалом и подразумевают изменения на страницах описания прилады. А инциденты, при должном описании, стают требованиями.

Работа с подрядчиками

На данной странице описания работ, мы разрабатываем, что нам надо сделать для того, чтобы претворить в жизнь Требования к Учебкам. Координаторы уточняют детали разработок и предлагают план действий над тем, что невозможно поправить самим и на что нужны подрядчики.

Критерии найма

Первоначально следует нанять консультанта, который может высказать экспертное мнение относительно реализации Учебок и совместно с координатором доработать требования.
На работу с Учебками рассматриваем одного постоянного подрядчика на плановые работы Обслуживание операций, и отдельных подрядчиков на Разовые работы. Это условие не запрещает постоянному подрядчику работать на разовых работах. Плановые работы будут проводиться циклично, с выходом новой стабильной сборки. Все роботы подрядчик должен задокументировать.
Знание русского или украинского будет преимуществом.
Подрядчики наниматься на основании требований, изложенных на этой странице, после прохождения собеседования и отбора.

Объявление

Нужен консультант на сайт Moodle -- https://ucebka.bskol.com/
Требуется экспертное мнение относительно безопасности, настроек, плагинов, предоставление ролей. Есть возможность найма на уже существующие требование. Более детально на странице https://pravka.bskol.com/ru/%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0_%D0%BD%D0%B0%D0%B4_%D0%A3%D1%87%D0%B5%D0%B1%D0%BA%D0%B0%D0%BC%D0%B8#.D0.9A.D1.80.D0.B8.D1.82.D0.B5.D1.80.D0.B8.D0.B8_.D0.BD.D0.B0.D0.B9.D0.BC.D0.B0
Знание русского будет преимуществом.
We are looking for a consultant for the Moodle website -- https://ucebka.bskol.com/
Expert opinion is required regarding security, settings, plugins, role settings. There is a possibility of hiring in accordance with the existing need. More details on the page --https://pravka.bskol.com/ru/%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0_%D0%BD%D0%B0%D0%B4_%D0%A3%D1%87%D0%B5%D0%B1%D0%BA%D0%B0%D0%BC%D0%B8#.D0.9A.D1.80.D0.B8.D1.82.D0.B5.D1.80.D0.B8.D0.B8_.D0.BD.D0.B0.D0.B9.D0.BC.D0.B0
Knowledge of the Russian language will be an advantage.

Ресурсы для размещения объявлений

Основным сайтом для поиска подрядчиков будет upwork.com, но стоит разместить объявления и на украинских ресурсах таких как work.ua либо robota.ua.

Порядок отбора

С теми, кто откликнется на объявление будет проведено собеседование. Основным критерием отбора будет возможность подрядчика реализовать требования. В отборе преимущество имеют те кандидаты, которые готовы выполнить требования за минимальный бюджет, иметь опыт работы с подобными задачами. В результате положительного собеседования должны быть доработаны требования, то есть подрядчик должен высказать мнение о предстоящих работах.

Договор

С подрядчиком, который прошел отбор, будет заключен договор [[1]].

Адаптация на работах

Для адаптации на проекте, к подрядчику будет закреплен координатор, который в данный момент координирует Брацки Учебки.
Предполагается, что подрядчик все работы, первично, будет выполнять на Будуща Учебка. Во избежание чрезвычайных ситуаций, так как Брацка Учебка являться действующей приладой, на которой проходят обучение ученики. После отработки алгоритма изменений на Будуща Учебка, и ее тестирования, изменения будут вноситься на Брацка Учебка.

Завершение работ

Для завершение работ, координатор и подрядчик должны пройти приемочное тестирование, которое подтвердит выполненный объём работ.

Обслуживание операций

Обновление

Обеспечить плановое обновление версий на Moodle. Обновление версий нужно проводить на Будуща Учебка "экспериментальной" приладе. После обновлений нужно провести тестирование для выявления проблем функционала. Основная версия обновляется после того, как экспериментальная версия пройдет тестирование.

Мониторинг

Обеспечить плановый экспертный мониторинг приложения. Тут должны быть пункты относительно безопасности, установки и настройки плагинов, обеспечения функционала, настройки и форматирования ролей и разрешений. Мы хотим услышать мнение эксперта, относительно этого вопроса, что он сможет предложит.

Тестирование

Обеспечить тестирование сайта Учебки на Mooodle. Имеет смысл создания функциональных тест кейсов для проверки Будуща Учебка, которые будут использоваться для тестирования после обновлений. До тестирования можно привлекать учеников в качестве практических заданий.
В тестировании сайта после обновлений должна принять участие сторона исполнителя и сторона заказчика. Предположительно, сам подрядчик и координатор, который занимается Учебками. Тестирование стоит проводить по следующим пунктами:
  • записи на курс новых учеников;
  • продолжение обучение учеников, которые пребывают на курсе;
  • сохранение прогресса учеников, которые пребывают на курсе;
  • проверка основного функционала страниц курса: лекция, тест, глоссарий, форум, задание.

Разовые работы

Картинки

  1. При отображении на десктопе должны занимать 50% экрана, на мобильных устройствах - 100%. А так же иметь подписи и открываться в отдельном окне.
  2. Разрабатываются в формате .svg, однако должны конвертироваться вручную в .png из-за отказа системы работать с .svg форматом.
  3. Возможно, следует собрать в определенном репозитории, а на остальных ресурсах при вставке картинок ссылаться на него. Для картинок на Брацкой Правке рассматривается использование Вики-склада. Надо рассмотреть возможность объединить эти две разработки.
  4. Существует проблема инструкций по работе с картинками. Инструкция висит на сообществе координаторов, но не понятно, почему там, как о ней узнать и как получить.

Учебный элемент "Лекция"

  1. Нет возможности скачивать, обрабатывать и выводить ответы. Некоторые из ответов, например, эссе, планируется связывать с профилем ученика.
  2. Есть интерес использовать кластеры страниц, но нет опыта.
  3. Для отзывов используются информационные страницы типа "Список разделов"; стандартные инструменты отзывов элемента не используются. Однако если управляющий курса по ошибке вставляет текст в стандартное поле отзыва и затем вставленный по ошибке текст удаляет, система продолжает отображать стандартный отзыв, который к тому времени уже пуст.
  4. Значительные пробелы (отступы, пустые места) между заголовком и основным текстом лектио в уроке "Об Услугах Bskol" первого курса. Причина возникновения и способ исправления неизвестны. Не известно также, возникает ли данная проблема на других лектио.
  5. Форматирование в режиме HTML является основным для нас. Однако клавиша спрятана в дополнительных возможностях, что заставляет делать два клика каждый раз. Более того, если HTML не выбран, то Moodle автоматически редактирует текст, добавляя дополнительные параграфы и разрывы страниц.
  6. Ошибки шкалы прогресса в Учебке
  7. Нет удобного способа пересматривать микро-лекции. На каждом курсе есть страница со списком всех лекций и ссылками на них, при этом списка микро-лекций там нет. Есть необходимость добавить список микро-лекции (и ссылки на них), из которых состоят лекции, на страницы курсов со списком лекций.
  8. Когда нужно возвращаться к предыдущим микро-лекциям, стоит убрать необходимость отвечать заново на вопрос, чтобы была возможность переключаться на следующие микро-лекции и не тратить время на выбор ответа. Ответ должен автоматически сохраниться с того раза, когда эта микро-лекция была пройдена в первый раз.

Автосвязывание

  1. обеспечить работу автосвязывания терминов словаря (Глоссария) с текстами лектико. Автосвязывание терминов словаря с текстами лектио не работает. В настройках словаря и терминов функция автосвязывания включена.
  2. автосвязывания разделов курса с их названиями в текстах лектико необходимо убрать (снимок приложен).
    Автосвязи на Moodle.png

Безопасность

  1. Авторизация осуществляется федеративной службой, которая передаёт Учебке два типа емейлов -- один персональный и другой -- корпоративный. В данный момент, любой привелегированный пользователь курса (например, учитель или управляющий курса) имеет доступ к персональным емейлам. Проблема заключается в том, что учителями теоретически может быть большое количество участников проекта. Для обеспечения анонимности и неразглашения персональных данных учащихся, в профилях предлагается не показывать персональных емейлов вообще или, потенциально, показывать корпоративные емейлы.
  2. Для разметки текста на Moodle используется HTML. В использовании JavaScript пока нет нужды, имеет смысл запретить его использования на учебных страницах, в целях безопасности.
  3. Ученики на Брацка Учебка, в процессе прохождения обучения, используют только публикация простого не форматированного текста. Ввод форматированного текста должен быть запрещен. Запретить загрузку файлов учениками на курсе. Если в будущих курсах понадобиться использование учениками HTML разметки в тексте, нужно применить экранирование, для невозможности интерпретации JavaScript.
  4. Разработать план аутентификации, который делает невозможным ввод стандартных логинов и паролей (admin / admin; admin / apple; admin / 1234…) не федеральных пользователей. Возможно с использовать плагинов.
  5. Обеспечить недопущение идентификации при помощи не валидных данных.
  6. Применять этапы подтверждения при удалении большого объема данных.

Содержимое

  1. Тексты отзывов на втором и третьем курсе должны быть приведены в соответствие с текстами на первом курсе.
  2. Оставить только два эссе "придумайте вопрос" на третьем курсе. Изначально, эти эссе были сделаны в качестве "заглушек", а затем о них забыли.
  3. Преобразование микролекций в аудио формат c добавлением оных в начале лектио.

Роли

  1. Роль "Студент" переименовать в "Ученик".
  2. Роль "Преподаватель" переименовать в "Дидаскал".

Инсайты

  1. По умолчанию инсайты о не посещении студентами курса приходят не менее чем через 30 дней. Нужно изменить данный параметр с 30 на 14 дней.

Инциденты

Случаи нештатной работы, которые надо либо разрешить, либо доработать до требований:

Ошибка записи

На курсе Вводка ученик сообщил об ошибке записи в базу данных при обрабатывания кнопки "Отправить".

Незащищённое соединение

На курсе Выбор профессии по завершению первой четверти при открытии тестового задания в тексте ссылка bskol.com при нажатии для перехода выбивает "Подключение не защищено".[[2]]

DKIM ключи

При сдаче тестового задания за ученика (который прислал ответ емейлом), админ-пользователь Gary получил такую ошибку:

Email DKIM selector chosen due to admin@cnmcyber.com but no certificate found at /var/www/html/moodledata.bskol/dkim/cnmcyber.com/mail._domainkey.private line 6282 of /lib/moodlelib.php: call to debugging() line 102 of /message/output/email/message_output_email.php: call to email_to_user() line 506 of /lib/classes/message/manager.php: call to message_output_email->send_message() line 382 of /lib/classes/message/manager.php: call to core\message\manager::call_processors() line 349 of /lib/classes/message/manager.php: call to core\message\manager::send_message_to_processors() line 341 of /lib/messagelib.php: call to core\message\manager::send_message() line 6661 of /mod/assign/locallib.php: call to message_send() line 6689 of /mod/assign/locallib.php: call to assign::send_assignment_notification() line 6742 of /mod/assign/locallib.php: call to assign->send_notification() line 7743 of /mod/assign/locallib.php: call to assign->notify_student_submission_receipt() line 7780 of /mod/assign/locallib.php: call to assign->save_submission() line 503 of /mod/assign/locallib.php: call to assign->process_save_submission() line 55 of /mod/assign/view.php: call to assign->view() Error calling message processor email line 507 of /lib/classes/message/manager.php: call to debugging() line 382 of /lib/classes/message/manager.php: call to core\message\manager::call_processors() line 349 of /lib/classes/message/manager.php: call to core\message\manager::send_message_to_processors() line 341 of /lib/messagelib.php: call to core\message\manager::send_message() line 6661 of /mod/assign/locallib.php: call to message_send() line 6689 of /mod/assign/locallib.php: call to assign::send_assignment_notification() line 6742 of /mod/assign/locallib.php: call to assign->send_notification() line 7743 of /mod/assign/locallib.php: call to assign->notify_student_submission_receipt() line 7780 of /mod/assign/locallib.php: call to assign->save_submission() line 503 of /mod/assign/locallib.php: call to assign->process_save_submission() line 55 of /mod/assign/view.php: call to assign->view()