Руководство пользователя АПС «Ноэсис»

Версия документа: 1.2 · Версия продукта: 0.11.0
© Лосев Андрей Васильевич
Реестр БД: свидетельство о государственной регистрации № 2026622608

Содержание

1. О системе
2. Установка и первый запуск
3. Вход в систему и интерфейс
4. Главная страница
5. Библиотека методик
6. Клиенты
7. Календарь и подготовка к приёму
8. Проведение обследования
9. Распознавание бланков
10. Результаты и журнал
11. Отчёты и заключения
12. Аналитика и психометрика
13. Справочники
14. Профиль и безопасность
15. Администрирование
16. Горячие клавиши и советы
17. Устранение неполадок
18. Правовые сведения

1. О системе

АПС «Ноэсис» (Noesis Shell) — автоматизированная психодиагностическая система для:

• проведения психологических обследований;
• интерпретации результатов по встроенным правилам;
• ведения карточек клиентов и динамики показателей;
• планирования приёмов и подготовки к сессиям;
• формирования заключений и отчётов;
• исследовательской аналитики и психометрики.

Ключевой принцип

Оболочка отделена от контента: ядро системы не содержит конкретных методик. Методики подключаются как контентные пакеты без изменения программного кода. Это позволяет обновлять библиотеку методик независимо от версии оболочки.

Режим работы

Десктопная версия работает локально и офлайн:

• на компьютере запускается встроенный сервер (адрес 127.0.0.1, порт по умолчанию 8765);
• интерфейс открывается в браузере по адресу http://127.0.0.1:8765/app;
• данные хранятся на диске пользователя; для работы не требуется постоянное подключение к интернету.

Роли пользователей

Конкретный набор доступных разделов зависит от назначенной роли.

2. Установка и первый запуск

2.1. Системные требования

2.2. Установка на macOS

1. Откройте файл .dmg и перетащите Noesis.app в папку «Программы».
2. При первом запуске неподписанной сборки macOS может заблокировать приложение. Варианты:

• правый клик по Noesis.app → Открыть → Открыть;
• или в Терминале: xattr -dr com.apple.quarantine /Applications/Noesis.app

3. Положите файл лицензии в каталог данных (см. ниже).

2.3. Установка на Windows

1. Запустите установщик Noesis-Setup-*.exe или распакуйте портативный архив Noesis-Portable-*.zip.
2. При установке без прав администратора выберите режим «только для меня».
3. Мастер установки может предложить указать файл лицензии — при отказе положите его вручную в каталог данных.

2.4. Файл лицензии

Лицензия — файл license.noesislic, выдаваемый правообладателем.

При отсутствии или просрочке лицензии программа покажет диалог с пояснением и откроет папку, куда нужно положить файл.

2.5. Каталог данных пользователя

Содержимое каталога:

Важно: удаление программы из «Программ» не удаляет каталог данных. База и лицензия сохраняются.

2.6. Запуск программы

1. Дважды щёлкните по ярлыку Ноэсис.
2. Появится окно ожидания: «Запуск АПС «Ноэсис»…» → «Проверка лицензии…» → «Подготовка базы данных…» → «Открытие интерфейса…».
3. При задержке более 1 секунды отображается: «Подождите, идёт формирование системы диагностики…».
4. Автоматически откроется браузер с интерфейсом системы.

После закрытия браузера программа продолжает работать в фоне. Чтобы снова открыть интерфейс:

• macOS: кликните по иконке «Ноэсис» в Dock;
• Windows: запустите ярлык повторно;
• для полного выхода на macOS: Cmd+Q или меню Ноэсис → Завершить.

Повторный запуск ярлыка, пока сервер уже работает, просто откроет браузер заново — второй экземпляр сервера не создаётся.

2.7. Первый вход в систему

При первом запуске на пустой базе отображается форма «Создание администратора»:

1. Укажите e-mail (будет логином).
2. Задайте пароль (не менее 8 символов).
3. Нажмите Создать.

При последующих запусках — форма «Вход в систему»:

1. Введите e-mail и пароль.
2. При включённой двухфакторной аутентификации (2FA) — код из приложения-аутентификатора.
3. Нажмите Войти.

3. Вход в систему и интерфейс

3.1. Верхнее меню

Шапка занимает две строки: сверху — бренд «НОЭСИС», поиск и инструменты (Аа, справка, профиль); снизу — пункты разделов на всю ширину окна.

На большинстве экранов доступны разделы:

3.2. Правая часть шапки

• «Сегодня: N» — число приёмов на сегодня (клик → календарь).
• Чип роли и e-mail — текущий пользователь.
• Профиль — смена пароля, 2FA.
• Выйти — завершение сеанса работы в браузере.

3.3. Инструменты оболочки

3.4. Доступность

Ссылка «Перейти к содержимому» в начале страницы (активируется клавишей Tab) позволяет сразу перейти к основному содержимому, минуя навигацию.

4. Главная страница

После входа открывается раздел «Рабочее пространство».

4.1. Сводные показатели

Кликабельные карточки в верхней части:

• методик в библиотеке → Библиотека;
• источников в реестре → реестр научных источников;
• отчёты и заключения → раздел отчётов.

4.2. Виджет «Сегодня»

Список приёмов на текущий день с метками:

• Сейчас — приём в ближайшее время;
• Требует подтверждения;
• Не подтверждён.

Ссылка «Подготовка →» ведёт на экран подготовки к сессии (/prep).

4.3. Дашборд

• Незавершённые сессии — продолжить начатое обследование.
• Последние результаты — быстрый переход к результату.
• Быстрый старт: ссылки на Клиенты, Календарь, Библиотеку.

4.4. История использования методик

График топ-методик за последние 6 месяцев по числу проведённых сессий. Клик по методике → Библиотека с фильтром.

4.5. Блок «Проведение и результаты»

Карточки-ссылки: Библиотека методик · Карточки клиентов · Провести обследование · Результат обследования · Журнал обследований · Многомерная аналитика.

5. Библиотека методик

Раздел «Библиотека методик» (/library) — каталог всех подключённых пакетов методик.

5.1. Фильтры (левая панель)

Дополнительно:

• «Скрывать неготовые» — включён по умолчанию; скрывает методики без полного комплекта (шкалы, нормы, интерпретатор). Настройка сохраняется в браузере.
• «Сбросить фильтры» — вернуть значения по умолчанию.

5.2. Поиск и действия

• Поиск по названию или коду методики (работает вместе с фильтрами).
• ▣ Распознать бланки — переход к пакетному распознаванию (/blanks).
• (только администратор) ⟳ Обновить методики из пакета — импорт новых версий пакетов.
• (только администратор) ↻ Переобработать все результаты — пересчёт интерпретаций.

5.3. Карточка методики в списке

На каждой карточке отображаются:

• название, код, тип;
• число пунктов, примерное время прохождения;
• бейджи: не готова, доказательная база.

Кнопки:

5.4. Модальное окно «Подробнее»

Секции: готовность (шкалы, пункты, нормы, интерпретатор, источники), список шкал, библиографические источники.

Кнопки внизу окна:

5.5. Типовой сценарий: провести обследование из библиотеки

1. Найдите методику (фильтры + поиск).
2. Убедитесь, что нет бейджа «не готова».
3. Нажмите Провести (на карточке или в модальном окне).
4. На экране обследования выберите клиента и начните прохождение (см. раздел 8).

6. Клиенты

6.1. Реестр клиентов (/subjects)

Заголовок: «Клиенты».

Панель управления

• Поиск по ФИО или идентификатору.
• Фильтр статуса: Все · Новый · В работе · Обследован · Архив.
• Чекбокс «Обезличенно» — скрывает персональные данные (режим 152-ФЗ).
• + Новая карточка — создать клиента.

Действия в строке клиента

Массовые действия

Отметьте чекбоксы у нескольких клиентов → Свести по выбранным · PDF / DOCX / Снять выбор.

Создание и редактирование карточки

Поля: Фамилия, Имя, Отчество, Идентификатор (псевдоним), Дата рождения, Пол, Статус, Обезличенная карточка, Примечание.

Кнопки: Удалить · Отмена · Сохранить.

Важно: удаление карточки недоступно, если к ней привязаны сессии обследования. Вместо удаления установите статус «Архив».

6.2. Карточка клиента (/subject)

Открывается по ссылке Динамика или клику по строке в реестре.

Кнопки шапки

• Начать обследование — выбор методики и запуск.
• Распознать бланки — пакетное распознавание с автопривязкой к этому клиенту.
• Скачать историю (PDF/DOCX) — экспорт всей истории.

Вкладки

Сводный отчёт

Выберите сессии на вкладке «История результатов» → Свести в отчёт · PDF или DOCX.

7. Календарь и подготовка к приёму

7.1. Календарь (/calendar)

Календарь приёмов на базе FullCalendar (русская локаль, работает офлайн).

Виды отображения

День · Неделя · Месяц · Список.

Фильтры

• Статус: запланирован, подтверждён, завершён, отменён, неявка.
• Специалист (при нескольких пользователях).

Действия

• Обновить — перезагрузить данные.
• Экспорт CSV — выгрузка расписания.
• Печать — печатная версия.

Работа с записями

• Клик по свободному слоту → форма «Новый приём» (клиент, вид приёма, время, методики, пометка).
• Перетаскивание записи — перенос времени.
• Клик по записи — просмотр и редактирование.

Цвета по виду приёма: консультация, семейная, диагностика, выезд, супервизия. Пунктирная рамка — неподтверждённый приём.

7.2. Подготовка к сессии (/prep)

Открывается из виджета «Сегодня» или по ссылке с ?appointment_id=….

Содержание экрана:

• Таймер сессии: Старт · Пауза · Стоп.
• Контекст клиента: последняя запись, задания, план работы.
• Последние результаты обследований.
• ИПО — непокрытые диагностические домены.

Действия:

• Создать сессии по плану — запустить обследования из плана работы.
• Новая запись — добавить заметку консультации.
• Подтвердить оплату — отметить финансовый статус приёма.

8. Проведение обследования

Экран «Проведение обследования» (/assess) — основной рабочий процесс диагностики.

8.1. Мастер старта

В режиме «Самостоятельно» испытуемому не показывается клиническое заключение.

8.2. Инструкции

Перед началом отображается текст инструкции для испытуемого и специалиста. Для некоторых методик (например, ТАТ) — выбор набора таблиц (пол / возраст).

Кнопки: ← Назад · Начать →

8.3. Прохождение пунктов

• Пункты предъявляются по одному с вариантами ответа.
• Время реакции (RT) фиксируется автоматически.
• Подсказка: «Выберите ответ (мышью или клавишами 1–9). Назад — клавиша «←»».
• На экране прохождения доступны локальные А− / А+ / ◐ (размер шрифта и контраст).
• Кнопки ← Назад · Далее →.

Для проективных, наблюдательных и специальных методик используются отдельные экраны ввода (см. раздел 8.4).

8.4. Специализированные экраны ввода

Экран открывается автоматически при старте соответствующей методики или по кнопке Экран ввода в карточке методики.

8.5. Завершение

• Ответы сохраняются в сессию автоматически.
• По завершении — переход к результату (/result?sid=…).

9. Распознавание бланков

Система поддерживает OMR (оптическое распознавание меток) на отсканированных или сфотографированных бланках. Бланки нового формата содержат идентификационную полосу (v2), позволяющую автоматически определить методику, пол и номер страницы.

9.1. Когда что использовать

9.2. Одиночное распознавание (/blank_scan)

Пошагово:

1. Выберите методику (предзаполняется из URL ?method=КОД).
2. Выберите вариант текста: мужской / женский.
3. Загрузите файлы: PDF или изображения (все страницы одного бланка).
4. Нажмите Распознать.
5. Проверьте таблицу результатов (пункт · ответ · статус).
6. При необходимости: Скопировать ответы (JSON).
7. Назначьте испытуемого (или ＋ Новый испытуемый).
8. Нажмите Создать обследование и рассчитать → переход к результату.

9.3. Пакетное распознавание (/blanks)

Пошагово:

1. Перетащите файлы в зону загрузки или выберите через диалог. Поддерживаются PDF и изображения; можно загрузить несколько файлов сразу.
2. Нажмите Распознать пачку.
3. Система разложит страницы по экземплярам бланков.

Статусы экземпляров

Действия на карточке экземпляра

• Выбор клиента из списка.
• Проверить — таблица пункт / ответ / статус для ручной корректировки.
• Создать обследование — для одного экземпляра.
• Создать обследования для всех готовых — массовое создание.

Управление страницами

• Перетаскивание чипов «стр.N» между карточками экземпляров.
• Двойной клик по чипу — изменить номер страницы.
• + Новый экземпляр — создать пустой бланк (выбор методики и пола).

Неопознанные страницы

Страницы старых бланков (без полосы v2) попадают в блок «Неопознанные страницы»:

• Укажите методику, пол и номер страницы вручную.
• Распознать страницу — попытка OMR с заданными параметрами.
• В новый экземпляр — добавить на новую карточку.
• Исключить — убрать из обработки.
• Собрать все страницы — объединить все неопознанные в один бланк (с выбором методики и пола).

Параметры URL

• ?method=КОД — подсказка методики при создании экземпляра.
• ?subject_id=ID — предзаполнение клиента.
• ?gender=male|female — предзаполнение пола.

9.4. Печать бланков

PDF бланка для заполнения от руки: Библиотека → Подробнее → Печать бланка.

Рекомендации для качественного распознавания:

• сканирование или фото при хорошем освещении;
• бланк полностью в кадре, без сильного наклона;
• чёткие метки в кружках (закрашенный кружок, не галочка);
• для многостраничных бланков — все страницы в одной загрузке.

10. Результаты и журнал

10.1. Просмотр результата (/result)

Открытие результата:

• Введите ID сессии и нажмите Открыть;
• или перейдите по ссылке из журнала, дашборда или после завершения обследования.

Содержание экрана:

Экспорт (боковая панель): PDF · DOCX · XLSX · CSV · HTML · JSON.

Дополнительные действия:

• Обновить интерпретацию — пересчёт по актуальным нормам и правилам.
• Свести в отчёт · PDF/DOCX — объединить несколько сессий одного клиента.
• ← Все обследования — календарный браузер сессий.

10.2. Журнал по методике (/journal)

«Результаты по методике» — таблица всех сессий по выбранной методике.

• Фильтры по статусу и периоду.
• Режим обезличивания (скрытие ФИО).
• Действия в строке: Результат · Продолжить (для незавершённых) · PDF.

Открывается из библиотеки кнопкой Журнал на карточке методики.

11. Отчёты и заключения

Раздел «Отчёты и заключения» (/reports) — конструктор документов для клинической и исследовательской отчётности.

11.1. Вкладки

11.2. Конструктор состава документа

1. Выберите испытуемого.
2. Выберите сессию с результатом (основное обследование).
3. При необходимости отметьте дополнительные обследования (мультивыбор).
4. Включите дополнительные разделы:

• ☑ Сводный отчёт по всем обследованиям клиента
• ☑ Выписка из календаря приёмов за период
• ☑ Записи консультаций (только ваши записи)

5. Нажмите Предпросмотр · Скачать PDF · Скачать DOCX.

Без выбора дополнительных разделов документ формируется в стандартном составе.

11.3. Реквизиты

Заполните данные организации и специалиста один раз — они подставляются во все шаблоны автоматически.

12. Аналитика и психометрика

12.1. Многомерная аналитика (/analytics)

Мастер из 4 шагов: Задача → Метод → Данные → Результат.

Доступные задачи

Параметры: код методики, число факторов / кластеров.

Действия: Анализировать · Сохранить как отчёт.

Для демонстрации факторного/кластерного анализа при малой реальной выборке администратор может загрузить синтетический демо-набор кнопкой «Демо-выборка» на экране (~120 завершённых сессий с пометкой демо-набора). Данные не клинические; удаляются кнопкой «Удалить демо».

12.2. Психодиагностика методики (/psychometrics)

Открывается из библиотеки: Подробнее → Психодиагностика.

• Описательная статистика по шкалам.
• Пересчитать — обновить показатели.
• Анализ пунктов — дискриминативность, сложность.
• Построить нормы из выборки → Подтвердить сохранение.

13. Справочники

13.1. Нейропсихология (/neuropsy)

Справочник NPS-DB: синдромы и симптомы нейропсихологической диагностики.

• Поиск по названию.
• Фильтры по категориям.
• Экспорт выбранных записей в PDF.

13.2. Логопедия (/logoped)

Справочник ЛогоБД: методы диагностики и коррекции.

• Фильтры по возрасту, направлению, типу нарушения.
• Раздел «Зоны пересечения с БД медпсихологии» — связи с психодиагностическими конструктами.

14. Профиль и безопасность

Раздел «Профиль и безопасность» (/profile).

14.1. Смена пароля

1. Введите текущий пароль.
2. Введите новый пароль (не менее 8 символов).
3. Подтвердите новый пароль.
4. Нажмите Сохранить.

14.2. Двухфакторная аутентификация (2FA)

Подключение:

1. Нажмите Подключить 2FA.
2. Отсканируйте QR-код приложением-аутентификатором (Google Authenticator, Authy и др.).
3. Введите код подтверждения.

Отключение: введите текущий код → Отключить 2FA.

15. Администрирование

Раздел «О программе и администрирование» содержит сведения о лицензии и вход в административные функции (видны пользователям с ролью admin / superadmin).

Краткий обзор для специалистов ИТ организации — в руководстве администратора.

15.1. Пользователи и доступ

• Таблица: E-mail, роль, организация, активность, 2FA.
• Создание пользователя и (при наличии прав) организации.
• Редактирование роли, пароля, активности.

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

• Ротация ключей шифрования персональных данных (AES-256-GCM).
• Профили доступа (стандартный / ограниченный) и защищённости.
• Разрешённые IP-адреса (CIDR).
• Журнал аудита — экспорт, проверка целостности.

15.3. Обновление методик

В библиотеке (роль admin): ⟳ Обновить методики из пакета.

15.4. Авторинг методик

Для ролей с правом авторинга доступен мастер создания и публикации контентных пакетов: подбор источников, сборка пакета, редактор правил интерпретации, верификация и публикация версии, а также сверка текстов.

16. Горячие клавиши и советы

16.1. Горячие клавиши

16.2. Полезные советы

• Фильтр «Скрывать неготовые» в библиотеке включён по умолчанию — снимите, если нужно увидеть методики в разработке.
• Удаление клиента с сессиями невозможно — используйте статус «Архив».
• В отчётах записи консультаций включаются только ваши (не коллег).
• Токен авторизации продлевается автоматически при работе — повторный вход не требуется.
• Повторный клик по ярлыку программы открывает интерфейс, если сервер уже запущен.
• На macOS после закрытия браузера клик по иконке в Dock снова откроет интерфейс.

17. Устранение неполадок

17.1. Программа не запускается (macOS)

1. Запустите из Терминала для диагностики:

/Applications/Noesis.app/Contents/MacOS/Noesis

2. Проверьте лог:

~/Library/Application Support/Noesis/logs/noesis.log

3. Чаще всего: отсутствует license.noesislic — положите файл в каталог данных.
4. Gatekeeper блокирует: xattr -dr com.apple.quarantine /Applications/Noesis.app
5. Порт 8765 занят: запустите с другим портом:

NOESIS_PORT=8790 /Applications/Noesis.app/Contents/MacOS/Noesis

17.2. Программа не запускается (Windows)

1. Лог: %APPDATA%\Noesis\logs\noesis.log
2. Лицензия: %APPDATA%\Noesis\license.noesislic
3. Антивирус может блокировать Noesis.exe — добавьте в исключения.

17.3. Окно ожидания зависло

Подождите до 2 минут — при первом запуске идёт подготовка базы и импорт методик. Если браузер не открылся — проверьте лог (п. 17.1 / 17.2).

17.4. Иконка в Dock / трее не реагирует

Убедитесь, что установлена актуальная сборка (метка сборки указана в журнале). Если проблема сохраняется — переустановите программу из официального дистрибутива или обратитесь в поддержку.

17.5. Сессия истекла

Появится сообщение «Сессия истекла, войдите снова» — перейдите на /app и авторизуйтесь заново. Несохранённые данные в открытых формах могут быть потеряны.

17.6. Методика «не готова»

В библиотеке отображается бейдж «не готова». Причины: отсутствуют шкалы, нормы, интерпретатор или стимулы. Снимите фильтр «Скрывать неготовые» для просмотра. Администратор может выполнить Обновить методики из пакета.

17.7. Плохое распознавание бланка

• Проверьте качество скана (резкость, освещение, положение бланка).
• Убедитесь, что используется актуальный бланк с идентификационной полосой (v2).
• Для старых бланков используйте ручное назначение на экране /blanks.
• Проверьте правильность выбора пола (мужской / женский вариант текста).

17.8. Где искать помощь

• О программе — краткие разделы справки и статус лицензии.
• Кнопка ? в шапке — подсказки по текущему экрану.
• Журнал: logs/noesis.log в каталоге данных.
• Руководство администратора (обзор для ИТ) и контакты на сайте продаж.

18. Правовые сведения

18.1. Лицензионное соглашение (EULA)

Программа предоставляется правообладателем (Лосев А. В.) на условиях лицензии. Разрешается использование в пределах приобретённой редакции и числа рабочих мест.

Запрещается:

• модификация и декомпиляция программы;
• удаление атрибуции реестра № 2026622608;
• распространение методического наполнения без согласия правообладателя.

18.2. Результаты диагностики

Результаты обследования носят вспомогательный характер и подлежат профессиональной интерпретации квалифицированным специалистом. Система не заменяет клиническое суждение.

18.3. Персональные данные

Обработка персональных данных ведётся в соответствии с 152-ФЗ. За корректность правовых оснований обработки отвечает организация-пользователь.

Система поддерживает:

• шифрование персональных данных;
• режим обезличивания при отображении и экспорте;
• профили доступа standard / restricted;
• тамперозащищённый журнал аудита.

18.4. Атрибуция реестра

Свидетельство о государственной регистрации базы данных № 2026622608 проставляется во всех формируемых отчётах и документах и не может быть отключена.

© Лосев Андрей Васильевич. АПС «Ноэсис».