ТРЕНАЖЁР ТЕРМИНОВ
Информация, необходимая для установки и эксплуатации программного обеспечения
Версия 1.0

Правообладатель:  ИП Котов Дмитрий Анатольевич
ИНН:              250600153888
Контакты:         +7 (985) 767-08-05, trgp@ya.ru

  Консольная программа для запоминания терминов.
  На экране — определение, нужно выбрать правильный термин из списка.

------------------------------------------------------------------------
  СОДЕРЖАНИЕ
------------------------------------------------------------------------

    1.  Что нужно для работы
    2.  Установка Python
    3.  Подготовка к запуску
    4.  Запуск программы
    5.  Порядок работы
    6.  Прогресс и словарь
    7.  Частые проблемы
    8.  Краткая памятка


------------------------------------------------------------------------
  1.  ЧТО НУЖНО ДЛЯ РАБОТЫ
------------------------------------------------------------------------

  Требования

    Python      версия 3.8 или новее (рекомендуется 3.10+)
    Библиотеки  не нужны
    Интернет    не нужен

  Проверка версии Python

    Linux / Astra / ALT / Ред ОС     python3 --version
    Windows                          python --version

  Состав комплекта (ZIP-архив)

    trainer.py                                      программа
    dictionary.md                                   словарь
    help.txt                                        руководство
    doc/Описание_функциональных_характеристик.pdf  документация
    doc/Описание_технической_архитектуры.pdf        документация
    doc/Описание_хранения_исходного_кода.pdf        документация
    doc/Описание_сопровождения_и_жизненного_цикла.pdf  документация
    doc/Сведения_об_исключительном_праве.pdf           право
    doc/Лицензионное_соглашение_для_юридических_лиц.pdf  лицензия (юрлица)
    doc/Класс_ПО_12.17.pdf                            класс по классификатору Минцифры

    Класс ПО (классификатор Минцифры, пр. № 486): 12.17
    «Программное обеспечение для решения отраслевых задач в области образования»
    Раздел 12 — отраслевое прикладное программное обеспечение.

    Для работы программы достаточно trainer.py и dictionary.md.
    Файл dictionary.md нужен с правом записи — в него сохраняется
    прогресс обучения.


------------------------------------------------------------------------
  2.  УСТАНОВКА PYTHON
------------------------------------------------------------------------

  Windows

    1.  Скачать установщик:  https://www.python.org/downloads/
    2.  При установке включить:  Add Python to PATH
    3.  Проверить в терминале:  python --version

  Astra Linux / ALT Linux

    sudo apt update
    sudo apt install python3

  Ред ОС

    sudo dnf install python3


------------------------------------------------------------------------
  3.  ПОДГОТОВКА К ЗАПУСКУ
------------------------------------------------------------------------

  Для корректного отображения кириллицы в консоли нужна кодировка UTF-8.

  Linux — выполнить перед запуском:

    export LANG=ru_RU.UTF-8
    export LC_ALL=ru_RU.UTF-8

  Windows — обычно достаточно Windows Terminal или PowerShell.


------------------------------------------------------------------------
  4.  ЗАПУСК ПРОГРАММЫ
------------------------------------------------------------------------

  Linux / Astra / ALT / Ред ОС

    cd /путь/к/папке
    python3 trainer.py

  Windows

    cd C:\путь\к\папке
    python trainer.py

  Прервать работу:  Ctrl+C


------------------------------------------------------------------------
  5.  ПОРЯДОК РАБОТЫ
------------------------------------------------------------------------

  Шаг 1.  Вопрос

    Программа показывает определение и нумерованный список терминов
    (до 5 вариантов, один правильный).
    Если остался последний неизученный термин — показывается один вариант.

  Шаг 2.  Ответ

    Введите номер строки и нажмите Enter.

  Шаг 3.  Если ответ верный

    -  появится сообщение «Верно!»
    -  термин помечается в dictionary.md  (строка ### ... → +### ...)
    -  этот термин больше не попадает в вопросы
    -  выводится строка «Осталось изучить: N из M»

  Шаг 4.  Если ответ неверный

    -  появится сообщение «Неверно.»
    -  сразу показывается следующий вопрос

  Шаг 5.  Завершение

    Когда все термины изучены:
    -  «Изучение завершено. Все термины пройдены.»
    -  нажмите Enter — программа закроется


------------------------------------------------------------------------
  6.  ПРОГРЕСС И СЛОВАРЬ
------------------------------------------------------------------------

  Прогресс хранится в файле dictionary.md (в той же папке, что trainer.py).

  Пример пометки изученного термина:

    было:    ### Ликвидность
    стало:   +### Ликвидность

  Чтобы пройти словарь заново — удалите символ + у нужных строк
  или восстановите dictionary.md из резервной копии.


------------------------------------------------------------------------
  7.  ЧАСТЫЕ ПРОБЛЕМЫ
------------------------------------------------------------------------

  python3: command not found
      →  Установите пакет python3 (раздел 2).

  Не найден словарь
      →  Положите dictionary.md в ту же папку, что и trainer.py.

  Нечитаемый русский текст («кракозябры»)
      →  Настройте UTF-8 (раздел 3).

  Ошибка записи в словарь
      →  Снимите атрибут «только чтение» с dictionary.md.

  Окно сразу закрывается
      →  Запускайте программу из терминала, а не двойным щелчком.


------------------------------------------------------------------------
  8.  КРАТКАЯ ПАМЯТКА
------------------------------------------------------------------------

    1.  Установить Python 3.8+
    2.  Положить trainer.py и dictionary.md в одну папку
    3.  Запустить:  python3 trainer.py   (Windows: python trainer.py)
    4.  Читать определение → ввести номер → Enter
    5.  В конце нажать Enter для выхода

------------------------------------------------------------------------
