1 stage front refactoring
This commit is contained in:
itqop
parent
6e29b2e6df
commit
fc2eeb82ca
|
|
@ -0,0 +1,325 @@
|
||||||
|
# Рефакторинг app.js → Модули: Прогресс
|
||||||
|
|
||||||
|
**Дата начала**: 2025-12-25
|
||||||
|
**Стратегия**: Постепенная миграция (app.js остаётся рабочим)
|
||||||
|
**Статус**: 🟡 В процессе
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📊 Общий прогресс: 20%
|
||||||
|
|
||||||
|
```
|
||||||
|
[████░░░░░░░░░░░░░░░░] 20% завершено
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Этапы рефакторинга
|
||||||
|
|
||||||
|
### ✅ Этап 1: Подготовка (ЗАВЕРШЁН)
|
||||||
|
|
||||||
|
**Дата**: 2025-12-25
|
||||||
|
**Статус**: ✅ Готово
|
||||||
|
|
||||||
|
- [x] Создать структуру папок `static/js/`
|
||||||
|
- [x] `js/state/`
|
||||||
|
- [x] `js/services/`
|
||||||
|
- [x] `js/ui/`
|
||||||
|
- [x] `js/utils/`
|
||||||
|
- [x] `js/data/`
|
||||||
|
- [x] Создать `js/config.js` с константами
|
||||||
|
|
||||||
|
**Результат**: Структура готова, app.js не тронут ✅
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### ✅ Этап 2: Утилиты (ЗАВЕРШЁН)
|
||||||
|
|
||||||
|
**Дата**: 2025-12-25
|
||||||
|
**Статус**: ✅ Готово
|
||||||
|
|
||||||
|
#### 2.1. utils/format.utils.js ✅
|
||||||
|
**Строки из app.js**: 150-273
|
||||||
|
**Функции** (11 шт.):
|
||||||
|
- [x] `generateUUID()` - генерация UUID
|
||||||
|
- [x] `formatTime(seconds)` - форматирование времени
|
||||||
|
- [x] `formatTimestamp(isoString)` - ISO → локальное время
|
||||||
|
- [x] `isTableText(text)` - проверка на таблицу
|
||||||
|
- [x] `parseTextTable(text)` - парсинг текстовых таблиц
|
||||||
|
- [x] `escapeHtml(text)` - экранирование HTML
|
||||||
|
- [x] `pluralize(count, one, few, many)` - склонение числительных
|
||||||
|
|
||||||
|
**Экспорт**: ES6 named exports ✅
|
||||||
|
|
||||||
|
#### 2.2. utils/file.utils.js ✅
|
||||||
|
**Строки из app.js**: 262-273, 984-1132
|
||||||
|
**Функции** (6 шт.):
|
||||||
|
- [x] `downloadJSON(data, filename)` - скачать JSON
|
||||||
|
- [x] `loadFileAsJSON(file)` - загрузить JSON
|
||||||
|
- [x] `loadFileAsText(file)` - загрузить текст
|
||||||
|
- [x] `selectFile(accept)` - выбрать файл
|
||||||
|
- [x] `downloadText(text, filename)` - скачать текст
|
||||||
|
|
||||||
|
**Экспорт**: ES6 named exports ✅
|
||||||
|
|
||||||
|
#### 2.3. utils/validation.utils.js ✅
|
||||||
|
**Строки из app.js**: 823-860
|
||||||
|
**Функции** (4 шт.):
|
||||||
|
- [x] `validateJSON(jsonString)` - валидация JSON
|
||||||
|
- [x] `validateLoginFormat(login)` - проверка формата логина (8 цифр)
|
||||||
|
- [x] `validateQuestions(questions)` - валидация массива вопросов
|
||||||
|
- [x] `validateEnvironment(environment)` - проверка окружения
|
||||||
|
|
||||||
|
**Экспорт**: ES6 named exports ✅
|
||||||
|
|
||||||
|
#### 2.4. utils/dom.utils.js ✅
|
||||||
|
**Строки из app.js**: 277-281 + новые
|
||||||
|
**Функции** (15 шт.):
|
||||||
|
- [x] `showElement(element)` - показать элемент
|
||||||
|
- [x] `hideElement(element)` - скрыть элемент
|
||||||
|
- [x] `toggleElement(element)` - переключить видимость
|
||||||
|
- [x] `setElementText(element, text)` - установить текст
|
||||||
|
- [x] `setElementHTML(element, html)` - установить HTML
|
||||||
|
- [x] `getInputValue(element)` - получить значение input
|
||||||
|
- [x] `setInputValue(element, value)` - установить значение input
|
||||||
|
- [x] `addClass(element, className)` - добавить класс
|
||||||
|
- [x] `removeClass(element, className)` - удалить класс
|
||||||
|
- [x] `hasClass(element, className)` - проверить класс
|
||||||
|
- [x] `showToast(message, type)` - показать уведомление
|
||||||
|
- [x] `clearChildren(element)` - очистить детей
|
||||||
|
- [x] `createElement(tag, attributes, parent)` - создать элемент
|
||||||
|
|
||||||
|
**Экспорт**: ES6 named exports ✅
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 🟡 Этап 3: State Management (В ПРОЦЕССЕ)
|
||||||
|
|
||||||
|
**Дата**: -
|
||||||
|
**Статус**: 🔲 Ожидает
|
||||||
|
|
||||||
|
#### 3.1. state/appState.js 🔲
|
||||||
|
**Строки из app.js**: 10-51
|
||||||
|
**Что нужно**:
|
||||||
|
- [ ] Создать класс AppState
|
||||||
|
- [ ] Геттеры: `getCurrentEnv()`, `getCurrentEnvSettings()`
|
||||||
|
- [ ] Сеттеры: `setCurrentEnvironment()`, `updateSettings()`
|
||||||
|
- [ ] Методы: `saveToLocalStorage()`, `loadFromLocalStorage()`
|
||||||
|
- [ ] Export: default export singleton
|
||||||
|
|
||||||
|
#### 3.2. data/storage.js 🔲
|
||||||
|
**Строки из app.js**: 618-642
|
||||||
|
**Что нужно**:
|
||||||
|
- [ ] `saveEnvironmentData(env, data)` - сохранить данные окружения
|
||||||
|
- [ ] `loadEnvironmentData(env)` - загрузить данные окружения
|
||||||
|
- [ ] `clearEnvironmentData(env)` - очистить данные
|
||||||
|
- [ ] `clearAllData()` - очистить всё
|
||||||
|
|
||||||
|
#### 3.3. data/defaults.js 🔲
|
||||||
|
**Файл**: settings.js (перенести)
|
||||||
|
**Что нужно**:
|
||||||
|
- [ ] Экспортировать `defaultSettings` из settings.js
|
||||||
|
- [ ] Адаптировать для использования в модулях
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 🔲 Этап 4: Services (ОЖИДАЕТ)
|
||||||
|
|
||||||
|
**Дата**: -
|
||||||
|
**Статус**: 🔲 Ожидает
|
||||||
|
|
||||||
|
#### 4.1. services/api-client.js 🔲
|
||||||
|
**Файл**: api-client.js (переместить)
|
||||||
|
- [ ] Переместить существующий `api-client.js` в `services/`
|
||||||
|
- [ ] Добавить ES6 экспорт: `export default new BriefBenchAPI()`
|
||||||
|
- [ ] Протестировать импорт
|
||||||
|
|
||||||
|
#### 4.2. services/auth.service.js 🔲
|
||||||
|
**Строки из app.js**: 60-140
|
||||||
|
**Функции**:
|
||||||
|
- [ ] `checkAuth()` - проверка авторизации
|
||||||
|
- [ ] `login(loginString)` - вход
|
||||||
|
- [ ] `logout()` - выход
|
||||||
|
- [ ] `isAuthenticated()` - проверка статуса
|
||||||
|
|
||||||
|
#### 4.3. services/settings.service.js 🔲
|
||||||
|
**Строки из app.js**: 290-357
|
||||||
|
**Функции**:
|
||||||
|
- [ ] `loadFromServer()` - загрузить с сервера
|
||||||
|
- [ ] `saveToServer(settings)` - сохранить на сервер
|
||||||
|
- [ ] `extractEnvSettings(envSettings)` - извлечь настройки окружения
|
||||||
|
- [ ] `resetToDefaults()` - сброс к дефолтным
|
||||||
|
|
||||||
|
#### 4.4. services/query.service.js 🔲
|
||||||
|
**Строки из app.js**: 861-1063
|
||||||
|
**Функции**:
|
||||||
|
- [ ] `buildRequestBody()` - построить тело запроса
|
||||||
|
- [ ] `sendQuery(env, apiMode, body)` - отправить запрос
|
||||||
|
- [ ] `extractQuestions()` - извлечь вопросы из textarea
|
||||||
|
- [ ] `loadRequestFromFile()` - загрузить запрос из файла
|
||||||
|
- [ ] `loadResponseFromFile()` - загрузить ответ из файла
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 🔲 Этап 5: UI Components (ОЖИДАЕТ)
|
||||||
|
|
||||||
|
**Дата**: -
|
||||||
|
**Статус**: 🔲 Ожидает
|
||||||
|
|
||||||
|
#### 5.1. ui/auth.ui.js 🔲
|
||||||
|
**Строки из app.js**: 77-132
|
||||||
|
- [ ] `showLoginScreen()` - показать экран входа
|
||||||
|
- [ ] `hideLoginScreen()` - скрыть экран входа
|
||||||
|
- [ ] `setupListeners()` - подключить обработчики
|
||||||
|
- [ ] `handleLoginSubmit()` - обработка входа
|
||||||
|
|
||||||
|
#### 5.2. ui/loading.ui.js 🔲
|
||||||
|
**Строки из app.js**: 1137-1145
|
||||||
|
- [ ] `show(message)` - показать загрузку
|
||||||
|
- [ ] `hide()` - скрыть загрузку
|
||||||
|
|
||||||
|
#### 5.3. ui/settings.ui.js 🔲
|
||||||
|
**Строки из app.js**: 362-813
|
||||||
|
- [ ] `open()` - открыть диалог
|
||||||
|
- [ ] `close()` - закрыть диалог
|
||||||
|
- [ ] `populate()` - заполнить поля
|
||||||
|
- [ ] `read()` - прочитать поля
|
||||||
|
- [ ] `toggleBackendSettings(show)` - показать/скрыть backend настройки
|
||||||
|
- [ ] `save()` - сохранить настройки
|
||||||
|
- [ ] `reset()` - сбросить настройки
|
||||||
|
- [ ] `export()` - экспорт настроек
|
||||||
|
- [ ] `import()` - импорт настроек
|
||||||
|
- [ ] `setupListeners()` - подключить обработчики
|
||||||
|
|
||||||
|
#### 5.4. ui/query-builder.ui.js 🔲
|
||||||
|
**Строки из app.js**: 643-883, 884-950
|
||||||
|
- [ ] `show()` - показать построитель запросов
|
||||||
|
- [ ] `switchMode(mode)` - переключить режим (questions/raw-json)
|
||||||
|
- [ ] `validateJSON()` - валидация JSON
|
||||||
|
- [ ] `handleSendQuery()` - обработка отправки
|
||||||
|
- [ ] `setupListeners()` - подключить обработчики
|
||||||
|
|
||||||
|
#### 5.5. ui/questions-list.ui.js 🔲
|
||||||
|
**Строки из app.js**: 1179-1273
|
||||||
|
- [ ] `render()` - рендер списка вопросов
|
||||||
|
- [ ] `selectAnswer(index)` - выбрать ответ
|
||||||
|
- [ ] `updateCount()` - обновить счётчик
|
||||||
|
- [ ] `hasAnnotations(docsSection)` - проверить наличие аннотаций
|
||||||
|
- [ ] `setupListeners()` - подключить обработчики
|
||||||
|
|
||||||
|
#### 5.6. ui/answer-viewer.ui.js 🔲
|
||||||
|
**Строки из app.js**: 1279-1443
|
||||||
|
- [ ] `render(index)` - рендер ответа
|
||||||
|
- [ ] `renderBody(elementId, text)` - рендер тела ответа
|
||||||
|
- [ ] `renderDocuments(containerId, docs, ...)` - рендер документов
|
||||||
|
- [ ] `toggleExpansion(id)` - раскрыть/свернуть
|
||||||
|
- [ ] `switchTab(tabButton, tabId)` - переключить таб
|
||||||
|
- [ ] `setupListeners()` - подключить обработчики
|
||||||
|
|
||||||
|
#### 5.7. ui/annotations.ui.js 🔲
|
||||||
|
**Строки из app.js**: 1448-1615
|
||||||
|
- [ ] `initForAnswer(index)` - инициализация аннотаций
|
||||||
|
- [ ] `loadForAnswer(index)` - загрузить аннотации
|
||||||
|
- [ ] `loadSection(section, data)` - загрузить секцию
|
||||||
|
- [ ] `loadDocuments(section, subsection, docs)` - загрузить документы
|
||||||
|
- [ ] `setupListeners()` - подключить обработчики
|
||||||
|
- [ ] `saveDraft()` - сохранить черновик
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 🔲 Этап 6: Main Entry Point (ОЖИДАЕТ)
|
||||||
|
|
||||||
|
**Дата**: -
|
||||||
|
**Статус**: 🔲 Ожидает
|
||||||
|
|
||||||
|
#### 6.1. js/main.js 🔲
|
||||||
|
**Что нужно**:
|
||||||
|
- [ ] Импортировать все модули
|
||||||
|
- [ ] Функция `initApp()` - инициализация приложения
|
||||||
|
- [ ] Функция `setupEnvironmentTabs()` - настройка табов
|
||||||
|
- [ ] Функция `switchEnvironment(env)` - переключение окружения
|
||||||
|
- [ ] Функция `updateUI()` - обновление UI
|
||||||
|
- [ ] DOMContentLoaded listener - точка входа
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 🔲 Этап 7: Тестирование (ОЖИДАЕТ)
|
||||||
|
|
||||||
|
**Дата**: -
|
||||||
|
**Статус**: 🔲 Ожидает
|
||||||
|
|
||||||
|
#### 7.1. Ручное тестирование 🔲
|
||||||
|
- [ ] Авторизация работает
|
||||||
|
- [ ] Загрузка/сохранение настроек
|
||||||
|
- [ ] Отправка запросов (bench mode)
|
||||||
|
- [ ] Отправка запросов (backend mode)
|
||||||
|
- [ ] Отображение ответов
|
||||||
|
- [ ] Аннотации сохраняются
|
||||||
|
- [ ] Экспорт/импорт работает
|
||||||
|
- [ ] Переключение окружений
|
||||||
|
|
||||||
|
#### 7.2. Обновление index.html 🔲
|
||||||
|
- [ ] Закомментировать старые скрипты:
|
||||||
|
```html
|
||||||
|
<!-- <script src="settings.js"></script> -->
|
||||||
|
<!-- <script src="api-client.js"></script> -->
|
||||||
|
<!-- <script src="app.js"></script> -->
|
||||||
|
```
|
||||||
|
- [ ] Подключить новый entry point:
|
||||||
|
```html
|
||||||
|
<script type="module" src="js/main.js"></script>
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 7.3. Очистка 🔲
|
||||||
|
- [ ] Удалить старый `app.js` (или переименовать в `app.js.old`)
|
||||||
|
- [ ] Удалить `settings.js` (или переименовать)
|
||||||
|
- [ ] Переместить `api-client.js` (если еще не перемещён)
|
||||||
|
- [ ] Проверить что всё работает
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📈 Статистика
|
||||||
|
|
||||||
|
### Создано файлов: 5/17
|
||||||
|
|
||||||
|
| Категория | Создано | Всего | Прогресс |
|
||||||
|
|-----------|---------|-------|----------|
|
||||||
|
| Config | 1 | 1 | 100% ✅ |
|
||||||
|
| Utils | 4 | 4 | 100% ✅ |
|
||||||
|
| State | 0 | 1 | 0% 🔲 |
|
||||||
|
| Data | 0 | 2 | 0% 🔲 |
|
||||||
|
| Services | 0 | 4 | 0% 🔲 |
|
||||||
|
| UI | 0 | 7 | 0% 🔲 |
|
||||||
|
| Main | 0 | 1 | 0% 🔲 |
|
||||||
|
|
||||||
|
### Перенесено функций: ~36/~150
|
||||||
|
|
||||||
|
- ✅ Format utils: 11 функций
|
||||||
|
- ✅ File utils: 6 функций
|
||||||
|
- ✅ Validation utils: 4 функций
|
||||||
|
- ✅ DOM utils: 15 функций
|
||||||
|
- 🔲 Остальное: ~114 функций
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🎯 Следующий шаг
|
||||||
|
|
||||||
|
**Этап 3: State Management**
|
||||||
|
|
||||||
|
Создать:
|
||||||
|
1. `state/appState.js` - глобальное состояние
|
||||||
|
2. `data/storage.js` - обёртка localStorage
|
||||||
|
3. `data/defaults.js` - дефолтные настройки
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📝 Заметки
|
||||||
|
|
||||||
|
- app.js (1671 строка) остаётся рабочим до конца рефакторинга
|
||||||
|
- Все новые модули используют ES6 синтаксис
|
||||||
|
- Экспорты: named exports для utils, default export для сервисов/UI
|
||||||
|
- Модули полностью автономны и тестируемы
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**Последнее обновление**: 2025-12-25 (Этап 2 завершён)
|
||||||
|
|
@ -0,0 +1,54 @@
|
||||||
|
/**
|
||||||
|
* Application Configuration
|
||||||
|
*
|
||||||
|
* Централизованная конфигурация приложения.
|
||||||
|
*/
|
||||||
|
|
||||||
|
// API Configuration
|
||||||
|
export const API_CONFIG = {
|
||||||
|
baseURL: '/api/v1',
|
||||||
|
timeout: 1800000 // 30 minutes in milliseconds
|
||||||
|
}
|
||||||
|
|
||||||
|
// UI Configuration
|
||||||
|
export const UI_CONFIG = {
|
||||||
|
defaultQueryMode: 'questions',
|
||||||
|
defaultWithDocs: true,
|
||||||
|
maxAnnotationLength: 5000
|
||||||
|
}
|
||||||
|
|
||||||
|
// Storage Keys
|
||||||
|
export const STORAGE_KEYS = {
|
||||||
|
token: 'briefBenchToken',
|
||||||
|
user: 'briefBenchUser',
|
||||||
|
settings: 'briefBenchSettings',
|
||||||
|
envData: (env) => `briefBenchData_${env}`,
|
||||||
|
annotations: 'briefBenchAnnotationsDraft'
|
||||||
|
}
|
||||||
|
|
||||||
|
// Constants
|
||||||
|
export const ENVIRONMENTS = ['ift', 'psi', 'prod']
|
||||||
|
export const API_MODES = ['bench', 'backend']
|
||||||
|
|
||||||
|
// Environment Names
|
||||||
|
export const ENV_NAMES = {
|
||||||
|
ift: 'ИФТ',
|
||||||
|
psi: 'ПСИ',
|
||||||
|
prod: 'ПРОМ'
|
||||||
|
}
|
||||||
|
|
||||||
|
// Annotation Issue Types
|
||||||
|
export const ANNOTATION_ISSUES = [
|
||||||
|
'factual_error',
|
||||||
|
'inaccurate_wording',
|
||||||
|
'insufficient_context',
|
||||||
|
'offtopic',
|
||||||
|
'technical_answer'
|
||||||
|
]
|
||||||
|
|
||||||
|
// Rating Values
|
||||||
|
export const RATING_VALUES = {
|
||||||
|
CORRECT: 'correct',
|
||||||
|
PARTIAL: 'partial',
|
||||||
|
INCORRECT: 'incorrect'
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,178 @@
|
||||||
|
/**
|
||||||
|
* DOM Utilities
|
||||||
|
*
|
||||||
|
* Функции для работы с DOM (показать/скрыть элементы, обновить текст).
|
||||||
|
*/
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Показать элемент
|
||||||
|
* @param {string|HTMLElement} element - ID элемента или сам элемент
|
||||||
|
*/
|
||||||
|
export function showElement(element) {
|
||||||
|
const el = typeof element === 'string' ? document.getElementById(element) : element
|
||||||
|
if (el) {
|
||||||
|
el.style.display = ''
|
||||||
|
el.classList.remove('hidden')
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Скрыть элемент
|
||||||
|
* @param {string|HTMLElement} element - ID элемента или сам элемент
|
||||||
|
*/
|
||||||
|
export function hideElement(element) {
|
||||||
|
const el = typeof element === 'string' ? document.getElementById(element) : element
|
||||||
|
if (el) {
|
||||||
|
el.classList.add('hidden')
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Переключить видимость элемента
|
||||||
|
* @param {string|HTMLElement} element - ID элемента или сам элемент
|
||||||
|
*/
|
||||||
|
export function toggleElement(element) {
|
||||||
|
const el = typeof element === 'string' ? document.getElementById(element) : element
|
||||||
|
if (el) {
|
||||||
|
if (el.classList.contains('hidden')) {
|
||||||
|
showElement(el)
|
||||||
|
} else {
|
||||||
|
hideElement(el)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Установить текст элемента
|
||||||
|
* @param {string|HTMLElement} element - ID элемента или сам элемент
|
||||||
|
* @param {string} text - Текст для установки
|
||||||
|
*/
|
||||||
|
export function setElementText(element, text) {
|
||||||
|
const el = typeof element === 'string' ? document.getElementById(element) : element
|
||||||
|
if (el) {
|
||||||
|
el.textContent = text
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Установить HTML элемента
|
||||||
|
* @param {string|HTMLElement} element - ID элемента или сам элемент
|
||||||
|
* @param {string} html - HTML для установки
|
||||||
|
*/
|
||||||
|
export function setElementHTML(element, html) {
|
||||||
|
const el = typeof element === 'string' ? document.getElementById(element) : element
|
||||||
|
if (el) {
|
||||||
|
el.innerHTML = html
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Получить значение input элемента
|
||||||
|
* @param {string|HTMLElement} element - ID элемента или сам элемент
|
||||||
|
* @returns {string} Значение элемента
|
||||||
|
*/
|
||||||
|
export function getInputValue(element) {
|
||||||
|
const el = typeof element === 'string' ? document.getElementById(element) : element
|
||||||
|
return el ? el.value : ''
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Установить значение input элемента
|
||||||
|
* @param {string|HTMLElement} element - ID элемента или сам элемент
|
||||||
|
* @param {string} value - Значение для установки
|
||||||
|
*/
|
||||||
|
export function setInputValue(element, value) {
|
||||||
|
const el = typeof element === 'string' ? document.getElementById(element) : element
|
||||||
|
if (el) {
|
||||||
|
el.value = value
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Добавить класс элементу
|
||||||
|
* @param {string|HTMLElement} element - ID элемента или сам элемент
|
||||||
|
* @param {string} className - Имя класса
|
||||||
|
*/
|
||||||
|
export function addClass(element, className) {
|
||||||
|
const el = typeof element === 'string' ? document.getElementById(element) : element
|
||||||
|
if (el) {
|
||||||
|
el.classList.add(className)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Удалить класс у элемента
|
||||||
|
* @param {string|HTMLElement} element - ID элемента или сам элемент
|
||||||
|
* @param {string} className - Имя класса
|
||||||
|
*/
|
||||||
|
export function removeClass(element, className) {
|
||||||
|
const el = typeof element === 'string' ? document.getElementById(element) : element
|
||||||
|
if (el) {
|
||||||
|
el.classList.remove(className)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Проверить наличие класса у элемента
|
||||||
|
* @param {string|HTMLElement} element - ID элемента или сам элемент
|
||||||
|
* @param {string} className - Имя класса
|
||||||
|
* @returns {boolean} True если класс есть
|
||||||
|
*/
|
||||||
|
export function hasClass(element, className) {
|
||||||
|
const el = typeof element === 'string' ? document.getElementById(element) : element
|
||||||
|
return el ? el.classList.contains(className) : false
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Показать toast уведомление
|
||||||
|
* @param {string} message - Сообщение
|
||||||
|
* @param {string} type - Тип ('info', 'success', 'error', 'warning')
|
||||||
|
*/
|
||||||
|
export function showToast(message, type = 'info') {
|
||||||
|
// TODO: Implement proper toast/snackbar component
|
||||||
|
console.log(`[${type.toUpperCase()}] ${message}`)
|
||||||
|
alert(message)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Очистить всех детей у элемента
|
||||||
|
* @param {string|HTMLElement} element - ID элемента или сам элемент
|
||||||
|
*/
|
||||||
|
export function clearChildren(element) {
|
||||||
|
const el = typeof element === 'string' ? document.getElementById(element) : element
|
||||||
|
if (el) {
|
||||||
|
el.innerHTML = ''
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Создать элемент с атрибутами
|
||||||
|
* @param {string} tag - Тег элемента
|
||||||
|
* @param {object} attributes - Атрибуты элемента
|
||||||
|
* @param {string|HTMLElement} parent - Родительский элемент (опционально)
|
||||||
|
* @returns {HTMLElement} Созданный элемент
|
||||||
|
*/
|
||||||
|
export function createElement(tag, attributes = {}, parent = null) {
|
||||||
|
const el = document.createElement(tag)
|
||||||
|
|
||||||
|
for (const [key, value] of Object.entries(attributes)) {
|
||||||
|
if (key === 'class') {
|
||||||
|
el.className = value
|
||||||
|
} else if (key === 'text') {
|
||||||
|
el.textContent = value
|
||||||
|
} else if (key === 'html') {
|
||||||
|
el.innerHTML = value
|
||||||
|
} else {
|
||||||
|
el.setAttribute(key, value)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (parent) {
|
||||||
|
const parentEl = typeof parent === 'string' ? document.getElementById(parent) : parent
|
||||||
|
if (parentEl) {
|
||||||
|
parentEl.appendChild(el)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return el
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,111 @@
|
||||||
|
/**
|
||||||
|
* File Utilities
|
||||||
|
*
|
||||||
|
* Функции для работы с файлами (загрузка, сохранение).
|
||||||
|
*/
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Скачать данные как JSON файл
|
||||||
|
* @param {object} data - Данные для экспорта
|
||||||
|
* @param {string} filename - Имя файла
|
||||||
|
*/
|
||||||
|
export function downloadJSON(data, filename) {
|
||||||
|
const blob = new Blob([JSON.stringify(data, null, 2)], { type: 'application/json' })
|
||||||
|
const url = URL.createObjectURL(blob)
|
||||||
|
const a = document.createElement('a')
|
||||||
|
a.href = url
|
||||||
|
a.download = filename
|
||||||
|
document.body.appendChild(a)
|
||||||
|
a.click()
|
||||||
|
document.body.removeChild(a)
|
||||||
|
URL.revokeObjectURL(url)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Загрузить файл как JSON
|
||||||
|
* @param {File} file - Файл для загрузки
|
||||||
|
* @returns {Promise<object>} Распарсенный JSON объект
|
||||||
|
*/
|
||||||
|
export async function loadFileAsJSON(file) {
|
||||||
|
return new Promise((resolve, reject) => {
|
||||||
|
const reader = new FileReader()
|
||||||
|
|
||||||
|
reader.onload = (e) => {
|
||||||
|
try {
|
||||||
|
const data = JSON.parse(e.target.result)
|
||||||
|
resolve(data)
|
||||||
|
} catch (error) {
|
||||||
|
reject(new Error('Невалидный JSON формат'))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
reader.onerror = () => {
|
||||||
|
reject(new Error('Ошибка чтения файла'))
|
||||||
|
}
|
||||||
|
|
||||||
|
reader.readAsText(file)
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Загрузить файл как текст
|
||||||
|
* @param {File} file - Файл для загрузки
|
||||||
|
* @returns {Promise<string>} Содержимое файла
|
||||||
|
*/
|
||||||
|
export async function loadFileAsText(file) {
|
||||||
|
return new Promise((resolve, reject) => {
|
||||||
|
const reader = new FileReader()
|
||||||
|
|
||||||
|
reader.onload = (e) => {
|
||||||
|
resolve(e.target.result)
|
||||||
|
}
|
||||||
|
|
||||||
|
reader.onerror = () => {
|
||||||
|
reject(new Error('Ошибка чтения файла'))
|
||||||
|
}
|
||||||
|
|
||||||
|
reader.readAsText(file)
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Создать input для выбора файла и вернуть выбранный файл
|
||||||
|
* @param {string} accept - MIME типы (например, 'application/json')
|
||||||
|
* @returns {Promise<File|null>} Выбранный файл или null
|
||||||
|
*/
|
||||||
|
export async function selectFile(accept = '*') {
|
||||||
|
return new Promise((resolve) => {
|
||||||
|
const input = document.createElement('input')
|
||||||
|
input.type = 'file'
|
||||||
|
input.accept = accept
|
||||||
|
|
||||||
|
input.onchange = (e) => {
|
||||||
|
const file = e.target.files[0]
|
||||||
|
resolve(file || null)
|
||||||
|
}
|
||||||
|
|
||||||
|
input.oncancel = () => {
|
||||||
|
resolve(null)
|
||||||
|
}
|
||||||
|
|
||||||
|
input.click()
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Скачать текст как файл
|
||||||
|
* @param {string} text - Текст для сохранения
|
||||||
|
* @param {string} filename - Имя файла
|
||||||
|
* @param {string} mimeType - MIME тип (по умолчанию text/plain)
|
||||||
|
*/
|
||||||
|
export function downloadText(text, filename, mimeType = 'text/plain') {
|
||||||
|
const blob = new Blob([text], { type: mimeType })
|
||||||
|
const url = URL.createObjectURL(blob)
|
||||||
|
const a = document.createElement('a')
|
||||||
|
a.href = url
|
||||||
|
a.download = filename
|
||||||
|
document.body.appendChild(a)
|
||||||
|
a.click()
|
||||||
|
document.body.removeChild(a)
|
||||||
|
URL.revokeObjectURL(url)
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,150 @@
|
||||||
|
/**
|
||||||
|
* Format Utilities
|
||||||
|
*
|
||||||
|
* Функции для форматирования данных (время, текст, UUID).
|
||||||
|
*/
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Генерация UUID v4
|
||||||
|
* @returns {string} UUID
|
||||||
|
*/
|
||||||
|
export function generateUUID() {
|
||||||
|
return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c) {
|
||||||
|
const r = Math.random() * 16 | 0
|
||||||
|
const v = c === 'x' ? r : (r & 0x3 | 0x8)
|
||||||
|
return v.toString(16)
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Форматировать время в секундах в читаемый вид
|
||||||
|
* @param {number} seconds - Количество секунд
|
||||||
|
* @returns {string} Отформатированное время (например, "2.5 сек", "1 мин 30 сек")
|
||||||
|
*/
|
||||||
|
export function formatTime(seconds) {
|
||||||
|
if (seconds < 60) {
|
||||||
|
return `${seconds.toFixed(1)} сек`
|
||||||
|
}
|
||||||
|
|
||||||
|
const minutes = Math.floor(seconds / 60)
|
||||||
|
const secs = Math.floor(seconds % 60)
|
||||||
|
return `${minutes} мин ${secs} сек`
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Форматировать ISO timestamp в локальное время
|
||||||
|
* @param {string} isoString - ISO строка времени
|
||||||
|
* @returns {string} Отформатированное локальное время
|
||||||
|
*/
|
||||||
|
export function formatTimestamp(isoString) {
|
||||||
|
try {
|
||||||
|
const date = new Date(isoString)
|
||||||
|
return date.toLocaleString('ru-RU', {
|
||||||
|
year: 'numeric',
|
||||||
|
month: '2-digit',
|
||||||
|
day: '2-digit',
|
||||||
|
hour: '2-digit',
|
||||||
|
minute: '2-digit',
|
||||||
|
second: '2-digit'
|
||||||
|
})
|
||||||
|
} catch (e) {
|
||||||
|
return isoString
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Проверить является ли текст таблицей
|
||||||
|
* @param {string} text - Текст для проверки
|
||||||
|
* @returns {boolean} True если текст похож на таблицу
|
||||||
|
*/
|
||||||
|
export function isTableText(text) {
|
||||||
|
const lines = text.split('\n').filter(line => line.trim())
|
||||||
|
if (lines.length < 3) return false
|
||||||
|
|
||||||
|
// Проверить наличие разделителей
|
||||||
|
const hasSeparator = lines.some(line => /^[\s\-|+]+$/.test(line))
|
||||||
|
const hasPipes = lines.filter(line => line.includes('|')).length > 2
|
||||||
|
|
||||||
|
return hasSeparator || hasPipes
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Парсинг текстовой таблицы в HTML
|
||||||
|
* @param {string} text - Текст таблицы
|
||||||
|
* @returns {string} HTML таблица
|
||||||
|
*/
|
||||||
|
export function parseTextTable(text) {
|
||||||
|
const lines = text.split('\n').filter(line => line.trim())
|
||||||
|
|
||||||
|
if (lines.length < 2) {
|
||||||
|
return `<pre>${escapeHtml(text)}</pre>`
|
||||||
|
}
|
||||||
|
|
||||||
|
let html = '<table class="parsed-table">'
|
||||||
|
let inHeader = true
|
||||||
|
|
||||||
|
for (const line of lines) {
|
||||||
|
// Skip separator lines
|
||||||
|
if (/^[\s\-|+]+$/.test(line)) {
|
||||||
|
inHeader = false
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
|
||||||
|
// Parse cells
|
||||||
|
const cells = line.split('|')
|
||||||
|
.map(cell => cell.trim())
|
||||||
|
.filter((cell, i, arr) => i > 0 && i < arr.length - 1) // Remove first and last empty cells
|
||||||
|
|
||||||
|
if (cells.length === 0) continue
|
||||||
|
|
||||||
|
html += '<tr>'
|
||||||
|
const tag = inHeader ? 'th' : 'td'
|
||||||
|
|
||||||
|
for (const cell of cells) {
|
||||||
|
html += `<${tag}>${escapeHtml(cell)}</${tag}>`
|
||||||
|
}
|
||||||
|
|
||||||
|
html += '</tr>'
|
||||||
|
|
||||||
|
if (inHeader) {
|
||||||
|
inHeader = false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
html += '</table>'
|
||||||
|
return html
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Экранировать HTML спецсимволы
|
||||||
|
* @param {string} text - Исходный текст
|
||||||
|
* @returns {string} Экранированный текст
|
||||||
|
*/
|
||||||
|
export function escapeHtml(text) {
|
||||||
|
const div = document.createElement('div')
|
||||||
|
div.textContent = text
|
||||||
|
return div.innerHTML
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Склонение числительных (русский язык)
|
||||||
|
* @param {number} count - Число
|
||||||
|
* @param {string} one - Форма для 1 (например, "вопрос")
|
||||||
|
* @param {string} few - Форма для 2-4 (например, "вопроса")
|
||||||
|
* @param {string} many - Форма для 5+ (например, "вопросов")
|
||||||
|
* @returns {string} Правильная форма
|
||||||
|
*/
|
||||||
|
export function pluralize(count, one, few, many) {
|
||||||
|
const mod10 = count % 10
|
||||||
|
const mod100 = count % 100
|
||||||
|
|
||||||
|
if (mod10 === 1 && mod100 !== 11) {
|
||||||
|
return one
|
||||||
|
}
|
||||||
|
|
||||||
|
if (mod10 >= 2 && mod10 <= 4 && (mod100 < 10 || mod100 >= 20)) {
|
||||||
|
return few
|
||||||
|
}
|
||||||
|
|
||||||
|
return many
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,133 @@
|
||||||
|
/**
|
||||||
|
* Validation Utilities
|
||||||
|
*
|
||||||
|
* Функции для валидации данных.
|
||||||
|
*/
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Валидация JSON строки
|
||||||
|
* @param {string} jsonString - JSON строка для валидации
|
||||||
|
* @returns {{valid: boolean, error: string|null, data: object|null}} Результат валидации
|
||||||
|
*/
|
||||||
|
export function validateJSON(jsonString) {
|
||||||
|
if (!jsonString || !jsonString.trim()) {
|
||||||
|
return {
|
||||||
|
valid: false,
|
||||||
|
error: 'JSON не может быть пустым',
|
||||||
|
data: null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
const data = JSON.parse(jsonString)
|
||||||
|
return {
|
||||||
|
valid: true,
|
||||||
|
error: null,
|
||||||
|
data
|
||||||
|
}
|
||||||
|
} catch (e) {
|
||||||
|
return {
|
||||||
|
valid: false,
|
||||||
|
error: `Ошибка парсинга JSON: ${e.message}`,
|
||||||
|
data: null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Валидация формата логина (8 цифр)
|
||||||
|
* @param {string} login - Логин для проверки
|
||||||
|
* @returns {{valid: boolean, error: string|null}} Результат валидации
|
||||||
|
*/
|
||||||
|
export function validateLoginFormat(login) {
|
||||||
|
if (!login || !login.trim()) {
|
||||||
|
return {
|
||||||
|
valid: false,
|
||||||
|
error: 'Логин не может быть пустым'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!/^[0-9]{8}$/.test(login)) {
|
||||||
|
return {
|
||||||
|
valid: false,
|
||||||
|
error: 'Логин должен состоять из 8 цифр'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return {
|
||||||
|
valid: true,
|
||||||
|
error: null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Валидация массива вопросов для запроса
|
||||||
|
* @param {Array} questions - Массив вопросов
|
||||||
|
* @returns {{valid: boolean, error: string|null}} Результат валидации
|
||||||
|
*/
|
||||||
|
export function validateQuestions(questions) {
|
||||||
|
if (!Array.isArray(questions)) {
|
||||||
|
return {
|
||||||
|
valid: false,
|
||||||
|
error: 'Вопросы должны быть массивом'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (questions.length === 0) {
|
||||||
|
return {
|
||||||
|
valid: false,
|
||||||
|
error: 'Необходимо добавить хотя бы один вопрос'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
for (let i = 0; i < questions.length; i++) {
|
||||||
|
const q = questions[i]
|
||||||
|
|
||||||
|
if (!q.body || typeof q.body !== 'string' || !q.body.trim()) {
|
||||||
|
return {
|
||||||
|
valid: false,
|
||||||
|
error: `Вопрос ${i + 1}: текст вопроса не может быть пустым`
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (typeof q.with_docs !== 'boolean') {
|
||||||
|
return {
|
||||||
|
valid: false,
|
||||||
|
error: `Вопрос ${i + 1}: поле with_docs должно быть boolean`
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return {
|
||||||
|
valid: true,
|
||||||
|
error: null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Валидация окружения
|
||||||
|
* @param {string} environment - Окружение для проверки
|
||||||
|
* @returns {{valid: boolean, error: string|null}} Результат валидации
|
||||||
|
*/
|
||||||
|
export function validateEnvironment(environment) {
|
||||||
|
const validEnvs = ['ift', 'psi', 'prod']
|
||||||
|
|
||||||
|
if (!environment) {
|
||||||
|
return {
|
||||||
|
valid: false,
|
||||||
|
error: 'Окружение не может быть пустым'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!validEnvs.includes(environment)) {
|
||||||
|
return {
|
||||||
|
valid: false,
|
||||||
|
error: `Недопустимое окружение. Разрешены: ${validEnvs.join(', ')}`
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return {
|
||||||
|
valid: true,
|
||||||
|
error: null
|
||||||
|
}
|
||||||
|
}
|
||||||
Loading…
Reference in New Issue