Initial commit MKD fixes

2026-02-04 00:17:04 +05:00
commit de94ad707b
312 changed files with 138754 additions and 0 deletions
--- a/backend/1c-integration-options.md
+++ b/backend/1c-integration-options.md
@@ -0,0 +1,173 @@
+# Варианты интеграции с 1С для получения данных по зарплате
+
+## Текущая ситуация
+В системе уже есть:
+- ✅ Обработчик файлов (CSV/XLSX) - `fileProcessor.js`
+- ✅ Таблица `employees` с полем `salary`
+- ✅ Таблица `employee_accounting_data` (ИНН, СНИЛС, банковские реквизиты)
+- ✅ API для загрузки финансовых отчетов
+
+## Варианты интеграции
+
+### 1. 📄 **Импорт файлов (Excel/CSV) - РЕКОМЕНДУЕТСЯ**
+**Сложность:** ⭐ Низкая  
+**Время внедрения:** 1-2 дня  
+**Требования:** 1С может экспортировать отчеты в Excel/CSV
+
+**Как работает:**
+- В 1С настраивается выгрузка отчета по зарплате в Excel/CSV
+- Пользователь загружает файл через веб-интерфейс
+- Система автоматически парсит и обновляет данные сотрудников
+
+**Плюсы:**
+- ✅ Уже реализована базовая инфраструктура
+- ✅ Не требует изменений в 1С
+- ✅ Простое внедрение
+- ✅ Работает с любой версией 1С
+
+**Минусы:**
+- ⚠️ Ручная загрузка файлов
+- ⚠️ Нет автоматической синхронизации
+
+**Что нужно сделать:**
+1. Расширить `fileProcessor.js` для обработки зарплатных данных
+2. Добавить маппинг полей из 1С отчета
+3. Создать API endpoint для обновления зарплат сотрудников
+4. Добавить UI для загрузки зарплатных отчетов
+
+---
+
+### 2. 🌐 **REST API 1С (HTTP-сервис)**
+**Сложность:** ⭐⭐ Средняя  
+**Время внедрения:** 3-5 дней  
+**Требования:** 1С:Предприятие 8.3+ с настроенным HTTP-сервисом
+
+**Как работает:**
+- В 1С создается HTTP-сервис, который отдает данные по зарплате
+- Node.js backend делает запросы к 1С API
+- Автоматическая синхронизация по расписанию
+
+**Плюсы:**
+- ✅ Автоматическая синхронизация
+- ✅ Актуальные данные в реальном времени
+- ✅ Можно настроить расписание обновлений
+
+**Минусы:**
+- ⚠️ Требует настройки HTTP-сервиса в 1С
+- ⚠️ Нужен доступ к серверу 1С
+- ⚠️ Требуется настройка безопасности
+
+**Что нужно сделать:**
+1. Настроить HTTP-сервис в 1С
+2. Создать модуль `1cApiClient.js` для работы с API
+3. Добавить endpoint `/api/salary/sync-from-1c`
+4. Настроить cron-задачу для автоматической синхронизации
+
+---
+
+### 3. 🔌 **COM/OLE соединение (Windows)**
+**Сложность:** ⭐⭐⭐ Высокая  
+**Время внедрения:** 5-7 дней  
+**Требования:** Windows сервер, 1С установлена локально
+
+**Как работает:**
+- Node.js использует COM-объекты для подключения к 1С
+- Прямое обращение к данным через OLE
+
+**Плюсы:**
+- ✅ Прямой доступ к данным
+- ✅ Не нужны промежуточные файлы
+
+**Минусы:**
+- ⚠️ Работает только на Windows
+- ⚠️ Требует установленной 1С на сервере
+- ⚠️ Сложная настройка
+- ⚠️ Проблемы с производительностью
+
+**Не рекомендуется** для веб-приложения
+
+---
+
+### 4. 🗄️ **ODBC/OLE DB подключение к базе 1С**
+**Сложность:** ⭐⭐⭐ Высокая  
+**Время внедрения:** 5-7 дней  
+**Требования:** 1С на SQL Server, доступ к БД
+
+**Как работает:**
+- Прямое подключение к базе данных 1С через ODBC
+- SQL-запросы к таблицам 1С
+
+**Плюсы:**
+- ✅ Прямой доступ к данным
+- ✅ Можно использовать SQL-запросы
+
+**Минусы:**
+- ⚠️ Требует знания структуры БД 1С
+- ⚠️ Зависит от версии 1С
+- ⚠️ Проблемы с безопасностью
+- ⚠️ Может сломаться при обновлении 1С
+
+**Не рекомендуется** - хрупкое решение
+
+---
+
+## Рекомендация
+
+### 🎯 **Гибридный подход: Файлы + HTTP-сервис**
+
+**Этап 1 (быстрое внедрение):**
+- Расширить существующую систему импорта файлов для зарплатных данных
+- Пользователи загружают отчеты вручную
+
+**Этап 2 (автоматизация):**
+- Настроить HTTP-сервис в 1С
+- Добавить автоматическую синхронизацию по расписанию
+- Файлы остаются как резервный вариант
+
+---
+
+## Структура данных для зарплатного отчета
+
+### Поля, которые нужно получать из 1С:
+
+```typescript
+interface SalaryReportRow {
+  // Идентификация сотрудника
+  employeeIdentifier: string; // ФИО, ИНН, табельный номер
+  inn?: string;              // ИНН (для точного сопоставления)
+  snils?: string;            // СНИЛС
+  
+  // Зарплатные данные
+  period: string;             // Период (месяц/год)
+  baseSalary: number;         // Оклад
+  actualSalary: number;       // Фактическая зарплата
+  bonuses?: number;           // Премии
+  deductions?: number;        // Удержания
+  netSalary?: number;         // К выплате
+  
+  // Дополнительно
+  workedDays?: number;         // Отработано дней
+  workedHours?: number;        // Отработано часов
+  vacationDays?: number;       // Дни отпуска
+  sickLeaveDays?: number;      // Дни больничного
+}
+```
+
+---
+
+## Следующие шаги
+
+1. **Определить формат отчета из 1С:**
+   - Какие поля содержит отчет?
+   - В каком формате экспортируется (Excel, CSV)?
+   - Есть ли возможность настроить выгрузку?
+
+2. **Выбрать вариант интеграции:**
+   - Начать с импорта файлов (быстро)
+   - Планировать HTTP-сервис (автоматизация)
+
+3. **Реализовать:**
+   - Расширить fileProcessor для зарплатных данных
+   - Создать маппинг полей
+   - Добавить UI для загрузки
+   - Настроить обновление данных сотрудников