docs: добавлена полная документация системы

README.md

@@ -1,2 +1,139 @@
-# sozday-sovremennyy-veb-sayt
+# Учёт оборудования | Контроль проверок
 
+Система учёта и контроля сроков проверки оборудования и средств безопасности.
+
+## Возможности
+
+### Dashboard
+- Общее количество оборудования
+- Количество оборудования с проверкой в ближайшие 30 дней
+- Количество просроченных проверок
+- Количество оборудования с действующим сроком
+- Количество проверок на текущий месяц
+- Список ближайших проверок
+
+### Таблица оборудования
+Поля:
+- № — порядковый номер
+- Наименование — например, огнетушитель ОП-5
+- Категория — огнетушитель, инструмент, СИЗ и т.д.
+- Инвентарный номер — уникальный номер
+- Место нахождения — кабинет, объект, участок
+- Ответственный — ФИО ответственного
+- Дата последней проверки
+- Периодичность — например, 12 месяцев
+- Следующая проверка — рассчитывается автоматически
+- Статус — действует / скоро проверка / просрочено
+
+### Автоматический расчёт статусов
+
+**Более 30 дней до проверки:**
+- Статус «Действует» (зелёный)
+
+**30 дней или меньше:**
+- Статус «Скоро проверка» (оранжевый)
+- Оборудование появляется во вкладке «Проверка в ближайшие 30 дней»
+- Красное выделение строки
+
+**Дата проверки наступила или прошла:**
+- Статус «ПРОСРОЧЕНО» (красный)
+- Оборудование переносится во вкладку «Просрочено»
+- Тёмно-красное выделение строки
+
+### Вкладки системы
+1. **Dashboard** — сводка и ближайшие проверки
+2. **Всё оборудование** — полная таблица с фильтрами
+3. **Проверка в ближайшие 30 дней** — только оборудование на проверке
+4. **Просрочено** — оборудование с истёкшим сроком
+5. **Добавить оборудование** — форма добавления
+6. **Отчёты** — экспорт в Excel
+
+### Добавление оборудования
+Форма включает поля:
+- Наименование
+- Категория (огнетушитель, аптечка, электроинструмент, СИЗ, измерительный прибор, лестница, другое)
+- Инвентарный номер
+- Место нахождения
+- Ответственный сотрудник
+- Дата последней проверки
+- Периодичность проверки (месяцев)
+- Следующая дата проверки (рассчитывается автоматически)
+- Примечание
+
+**Автоматический расчёт:**
+```
+Последняя проверка: 15.09.2026
+Периодичность: 12 месяцев
+Следующая проверка: 15.09.2027
+```
+
+### Уведомления
+Система автоматически показывает:
+- За 30 дней: «Внимание! Приближается срок проверки»
+- За 7 дней: «До проверки осталось 7 дней»
+- После наступления: «Проверка просрочена»
+
+### Поиск и фильтры
+**Поиск по:**
+- Инвентарному номеру
+- Названию
+- Ответственному
+- Месту нахождения
+
+**Фильтры:**
+- Категория
+- Статус (действует/скоро/просрочено)
+
+### Отчёты
+Экспорт в Excel (CSV с кодировкой UTF-8):
+- Всё оборудование
+- Оборудование на проверку
+- Просроченное оборудование
+- Проверенное оборудование
+
+### Детали оборудования
+При клике на кнопку «Подробнее» открывается карточка с:
+- Полной информацией об оборудовании
+- Текущим статусом
+- Днями до следующей проверки
+- Историей проверок (будущее расширение)
+
+## Технологии
+- Фронтенд: HTML5, CSS3, Vanilla JS
+- Дизайн-система: KT AI Design System
+- Бэкенд: Node.js (нативный http)
+- Хранение: data.json
+
+## Запуск
+```bash
+run
+```
+
+Приложение откроется по ссылке из вывода команды.
+
+## Структура данных
+```json
+{
+  "id": 1,
+  "name": "Огнетушитель ОП-5",
+  "category": "Огнетушитель",
+  "inventoryNumber": "ИН-001",
+  "location": "Кабинет 101",
+  "responsible": "Иванов И.И.",
+  "lastCheck": "2025-09-15",
+  "period": 12,
+  "nextCheck": "2026-09-15",
+  "note": "Порошковый огнетушитель",
+  "status": "warning"
+}
+```
+
+## Расширения (планируется)
+- Несколько пользователей с ролями
+- Администратор / ответственный за оборудование
+- Журнал действий
+- QR-коды на оборудовании
+- Сканирование QR → карточка оборудования
+- Автоматическая ежедневная проверка дат
+- История проверок с результатами
+- Загрузка фотографий и документов