git_tg

README.md

@@ -41,7 +41,7 @@
 
 ## 1. Введение
 
-## 1.1. Область применения
+### 1.1. Область применения
 
 «ИИ-Академия» применяется в корпоративной среде для автоматизации процессов обучения и оценки компетенций персонала. Система обеспечивает интерактивное взаимодействие сотрудника с ИИ-наставником в формате диалоговых тренажёров и позволяет HR-подразделениям отслеживать прогресс и формировать аналитику.
 
@@ -53,7 +53,7 @@
 - Оценка уровня освоения корпоративных компетенций.
 - HR-аналитика по отделам и отдельным сотрудникам.
 
-## 1.2. Краткое описание возможностей
+### 1.2. Краткое описание возможностей
 
 «ИИ-Академия» предоставляет следующие возможности:
 
@@ -66,7 +66,7 @@
 - **Журнал событий** — аудит всех действий пользователей (для администратора).
 - **Ролевая модель** — три уровня доступа: `employee` / `hr` / `admin`.
 
-## 1.3. Уровень подготовки пользователя
+### 1.3. Уровень подготовки пользователя
 
 Пользователь должен обладать следующими знаниями и навыками:
 
@@ -74,7 +74,7 @@
 - Для **HR-менеджера**: знание структуры отделов и перечня сотрудников организации.
 - Для **администратора**: базовые навыки администрирования Linux-систем, знание PostgreSQL, опыт работы с командной строкой (`bash`, `pip`, `npm`).
 
-## 1.4. Перечень эксплуатационной документации
+### 1.4. Перечень эксплуатационной документации
 
 При эксплуатации системы «ИИ-Академия» следует руководствоваться:
 
@@ -111,7 +111,7 @@
 
 ## 3. Подготовка к работе
 
-## 3.1. Состав и содержание дистрибутивного носителя данных
+### 3.1. Состав и содержание дистрибутивного носителя данных
 
 Исходный код системы размещён в репозитории: https://gogs.itiscaf.ru/varukhin_na/ii-academy
 
@@ -140,7 +140,7 @@ ii-academy/
 └── README.md
 ```
 
-## 3.2. Порядок загрузки данных и программ
+### 3.2. Порядок загрузки данных и программ
 
 - [ ] **3.2.1. Получение исходного кода**
 
@@ -194,7 +194,7 @@ ng serve --open
 
 Приложение откроется по адресу: `http://localhost:4200`
 
-## 3.3. Порядок проверки работоспособности
+### 3.3. Порядок проверки работоспособности
 
 **1. Проверка бэкенда:**
 
@@ -229,7 +229,7 @@ pytest tests/test_platform.py -v
 
 ## 4. Описание операций
 
-## 4.1. Вход в систему
+### 4.1. Вход в систему
 
 Откройте браузер и перейдите по адресу `http://localhost:4200`. На странице входа введите корпоративный email и пароль, затем нажмите кнопку **«Войти»**.
 
@@ -237,7 +237,7 @@ pytest tests/test_platform.py -v
 
 При успешной аутентификации система перенаправит вас на дашборд в соответствии с вашей ролью.
 
-## 4.2. Прохождение диалогового тренинга
+### 4.2. Прохождение диалогового тренинга
 
 1. Перейдите в раздел **«Мои задания»**.
 2. Выберите назначенное задание и нажмите **«Начать»**.
@@ -277,7 +277,7 @@ reply = httpx.post(
 print(reply["ai_response"])
 ```
 
-## 4.3. Просмотр карты навыков
+### 4.3. Просмотр карты навыков
 
 В разделе **«Карта навыков»** отображается прогресс освоения всех компетенций. Каждый навык имеет статус:
 
@@ -287,7 +287,7 @@ print(reply["ai_response"])
 
 ![Карта навыков](screenshots/skill_map.png)
 
-## 4.4. Назначение заданий (HR)
+### 4.4. Назначение заданий (HR)
 
 1. Перейдите в **«HR-дашборд»** → **«Управление заданиями»**.
 2. Нажмите **«Назначить задание»**.
@@ -297,13 +297,13 @@ print(reply["ai_response"])
 
 ![Форма назначения задания](screenshots/hr_assign.png)
 
-## 4.5. Формирование отчётов (HR)
+### 4.5. Формирование отчётов (HR)
 
 Перейдите в **«HR-дашборд»** → **«Отчёты»**, выберите сотрудника или отдел, укажите период и нажмите **«Сгенерировать»**. Готовый отчёт можно скачать в форматах **PDF** или **DOCX**.
 
 ![Страница отчётов](screenshots/reports.png)
 
-## 4.6. Управление пользователями (Администратор)
+### 4.6. Управление пользователями (Администратор)
 
 Раздел **«Администрирование»** → **«Пользователи»** позволяет:
 
@@ -319,7 +319,7 @@ print(reply["ai_response"])
 
 ## 5. Аварийные ситуации
 
-## 5.1. Бэкенд-сервер недоступен
+### 5.1. Бэкенд-сервер недоступен
 
 **Симптом:** страница входа не открывается, браузер показывает ошибку подключения.
 
@@ -329,7 +329,7 @@ print(reply["ai_response"])
 3. Проверьте подключение к базе данных в файле `.env`.
 4. Перезапустите сервер: `uvicorn main:app --host 0.0.0.0 --port 8000 --reload`.
 
-## 5.2. Ошибка «Неверный логин или пароль»
+### 5.2. Ошибка «Неверный логин или пароль»
 
 **Симптом:** при вводе корректных данных система возвращает ошибку аутентификации.
 
@@ -338,7 +338,7 @@ print(reply["ai_response"])
 2. Убедитесь, что учётная запись активна — обратитесь к администратору.
 3. Администратор может сбросить пароль через раздел «Управление пользователями».
 
-## 5.3. ИИ-наставник не отвечает
+### 5.3. ИИ-наставник не отвечает
 
 **Симптом:** после отправки сообщения в тренажёре индикатор загрузки крутится более 30 секунд.
 
@@ -347,7 +347,7 @@ print(reply["ai_response"])
 2. Убедитесь в корректности ключа `GIGACHAT_AUTH_KEY` (или ключа OpenAI).
 3. Для быстрой проверки временно установите `LLM_PROVIDER=mock` — это включит демо-режим без реального ИИ.
 
-## 5.4. Отчёт не формируется
+### 5.4. Отчёт не формируется
 
 **Симптом:** при нажатии «Сгенерировать» кнопка неактивна или появляется ошибка.
 
@@ -355,7 +355,7 @@ print(reply["ai_response"])
 1. Убедитесь, что у выбранного сотрудника есть хотя бы одна завершённая диалоговая сессия.
 2. Проверьте, что в системе установлены библиотеки `reportlab` и `python-docx` (входят в `requirements.txt`).
 
-## 5.5. Белый экран после входа
+### 5.5. Белый экран после входа
 
 **Симптом:** после успешного входа отображается белая страница без содержимого.