# 📦 Локальная система учёта и перемещения оборудования

Система для контроля, учета и аудита перемещений оборудования и ТМЦ (роутеры, терминалы, приставки, коммутаторы и др.) с **Zero-Setup архитектурой** — запуск в 1 клик на macOS и ПК без необходимости установки серверов, баз данных или компиляторов.

---

## 🚀 Быстрый запуск

### Способ 1. Напрямую через файл (Zero-Setup)

#### macOS:
1. Дважды кликните по файлу **`open_app.command`**
2. Приложение мгновенно откроется в браузере Safari

#### Windows:
1. Дважды кликните по файлу **`open_app.bat`**
2. Приложение откроется в браузере по умолчанию

#### Любой ОС (вручную):
1. Откройте файл **`index.html`** в любом браузере (Safari, Chrome, Edge, Firefox, Arc)
2. Приложение готово к работе!

> 💡 **Совет:** Вы можете добавить вкладку в Dock Safari / Chrome как отдельное десктопное приложение через меню `Файл → Добавить в Dock`.

---

## 📦 Структура и экраны системы

### 1. 📊 Дашборд (Свод)
- **KPI-метрики**:
  - Всего ТМЦ в базе
  - На складе (готово к выдаче)
  - У абонентов (в эксплуатации)
  - У сотрудников (в подотчете)
  - Поиск / ДЗ (требует внимания)
  - Списано
- **Интерактивная диаграмма распределения по статусам**: динамический круговой график с процентами
- **Оборудование на руках у сотрудников**: таблица с группировкой по активным монтажникам/сотрудникам
- **Лента последних операций**: последние 6 перемещений оборудования в реальном времени

### 2. ⚡ Ввод / Операции (Хаб операционных форм)

#### Форма 1: Оприходование (Ввод оборудования)
- Ввод даты, SN, IMEI, выбор модели (с кнопкой быстрого создания нового наименования «+ Новая модель»), начальный статус
- Автоматически создает оборудование в реестре и первую запись в архиве

#### Форма 2: Выдача оборудования
- Быстрый выбор по SN с карточкой предпросмотра (текущий статус, модель, держатель)
- Выбор активного сотрудника
- **Авто-логика**: переводит статус в *«выдано сотруднику»*, закрепляет `current_employee_id`, очищает Л/С и заказ, фиксирует запись в архиве

#### Форма 3: Установка оборудования
- Поиск по SN с предпросмотром
- Чекбоксы контроля *«Наличие наименования»* и *«Наличие IMEI»* (с блоком авто-дозаписи реквизитов)
- Лицевой счет, Номер заказа, Инициатор
- **Авто-логика**: статус переходит в *«у абонента»*, заполняются Л/С и Заказ, сбрасывается сотрудник, пишется история

#### Форма 4: Возврат / Снятие / Списание / ДЗ
- Выбор типа: *«Снятие»* (➔ на склад), *«Списание»* (➔ списано), *«ДЗ»* (➔ ДЗ), *«вывести из склада»* (➔ к поиску), *«перемещение с др складов»* (➔ на склад)
- Фиксация в архиве и обновление базы

### 3. 📦 Склад (Реестр оборудования)
- Полнотекстовый поиск по SN, IMEI, Лицевому счету, Номеру заказа, ФИО сотрудника
- Фильтры по Статусам, Типам и Сотрудникам
- Цветовые бейджи статусов
- Клик по статусу или кнопка 🔍 ➔ модальное окно с подробным таймлайном всей истории перемещений оборудования
- Экспорт перечня оборудования в **CSV** для Excel

### 4. 📋 Передвижения (Архив перемещений)
- Полный хронологический аудит-журнал со всеми операциями
- Интерактивная кнопка **«Отработано / В работе»** (зеленая галочка)
- Фильтрация по типам операций и поиск
- Экспорт архива в **CSV**

### 5. ⚙️ Справочники и Управление данными
- **Сотрудники**: добавление новых, изменение статуса (активен / в архиве)
- **Наименования ТМЦ**: справочник типов с подсчетом количества единиц в базе
- **Статусы**: наглядная цветовая карта статусов
- **Резервные копии**:
  - *«Скачать JSON»* — сохранение полной базы в 1 файл на диск
  - *«Восстановить»* — загрузка сохраненной копии
  - *«Сброс к демо-данным»* — возврат к начальным демонстрационным данным

---

## 🗄️ Хранение данных

Все данные хранятся локально в изолированном хранилище браузера (`localStorage`) с автоматическим сохранением после каждого действия.

**Преимущества:**
- ✅ Не требуется интернет
- ✅ Не требуется сервер
- ✅ Не требуется установка ПО
- ✅ Данные полностью под вашим контролем
- ✅ Автоматическое резервное копирование через функцию экспорта

**Рекомендация:** Регулярно делайте резервные копии через меню «Справочники» → «Скачать JSON базу», чтобы не потерять данные при очистке кэша браузера.

---

## 🎨 Дизайн-система

Интерфейс построен на дизайн-системе KT AI с современной тёмной темой:
- Цветовые токены для статусов
- Адаптивная вёрстка
- Плавные анимации и переходы
- Удобная навигация между экранами

---

## 📝 Структура файлов

```
lokalnaya-sistema-ucheta-i-p/
├── index.html          # Главный файл приложения
├── style.css           # Стили дизайн-системы
├── script.js           # Логика приложения
├── open_app.command    # Скрипт запуска для macOS
├── open_app.bat        # Скрипт запуска для Windows
└── README.md           # Этот файл
```

---

## 🔧 Требования

- Любой современный браузер (Safari, Chrome, Edge, Firefox, Arc)
- Поддержка JavaScript ES6+
- Поддержка localStorage (включён по умолчанию)

**Никаких дополнительных зависимостей не требуется!**

---

## 🎯 Примеры использования

### Сценарий 1: приёмка нового оборудования
1. Откройте вкладку «Операции» → «Оприходование»
2. Введите дату, SN, IMEI (если есть)
3. Выберите модель из списка или создайте новую
4. Выберите начальный статус («на складе» или «поиск / дз»)
5. Нажмите «Оприходовать»

### Сценарий 2: выдача оборудования сотруднику
1. Откройте вкладку «Операции» → «Выдача»
2. Введите SN оборудования для поиска
3. Проверьте карточку предпросмотра
4. Выберите сотрудника из списка
5. Нажмите «Выдать оборудование»

### Сценарий 3: установка абоненту
1. Откройте вкладку «Операции» → «Установка»
2. Найдите оборудование по SN
3. Отметьте чекбоксами наличие наименования и IMEI (при необходимости)
4. Введите лицевой счет, номер заказа, инициатора
5. Нажмите «Установить оборудование»

### Сценарий 4: возврат / списание
1. Откройте вкладку «Операции» → «Возврат / Списание»
2. Выберите тип операции (снятие, списание, ДЗ, и т.д.)
3. Найдите оборудование по SN
4. Добавьте комментарий (причина)
5. Нажмите «Выполнить операцию»

---

## 📊 Экспорт данных

### Экспорт склада в CSV
- Нажмите кнопку «📥 Экспорт CSV» на вкладке «Склад»
- Файл откроется в Excel с сохранением кириллицы

### Экспорт архива перемещений
- Нажмите кнопку «📥 Экспорт CSV» на вкладке «Передвижения»
- Получите полную историю всех операций

### Резервное копирование
- Откройте вкладку «Справочники»
- Нажмите «📥 Скачать JSON базу»
- Сохраните файл в надёжном месте

### Восстановление из резервной копии
- Откройте вкладку «Справочники»
- Нажмите «📤 Восстановить из JSON»
- Выберите ранее сохранённый файл `.json`

---

## 🛠️ Поддержка

При возникновении вопросов:
1. Проверьте, что браузер современный (последние 2-3 версии)
2. Убедитесь, что JavaScript включён
3. Проверьте, что localStorage не заблокирован
4. Попробуйте другой браузер

---

**Версия:** 1.0  
**Дата обновления:** 2024